PMDF Installation Guide
OpenVMS Edition


Previous Contents Index

19.2 Step-by-Step Installation and Configuration Instructions on NT

The following discussion outlines the steps in the PMDF-XGS transport bridge component installation and configuration on NT (Intel). Refer to Chapter 20 for a sample installation and configuration dialogue.

  1. Insert the PMDF distribution CD-ROM into a drive accessible from the NT (Intel) transport bridge system.
  2. Create a directory where you want the code installed, and move to it as the current directory; for instance:


    C:\>md xgs
    C:\>cd xgs
    

  3. Copy the program files from the PMDF distribution CD-ROM to this directory; for instance:


    C:\xgs>copy CD-ROM-drive:\other\nt-intel\xgs\*.*
    
    where CD-ROM-drive is the drive for the CD-ROM reader.

  4. Execute the config.bat program by issuing the command:


    C:\xgs>config.bat
    

  5. The configuration procedure will then ask how many processes to use to communicate with the PMDF-MTA/PMDF-XGS system. One process is generally sufficient, though some sites might 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 want to use.

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

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

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

  9. The configuration procedure will next ask what is the maximum size of document that you want 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 want to allow. Unless you have particular reasons for limiting document size, there is usually no reason not to allow a very large size here.

  10. 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 []? 
    
    Enter the system to whose syslog daemon you want the PMDF-XGS transport bridge programs to write any logging output.

  11. 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 can 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 might want 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 want to configure:


    There can 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 might want 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 want to configure. Entering [RETURN] with no port number will terminate this dialogue.

  12. 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.bat 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.
  13. 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 21 and Chapter 22 for configuration instructions and a sample configuration dialogue.


Previous Next Contents Index