PMDF Installation Guide
OpenVMS Edition
PMDF-INST-VMS-6.0

The following discussion outlines the steps in the PMDF-XGS transport bridge component installation and configuration on OS/2. Refer to Chapter 24 for a sample installation and configuration dialogue.

• Insert the PMDF distribution CD-ROM into a drive accessible from the OS/2 transport bridge system.
  
• Execute the install.cmd program by issuing the command

  C: CD-ROM-drive:\other\os2\xgs\install.cmd
  

  where CD-ROM-drive is the drive for the CD-ROM reader.
  
• The installation procedure will then ask where you wish to install the PMDF-XGS transport bridge programs:

  Where do you want the code installed [C:\XGS]? 
  

  Enter the drive and directory where you would like to install the PMDF-XGS transport bridge programs. You may enter RETURN if you would like to install these programs in the default location, C:\XGS. The installation procedure will then install the programs in the location you specified, printing informational messages as it does so.
  
• After installing these programs, the installation procedure will then begin prompting for configuration options. Closely example the sample installation and configuration presented in Chapter 24 . The sample configuration dialogue should be analogous to your own network setup and required PMDF-XGS transport bridge configuration. When appropriate, the configuration questions will present default answers; you may enter RETURN to accept a default answer.
  
• The first configuration question is:

  The active components need to introduce themselves to the SNMP control process 
  on some TCP/IP port. 
  What port is to be used [9990]? 
  

  Enter the port number that the sendsrv and recvsrv programs should use to report SNMP information.
  
• The installation and configuration procedure will then ask:

  The control process needs an SNMP community name to register the 
  Gateway MIB. 
  What community name is going to be used [public]? 
  

  Enter the SNMP community name you wish to use.
  
• The next configuration question will ask how many processes to use to communicate with the PMDF-MTA/PMDF-XGS system. One process is generally sufficient, though some sites may choose to enable additional processes for performance reasons.

  One or more SNADS receive processes may be configured 
  How many receive processes should be run [1]? 
  

  Enter the number of processes you wish to use.
  
• The configuration procedure will next ask:

  The receive processes need to connect to the PMDF MTA 
  What is the TCP/IP hostname of the machine running PMDF? 
  

  Enter the TCP/IP name of the PMDF-MTA/PMDF-XGS system.
  
• The configuration procedure will then ask:

  What port is the SNADS receive process on the PMDF machine listening on 
  Port number [9993]? 
  

  Enter the TCP/IP port number on which the PMDF Service Dispatcher on the PMDF-MTA/PMDF-XGS system will be configured to listen for connections from the PMDF-XGS transport bridge.
  
• The configuration procedure will next ask:

  What is the SNADS name of the Gateway? 
  

  Enter the SNADS name which the SNADS nodes will be configured to use for the PMDF-XGS transport bridge. Note that any SNADS distributions sent to the PMDF-XGS transport bridge will be passed through to the PMDF-MTA/PMDF-XGS system itself. Thus although the transport bridge is often given its own SNADS name, it is actually possible to use the same SNADS name for the PMDF-XGS transport bridge as for the PMDF-MTA/PMDF-XGS system itself. (Using the same name means one less name that the SNADS nodes must be configured to know.)
  
• The configuration procedure will next ask what is the maximum size of document that you wish the PMDF-XGS transport bridge to accept for passing through:

  What is the maximum document size to be accepted by the Gateway [10000000]? 
  

  Enter the maximum document size you wish to allow. Unless you have particular reasons for limiting document size, there is usually no reason not to allow a very large size here.
  
• The PMDF-XGS transport bridge programs can write logging information to the syslog daemon on the system of your choice. The configuration procedure will ask which system that should be:

  What is the TCP/IP host name of the syslog host [localhost]? 
  

  Enter the system to whose syslog daemon you wish the PMDF-XGS transport bridge programs to write any logging output.
  
• The PMDF-XGS transport bridge programs can optionally save copies of the SNADS distributions (messages) that pass through it. The configuration procedure will ask to what directory to save such copies:

  What directory is to be used to store captured SNADS distributions [.\capture]? 
  

  Enter the name of the directory in which you wish to save copies of SNADS distributions.
  
• The PMDF-XGS transport bridge uses a separate SNADS send process for each SNADS node to which it connects directly, or in other words, to which it is directly adjacent. Note that any number of SNADS nodes may be connected by routing through a single SNADS node directly adjacent to the PMDF-XGS transport bridge. A decision to configure multiple SNADS nodes to be directly adjacent to the PMDF-XGS transport bridge is usually a matter of administrative convenience or performance. If you are configuring for the first time, you may wish to begin by configuring only one directly adjacent SNADS node. The configuration procedure will now ask how many SNADS send processes, each corresponding to a different directly adjacent SNADS node, you wish to configure:

  There may be several SNADS send processes.  Each listens on a separate port 
  and is typically used to send to a different SNADS node. 
  What port number should the first SNADS send process use [9994]? 
  

  Enter the port number that the first SNADS send process should use. The configuration procedure will then ask about any additional SNADS send processes you may wish to configure:

  What port number should the next SNADS send process use? 
  (press enter to end) 
  

  Enter another port number for each additional SNADS send process you wish to configure. Entering RETURN with no port number will terminate this dialogue.
  
• The PMDF-XGS transport bridge installation and configuration procedure will now complete with no further questions. Using your configuration answers, it creates a file xgs.cmd that you must execute to start up the PMDF-XGS transport bridge programs. This file should also be shadowed to the transport bridge system's "Startup" folder so that it will be autostarted.
  
• If you have not yet configured the SNADS nodes to know about the PMDF-XGS transport bridge and the PMDF-MTA/PMDF-XGS system, you must do so; see the PMDF System Manager's Guide for details. If you have not yet installed and configured PMDF-XGS on the PMDF-MTA system, you must do that also; see Chapter 1 for installation instructions and see Chapter 25 and Chapter 26 for configuration instructions and a sample configuration dialogue.

  ---

  Previous | Next | Contents