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