Installing NCDware 3.2.1 on SCO Unix. NFS file access. This document provides instructions for installing NCDware with the following conditions. Please read the Installation Guide notes before using these instructions. A. These instructions are for a complete installation of all NCDware files. B. NFS file access is used for downloading the server and reading files. ONLY NCD TERMINALS WITH BOOT PROM VERSION 2.6.0 OR GREATER CAN DOWNLOAD THE SERVER USING NFS. If you have NCD terminals with boot prom versions earlier than this, you must use TFTP to download the server image. Follow the instructions for TFTP configurations if you cannot use NFS to download the server. Advanced administrator's can then use these notes to set up NFS for reading the configuration and font files. C. Default file installation locations. D. Booting the NCD from NVRAM. E. Logging in with XDM. See Also: The techtip article NCD-Articles/unix_info/general_unix_issues/NFS_booting on the Contrib CD or in /pub/ncd/Archive at ftp.ncd.com. Installation Instructions ------------------------- 1. Login as 'root'. 2. Mount the CD and create links to the CD file names. This will take a few minutes to complete. # umask 022 # mkdir /cdrom # mount -r -f HS,lower /dev/cd0 /cdrom # mkdir /tmp/ncd_files # cd /tmp/ncd_files # cp /cdrom/MAPNAMES.?? mapnames # chmod +x mapnames # ./mapnames -v /cdrom/FILES . 3. Copy the server files from the CD to the host. Default location: /tftpboot Copy only the files you need. We can't tell you what you need, so read Chapter 1 of the installation guide to determine which files you need. If the NCD terminals have server PROMS or PCMCIA cards, you may not need the server files. You can copy all of the files, but they take a lot of disk space. Be sure you have enough disk space before copying the files. The following instructions copy all of the servers for the 88k models (17cr, 19c, 19g, 21c, MCX). # mkdir -p /tftpboot/Xncd.3.2.1 # copy /tmp/ncd_files/tftpboot/Xncd19c* /tftpboot/Xncd.3.2.1 Make links from the server image names to the boot file name. NCD's use the model name as part of the default name used for the boot file. The standard way to get the default name for booting is to make links to the real server images. The following instructions sets the boot file image for the 88k models to be the minimal server. # cd /tftpboot # ln -s Xncd.3.2.1/Xncd19c Xncd19c ADVANCED NOTES: If you don't have enoug disk space in /tftpboot, you can use another partition and export it. You can use heximdecimal forms of a terminal's IP address for the boot file name if you have several terminals of the same model but want to use different server images for them. 4. SCO is not a supported platform by NCD, so there are no binaries for it on the CD. Binaries can be found on the Contrib CD under bin/Contributed/Bin.3.1.x/SCO.3.0 and bin/Contributed/Bin.3.2.x/SCO or ftp'd via anonymous FTP from ftp.ncd.com in the directories /pub/ncd/Archive/Bin.3.1.x/SCO.3.0 and /pub/ncd/Archive/Bin.3.2.x/SCO. Default installation location: /usr/bin/X11 ADVANCED NOTES: The binaries can go into any directory in the user's command path. 5. Copy the ncd files from the CD to the host. This command will take a few minutes to complete. Default location: /usr/lib/X11/ncd # mkdir -p /usr/lib/X11/ncd # copy -r /tmp/ncd_files/usr/lib/X11/ncd /usr/lib/X11/ncd ADVANCED NOTES: You can put the files in any partition if you export the partition and configure the NCD to read the files from that partition. Sites with a previous NCD installation may not need to copy all of the files. The font and font server files are the same as in previous NCDware 3.x releases. The fonts are different than in NCDware 2.x releases. The SNMP and DPS files are new for this release, but are not needed if you are not going to use SNMP or DPS. 6. Copy the NCD man pages from the CD to the host. Default location: /usr/man # mkdir -p /usr/man # copy -r /tmp/ncd_files/usr/man /usr/man 7. Configure NFS. Add an entry to the /etc/exports file to export the file systems needed. # cd /etc # vi exports Insert the following lines if needed. /tftpboot /usr/lib/X11/ncd Export the partitions. # exportfs -a See the man pages on nfs and exportfs for more information on configuring them. ADVANCED NOTES: Access restrictions can be included in /etc/exports to limit access to the desired systems. 8. Add the NCD terminals to the /etc/hosts file. Each NCD terminal must be assigned an IP address and host name. Put the assigned address and name in the /etc/hosts file. # cd /etc # cp hosts hosts.bak # vi hosts This is a sample of what could be added to the file. 192.20.100.10 ncdu1.company.com ncdu1 # NCD terminal ADVANCED NOTES: Put the NCDs addresses and host names in the name service database if you are using a name service. 9. Create the terminal's configuration file. The NCD will read a configuration file when it boots. It will first try to read a file name based on the hexidecimal form of the terminal's IP address. For example, the terminal with IP address 138.43.209.58 looks for the file named 8A2BD13A. If the NCD does not find this file, it will look for the file named ncd_std. It is good to use the hex-ip file for configuration parameters which are unique to the terminal, such as the IP address and license keys. Use the file ncd_std for parameters which are used by all terminals. There are example configuration files in /usr/lib/X11/ncd/configs. These instructions will create the files you need for a basic configuration where the NCD gets IP information from NVRAM. Replace the items with < > with the specified information. # cd /usr/lib/X11/ncd/configs # vi Insert the following lines in the hex-ip file: ip-address-at-next-boot = read ncd_std apply Now edit the ncd_std file and add the lines below. # vi ncd_std boot-tcpip-desired-server = initial-file-server-1 = initial-file-protocol-1 = nfs ip-use-address-discovery = false ADVANCED NOTES: Additional configuration parameters which are commonly set: exec-startup-commands file-service-table file-nfs-uid file-nfs-gid ip-subnet-mask ip-broadcast-address ip-initial-default-gateway-1 tcpip-name-servers tcpip-name-server-protocol xserver-default-font-path 10. Configure XDM. SCO is shipped with a session manager, scologin, enabled. You should read the man pages on this for information on adapting it for your needs. You may need to modify the /usr/lib/X11/scologin/Xsession or the user's $HOME/.xsession file to get a successful login. Check the file /usr/lib/X11/scologin/Xerrors for help with debugging the xsession files. Example xsession files are provided in the "Advanced User's Guide for Unix Systems", in chapter 5. 11. Boot the NCD terminal. Turn on the NCD. It will do some self tests, then try to find out its IP address. You will see the message "Searching for IP Address". Press the Escape key to interrupt this. You will have to press it a couple of times until you get a ">" prompt. Once you get the prompt, press the Setup key to get to the boot monitor setup menus. Go to the Network menu. Set the following values: Get IP Addresses From: NVRAM Terminal IP Address: Boot Host IP Address: Gateway IP Address: Subnet Mask: Broadcase IP Address: Go to the Boot menu. Set the following values: Boot File: Replace with the name of the boot image for the terminal. The boot image name will be one of the following: Xncd14c Xncd15b Xncd17c Xncd19 Xncd19c Xncd19r Xncdecx Xncdhmx TFTP Boot Directory: NFS Boot Directory: /tftpboot/ Config File: UNIX Config Directory: /usr/lib/X11/ncd/configs/ NCDnet Config Directory: TFTP Order: Disabled NFS Order: 1 MOP Order: Disabled LOCAL Order: Disabled Go to the Done menu and select "Reboot". ADVANCED NOTES: Use bootp or rarp to resolve IP addresses instead of specifying them in the setup menus.