PMDF Installation Guide
Solaris Edition


Previous Next Contents Index


Chapter 9
PMDF-X400 Example Configuration

Example 9-1 configures a PMDF-X400 gateway at EXAMPLE.COM on node naples, and Example 9-2 shows a corresponding checklist file. This is the same sample site pictured in Figure 5-1 and configured in Chapter 5.

In this example, EXAMPLE has added an X.400 gateway to the fictional service provider GALACTIMAIL. Prior to configuring PMDF-X400, EXAMPLE has been assigned an X.400 address consisting of:
  Country: US
  Administrative Domain: GALACTIMAIL
  Private Domain: EXAMPLE Corp
  Organization: HQ
EXAMPLE and the management of the remote X.400 MTA have coordinated the use of MTA information and network addresses. They will be using X.400 1988 Normal transfer mode over RFC 1006 TCP/IP transport. The relevant parameters on which they've agreed are:
Parameter EXAMPLE's PMDF-X400 MTA GALACTIMAIL's MTA
Presentation Selector: "MTA" "BIG"
Session Selector: "MTA" "BUCKS"
Transport Selector: "PMDF-X400" "X400"
NSAP (TCP/IP) Address: 192.168.1.1 192.168.5.1
MTA Name: naples galactimail
MTA Password:   secret
Note that EXAMPLE is using an empty password string for their PMDF-X400 MTA which will be specified to PMDF-X400 using empty double-quotes. In this example, the other MTA name and password strings do not require quoting. The MTA name and password strings are case-sensitive and should be entered exactly as expected by both MTAs.

Remember that the values used 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.

Whenever appropriate, each prompt supplies a default answer which is enclosed within square brackets. Simply pressing return, [RETURN], selects the default answer. In this example configuration no answer has had to be specified to many of the prompts since the defaults are usually sufficient.

Example 9-1 Example PMDF-X400 configuration

# cd /pmdf/table
# pmdf configure x400
 
PMDF-X400 Configuration Utility, Version 6.6 
 
  This utility creates an initial pair of databases for mapping PMDF's 
  822-style addresses to X.400 addresses and back again. Only minimal 
  mappings are created; no attempt is made to create a complete domain 
  name to ORname mapping of the type specified in RFC1327. Note that 
  this is a limitation of this configuration procedure only; the 
  database is quite capable of supporting such a sophisticated mapping. 
 
  Important note: No changes are made to existing PMDF-X400's database 
  information until all questions have been answered. This utility 
  can be aborted at any prompt by entering a CTRL/C. The files 
  output by this utility may optionally be redirected to a different 
  location so they will have no impact on the existing PMDF-X400 
  databases. 
 
  You have a history file from a previous run of the configure utility. 
 
Do you want to use answers from the previous run as defaults [N]? N
Do you wish to continue [Y]? YES
Do you wish to have a detailed explanation printed before each question [Y]? Y
 
  Enter the most widely used domain name that corresponds to your 
  local host. Normally this is the official channel host name 
  associated with PMDF's local channel. 
 
Official local host name [naples.example.com]? naples.example.com
 
  A standard domain-style host name is used to refer to the gateway 
  from the Internet/822 side. X.400 addresses then appear relative 
  to this gateway on the Internet/822 side. For example, if you choose 
  a domain name like X400.EXAMPLE.COM for the gateway, an address of 
  the form /C=US/ADMD=MCI/PRMD=DEC/S=Doe/@X400.EXAMPLE.COM might be 
  used from the Internet/822 side to send messages to an X.400 user. 
  The choice of the X400.domain format is a common one. Be 
  sure that the name you choose is within a domain or subdomain that 
  you have administrative authority over. Also be sure to choose a name 
  that is NOT currently in use. 
 
Domain name for the X.400 gateway [x400.naples.example.com]? 
x400.naples.example.com
 
  Enter the ORname components that serve to identify messages to be 
  processed by this MTA. User-specific fields should not be specified. 
 
ORname stem for the local PMDF MTA 
    Enter a ISO3166 two character alphabetic country code. 
  Country [US]? US
    Optionally enter an Administration Domain Name (ADMD). 
  Administration Domain []? GALACTIMAIL
    Optionally enter a Private Domain Name (PRMD). 
  Private Domain []? EXAMPLE Corp
    Optionally enter an Organization name (O). 
  Organization []? HQ
    Optionally enter 1-4 Organization Unit names (OU). You will be 
    prompted for each one separately; press RETURN when there are no 
    more Organizational Units to specify. 
  Organizational Unit []? [RETURN]
 
  Enter the Presentation Address that PMDF-X400 should use 
  to receive incoming X.400 RTS network connections.  You should 
  supply a Presentation Selector, PSEL, Session Selector, SSEL, 
  and Transport Selector, TSEL. 
 
  Do not enter your Network Service Access Point, or NSAP, address 
  as that will be determined automatically. 
 
  Transport level connection requests to the TSEL you provide 
  here will be directed to PMDF-X400.  In addition, you 
  will need to provide remote MTAs with these selectors as well as 
  your Network Server Access Point, or NSAP, before they will be 
  able to initiate connections to PMDF-X400. 
 
Hit RETURN for more: [RETURN]
 
  Supported Selector formats are: 
 
      Type           Syntax                        Example 
      ------------   ---------------------------   ----------- 
      string         "<printable-string>"          "PMDF-X400" 
      numeric        #<decimal-number>             #591 
      octet-stream   '<hexadecimal-byte-string'H   '353931'H 
 
  You must enter all three selectors, and you must separate them 
  with / characters, in the order: 
 
      PSEL / SSEL / TSEL 
 
  For example:         "MTA"/"MTA"/"PMDF-X400" 
 
Presentation Address for PMDF-X400 ["MTA"/"MTA"/"PMDF-X400"]? [RETURN]
 
  You will now be asked to provide the information required to set up 
  connections to a single remote MTA. This configuration procedure 
  currently only generates configurations that connect to a single 
  remote MTA. Configurations that connect to multiple MTAs are 
  supported but must be built manually. 
 
MTA connection information... 
 
    Enter the X.400 Transfer Mode to be used with this MTA.  Valid 
    responses are 1988-NORMAL, 1988-X410, and 1984.  If 1984 is chosen, 
    messages will be downgraded to 1984 X.400 and 1984 Reliable 
    Transfer Service will be used.  If 1988-X410 is chosen, messages 
    will comply with 1988 X.400, but 1984 RTS will be used.  If 
    1988-NORMAL is chosen, messages will comply with 1988 X.400 
    and 1988 RTSE. 
 
  Transfer mode for this MTA [1988-NORMAL]? [RETURN]
 
    Enter the Presentation Address that's used to identify the local 
    system when connecting to the remote MTA.  You should use the 
    default provided unless the remote MTA specifically requires some 
    other address.  Do not enter the Network Service Access Point, or 
    NSAP, address at this point, enter only the selector portion of 
    the address. 
 
    Note that if 1984 or 1988-X410 transfer mode has been chosen, 
    only the Transport Selector, TSEL, is used here. 
 
  Local MTA address ["MTA"/"MTA"/"PMDF-X400"]? [RETURN]
 
    Enter the MTA name that your system should use to identify itself 
    when connecting to the remote MTA. This string is transferred 
    as part of connection setup. 
 
  Local MTA name []? naples
 
    Enter the password that your system should use to identify itself 
    when connecting to the remote MTA. This string is transferred 
    as part of connection setup. 
 
  Local MTA password []? ""
 
    Enter the complete Presentation Address associated with the remote 
    MTA.  PMDF-X400 will connect to this address when transferring 
    messages to the remote MTA. 
 
    If using 1984 or 1988-X410 transfer modes, then you must enter only 
    a single Transport Selector, or TSEL.  If using 1988-NORMAL mode 
    you must enter all three selectors, and you must separate them with 
    / characters.  Finally, you must also include the Network Service 
    Access Point, or NSAP for the remote MTA.  Separate the NSAP from 
    the selectors using a / character, in the order: 
 
        PSEL / SSEL / TSEL / NSAP 
 
    Some examples: 
 
    1984 RFC-1006 (TCP): "X400"/Internet=111.222.3.4 
    1984 CONS (X.25)   : "X400"/NSAP=49004008002B1D161521 
    1984 CLNS          : "X400"/NSAP=49004008002B1D161521 
 
    1988 RFC-1006 (TCP): "MTA"/"MTA"/"X400"/Internet=111.222.3.4 
    1988 CONS (X.25)   : "MTA"/"MTA"/"X400"/NSAP=49004008002B1D161521 
    1988 CLNS          : "MTA"/"MTA"/"X400"/NSAP=49004008002B1D161521 
 
  Remote MTA address []? "BIG"/"BUCKS"/"X400"/Internet=142.168.5.1
 
    Enter the MTA name that you expect the remote MTA to return. This 
    string is transferred as part of connection setup. 
 
  Remote MTA name []? galactimail
 
    Enter the password that you expect the remote MTA to return. This 
    string is transferred as part of connection setup. 
 
  Remote MTA password []? secret
 
  The PMDF address of the local PostMaster is used when blank addresses 
  (which are allowed in RFC822 but not in X.400) are encountered that 
  must be converted into X.400 addresses. Please enter a full domain 
  address for the local PostMaster. Do not use shortform host names 
  since there is no guarantee that the address will be interpreted 
  in the context where the shortform name is valid. 
 
RFC822 address of local PostMaster []? postmaster@naples.example.com
 
  Enter the name of the file to which the text form of the PMDF to X.400 
  mapping should be written. This file will be created automatically 
  by this configuration procedure. Any old versions of the file will be 
  superseded. 
 
PMDF to X.400 mapping text file [/pmdf/table/to_x400.txt]? [RETURN]
 
  Enter the name of the file to which the text form of the X.400 to PMDF 
  mapping should be written. This file will be created automatically by 
  this configuration procedure. Any old versions of the file will be 
  superseded. 
 
X.400 to PMDF mapping text file [/pmdf/table/from_x400.txt]? [RETURN]
 
  This procedure generates an options file that contains X.400 
  connection information, addresses, MTA names, and passwords. This 
  file is read by the gateway as it initializes and provides the 
  information needed to establish connections to a remote X.400 MTA. 
  WARNING: This file contains password information and should be 
  protected against world read access! 
 
Gateway options file [/pmdf/table/x400_local_option]? [RETURN]
 
  Enter the name of the file to contain the database form of the PMDF to 
  X.400 mapping. This file will be created automatically by this 
  configuration procedure. Any old versions of the file will be 
  superseded. This file name must agree with the TO_X400_DATABASE 
  channel option or with the PMDF_TO_X400_DATABASE 
  tailor file option for it to be actually used by the gateway. 
 
PMDF to X.400 mapping database [/pmdf/table/to_x400]? [RETURN]
 
  Enter the name of the file to contain the database form of the X.400 to 
  PMDF mapping. This file will be created automatically by this 
  configuration procedure. Any old versions of the file will be 
  superseded. This file name must agree with the FROM_X400_DATABASE 
  channel option or with the PMDF_FROM_X400_DATABASE 
  tailor file option for it to be actually used by the gateway. 
 
X.400 to PMDF mapping database [/pmdf/table/from_x400]? [RETURN]
 
  Enter the name of the file to contain the PMDF configuration rewrite 
  rules created by this procedure.  This file should subsequently be 
  included in your PMDF configuration file. 
 
Rewrite rules text file [/pmdf/table/x400.rules]? [RETURN]
 
  Enter the name of the file to contain the channel block definition for 
  the PMDF-X400 channels.  This file will be created automatically 
  by this configuration procedure.  Any old versions of the file will be 
  superseded. 
 
Channel definitions text file [/pmdf/table/x400.chans]? [RETURN]
 
  PMDF-X400 requires the presence of an isoentities file. 
  This procedure will create the appropriate file. 
 
PMDF-X400 ISOENTITIES file name [/pmdf/table/isoentities]? [RETURN]
 
  PMDF-X400 requires the presence of an isomacros file. 
  This procedure will create the appropriate file. 
 
PMDF-X400 ISOMACROS file name [/pmdf/table/isomacros]? [RETURN]
 
  PMDF-X400 requires the presence of an isotailor file. 
  This procedure will create the appropriate file. 
 
PMDF-X400 ISOTAILOR file name [/pmdf/table/isotailor]? [RETURN]
 
  PMDF-X400 requires the presence of an ISOSERVICES file. 
  This procedure will create the appropriate file. 
 
PMDF-X400 ISOSERVICES file name [/pmdf/table/isoservices]? 
 
  This procedure generates a checklist file that contains the list 
  of actions you must perform in order to make the PMDF-X400 gateway 
  operational. This procedure does *NOT* perform these operations 
  itself; you must do them manually. 
 
PMDF-X400 checklist file name [/pmdf/table/x400.checklist]? [RETURN]
 
All configuration questions have been answered. 
 
 
  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]? YES
 
Generating PMDF to X.400 mapping text file... 
PMDF to X400 mapping text file is complete. 
 
Generating X400 to PMDF mapping text file... 
X.400 to PMDF mapping text file is complete. 
 
Generating the rewrite rules file... 
Rewrite rules file is complete. 
 
Generating the channel definitions file... 
Channel definitions file is complete. 
 
Generating the isoentities file... 
isoentities file is complete. 
 
Generating the isomacros file... 
isomacros file is complete. 
 
Generating the isotailor file... 
isotailor file is complete. 
 
Generating the isoservices file... 
isoservices file is complete. 
 
Generating the setup checklist... 
Checklist file is complete. 
 
Converting the PMDF to X.400 mapping text file to a database... 
Entries converted: 21 
Entries too long to fit: 0 
PMDF to X.400 mapping conversion is complete. 
 
Converting the X.400 to PMDF mapping text file to a database... 
Entries converted: 108 
Entries too long to fit: 0 
X.400 to PMDF mapping conversion is complete. 
 
Generating options file... 
Options file is complete. 
 
*********************************************************************** 
* 
*   To complete your PMDF-X400 configuration, carry out the steps 
*   detailed in the setup checklist  /pmdf/table/x400.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
# 

Example 9-2 Example checklist file for PMDF-X400 configuration

# cat x400.checklist
 
  Checklist for setting up your PMDF-X400 gateway. 
  Written by root, Oct 17 17:56:52 EST 2012 
  This file was created by the PMDF-X400 configuration generator V6.6 
 
  (1) The rewrite rules for PMDF-X400 have been written out 
      to a file. You can simply include this file in your 
      configuration by adding the line 
 
          </pmdf/table/x400.rules 
 
      to the rewrite rules section of your pmdf.cnf file; it should be 
      be added before any general TCP/IP rewrite rules (e.g., .COM, 
      .EDU, etc.). 
 
      Note: You may find the lines 
 
          ! 
          ! Rewrite rules for PMDF-X400 
          ! 
          !</pmdf/table/x400.rules 
 
      around the middle of your PMDF.CNF file.  In this case, merely 
      uncomment the line "!</pmdf/table/x400.rules" and, if 
      necessary, change the file name so that it reads 
 
          ! 
          ! Rewrite rules for PMDF-X400 
          ! 
          </pmdf/table/x400.rules 
 
  (2) The channel definitions for PMDF-X400 have been written out 
      to a file. You can simply include this file in your 
      configuration by adding the line 
 
          </pmdf/table/x400.chans 
 
      to the very end of your PMDF.CNF file; it should be preceded by 
      a single blank line. 
 
      Note: You may find the lines 
 
          ! 
          ! PMDF-X400 channels 
          ! 
          !</pmdf/table/x400.chans 
 
      towards the end of your PMDF.CNF file.  In this case, merely 
      uncomment the "!</pmdf/table/x400.chans" line and, if 
      necessary, change the file name so that it reads 
 
          ! 
          ! PMDF-X400 channels 
          ! 
          </pmdf/table/x400.chans 
 
  (3) You can start PMDF-X400 listening for incoming connections 
      now with the command: 
 
          # pmdf startup x400 
 
      Upon system startup, the standard PMDF startup procedures will 
      take care of starting up PMDF-X400. 
 
  (4) PMDF-X400 is capable of converting between various types of X.400 
      body parts (attachments) and MIME attachment types.  You should 
      consider enabling such attachment handling.  Sample mappings may 
      be found in the file /pmdf/table/x400_mappings.sample.  To 
      enable these mappings, paste the contents of the sample file into 
      the /pmdf/table/mappings file. 
 
  That's all! 
# 


Previous Next Contents Index