1.   Installing KEYpak

This chapter lists the installation requirements and provides step-by-step instructions to install KEYpak as a stand-alone application in the UNIX environment. 

For installing KEYpak in the OpenMail or LMS environment, refer to chapter 2 and 3, respectively.

Installation Requirements

Software

•       KEYpak installation tape

•       UNIX operating system

Disk Space

•       To install the full KEYpak conversion library, you will require 20MB of disk space.

                        Note                After installing KEYpak, if you do not require all the conversion formats, you may remove these formats to free up some disk space.  See “Removing KEYpak Conversion Formats” at the end of this chapter.

Time

•       Installation of KEYpak will take approximately half an hour for the UNIX system.

Installation Procedure

Use the following steps to install KEYpak in the UNIX environment:

1.         Log into the UNIX system as a root.

2.         Create a temporary directory such as /temp:

Type       mkdir /temp
Press      <RETURN>  or  <ENTER>

3.         Now change to your newly created directory:

Type       cd /temp
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.         When all the files have been copied, remove the tape from the tape drive. 

7.         You will now install KEYpak software onto your system by using the INSTALL script:

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

8.         The install program will prompt you to enter the directory name for the executable modules:

Executable directory [/usr/bin]:

9.         Enter the directory name of your choice:

Type       <executable-directory>
Press      <RETURN> or <ENTER>.

Otherwise, to install the executable modules in the default directory
/usr/bin:

Press      <RETURN> or <ENTER>

10.       You will now be prompted to enter the directory name for the non-executable files (i.e. *.doc, etc.):

Library directory [/usr/lib/kw]:

11.       Enter the directory name of your choice:

Type       <library-directory>
Press      <RETURN> or <ENTER>.

Otherwise, to install the non-executable files in the default directory
/usr/lib/kw:

Press      <RETURN> or <ENTER>

12.       You will now be prompted to enter the directory name for the sample files:

Sample files directory [./sample]:

13.       Enter the directory name of your choice:

Type       <sample-files-directory>
Press      <RETURN> or <ENTER>.

Otherwise, to install the sample files in the default directory
./sample:

Press      <RETURN> or <ENTER>

                        Note                    It is not necessary to create the <executable-directory>, <library‑directory> or <sample-files-directory> first.  The install program will create them automatically.

14.       The system will copy all KEYpak files into their appropriate directories.

When this procedure is completed, the system will display the following prompt:

KEYpak installation complete.

15.       Delete the temporary directory created in step 2.

Post-installation Procedure

Modifying/Setting Environment Variable PATH

•       Before running KEYpak, modify the environment variable PATH to locate the directories in which KEYpak is installed.  For example, under the Bourne shell, path for default directories can be set as:

PATH=:/usr/bin:/usr/lib/kw
export PATH

•       To see instructions for setting PATH under other shells, type the command man sh.

•       If there are other PATH definitions, specify the KEYpak path definition at the beginning.

Setting Environment Variable KW

After installing KEYpak, you may also want to set the environment variable KW to locate KEYpak and related files.  To set the environment variable KW under the Bourne shell, use the following command:

KW=/usr/lib/kw; export KW

where, /usr/lib/kw is the installation directory for KEYpak.

KEYpak is now ready to run by using the KEYpak command line.  See chapter 5 for detailed instructions on using KEYpak through the command line.

                      Notes        •       KEYpak searches for the data files, message files, and/or executable modules in the following order:

1.     Same directory as the executable kw (if available on the platform)

2.     Directory for the environment variable KW

3.     Directories for the environment variable PATH

4.     Current directory

                                        •       KEYpak searches for the configuration files in the following order:

1.     Current directory

2.     On one of the search paths

3.     For the environmental variable KW

Installing Terminfo Database Description for WYSE-50 Terminal

When you install KEYpak, a menu-driven KEYpak User Interface will also be installed on your system.  However, to use this user interface on a WYSE-50 terminal, you must install the terminfo database description for the WYSE-50 terminal. 

The terminfo database description is contained in the file named wyse.inf.  This file will be loaded at the time of installation in the library directory. 

Use the following steps to install the terminfo database description:

                        Note                The following procedure applies only to the systems based on AT&T UNIX System V.

1.         Make a backup copy of the current wyse-50 terminfo entry:

Type           infocmp wyse50 > wyse.bak
Press          <RETURN>

            The back up procedure will do the following:

•       Read the attributes and capabilities for a WYSE-50 terminal from the database stored under /usr/lib/terminfo.

•       Arrange this information in the form of a terminfo terminal description.

•       Store this information in the file wyse.bak.

2.         Change your current working directory to the KEYpak directory.

3.         Invoke the terminal information compile (tic) command as follows.

Type           tic -v wyse.inf
Press          <RETURN>

            The command tic will update the terminfo entry/entries for the WYSE-50 terminal as stored under /usr/lib/terminfo/w.

                        Note                If it is necessary to restore the old WYSE-50 terminfo entry, repeat step 3 using wyse.bak.

KEYpak Files

When you install KEYpak, a number of files will be loaded on your system.  For a complete listing and description of these files, see Appendix B. 

For each conversion format, the following files may exist:

 

Source Executable                                        xxsrckw.exe

Target Executable                                        xxtrgkw.exe

Sample Document                                        sample.xx

Target Character set                                    xx*.cfg

Source Reference Documentation             xxsrc.doc

Target Reference Documentation             xxtrg.doc

 

 

xx is the 2 or 3 character identifying mnemonic.  See Appendix A for a list of KEYpak supported conversion formats and their mnemonics.

Removing KEYpak Conversion Formats

Each conversion format uses 1/2 to 3/4 MB of space on your system.  If you do not require all the conversion formats, they may be removed from your system to free up some disk space.  To remove these formats, you should delete all associated files as listed above. 

For example, if you want to remove the WordPerfect for Mac source conversion, you will delete the following files:

 

•       whsrckw.exe

•       sample.wpm

•       wpmsrc.doc

 

In this example, wpm is the KEYpak mnemonic and wh is the executable prefix for WordPerfect for Mac.  See Appendix A for a list of all KEYpak mnemonics and executable prefix exceptions.