downloading the Linux stk tools

This document describes how to install and configure the Linux STK tools. In order to use the file scanning tools, the tools package must be installed on an HP-UX system. The file scanners cannot be executed directly from a CD-ROM. This document contains:

	installing the Linux stk tools
	configuring the Linux stk tools

installing the Linux stk tools

To install the Linux STK tools on a client system:

1. Choose the correct tools package for the architecture of the machine you are installing to.
   • Download the HP-UX 11.00 Linux STK tools package to the file /tmp/STK11tools.bin
   • Download the HP-UX 11i Linux STK tools package to the file /tmp/STKL1111tools.bin
   • Download the Redhat 6.2 Linux STK tools package to the file /tmp/STKL6.2.tools.tar.gz

2. For the HP-UX 11.0 and HP-UX 11i versions:
   As superuser, install the package you just downloaded (either /tmp/STKL11tools.bin or /tmp/STKL1111tools.bin). For example:

   /usr/sbin/swinstall -s /tmp/STKL11tools.bin \
      STKL.STKL-TOOLS

   For the Redhat 6.2 Linux version:
   As superuser, cd to / and uncompress and untar the package (STKL6.2.tools.tar.gz). For example:

   cd /
   zcat /tmp/STKL6.2.tools.tar.gz | tar vxf -
   

   The Linux STK files will be placed in /opt/STKL, and one configuration file placed in /etc/opt/STKL/config.

	Note: Although the HP-UX packages are in tar format, you must use swinstall to install a package correctly.

configuring the Linux stk tools

client system configuration

On each system where you installed the tools, configure the location and language for the STK documentation, the location for the cgi-bin directories, and the editor. You must be superuser.

The file /etc/opt/STKL/config/client should contain the lines:

STK_HOME=http://server/STKL
STK_LANG=language
STK_CGI_BIN=http://server/cgi-bin/STKL
STK_EDITOR=editor

If STK_LANG is not set, the default is English. To set the language variable for Japanese, type STK_LANG=ja_JP.SJIS or STK_LANG=ja_JP.eucJP. But note that the Linux STK is only distributed in English language at present.

editor can be vi, emacs, xemacs, or softedit. The chosen editor becomes the default editor that is integrated with the output of the lxscandetail file scanner for easy source file modification. This editor is started when you choose a source file name link in the HTML impact report produced by lxscandetail. The editor starts and is positioned at the line number where the impact occurs (provided you are using a Web server).

If you do not have a Web server, you will not be able to automatically start an editor from the scanning tool impact report.

user configuration

For each user of the STK:

1. On HP-UX, SD appends /opt/STKL/bin to the system PATH environment variable during installation. If the user overrides the system PATH rather than appending to it, you should add /opt/STKL/bin to the user's PATH. For example, in the POSIX shell (sh):

     PATH=$PATH:/opt/STKL/bin
     export PATH
   

   If you are using Linux, you must add /opt/STKL/bin to your PATH as in the above example.

2. On HP-UX, SD appends /opt/STKL/share/man to the system MANPATH environment variable during installation. If the user overrides the system MANPATH rather than appending to it, you should add /opt/STKL/share/man to the user's MANPATH. For example, in the POSIX shell (sh):

     MANPATH=$MANPATH:/opt/STKL/share/man
     export MANPATH
   

   If you are using Linux, you must add /opt/STKL/share/man to your MANPATH as in the above example.

3. Add stkedit as a type in your Web browser.

   For example, in Netscape 3.0, you would do the following:

   1. In the Options menu, choose General Preferences.
   2. Choose Helpers, then New...
   3. Fill out the form with this information:

      Description: STK Editor
      Type: application/stkedit
      Handle By: Application
      /opt/STKL/bin/stkedit %s

   4. Choose OK.
   5. Choose OK again, then save the options.

   In Netscape 4.x, you would do the following:

   1. In the Edit menu, choose Preferences.
   2. Select Navigator, then Applications.
   3. Click "New", then fill out the form with this information:

      Description: STK Editor
      MIMEType: application/stkedit
      Suffixes: 
      Handled By: Application
         /opt/STKL/bin/stkedit %s
      

   4. Choose OK.
   5. Choose OK again, then save the options.
4. To override the configured defaults for a particular user, you can set any of the STK environment variables (either on the command line or in the appropriate HP-UX configuration file). For example, if STK_EDITOR has been set to vi but a particular user prefers emacs, that user can override the default by typing:

   export STK_EDITOR=emacs

   Any environment variable changes take effect the next time the file scanners are run.