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


Previous | Contents


Chapter 10
PMDF Service Dispatcher Example Configuration

Example 10-1 shows configuring the PMDF Service Dispatcher to handle the multithreaded SMTP server, and an HTTP server for serving out PMDF documentation and forms. Example 10-2 shows the corresponding checklist file.

Whenever appropriate, each prompt also supplies a default answer which is enclosed within square brackets. Simply pressing return, RETURN, selects the default answer.

Remember that the values entered in this sample are for purposes of example only. Be sure to use the values appropriate for your system when you perform the actual configuration.

Example 10-1 Sample Dispatcher configuration


$ PMDF CONFIGURE DISPATCHER
 
PMDF Dispatcher Configuration File Creation Utility, V6.0 
 
  This utility creates an initial PMDF Dispatcher configuration file 
  PMDF_TABLE:DISPATCHER.CNF and configuration file for the PMDF HTTP server 
  PMDF_TABLE:HTTP.CNF 
 
  * NOTE * that you must have Digital's TCP/IP package or another 
  TCP/IP package which supports UCX emulation for the Dispatcher 
  to work. 
 
Do you wish to continue [Y]? y
Do you wish to have a detailed explanation printed before each question [N]? y
 
  Enter the port number on which the PMDF HTTP server should listen 
  for incoming connections. 
 
What port number do you want the PMDF HTTP server to use [7633]? RETURN
 
  Enter the name of the configuration file for the Dispatcher. 
 
PMDF Dispatcher configuration file name [PMDF_TABLE:DISPATCHER.CNF]? RETURN
 
  Enter the name of the configuration file for the HTTP server. 
 
PMDF HTTP server configuration file name [PMDF_TABLE:HTTP.CNF]? RETURN
 
  This procedure generates a checklist file that contains the list of 
  steps you must perform in order to complete your PMDF configuration. 
  This procedure does *NOT* perform these steps itself; you must do 
  them manually. 
 
PMDF checklist file name [PMDF_TABLE:DISPATCHER.CHECKLIST]? RETURN
 
  This question gives you a last chance to change your mind 
  before any files are written.  Answer NO if you are not sure 
  you want to generate the configuration you have specified.  Answer 
  YES if you do. 
 
Do you wish to generate the configuration files [Y]? y
Generating the file PMDF_TABLE:DISPATCHER.CNF 
 
Generating the file PMDF_TABLE:HTTP.CNF 
 
Generating the checklist file, PMDF_TABLE:dispatcher.checklist 
 
*********************************************************************** 
* 
*   To complete your PMDF configuration, carry out the steps 
*   detailed in the checklist file PMDF_TABLE:dispatcher.checklist. 
* 
*********************************************************************** 
 
 
 
 Enter Yes if you want to see the checklist now. You can still type 
 the file out later if you say No. 
 
Do you want to see the checklist now [Y]? n
 
 Enter YES if you would now like to configure the PMDF POP and/or 
 IMAP servers.  If you answer NO, then you may configure them later 
 with the command 
 
     $ PMDF CONFIGURE MAILBOX_SERVERS 
 
Configure the POP and IMAP servers [Y]? n
 

Example 10-2 Sample Dispatcher configuration checklist file


$ type pmdf_table:dispatcher.checklist
Checklist for completing the setup of your PMDF Service Dispatcher 
Written by SYSTEM, 23-Feb-2000 11:25:52 
This file was created by the PMDF configuration generator V6.0 
 
 
  (1) If you did not configure PMDF to use the multithreaded SMTP server 
      already, then you need to reconfigure it before the PMDF Service 
      Dispatcher is started. 
 
      Your TCP/IP and VMS must be of the minimum version described in 
      the PMDF System Manager's manual. 
 
  (2) You have to start a new Dispatcher or restart the currently running 
      Dispatcher for the new configuration to take effect. The following 
      command is to be issued on each node: 
 
               pmdf startup dispatcher 
      or 
               pmdf restart dispatcher 
 
  (3) The dispatcher needs to be started in your system startup 
      file with the command 
 
               pmdf startup dispatcher 
 
  (4) The Dispatcher configuration includes a definition for the 
      PMDF HTTP server.  The PMDF HTTP server may serve out PMDF 
      documentation, general PMDF operation monitoring information, 
      and statistics on the Dispatcher's own operation, and allows 
      for web-based access to PMDF popstore management, and user 
      mailbox filters. 
 
      All access to the PMDF HTTP server is disabled unless an 
      HTTP_ACCESS mapping table is in use; access may be generally or 
      selectively enabled via this mapping table. The PMDF-MTA 
      configuration utility generates an HTTP_ACCESS mapping table 
      allowing access to "internal" systems.  The PMDF-ACCESS 
      configuration utility generates no HTTP_ACCESS table, so access 
      will be denied to all by default. See the PMDF System Manager's 
      Guide for details on the use of that mapping table. Alternatively 
      or in addition, if there is a PMDF HTTP server capability that 
      you do not wish to utilize at all, you may prefer to remove that 
      entire section from the HTTP server configuration file, 
      PMDF_TABLE:HTTP.CNF.  See the PMDF System Manager's Guide for 
      details on the format of this file. 
 


Previous | Next | Contents