Installing NCDware 3.2.1 on SGI hosts. Secure TFTP 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. SGI systems are enabled with secure TFTP file access, so these instructions are for secure tftp file access. C. Default file installation locations. D. Booting the NCD from NVRAM. E. Logging in with XDM. Installation Instructions ------------------------- 1. Login as 'root'. 2. Mount the CD. # mkdir /cdrom # (mount the cd on /cdrom with the appropriate mount command) 3. Copy the server files from the CD to the host. Default location: /usr/local/boot. 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. You need enough space for the server images if you are using non-secure tftp. You need enough space for the server images and all of the ncd files and fonts if you are using secure tftp. The following instructions copy all of the servers for the 88k models (17cr, 19c, 19g, 21c, MCX). # mkdir -p /usr/local/boot/Xncd.3.2.1 # cp -iR /cdrom/files/tftpboot/Xncd19c* /usr/local/boot/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 /usr/local/boot # ln -s Xncd.3.2.1/Xncd19c Xncd19c ADVANCED NOTES: /usr/local/boot is the default location for secure tftp on SGI hosts. It is not the default location for NCDs to boot from, so you have to be sure to specify the full path when booting the NCDs. The only way to be able to boot the NCDs automatically is to use bootp to supply the directory name, or NCDs with boot monitor versions 2.6.0 and later can specify the boot directory in the BootMonitor Setup=>Boot menu. You can use hexadecimal 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. SGI binaries are not provided on the release CD. Binaries can be found on the Contrib CD in bin/Contributed/Bin.3.2.x/SGI or ftp'd via anonymous FTP from ftp.ncd.com in the directory /pub/ncd/Archive/Bin.3.2.x/SGI. 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 may take a few minutes to complete. Default location: /usr/lib/X11/ncd # mkdir -p /usr/lib/X11/ncd # cp -iR /cdrom/files/usr/lib/X11/ncd/* /usr/lib/X11/ncd # cd /usr/lib/X11/ncd # find . -name NCDFILE.MAP -exec rm {} \; ADVANCED NOTES: 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 # cp -iR /cdrom/files/usr/man /usr/man # cd /usr/man # find . -name NCDFILE.MAP -exec rm {} \; 7. Configure TFTP. TFTP is configured in secure mode on SGI systems with /usr/local/boot as the secure directory. The entry in /usr/etc/inetd.conf usually looks like this: cd /etc vi inetd.conf tftp dgram udp wait guest /usr/etc/tftpd tftpd -s /usr/local/boot /usr/etc/boot /usr/lib/X11/ncd Change it to tftp dgram udp wait root /usr/etc/tftpd tftpd /usr/local/boot /usr/etc/boot /usr/lib/X11/ncd Exit editing 'vi' and save the changes. TFTP is now configured in non-secure mode on SGI systems. Send a HUP signal to inetd: # ps -ef | grep inetd Get the process id (pid) for the inetd process. # kill -HUP 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/local/boot/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 = ip-use-address-discovery = false ADVANCED NOTES: Additional configuration parameters which are commonly set: exec-startup-commands file-service-table 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. SGI systems are shipped with an XDM configured. The default Xsession starts some GL applications. These GL applications do not work on NCD terminals, so the startup may take a long time while waiting for these to fail. There are hints on how to modify the Xsession file for use with NCD terminals on the Contrib CD in /cdrom/NCD-Articles/unix_info/sgi or via ftp at ftp.ncd.com in /pub/ncd/Archive/NCD-Articles/unix_info/sgi. 11. Boot the NCD terminal. Turn on the NCD. It will do some self tests, then try 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. At the prompt, enter the command >bt /usr/local/boot/ Replace with the name of the boot image for the terminal and use the appropriate ip addresses. The boot image name will be one of the following: Xncd14c Xncd15b Xncd17c Xncd19 Xncd19c Xncd19r Xncdecx ADVANCED NOTES: Use bootp or rarp to resolve IP addresses instead of specifying them in the bt command. The NCD will not be able to boot automatically if they have boot monitor versions before 2.6.0. You must use bootp for the terminals to automatically boot and specify the home directory as /usr/local/boot.