How to Install the TLP Server Software (Sun Update Connection - Automated Baseline Management Service 1.0 User's Guide)

Sun Update Connection - Automated Baseline Management Service 1.0 User's Guide

How to Install the TLP Server Software

This procedure describes how to install the TLP server software. In this procedure, the current working directory is the TLP installation directory, /opt/SUNWtlp.

Before You Begin

Before you begin the installation, ensure that you have the following:

A sufficient amount of disk space available on the system.

For each set of baselines that you use, you will need 3 to 4 Gbytes of disk space. In addition, you need to reserve disk space for each TLP client. The amount of space that is required for each client system can vary between 1 to 5 Mbytes. In rare instances, the amount of disk space that is required could reach 200 Mbytes. Because the created patch sets are built from symbolic links that point to the patch repository, each patch set only requires about 100 Kbytes of disk space.
Perl, version 5.005_03, or later installed on the system.

Perl, version 5.005_3, or later is bundled with all Solaris OS versions, beginning with the Solaris 7 OS.
An HTTP server installed on the system.

The Apache HTTP Web Server software is bundled with the Solaris OS.
The latest TLP server software, which has been downloaded from the TLP server.
Access to the Sun patch baselines, for example, on an EIS-CD.

Steps

Extract the archive SUNWtlp-2.3.tar.gz to the /tmp directory.
# gzcat SUNWtlp-2.3.tar.gz | tar xvf -

Check the README file in /opt/SUNWtlp/README for the latest updates.

Install the TLP software package.
# pkgadd -a tlp.policy -d SUNWtlp-2.3
By default, the TLP software is installed in the /opt/SUNWtlp directory. See How to Add Software Packages (pkgadd) in System Administration Guide: Basic Administration for information on how to modify the installation directory.

Create the UNIX user and group for the tlp-user

Although you can run the TLP tool as the root user, the preferred method is to create a unique user ID. Use the Solaris Management Console to create the new user and group. For more information about creating users and groups with the Solaris Management Console, see Setting Up User Accounts (Task Map) in System Administration Guide: Basic Administration.

Create the TLP data directory and give ownership to the tlp-user.
# mkdir DataDirectory # chown tlp-user DataDirectory
The data directory is used by the TLP tool for storing patches and TLP results. Note the location of this directory, as you will need to add it to the tlp.cfg file later.

Using a text editor, modify the TLP server conf/tlp.cfg configuration file.

For more information, see How to Modify the TLP Configuration File.

Configure the CGI script to enable file transfers from the TLP client to the server.

For more information, see How to Install and Configure the CGI Script.

Example 2–1 Installing the TLP Server Software

This example shows a TLP server software installation. For the sake of brevity, the output in this example has been truncated.

root# gzcat SUNWtlp-2.3.tar.gz | tar xf -

root# ls
README              SUNWtlp-2.3         SUNWtlp-2.3.tar.gz  tlp.policy

root# pkgadd -a tlp.policy -d SUNWtlp-2.3

The following packages are available:
  1  SUNWtlp     Traffic Light Patchtool
                 (sparc) 2.3

Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: y

Processing package instance <SUNWtlp> from /var/tmp/tlp/SUNWtlp-2.3

Traffic Light Patchtool
(sparc) 2.3
============================================================================
Copyright (c) 2001-2003 Sun Microsystems, Inc. All rights reserved.
Protected by copyright and distributed under licenses restricting its use,
copying, distribution and decompilation. Sun, Sun Microsystems, the Sun
.
.
..
Checking for perl >= 5.005_03 ... yes
Checking for update ... no

Please enter installation directory (default: /opt/SUNWtlp) :  [?] 

TLP requires a data directoy for the baselines,
Explorer and generated patch sets. It is recommended to
put this directory in a separate file system.

Please enter a data directory (default: /opt/SUNWtlp/data) : \
[?] /export2/data

Which user:group should be the owner of tlp installation \
(default: root:other)
?  [?] tlpuser:staff

Create link /opt/sun/bin/tlp -> /opt/SUNWtlp/tlp ? (default: y) [y,n,?] 

Create link /opt/sun/bin/cpc -> /opt/SUNWtlp/tlp ? (default: y) [y,n,?] 

The selected base directory </opt/SUNWtlp> must exist before
installation is attempted.

Do you want this directory created now [y,n,?,q] y
Using </opt/SUNWtlp> as the package base directory.
## Processing package information.
## Processing system information.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.

This package contains scripts which will be executed with super-user
permission during the process of installing this package.

Do you want to continue with the installation of <SUNWtlp> [y,n,?] y

Installing Traffic Light Patchtool as <SUNWtlp>
## Executing preinstall script.
## Installing part 1 of 1.
/opt/SUNWtlp/CHANGES
/opt/SUNWtlp/README
/opt/SUNWtlp/conf/defaults/Patchcluster_README
/opt/SUNWtlp/conf/defaults/WITHDRAWNPATCHES
/opt/SUNWtlp/conf/defaults/black_list.cfg
/opt/SUNWtlp/conf/defaults/cpc.cfg
/opt/SUNWtlp/conf/defaults/log.cfg
.
.
.
## Executing postinstall script.
Installing .... /opt/SUNWtlp/conf/tlp.cfg
Installing .... /opt/SUNWtlp/conf/cpc.cfg
Installing .... /opt/SUNWtlp/conf/log.cfg
Installing .... /opt/SUNWtlp/conf/WITHDRAWNPATCHES
Installing .... /opt/SUNWtlp/conf/white_list.cfg
Installing .... /opt/SUNWtlp/conf/black_list.cfg
Installing .... /opt/SUNWtlp/conf/non-standard-patchids
Installing .... /opt/SUNWtlp/conf/node_group_definition.cfg
Setting DataDirectory in /opt/SUNWtlp/conf/cpc.cfg to /export2/data
Setting DataDirectory in /opt/SUNWtlp/conf/tlp.cfg to /export2/data
Creating link /opt/SUNWtlp/tlp --> /opt/sun/bin/tlp
Creating link /opt/SUNWtlp/tlp --> /opt/sun/bin/cpc
Setting ownership of /opt/SUNWtlp to tlpuser:staff

Installation of <SUNWtlp> was successful.