1*45187SsklowerInstallation Instructions
2*45187Ssklower
3*45187Ssklower1.  Install the kernel part of this distribution.  A reboot is not
4*45187Ssklower    required.
5*45187Ssklower
6*45187Ssklower
7*45187Ssklower
8*45187Ssklower2.  Examine the various makefiles in this directory and subdirectories
9*45187Ssklower    and if all appears to be well, type "make install".
10*45187Ssklower
11*45187Ssklower
12*45187Ssklower
13*45187Ssklower3.  Edit /etc/rc.local; You will need to add the following lines:
14*45187Ssklower
15*45187Ssklowerif [ -f /etc/x29d ]; then
16*45187Ssklower	/etc/x29d -r -c 1980 "/bin/login login -f"		>/dev/console
17*45187Ssklower	echo -n ' x29d'						>/dev/console
18*45187Ssklowerfi
19*45187Ssklowerif [ -f /etc/nimd ]; then
20*45187Ssklower	/etc/nimd -c 1980 /dev/ptyq0				>/dev/console
21*45187Ssklower	/etc/nimd -c 1980 /dev/ptyq1				>/dev/console
22*45187Ssklower	/etc/nimd -c 1980 /dev/ptyq2				>/dev/console
23*45187Ssklower	echo -n ' nimd'						>/dev/console
24*45187Ssklowerfi
25*45187Ssklower
26*45187Ssklower/etc/x29d is the call-in server and /etc/nimd is used for making out-calls
27*45187Ssklowerto other sites.  Removing the "-r" flag to x29d will cause the kernel X.25
28*45187Ssklowersoftware to clear incoming collect (ie. reverse charged) X.29 calls.
29*45187SsklowerThe exact number of nim daemons started, pseudo-tty devices used, and
30*45187Ssklowerparameter support are installation dependent.  This example starts
31*45187Ssklowerthree daemons that support the 1980 CCITT ITI parameter set.
32*45187Ssklower
33*45187Ssklower
34*45187Ssklower
35*45187Ssklower4. Optional: compile and install dist/bin/login.c (see makefile in that
36*45187Ssklower   directory).  This modified login program more gracefully handles
37*45187Ssklower   incoming X.29 calls.
38*45187Ssklower
39*45187Ssklower
40*45187Ssklower
41*45187Ssklower5. If you run 'tip' then add these lines to /etc/remote:
42*45187Ssklower
43*45187Ssklowernimd|pad|NIM Daemon:\
44*45187Ssklower	:hw:dv=/dev/ttyq0,/dev/ttyq1,/dev/ttyq2:
45*45187Ssklower
46*45187SsklowerMake sure that the 'dv' entry lists the slave devices corresponding to
47*45187Ssklowerthe master pseudo-tty devices that the nim daemons are connected to.
48*45187Ssklower
49*45187SsklowerAdditional lines like the following can be added if you have the version
50*45187Ssklowerof tip locally modified at UBC and wish to simplify connection procedures
51*45187Ssklowerto other remote hosts:
52*45187Ssklower
53*45187Ssklowerdatapacinfo|Datapac help:\
54*45187Ssklower	:cm=NIM p\s92100086:tc=nimd:
55*45187Ssklowerubcg-mts|ubc-mtsg|mts-g|U of British Columbia MTS-g:\
56*45187Ssklower	:cm=NIM call\subcg-mts:\
57*45187Ssklower	:tc=nimd:
58*45187Ssklower
59*45187Ssklower
60*45187Ssklower
61*45187Ssklower6. Edit /etc/x25hosts.  This step is optional.  The X.29 callin server uses
62*45187Ssklower   the information in this file to map an X.121 address to host name and
63*45187Ssklower   the nimd needs the same information to do the opposite with the "call"
64*45187Ssklower   command (see above example with 'ubcg-mts').  Add to the hosts file an
65*45187Ssklower   entry for each remote host that the X.121 address is known.  The flags
66*45187Ssklower   before the X.121 address must be either an 'r' (reverse charge), or 's'
67*45187Ssklower   (hi priority), or a 'p' (also hi priority).  The "hi priority" flag is
68*45187Ssklower   specific X.25(1976) DTE's attached to Canada's Datapac network; all other
69*45187Ssklower   sites can ignore this flag.  Some examples:
70*45187Ssklower
71*45187Ssklower#
72*45187Ssklower# Datapac hosts
73*45187Ssklower#
74*45187Ssklower68100124		camosun		# Camosun College, Victoria BC
75*45187Ssklowerp,92100086		datapacinfo	# Datapac help
76*45187Ssklowerr,67200040		ubcg-mts	# UBC MTS system 'G'
77*45187Ssklower#
78*45187Ssklower# US CCITT hosts
79*45187Ssklower#
80*45187Ssklowers,1311060700067		cornell		# Cornell University, Ithaca NY
81*45187Ssklowers,1311061700139		mit-multics	# Mass Institute of Tech
82*45187Ssklower
83*45187Ssklower
84*45187Ssklower
85*45187Ssklower7. Reboot with the new system.  The log file (default /usr/spool/log/nimd_log)
86*45187Ssklower   will contain a record of routine nimd server activity and any serious
87*45187Ssklower   problems.  This file should be periodically truncated.
88