Installing and Configuring the STK
 |
| |
| This page contains: |
Overview
 |
| |
| This document shows you how to configure the
HP-UX Software Transition Kit on HP-UX. |
| |
Installing the STK
 |
| |
| To download and install the latest STK, see the download and installation instructions on HP DSPP Home.
|
| |
Full versus tools-only installation
The Software Transition Kit can either be installed in its
entirety (recommended) or you can choose to install only the
tools component. If you choose to install only the tools,
then complete functionality will depend on your Web browser
having Internet access to devresource.hp.com. If you cannot
or choose not to depend on Internet access to devresource.hp.com
then you must install the full package which will require a local
Web server to serve documents and run CGI programs. The
Apache Web
Server is recommended.
If you choose to install only the STK tools component it is
possible that incompatibilities may arise in the future when the
STK or a component of the STK on devresource.hp.com is
updated.
Configuring the STK
 |
| |
| After the installation is complete, you may need to
configure the HP-UX STK. |
| |
User (client) configuration
You may want to add /opt/STK/bin to your PATH,
and /opt/STK/share/man to your MANPATH.
If you chose to install the full STK package, then the
/etc/opt/STK/config/client file should have been
configured to use your local Web server. In this case,
verify these definitions (substituting your system's full host
name for "hostname"):
STK_HOME=http://hostname/STK
STK_CGI_BIN=http://hostname/STK/cgi-bin/
If you chose to install the STK tools only, then the
/etc/opt/STK/config/client file should have been
configured to use the devresource.hp.com Web server. In
this case, verify these definitions:
STK_HOME=http://devresource.hp.com/STK
STK_CGI_BIN=http://devresource.hp.com/STK/cgi-bin/
To use the links in the scandetail reports that
bring up the source code files in your editor at the line in
question, you need to configure your Web browser to understand
the MIME type application/stkedit.
Before you open the 'file:' URL to view a
scandetail report you need to have added the MIME
type to your browser. For Netscape Navigator:
- Navigate the menus to
Edit/Preferences/Navigator/Applications.
- Choose the "New.." button
- specify the MIMEType of
application/stkedit,
- click the "Application" button and specify
"/opt/STK/bin/stkedit %s".
To pick which editor you want to use, define the STK_EDITOR
environment variable before you run scandetail. Legal
values are emacs, xemacs,
gvim, or vi. vi is the
default.
If the editor is vi, it will be run in a terminal
emulator. If you are using CDE, the default terminal emulator
will be dtterm, otherwise it will be
xterm. To specify a specific terminal emulator,
define the STK_TERM environment variable to the full path to the
desired terminal emulator. This environment variable must be
defined prior to starting your web browser.
Web server configuration
If you chose to install the full package, the installation
will configure an installed Apache Web Server as required, but
configuration of any other Web server (e.g., Netscape/iPlanet) is
left to the user. These Apache Web Server installations can
be automatically configured by the STK installation
procedures:
On HP-UX, the HP Apache Web Server, as installed in
/opt/apache/ or /opt/hpws/apache/,
will be configured for use with the STK by the installation.
If found, the the STK installation procedures will append
these lines to the end of the Apache configuration file
/opt/apache/conf/httpd.conf or
/opt/hpws/apache/conf/httpd.conf:
ScriptAlias /STK/cgi-bin/ /opt/STK/cgi-bin/
<Directory /opt/STK/cgi-bin>
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>
Alias /STK /opt/STK/htdocs
<Directory /opt/STK/htdocs>
Options Indexes MultiViews FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>
If you install the Apache Web Server after the STK
installation, you can configure it by adding those lines to the
end of the httpd.conf file. Then, restart your
Web server as follows:
# /opt/apache/bin/apachectl restart
or
# /opt/hpws/apache/bin/apachectl restart
Uninstalling the HP-UX STK
 |
| |
| To uninstall the HP-UX STK on HP-UX, use the
swremove command. |
|