NCDware Installation Guide

This guide is intended for users who are unable to use the installation
utility to install NCDware. It contains general information on what steps are
involved in installing the software. Included with this are instruction sheets
for specific hosts. The instruction sheets cover a basic installation, with
a few notes on what could be done by more advanced system administrators.
You must refer to the Advanced User's Guide for more information on
advanced or non-basic installations.  This covers UNIX systems only.

Specific instructions are available for the following hosts.

AIX 3.2 using TFTP. 
Generic System V for TFTP.
HP-UX 9.x using TFTP.
OSF/1 for Dec Alpha using TFTP.
SCO 3.0 using TFTP.
SCO 3.0 using NFS.
SGI using TFTP.
Solaris 2.x for TFTP.
Solaris 2.x for NFS.
SunOS 4.1.2 and SunOS 4.1.3 using TFTP.
SunOS 4.1.2 and SunOS 4.1.3 using NFS.
SunOS 4.1.0 and SunOS 4.1.1 using TFTP.
SunOS 4.1.0 and SunOS  4.1.1 for NFS.
Ultrix using TFTP.

Generic tape installation.

TO DO:

AIX 3.2 using NFS.
Generic System V for NFS.
HP-UX 9.x using NFS.
SGI using NFS.
Ultrix using NFS.

There are several decisions you must make when installing NCDware. This
guide explains what those decisions are. The attached instruction sheets
apply to specific cases based on what is chosen for these cases.

A. Determine what files you want to install.

	Files in NCDware are categorized into groups. Not all file groups
	are required for basic NCD functionality. These instructions assume
	that all file groups are installed.

	You must determine which server images you need. Server images are
	very large and it is recommended that you install only those you
	need. Each NCD model uses a different server image. There are
	different servers for specific functionality. You must select the
	servers with the functionality you want for each NCD model you have.
	The NCD units require additional memory for some of the servers,
	so you must be sure that the NCDs have enough memory for the server
	you want to use.

	Chapter 1 of the Installation Guide provides a complete list of the
	server images available, the disk space required on the host for them,
	and the memory required in the NCD to use them.

B. Determine what file access method to use

	The instructions cover various types of file access.

	You can choose to use non-secure TFTP, secure TFTP or NFS to access
	files. You must select the file access type for downloading the server
	to the NCD and for reading the configuration and font files. They do
	not have to use the same access method.

	All NCD terminals can use either TFTP method for dowloading or reading
	the files. All NCD terminals can use NFS for reading the configuration
	and font files.  Only NCD terminals with boot prom version 2.6.0 or
	later can use NFS to download the server images.

	TFTP is a general file transfer protocol, similar to ftp, but it does
	not require a user id for access. In non-secure mode, any file on the
	system is accessible via tftp. In secure mode, only files which
	exist in specified directories (called the TFTP home directories)
	are accessible. Most hosts have slight variations on how TFTP is
	enabled, what the home directory is, and how many home directories
	there can be. You must check the man pages on the host for specific
	details.  The attached instructions include what is needed for those
	hosts.

	NFS is the standard method for mounting specified directories on a
	host. The NCD will mount the directories from the host for NFS access.
	The directories on the host must be exported for NFS.

C. File locations

	The instructions are for default locations only, however that
	varies according to the type of file access and on available
	disk space. The instructions specify the locations being used.
	Be sure you have enough disk space for the files.

D. Determine the method you want to use for booting the NCD terminals.

	You can store booting information in the NCD and boot from NVRAM, or
	the NCD can get the booting information from the network using
	BOOTP or RARP (Reverse ARP) protocols.

	NVRAM is fine for sites with a few NCD terminals that are closely
	located or for first time installations. It requires going to each
	NCD unit to enter in the booting information.

	Installations with many NCD units may find that using BOOTPD is
	better. Once it is set up, it is very easy to add new terminals
	and to change terminal configurations.

	Instructions are given for booting from NVRAM only. See the Advanced
	User's Guide for information on setting up BOOTPD or RARP.

E. Select the method for users to log onto their hosts.

	There are basically two methods for accessing hosts: xdm or telnet.

	XDM provides a login banner from a host to the NCD terminal. The user
	enters her id and password in this window and is logged onto the host.
	A startup file called 'Xsession' initializes the users environment
	and starts applications. Applications can be run from any host on
	the network. The NCD can be configured to automatically have a login
	banner from a specific host, or to allow the user to choose which host
	to get the banner from.

	Telnet is easily accomplished by starting an NCD local telnet client,
	specifying the hostname or ip address, then logging in. The NCD can
	be configured to automatically start with a telnet client and window
	manager. Users can use more than one telnet client to log onto
	multiple hosts at one time. Applications can be run from any host on
	the network while the telnet sessions are active.

	Instructions are given only for using XDM access.

The following steps are covered in the instructions. If instructions are not
provided for the host you are using, then find a host which has the closest
match for the type of Unix you are using and adapt those instructions for
your host. Use the man pages on your host for help.

1. Log onto the host as root.
2. Mount the CDROM. The CD files can be read directly if you CD driver
   supports Rock Ridge extensions.  If it does not, then you must make links to
   the CD files to have valid file names to reference. A shell script is
   provided on the CD to make the links. The instructions for hosts which
   require this explain what to do.
3. Copy the server files to the host and make links for the boot files.
4. Copy the binary files from the CD to the host.
5. Copy the ncd files from the CD to the host.
6. Copy the NCD man pages from the CD to the host.
7. Enable the file access method on the host (non-secure TFTP, secure TFTP, NFS)
8. Add the NCD terminals to the /etc/hosts file.
9. Create the terminal's configuration file.
10. Configure XDM.
11. Boot the NCD terminal.

(last update 4/10/96 - slg)