Installing NCDware 4.0 on SCO UNIX for Use with Secure or Non-Secure TFTP File Access Before using these instructions, read "NCDware Installation Notes," contained in the README file in this directory. The instructions apply to all versions of NCDware which begin with '4.0'. The term '4.0.xxx' is used when the specific minor version is needed. Please replace the 'xxx' with the version number specified on your CD-ROM or in the release notes. These instructions install selected server groups and all other NCDware files into default file locations. They prepare the terminal to boot from information stored in NVRAM and for SCO login. 1. Login as root. 2. Mount the CD and create links to the CD filenames. Some systems cannot read CDs in High Sierra format. In this case, the files cannot be read directly from the CD, so the mapnames utility is used to make links to create valid filenames to reference. # mkdir /cdrom # mount -r -f HS /dev/cd0 /cdrom If your system can read High Sierra CDs, then you can skip this rest of this step and copy the files directly from the CD instead of from /tmp/ncd_files. # mkdir /tmp/ncd_files # cd /tmp/ncd_files # cp /cdrom/MAPNAMES. mapnames # chmod +x mapnames # ./mapnames -v /cdrom . 3. Copy the server files from the CD to the host. The default location is /tftpboot. Copy only the files you need. Read NCDware 4.0 Release Notes to determine which files you need and how much space they require. If your NCD terminals have PCMCIA cards, you may not need the server files. 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. # mkdir -p /tftpboot/ncd # cp -iR /tmp/ncd_files/terminals/ncd /tftpboot Make links from the server image names to the boot file name. NCD terminals 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 in the boot directory to the real server images and the modules directory. Be sure to put the correct version number for 'Xncd.4.0.xxx'. # cd /tftpboot # ln -s ./ncd/Xncd.4.0.xxx/Xncdhmx Xncdhmx # ln -s ./ncd/Xncd.4.0.xxx/modshmx modshmx # ln -s ./ncd/Xncd.4.0.xxx/Xncdxpl Xncdxpl # ln -s ./ncd/Xncd.4.0.xxx/modsxpl modsxpl Installation and Configuration Options: If you don't have enough disk space in /tftpboot, try using /usr/tftpboot. If you are using non-secure TFTP, you can link /usr/tftpboot to /tftpboot. If you are using secure TFTP, you must change the secure TFTP directory from /tftpboot to /usr/tftpboot. 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. NCDware does not include executable binary files of NCD utilities for SCO on the CD. Binaries can be found on the NCD Contribution CD in bin/Contributed/Bin.3.2.x/SCO or transported via anonymous FTP from ftp.ncd.com in the directory /pub/ncd/Archive/Bin.3.2.x/SCO. These are from NCDware version 3.2.1, but will work with this release. There are also audio tools in .../Bin.3.1.x/SCO.4.0. The default installation location is /usr/bin/X11. Installation and Configuration Options: The binaries can go into any directory in the user's command path. 5. Copy the NCD files from the CD to the host. These commands take a few minutes to complete. If you are using non-secure TFTP, the files are placed by default in /usr/lib/X11/ncd. Enter the following commands: # mkdir -p /usr/lib/X11/ncd # cp -iR /tmp/ncd_files/terminals/usr/lib/X11/ncd /usr/lib/X11 If you are using secure TFTP, the files are placed by default in /tftpboot/usr/lib/X11/ncd. Enter the following commands: # mkdir -p /tftpboot/usr/lib/X11/ncd # cp -iR /tmp/ncd_files/terminals/usr/lib/X11/ncd /tftpboot/usr/lib/X11 Installation and Configuration Options: If you don't have enough disk space in /tftpboot, try using /usr/tftpboot. If you are using non-secure TFTP, you can link /usr/tftpboot to /tftpboot. If you are using secure TFPT, you must change the secure TFTP directory from /tftpboot to /usr/tftpboot. If you have installed previous versions of NCDware on your network, you may not need to reinstall all the file groups in this version of NCDware. The font and font server files in this version of NCDware are the same as in previous NCDware 3.x releases, but differ from those in NCDware 2.x releases. If you are not going to use SNMP or DPS, you do not need the SNMP or DPS files. 6. Copy the NCD man pages from the CD to the host. The default location is /usr/man. # mkdir -p /usr/man # cp -iR /tmp/ncd_files/hostside/man /usr/man 7. Configure TFTP. To enable TFTP, you need to add an entry for TFTP to the /etc/inetd.conf if it does not have one. In some cases, you may need only to remove the comment sign (#) from an enabling line. After adding the enabling line, then send a HUP signal to the inetd process so that it re-reads its config file. # cd /etc # vi inetd.conf To enable non-secure TFTP, add a line like the following to /etc/inted.conf: tftp dgram udp wait root /etc/tftpd tftpd To enable secure TFTP, add a line like the following to /etc/inted.conf: tftp dgram udp wait root /etc/tftpd tftpd -s /tftpboot To send a HUP signal to inetd, issue the following commands: # ps -aux | egrep inetd # kill -HUP 8. Add the NCD terminals to the /etc/hosts file. You must assign an IP address and host name to each NCD terminal. Put the assigned address and name in the /etc/hosts file. # cd /etc # cp hosts hosts.bak # vi hosts The following is an example of an /etc/host file entry for an NCD terminal: 192.20.100.10 ncdu1.company.com ncdu1 # NCD terminal Installation and Configuration Options: Put the NCD terminals' 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 terminal reads a configuration file when it boots. It first tries to read a filename constructed from the hexadecimal 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 terminal does not find this file, it looks for the file named ncd_std. Use the hexadecimal address as the filename for configuration parameters that are unique to the terminal, such as the IP address and license keys. Use the file ncd_std for parameters that are used by all terminals. See the example configuration files in /usr/lib/X11/ncd/configs. The following instructions create the files you need for a basic configuration on terminals that boot based on IP information obtained 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 following lines: # vi ncd_std boot-tcpip-desired-server = ip-use-address-discovery = false Installation and Configuration Options: Additional configuration parameters that are commonly set include: 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. SCO UNIX is shipped with a session manager and scologin already enabled. Read the man pages for information on adapting them for your needs. You may need to modify the /usr/lib/X11/scologin/Xsession or the user's $HOME/.xsession file for successful login. Check the file /usr/lib/X11/scologin/Xerrors for help with debugging the xsession files. 11.Boot the NCD terminal. Turn on the NCD terminal. It performs self tests, then searches for its IP address. When you see the message "Searching for IP Address," press the Escape key (you may have to press it more than once) to get a Boot Monitor prompt (>). Once you get the prompt, press the Setup key to get 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: Xncdhmx or Xncdxpl TFTP Boot Directory: NFS Boot Directory: /tftpboot/ Config File: UNIX Config Directory: /usr/lib/X11/ncd/configs/ NCDnet Config Directory: TFTP Order: 1 NFS Order: Disabled MOP Order: Disabled LOCAL Order: Disabled Go to the Done menu and select "Reboot." Installation and Configuration Options: Use BOOTP or RARP to resolve IP addresses instead of setting them in the setup menus.