Welcome

TCP/IP Package For RT-11 Documentation

-... 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  assign-
ments used by the package are:  

     1.  TCP:   Location of client/server programs 
                and assorted configuration, message, 
                and help files.  

     2.  PAS:   Location of password files.  

     3.  ENx:   Selected device driver units 0-3.  


   The  logical  name  assignments  MAI:, location of mailboxes,
HTP:, location of HTTP home directory, and GPH:, location of GO-
PHER 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.  


Configurations

   The  RT-11  package  may be installed in one of the following
three configurations:  


1)  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 confi-
guration  puts  everything  in  one  place but installs about 90
files (and 2100 blocks) on your system disk.  


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.  


3)  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  re-
        quires  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 de-
        finitions  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.  

=> Section Index

Software Components

   The   following   annotated   list  summarizes  the  software
components:  

1.  TCP/IP Network Server 
   1.  TCPIP.COM        TCPIP startup command file 
   2.  TCPIP.SAV        TCPIP network server Program 
   3.  TCPIP.CFG        TCPIP configuration file 


2.  Telnet Client 
   1.  TELNET.COM       TELNET startup command file 
   2.  TELNET.SAV       TELNET client program 


3.  Remote TELNET Server 
   1.  RTELNT.CML       TELNET server startup command line 
   2.  RTELNT.COM       TELNET server startup command file 
   3.  RTELNT.SAV       TELNET server program 
   4.  RTELNT.MSG       TELNET server message file 
   5.  RTELNT.HLP       TELNET server help file 


4.  Remote Telnet Port Server 
   1.  RPTLNT.CML       TELNET Port server startup command line 
   2.  RPTLNT.COM       TELNET Port server startup command file 
   3.  RPTLNT.SAV       TELNET Port server program 
   4.  RPTLNT.MSG       TELNET Port server message file 
   5.  RPTLNT.HLP       TELNET Port server help file 


5.  CNCT Client 
   1.  CNCT.COM         CNCT startup command file 
   2.  CNCT.SAV         CNCT client program 


6.  Remote CNCT Server 
   1.  RCNCT.CML        CNCT server startup command line 
   2.  RCNCT.COM        CNCT server startup command file 
   3.  RCNCT.SAV        CNCT server program 
   4.  RCNCT.MSG        CNCT server message file 
   5.  RCNCT.HLP        CNCT server help file 


7.  Remote CNCT Port Server 
   1.  RPCNCT.CML       CNCT Port server startup command line 
   2.  RPCNCT.COM       CNCT Port server startup command file 
   3.  RPCNCT.SAV       CNCT Port server program 
   4.  RPCNCT.MSG       CNCT Port server message file 
   5.  RPCNCT.HLP       CNCT Port server help file 


8.  FTP Client 
   1.  FTP.COM          FTP startup command file 
   2.  FTP.SAV          FTP client program 
   3.  FTPCMD.TXT       FTP command help text 


9.  FTPL Client 
   1.  FTPL.COM         FTPL startup command file 
   2.  FTPL.SAV         FTPL client program 


10.  Remote FTP Server 
   1.  RFTP.CML         FTP server startup command line 
   2.  RFTP.COM         FTP server startup command file 
   3.  RFTP.SAV         FTP server program 
   4.  RFTP.MSG         FTP server message file 
   5.  RFTP.HLP         FTP server help file 


11.  MAIL Client 
   1.  MAIL.COM         MAIL startup command file 
   2.  MAIL.SAV         MAIL client program 
   3.  MAICMD.TXT       MAIL command help text 


12.  MMAIL Client 
   1.  MMAIL.COM        MMAIL startup command file 
   2.  MMAIL.SAV        MMAIL client program 
   3.  MMACMD.TXT       MMAIL command help text 


13.  POP3 Mail Server 
   1.  RPOP3.CML        RPOP3 server startup command line 
   2.  RPOP3.COM        RPOP3 server startup command file 
   3.  RPOP3.SAV        RPOP3 server program 


14.  MAILER Task 
   1.  MAILER.CML       MAILER task startup command line 
   2.  MAILER.COM       MAILER task startup command file 
   3.  MAILER.SAV       MAILER task program 


15.  Remote MAIL Server 
   1.  RSMTP.CML        MAIL server startup command line 
   2.  RSMTP.COM        MAIL server startup command file 
   3.  RSMTP.SAV        MAIL server program 
   4.  RSMTP.HLP        MAIL server help file 


16.  Local Printer Utilities 
   1.  LLPC.COM         LLPC local start printer queue 
   2.  LLPQ.COM         LLPQ local printer queue status 
   3.  LLPR.COM         LLPR local print command 
   4.  LLPRM.COM        LLPRM local remove print job 
   5.  LLPQRM.SAV       LLPxx local printer control program 


17.  Remote LPD Server 
   1.  RLPD.CML         RLPD server startup commnad line 
   2.  RLDP.COM         RLPD server startup command file 
   3.  RLPD.SAV         RLPD server program 


18.  Printer Daemon 
   1.  LPRINT.CML       LPRINT task startup command line 
   2.  LPRINT.COM       LPRINT task startup command file 
   3.  LPRINT.SAV       LPRINT task program 
   4.  LPDQRM.CFG       LPRINT configuration file 


19.  Remote Printer Utilities 
   1.  LPC.COM          LPC local start printer queue 
   2.  LPQ.COM          LPQ local printer queue status 
   3.  LPR.COM          LPR local print command 
   4.  LPRM.COM         LPRM local remove print job 
   5.  LPQRM.SAV        LPxx local printer control program 


20.  Remote Binary File Printing 
   1.  NTSND.COM        NTSND client startup command file 
   2.  NTSND.SAV        NTSND client program 


21.  Remote HTTP Web Server 
   1.  RHTTP.CML        RHTTP server startup command line 
   2.  RHTTP.COM        RHTTP server startup command file 
   3.  RHTTP.SAV        RHTTP server program 


22.  Remote Gopher Server 
   1.  RGOPH.CML        RGOPH server startup commnad line 
   2.  RGOPH.COM        RGOPH server startup command file 
   3.  RGOPH.SAV        RGOPH server program 
   4.  RGOPH.CFG        RGOPH server configuration list 


23.  Remote Authorization Server 
   1.  RAUTH.CML        RAUTH server startup command line 
   2.  RAUTH.COM        RAUTH server startup command file 
   3.  RAUTH.SAV        RAUTH server program 


24.  Port Monitor Program 
   1.  PMON.COM         PMON startup command file 
   2.  PMON.SAV         PMON program 


25.  Password and Authorization Files 
   1.  PASWRD.COM       Password startup command file 
   2.  PASWRD.SAV       Password program 
   3.  PASWRD.FIL       Password and authorization data file 


26.  Client/Server Monitor 
   1.  SKTMON.COM       Monitor startup command file 
   2.  SKTMON.SAV       Monitor program 


27.  Subdirectory Utilities 
   1.  LCD.COM          Change directory command file 
   2.  LDEL.COM         Delete file command file 
   3.  LDIR.COM         List directory command file 
   4.  LLS.COM          List directory command file 
   5.  LMKDIR.COM       Make directory command file 
   6.  LPRO.COM         Protect file command file 
   7.  LRENAM.COM       Rename file command file 
   8.  LRMDIR.COM       Delete Subdirectory command file 
   9.  LUNP.COM         Unprotect file command file 
  10.  UTIL.SAV         Utilities program 


28.  Subdirectory Summary Utility 
   1.  LDISKS.COM       Subdirectory summary command file 
   2.  RFTHLP.COM       Generate RFTP.HLP command file 
   3.  LDISKS.SAV       Subdirectory summary program file 


29.  Miscellaneous Files 
   1.  ABRTCP.SAV       Abort all Client/Server programs 
   2.  ABRTJB.COM       Abort Client/Server Job command file 
   3.  ABRTJB.SAV       Abort Client/Server Job program 
   4.  REMOVE.COM       Remove all Client/Server global regions 
   5.  DELAY2.SAV       Programmed 2 Second Delay 

=> Section Index

Installation in Detail

   Complete  the  hardware  installation  as  described  in  the
chapter titled Hardware Installation.  

   Under RT-11 the most convenient installation is:  

     1.  Create RTTCP.DSK[2400] as TCP:, 
         a logical disk for the TCP/IP files 

     2.  Create PASWRD.DSK[200] as PAS:, 
         a logical disk for the password files 

     3.  Optionally Create MAIL.DSK[nnn] as MAI:, 
         a logical disk for the MAIL directory 

     4.  Optionally Create HTTP.DSK[nnn] as HTP:, 
         a logical disk for the HTTP home directory 

     5.  Optionally Create GOPHER.DSK[nnn] as GPH:, 
         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 what-
              ever is needed.  



     6.  Copy  the  contents  of  the distribution disks RTDSK1,
         RTDSK2, and RTDSK3 to TCP:.  

     7.  Verify  that  your  RT-11 mapped system was sysgened to
         include timer support.  If not, then perform  a  system
         generation  or  rebuild the device handlers to your re-
         quirements.  

     8.  Copy and rename the appropriate device handler from the
         logical disk DVDSK1.DSK or DVDSK2.DSK to SY:.  (See the
         chapter  on  device  handlers  for  more information on
         selecting the appropriate device handler.) 

     9.  Edit  the  file  TCP:RTUCL.INS or TCP:RTUCLV.INS to in-
         clude the CCL commands you want and install these  com-
         mands.  

    10.  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:.  

    11.  Add  the  line '$@SY:TCPIP.RUN' to your startup command
         file.  

    12.  Copy PASWRD.SAV and PASWRD.FIL to PAS:.  

    13.  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.  

    14.  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.  

    15.  Edit  the files TCP:*.CML to contain the proper command
         line arguments for jobs started by SY:TCPIP.RUN.  

    16.  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 confi-
         guration file path is correct, file TCPIP.CFG  is  cor-
         rect,  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.  

    17.  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) 

    18.  Attempt to Telnet or FTP to a local computer using only
         the IP number of that computer.  (verifies  connections
         are possible) 

    19.  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) 

    20.  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) 

    21.  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) 


   Essentially your installation is now complete.  You only need
to update the password file to  specify  user/password  informa-
tion,  access rights, and default FTP and MAIL directories.  In-
dividual program configuration information is contained  in  the
chapter titled Program Options.  

=> Section Index

... Exit TCP/IP Documentation

... Home Page

Last Updated: June 2008