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