3.   Installing KEYpak for LMS

LMS (Lotus Messaging Switch) is a multi-protocol system that allows you to interconnect different types of mail systems.  By integrating KEYpak into LMS, mail messages can be delivered to recipients in a format of their choice. 

                      Notes               LMS is the new name for EMX.  Therefore, EMX in the installation procedure refers to LMS.

 

                                               LMS does not support external image/graphics data files.  Therefore, some image/graphics data may be lost in the delivered document.

This chapter lists the installation requirements and provides step-by-step instructions to install KEYpak for LMS.

3a. Installing KEYpak for LMS
      (DG AViiON systems)

Installation Requirements

Software

       KEYpak installation tape

       LMS system 2000 or higher

       LMS version 1.2 or higher

Access Rights

       Your access rights must be set up as:

chown      emxadmin
chgrp       general

Disk Space

       To install KEYpak for LMS, you will require 15MB of disk space.  You will also need additional 15MB of space in a temporary directory.

Installation Procedure

                        Note        Before installing KEYpak for LMS, make sure that the directory
/usr/opt/ooti exists on your system.

Use the following steps to install KEYpak for LMS.  These steps provide the instructions and explanation for the installation process.

1.         Shut down LMS and log into your system as emxadmin.

2.         Create a temporary directory such as tmp:

Type       mkdir tmp
Press      <RETURN>  or <ENTER>

3.         Now change to your newly created temporary directory:

Type       cd tmp
Press      <RETURN>  or  <ENTER>

4.         Insert the KEYpak installation tape into the tape drive.

5.         To load KEYpak files from the KEYpak installation tape:

Type       tar -xv
Press      <RETURN>  or <ENTER>

6.         To install KEYpak for LMS, run the installation script EMXI. 

Type       ./EMXI
Press      <RETURN>  or <ENTER>

7.         The KEYpak for LMS and sample files will be installed in the directories /usr/opt/ooti/kw and /usr/opt/ooti/kw/sample, respectively.  The sample files may be deleted if space is at a premium.

KEYpak for EMX executable directory [/usr/opt/ooti/kw]
KEYpak for EMX temporary directory [/usr/opt/ooti/kw/tmp]
Sample files directory [/usr/opt/ooti/kw/sample]
Installing auto detect executables
Installing conversion executables
Installing sample files
Installing configuration files

8.         The installation will ask whether you want to use the auto-detect function for determining the format of the source document. 

KEYpak has the ability to AutoDetect document type.
This allows improperly tagged documents to be converted.
Do you want to use AutoDetect y/n [y] 

9.         If yes (y) is selected for the previous question, KEYpak will use the auto-detect function to determine the document type of the source document and display similar to the following: 

If the document type supplied by EMX and the document type determined
by KEYpak Auto-Detect don't agree, you have the option of invoking the
OOTI return code 6 procedure. 
This will type the document as PCDATA (with no conversion).

Note:  The EMX release must be at least 3.1P4.

Do you want to use OOTI return code 6 y/n [y]

10.       If you use the KEYpak auto-detect function and you have LMS version 3.1P4 or later, you should enter yes (y) for the above question.  The "OOTI return code 6" option will improve attachment handling by gateways.

11.       The installation program will run the KECMP program to modify the MANIFEST.FIL configuration file.  The system will display similar to the following:

KEYpak EMX Configuration Modification Program
            $ Revision:
            $ Date:
            KECMP

MANIFEST.FIL directory is /usr/opt/ooti/kw
KEYpak executable directory is /usr/opt/ooti/kw

Looking for KEYpak source conversions
...

Looking for KEYpak target conversions
...

KECMP done.

12.       The installation program will copy the MANIFEST.FIL file to the emxadmin’s .cshrc directory and set the SSW_OLC_BIN_DIR environment variable.

Setting environment variable in /accounts/emxadmin/.cshrc

Cleaning up

KEYpak for EMX installation complete.

                        Note        The reference documentation files are included on the KEYpak installation tape, but they will not be installed.  To extract these files in a temporary directory, use steps 1 to 5 of the Installation Procedure.

KEYpak is now ready to be used with LMS.  For detailed information on using LMS, refer to the LMS User’s Guide.

 

3a. Installing KEYpak for LMS (RS6000 AIX)

Installation Requirements

Software

       KEYpak installation tape

       LMS system 2000 or higher

       LMS version 1.2 or higher

Access Rights

       Your access rights must be set up as:

chown      lms
chgrp       dba

Disk Space

       To install KEYpak for LMS, you will require 15MB of disk space.  You will also need additional 15MB of space in a temporary directory.

Installation Procedure

                        Note        Before installing KEYpak for LMS, make sure that the directory
/usr/opt exists on your system.

Use the following steps to install KEYpak for LMS.  These steps provide the instructions and explanation for the installation process.

1.         Shut down LMS and log into your system as lms

2.         Create a temporary directory such as tmp:

Type       mkdir tmp
Press      <RETURN>  or <ENTER>

3.         Now change to your newly created temporary directory:

Type       cd tmp
Press      <RETURN>  or  <ENTER>

4.         Insert the KEYpak installation tape into the tape drive.

5.         To load KEYpak files from the KEYpak installation tape:

Type       tar -xv
Press      <RETURN>  or <ENTER>

6.         To install KEYpak for LMS, run the installation script LMSI. 

Type       ./LMSI
Press      <RETURN>  or <ENTER>

7.         The KEYpak for LMS and sample files will be installed in the directories /usr/opt and /usr/opt/sample, respectively.  The sample files may be deleted if space is at a premium.

KEYpak for EMX executable directory [/usr/opt]
KEYpak for EMX temporary directory [/usr/opt/mp]
Sample files directory [/usr/opt/sample]
Installing auto detect executables
Installing conversion executables
Installing sample files
Installing configuration files

8.         The installation will ask whether you want to use the auto-detect function for determining the format of the source document. 

KEYpak has the ability to AutoDetect document type.
This allows improperly tagged documents to be converted.
Do you want to use AutoDetect y/n [y] 

9.         If yes (y) is selected for the previous question, KEYpak will use the auto-detect function to determine the document type of the source document and display similar to the following: 

If the document type supplied by  LMS and the document type determined
by KEYpak Auto-Detect don't agree, you have the option of invoking the
OOTI return code 6 procedure. 
This will type the document as PCDATA (with no conversion).

Note:  The  LMS release must be at least 3.1P4.

Do you want to use OOTI return code 6 y/n [y]

10.       If you use the KEYpak auto-detect function and you have LMS version 3.1P4 or later, you should enter yes (y) for the above question.  The "OOTI return code 6" option will improve attachment handling by gateways.

11.       The installation program will run the KECMP program to modify the MANIFEST.FIL configuration file.  The system will display similar to the following:

KEYpak EMX Configuration Modification Program
            $ Revision:
            $ Date:
            KECMP

MANIFEST.FIL directory is /usr/opt/ooti/kw
KEYpak executable directory is /usr/opt/ooti/kw

Looking for KEYpak source conversions
...

Looking for KEYpak target conversions
...

KECMP done.

12.       The installation program will copy the MANIFEST.FIL file to the emxadmin’s .cshrc directory and set the SSW_OLC_BIN_DIR environment variable.

Setting environment variable in /accounts/emxadmin/.cshrc

Cleaning up

KEYpak for LMS installation complete.

                        Note        The reference documentation files are included on the KEYpak installation tape, but they will not be installed.  To extract these files in a temporary directory, use steps 1 to 5 of the Installation Procedure.

KEYpak is now ready to be used with LMS.  For detailed information on using LMS, refer to the LMS User’s Guide.