NCBridge Software VMS Installation and Configuration Manual Version 4.0 Copyright Copyright © 1999, 2000 by Network Computing Devices, Inc. (NCD). The information contained in this document is subject to change without notice. Network Computing Devices, Inc. shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material. This document contains information which is protected by copyright. All rights are reserved. No part of this document may be photocopied, reproduced, or translated to another language without the prior written consent of Network Computing Devices, Inc. Copyright © 1990, 1992, 1993, 1994, 1995, 1996 Tektronix, Inc. Wilsonville, Oregon. Printed in the United States of America or the United Kingdom. All rights reserved. This document may not be copied in whole or in part, or otherwise reproduced except as specifically permitted under U.S. copyright law, without the prior written consent of Network Computing Devices, Inc., 350 North Bernardo Avenue, Mountain View, CA 94043 USA. Portions of the network computer source code are copyrighted © 1989 by Sun Microsystems, Inc. Sun design patents pending in the U.S. and foreign countries. OPEN LOOK is a trademark of AT&T. Used by written permission of the owners. Portions of this NCBridge software copyright © 1984-95 Adobe Systems Incorporated. All rights reserved. Some fonts are copyrighted © 1986, 1985 by Bigelow & Holmes. Lucida is a registered trademark of Bigelow & Holmes. Trademarks Network Computing Devices is a registered trademark of Network Computing Devices, Inc. WinDD and NCBridge are trademarks of Network Computing Devices, Inc. Ethernet is a trademark of Xerox Corporation; UNIX is a registered trademark of AT&T; DEC, DECnet, DECwindows, ULTRIX, SCAMP, VMS, and VT are trademarks of Digital Equipment Corporation; SPARCstation is a registered trademark of SPARC International, licensed exclusively to Sun Microsystems, Inc.; Sun Microsystems, SunOS, NFS, Sun, Sun-3, Sun-4, and OpenWindows are trademarks of Sun Microsystems, Inc.; OSF, OSF/Motif, and Motif are trademarks of Open Software Foundation, Inc.; X and X Window System are trademarks of the Massachusetts Institute of Technology. Hewlett-Packard, HP, and vue are trademarks of the Hewlett-Packard company. IBM and SMIT are trademarks of International Business Machines. Silicon Graphics and IRIS are registered trademarks and IRIX is a trademark of Silicon Graphics, Inc. OpenConnect is a registered trademark of OpenConnect Systems, Inc. Other trade names used in this document are trademarks or registered trademarks of the manufacturers or vendors of the associated products. Microsoft, Windows NT and Windows95 are registered trademarks of Microsoft Corporation. Adobe, Acrobat, Display PostScript, and ShowPS are trademarks of Adobe Systems Incorporated which may be registered in certain jurisdictions. Use of a term in this book should not be regarded as affecting the validity of any trademark or service mark. ii Certifications UL 1950, CAN/CSA C22.2 No. 950, IEC 950, FCC Class A, EN55022 (class A), EN50082-1, EN60950, C-Tick, VCCI, MPR II (monitors only), CE, Energy Star Compliant (both monitor and logic unit). Disclaimers THE SOFTWARE PRODUCTS ARE PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, NCD FURTHER DISCLAIMS ALL WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. THE ENTIRE RISK ARISING OUT OF THE USE OR PERFORMANCE OF THE SOFTWARE PRODUCTS AND DOCUMENTATION REMAINS WITH THE END USER. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL NCD OR ITS SUPPLIERS BE LIABLE FOR ANY CONSEQUENTIAL, INCIDENTAL, DIRECT, INDIRECT, SPECIAL, PUNITIVE, OR OTHER DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE PRODUCTS OR DOCUMENTATION, EVEN IF NCD HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. BECAUSE SOME STATES/JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, THE ABOVE LIMITATION MAY NOT APPLY TO YOU. Revisions Revision history of this document: Part Number Revision Date Description 9300846 May 5, 2000 NCBridge for VMS Installation and Configuration Manual, version 4.0, Rev. A. Contact Information Network Computing Devices, Inc. 350 North Bernardo Avenue Mountain View, CA 94043 USA 1-800-800-9599 (USA and Canada) 1-503-641-2200 http://www.ncd.com NCBridge for VMS Installation and Configuration Manual iii iv Contents Preface Map to the NCBridge Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi Discontinued Software Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xii Pieces of the Puzzle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv Chapter 1 Installing the Software Media Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-2 Preparing for Software Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-7 Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-10 Manually Supporting VAX Clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-19 Site-Specific System Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-20 User Login Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-22 Executable Image Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-23 Required Logical Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-24 Chapter 2 Getting Acquainted Gathering Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2 Booting the Network Computer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-4 Starting a Session with Launcher. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6 Logging in with Cterm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-8 Closing a Cterm Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-9 Using Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-10 Exiting Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-12 Chapter 3 Making Choices Planning Configurations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2 Configuration Strategies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-3 Booting Strategies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-5 File Access Strategies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-9 Host Connection Strategies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-11 ROM and Flash Memory Strategies . . . . . . . . . . . . . . . . . . . . . . . . .3-15 Boot Host Check List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-16 File Host Check List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-16 Network Computer Check List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-17 What Next?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-18 Configuration Workbook. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-19 NCBridge for UNIX Installation and Configuration Manual v Chapter 4 Building a Centralized System Remote Configuration Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3 Network Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3 File Host Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3 Environment Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4 Boot Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5 TCP/IP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6 TDEnet Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6 Serial Port Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 4-7 Net to Port Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7 Keyboard Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . 4-8 Input Extensions Configuration Parameters . . . . . . . . . . . . . . . . . . . . 4-9 SNMP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9 Local Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9 LAT Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10 Miscellaneous Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10 Including Other Configuration Files. . . . . . . . . . . . . . . . . . . . . . . . . . 4-10 Restricting Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . 4-10 Tek220 and Tek340 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11 Black and White Pixel Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . 4-11 Flash Memory Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12 HostMenu Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12 Local Print Spooler/Printing Configuration . . . . . . . . . . . . . . . . . . . . 4-13 DEC Session Manager Configuration. . . . . . . . . . . . . . . . . . . . . . . . 4-13 TFTP Daemon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13 Telnet Logout Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13 Remote Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13 WinDD Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14 Update Authorization Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14 RSHD Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14 Hardware MPEG Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14 CSLIP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15 Script Variable Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15 Gateway Table Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16 Internet Host Table Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17 TDEnet Node Table Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18 NFS Table Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19 Font Path Table Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20 Color Table Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21 Display Access Table Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21 vi NCBridge for UNIX Installation and Configuration Manual Chapter 5 Supporting a Centralized System Enabling Network Access. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3 Adding Nodes to the NCP Database . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-6 Connecting to Other Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-7 Local Clients. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-8 Starting Local Clients With xpsh . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-9 Starting Local Clients In The XP.CNF File. . . . . . . . . . . . . . . . . . . . .5-18 Starting Local Clients with rsh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-19 Enabling rsh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-19 Editing the.rhosts File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-19 Starting Local Clients with rsh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-20 Client Launcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-21 Configuring the Client Launcher . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-21 Downloading the Client Launcher . . . . . . . . . . . . . . . . . . . . . . . . . . .5-24 Starting the Client Launcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-26 Starting Local Motif Window Manager . . . . . . . . . . . . . . . . . . . . . . . . . .5-27 In Ultrix DECwindows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-27 In VMS DECwindows XUI (pre-Motif) . . . . . . . . . . . . . . . . . . . . . . . .5-29 In VMS DECwindows Motif 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-31 Motif Window Manager File Access. . . . . . . . . . . . . . . . . . . . . . . . . .5-33 Specifying Virtual Key Bindings. . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-37 Setting up Virtual Desktop Panning. . . . . . . . . . . . . . . . . . . . . . . . . .5-37 Troubleshooting MWM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-39 XP Window Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-41 Accessing the XPWM Defaults File. . . . . . . . . . . . . . . . . . . . . . . . . .5-41 Starting the XP Window Manager . . . . . . . . . . . . . . . . . . . . . . . . . . .5-41 Using XPWM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-42 Customizing XPWM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-45 Authorization Key Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-46 Setting Up SNMP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-46 The authkey.dat File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-47 Starting the Authorization Key Manager . . . . . . . . . . . . . . . . . . . . . .5-47 Using the Authorization Key Manager Client. . . . . . . . . . . . . . . . . . .5-48 Touchscreen Calibration Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-53 Chapter 6 Using Fonts How the X Server Builds the Font Database . . . . . . . . . . . . . . . . . . . . . .6-2 Resident and Boot Directory Fonts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-4 Installing SNF Fonts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-9 Using DECwindows Fonts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-10 Using BDF Fonts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-11 NCBridge for UNIX Installation and Configuration Manualvii Chapter 7 Troubleshooting The network computer cannot find the os file when booting via MOP. . . 7-2 The network computer loads the os file but cannot download files via DAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3 The network computer cannot find the fonts.tbl, nodes.tbl, or hosts.tbl files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3 The VMS Autologin window does not appear after booting. . . . . . . . . . . 7-4 viii NCBridge for UNIX Installation and Configuration Manual Preface This manual presents installation and configuration information for NCD NCBridge software and network computers. It is written for system and network administrators responsible for installing network computers in a distributed-computing environment. The procedures in this manual assume familiarity with: (cid:127) The operating system and administration of the intended host computer. (cid:127) The network protocols and concepts related to the local-area network (LAN). (cid:127) The X environment, including window managers and display managers. The following conventions and terminology are used in this manual. (cid:127) Pointing: Using the mouse to position the pointer on an object on the display. (cid:127) Moving: Using the mouse to change the location of the pointer on the display. (cid:127) Clicking: Pressing and releasing a mouse button without moving the pointer. (cid:127) Dragging: Pressing and holding down a mouse button while moving the pointer. (cid:127) Releasing: Releasing the mouse button to complete a dragging action. Figure 1 on the next page illustrates the typographical conventions used in this manual. Preface NCBridge for VMS Installation and Configuration Manual ix Preface Figure 1 Typographical Conventions x NCBridge for VMS Installation and Configuration Manual