.comment;softin.rt .chapter;Software Installation The TCP/IP Package software components should be installed as described in the following sections. The ethernet device handler specific to your particular hardware configuration must be copied to the RT-11 system device. The logical name assignments used by the package are: .list .list element;TCP:###Location of client/server programs .br #######and assorted configuration, message, .br #######and help files. .list element;PAS:###Location of password files. .list element;ENx:###Selected device driver units 0-3. .end list The logical name assignments MAI:, location of mailboxes, HTP:, location of HTTP home directory, and GPH:, location of GOPHER files, may be used in various command files. The TCP/IP Package for RT-11 executables are found on logical disks RTDSK1.DSK, RTDSK2.DSK, and RTDSK3.DSK. The required device handlers are found on the logical disk DVRDSK.DSK. .header level 1;Installation Configurations The RT-11 package may be installed in one of the following three configurations: .header level 2;Install All Files on System Device All command files and client/server programs are copied directly to your system disk. Assign SY: to TCP:. This configuration puts everything in one place but installs about 90 files (and 2100 blocks) on your system disk. .header level 2;Install Only Command Files on System Device Create a seperate logical disk (assigned as TCP:) for the client/server programs and perhaps seperate logical disks for the password files (assigned as PAS:) and mail boxes (assigned as MAI:). Copy the command files to the system directory. This will install about 50 files (and 50 blocks) on your system device. .header level 2;Install All Files on a Logical Disk Create a seperate logical disk (assigned as TCP:) for the package and perhaps seperate logical disks for the password files (assigned as PAS:) and mail boxes (assigned as MAI:). Copy all the files to the TCP: disk. This configuration requires the user to specify the TCP: logical when using any TCP/IP command file or program but removes all files from the system disk. CCL commands may be defined to obviate the need for using TCP:, see the file RTUCL.INS for a complete set of definitions using IND command files or RTUCLV.INS for definitions using the VRUN command without command files. Edit the selected file to include only the CCL definitions you wish defined. .header level 1;Software Components The following annotated list summarizes the software components: .lm 2 .list .tp 5 .list element; TCP/IP Network Server .list 0 .list element; TCPIP.COM TCPIP startup command file .list element; TCPIP.SAV TCPIP network server Program .list element; TCPIP.CFG TCPIP configuration file .end list .tp 3 .list element; Telnet Client .list 0 .list element; TELNET.COM TELNET startup command file .list element; TELNET.SAV TELNET client program .end list .tp 6 .list element; Remote TELNET Server .list 0 .list element; RTELNT.CML TELNET server startup command line .list element; RTELNT.COM TELNET server startup command file .list element; RTELNT.SAV TELNET server program .list element; RTELNT.MSG TELNET server message file .list element; RTELNT.HLP TELNET server help file .end list .tp 3 .list element; CNCT Client .list 0 .list element; CNCT.COM CNCT startup command file .list element; CNCT.SAV CNCT client program .end list .tp 6 .list element; Remote CNCT Server .list 0 .list element; RCNCT.CML CNCT server startup command line .list element; RCNCT.COM CNCT server startup command file .list element; RCNCT.SAV CNCT server program .list element; RCNCT.MSG CNCT server message file .list element; RCNCT.HLP CNCT server help file .end list .tp 4 .list element; FTP Client .list 0 .list element; FTP.COM FTP startup command file .list element; FTP.SAV FTP client program .list element; FTPCMD.TXT FTP command help text .end list .tp 3 .list element; FTPL Client .list 0 .list element; FTPL.COM FTPL startup command file .list element; FTPL.SAV FTPL client program .end list .tp 6 .list element; Remote FTP Server .list 0 .list element; RFTP.CML FTP server startup command line .list element; RFTP.COM FTP server startup command file .list element; RFTP.SAV FTP server program .list element; RFTP.MSG FTP server message file .list element; RFTP.HLP FTP server help file .end list .tp 4 .list element; MAIL Client .list 0 .list element; MAIL.COM MAIL startup command file .list element; MAIL.SAV MAIL client program .list element; MAICMD.TXT MAIL command help text .end list .tp 4 .list element; MMAIL Client .list 0 .list element; MMAIL.COM MMAIL startup command file .list element; MMAIL.SAV MMAIL client program .list element; MMACMD.TXT MMAIL command help text .end list .tp 4 .list element; POP3 Mail Server .list 0 .list element; RPOP3.CML RPOP3 server startup command line .list element; RPOP3.COM RPOP3 server startup command file .list element; RPOP3.SAV RPOP3 server program .end list .tp 4 .list element; MAILER Task .list 0 .list element; MAILER.CML MAILER task startup command line .list element; MAILER.COM MAILER task startup command file .list element; MAILER.SAV MAILER task program .end list .tp 5 .list element; Remote MAIL Server .list 0 .list element; RSMTP.CML MAIL server startup command line .list element; RSMTP.COM MAIL server startup command file .list element; RSMTP.SAV MAIL server program .list element; RSMTP.HLP MAIL server help file .end list .tp 6 .list element; Local Printer Utilities .list 0 .list element; LLPC.COM LLPC local start printer queue .list element; LLPQ.COM LLPQ local printer queue status .list element; LLPR.COM LLPR local print command .list element; LLPRM.COM LLPRM local remove print job .list element; LLPQRM.SAV LLPxx local printer control program .end list .tp 4 .list element; Remote LPD Server .list 0 .list element; RLPD.CML RLPD server startup commnad line .list element; RLDP.COM RLPD server startup command file .list element; RLPD.SAV RLPD server program .end list .tp 5 .list element; Printer Daemon .list 0 .list element; LPRINT.CML LPRINT task startup command line .list element; LPRINT.COM LPRINT task startup command file .list element; LPRINT.SAV LPRINT task program .list element; LPDQRM.CFG LPRINT configuration file .end list .tp 6 .list element; Remote Printer Utilities .list 0 .list element; LPC.COM LPC local start printer queue .list element; LPQ.COM LPQ local printer queue status .list element; LPR.COM LPR local print command .list element; LPRM.COM LPRM local remove print job .list element; LPQRM.SAV LPxx local printer control program .end list .tp 3 .list element; Remote Binary File Printing .list 0 .list element; NTSND.COM NTSND client startup command file .list element; NTSND.SAV NTSND client program .end list .tp 4 .list element; Remote HTTP Web Server .list 0 .list element; RHTTP.CML RHTTP server startup command line .list element; RHTTP.COM RHTTP server startup command file .list element; RHTTP.SAV RHTTP server program .end list .tp 4 .list element; Remote Gopher Server .list 0 .list element; RGOPH.CML RGOPH server startup commnad line .list element; RGOPH.COM RGOPH server startup command file .list element; RGOPH.SAV RGOPH server program .list element; RGOPH.CFG RGOPH server configuration list .end list .tp 4 .list element; Password and Authorization Files .list 0 .list element; PASWRD.COM Password startup command file .list element; PASWRD.SAV Password program .list element; PASWRD.FIL Password and authorization data file .end list .tp 3 .list element; Client/Server Monitor .list 0 .list element; SKTMON.COM Monitor startup command file .list element; SKTMON.SAV Monitor program .end list .tp 11 .list element; Subdirectory Utilities .list 0 .list element; LCD.COM Change directory command file .list element; LDEL.COM Delete file command file .list element; LDIR.COM List directory command file .list element; LLS.COM List directory command file .list element; LMKDIR.COM Make directory command file .list element; LPRO.COM Protect file command file .list element; LRENAM.COM Rename file command file .list element; LRMDIR.COM Delete Subdirectory command file .list element; LUNP.COM Unprotect file command file .list element; UTIL.SAV Utilities program .end list .tp 4 .list element; Subdirectory Summary Utility .list 0 .list element; LDISKS.COM Subdirectory summary command file .list element; RFTHLP.COM Generate RFTP.HLP command file .list element; LDISKS.SAV Subdirectory summary program file .end list .tp 4 .list element; Miscellaneous Files .list 0 .list element; ABRTCP.SAV Abort all Client/Server programs .list element; ABRTJB.COM Abort Client/Server Job command file .list element; ABRTJB.SAV Abort Client/Server Job program .list element; REMOVE.COM Remove all Client/Server global regions .list element; DELAY2.SAV Programmed 2 Second Delay .end list .end list .lm 8 .header level 1;Installation in Detail Complete the hardware installation as described in the chapter titled Hardware Installation. Under RT-11 the most convenient installation is: .list .list element;Create RTTCP.DSK[2400] as TCP:, .br a logical disk for the TCP/IP files .list element;Create PASWRD.DSK[200] as PAS:, .br a logical disk for the password files .list element;Optionally Create MAIL.DSK[nnn] as MAI:, .br a logical disk for the MAIL directory .list element;Optionally Create HTTP.DSK[nnn] as HTP:, .br a logical disk for the HTTP home directory .list element;Optionally Create GOPHER.DSK[nnn] as GPH:, .br a logical disk for the GOPHER home directory .note The MAIL, HTTP, and GOPHER directories are needed only if you are going to use the mail, http, or gopher servers. The size of the MAI:, GPH:, and HTP: logical disks are whatever is needed. .end note .list element;Copy the contents of the distribution disks RTDSK1, RTDSK2, and RTDSK3 to TCP:. .list element;Verify that your RT-11 mapped system was sysgened to include timer and device timeout support. If not, then perform a system generation or rebuild the device handlers to your requirements. .list element;Copy and rename the appropriate device handler from the logical disk DVRDSK.DSK to SY:. (See the chapter on device handlers for more information on selecting the appropriate device handler.) .list element;Edit the file TCP:RTUCL.INS or TCP:RTUCLV.INS to include the CCL commands you want and install these commands. .list element;Edit the file TCP:TCPIP.RUN to mount TCP:, PAS:, [MAI:, HTP:, and GPH:], load the appropriate device handler and assign units 0-3 of the device handler to EN0-3, and start the selected programs. Copy TCP:TCPIP.RUN to SY:. .list element;Add the line '$@SY:TCPIP.RUN' to your startup command file. .list element;Copy PASWRD.SAV and PASWRD.FIL to PAS:. .list element; Update the password file. The password file contains an anonymous account which you will need to update or delete. If you delete the anonymous account then add at least one valid account for initial testing with remote FTP enabled. .list element;Edit the file TCP:TCPIP.CFG for your configuration. Your machine's name and IP address are required and the specification of a name server and gateway may be required for your network. .list element;Edit the files TCP:*.CML to contain the proper command line arguments for jobs started by SY:TCPIP.RUN. .list element;Reboot your RT-11 system. Verify that the job TCPIP is running. (If the job did not start then check that SY:TCPIP.RUN has TCP: defined correctly, the configuration file path is correct, file TCPIP.CFG is correct, and that the selected device driver was loaded. Try starting the TCPIP server from the console using the IND control file TCP:TCPIP.COM with the appropriate command line arguments and see what errors the program gives. .list element;Verify that another networked computer can communicate with your machine by doing a 'ping'. Don't know what a ping is? Skip this step. (verifies that TCPIP is able to respond to data sent over the Ethernet wire) .list element;Attempt to Telnet or FTP to a local computer using only the IP number of that computer. (verifies connections are possible) .list element;Attempt to Telnet or FTP to a local computer using the computer's name. The computer's name and IP address must not be in the TCPIP.CFG file. (verifies that the name server entry is correct) .list element;Attempt to Telnet or FTP to a machine not on your local network. If you use the machine's name then the name server must be working or the machine's name and IP number must be in the configurataion file TCP:TCPIP.CFG. (verifies that the gateway entry is correct) .list element;If the RFTP job is running then attempt to FTP to your computer from some other networked machine using your machine's IP address. If your machine's name has not been added to the name server you must use the IP number. (verifies that the command line file TCP:RFTP.CML is correct and that password checking is working) .end list Essentially your installation is now complete. You only need to update the password file to specify user/password information, access rights, and default FTP and MAIL directories. Individual program configuration information is contained in the chapter titled Program Options.