Format of the Distribution Files for a J2EE Agent
Installation in Policy Agent 2.2

The distribution files for a J2EE agent in Policy Agent 2.2 are
provided to you in either a .tar.gz archive or a .zip archive. To unpack the .tar.gz archive, use
the GNU_tar program.

Caution –

For .tar.gz archives, do not use a program
other than GNU_tar to untar the contents of the J2EE agent
deliverables. Using a different program, such as another tar program, can
result in some files not being extracted properly. To learn more about the GNU_tar program, visit the following web site:

Each J2EE agent in the Policy Agent 2.2 release presents
you with three compressed-file options. The file names vary for each agent.
For example, Policy Agent 2.2 for Sun Java System Application Server
8.1 provides the three compressed-file options as follows:

For other J2EE agents, the file names are different, but the naming
format is the same. To see the names of the preceding compressed files specific
to the J2EE agent you are using, see Example 3–1.

Choose the file format that best fits your site's platform requirements.
The file that is in a .zip format is for Windows systems.
The other two compressed files both end in .tar.gz. The .tar.gz file with SUNWam_xx in the file name
contains distribution files in a package format. This package format is for
Solaris systems only. The other .tar file, the one containing
non-packaged distribution files, is for any UNIX-based system (including Solaris
systems).

The task of unpacking the compressed file that contains the J2EE deliverable
files is explained in this section separately for each platform as follows:

If you do not use the Solaris package distribution, therefore
you use one of the other two formats, choose a directory in which to unpack
the compressed file. Choose a directory location that best fits your site's
requirements, but note that unpacking the .zip or .tar file distributes the J2EE agent files within the directory you
have chosen, creating subdirectories where necessary, but containing all of
the subdirectories within the original directory that you have chosen.

To Unpack Non-Package Formatted Deliverables of a
J2EE Agent in Policy Agent 2.2

Follow the steps described in this task to unpack a compressed file
that is named in the following manner:

appserver_version_agent_2.2.tar.gz

The two following facts apply to the this compressed file: It is for
any UNIX-based system, including Solaris systems, and the distribution files
contained within this compressed file are not in package
format.

Issue the following command:

# gzip -dc appserver_version_agent_2.2.tar.gz | tar xvf -

where appserver_version represents the specific
deployment container, followed by an underscore “_”, followed
by the version.

For example, the command to unpack the archive
of Policy Agent 2.2 for Sun Java System Application Server 8.1 is
as follows:

# gzip -dc SJS_Appserver_81_agent_2.2.tar.gz | tar xvf -

For other J2EE agents, the file names are different, but the naming
format is the same. To see the preceding command specific to the J2EE agent
you are using, see Example 3–2.

Purpose of This Task

The preceding step unpacks the archive and provides you with the agent
deliverables for Policy Agent 2.2 for Sun Java System Application
Server 8.1.

To Unpack Package Formatted Deliverables of a J2EE
Agent in Policy Agent 2.2

Follow the steps described in this task to unpack a compressed file
that is named in the following manner:

appserver_version_agent_2.2_SUNWam_xx.tar.gz

The two following facts apply to the this compressed file: It is for
Solaris systems only and the distribution files contained within this compressed
file are in package format.

Issue the following command:

# gzip -dc appserver_version_agent_2.2_SUNWam_xx.tar.gz | tar xvf -

appserver_version

is the name of the specific deployment container, followed
by an underscore “_”, followed by the version

xx

is an abbreviated name for the specific deployment container

For example, the command to unpack the archive of Policy Agent 2.2 for Sun Java System Application
Server 8.1 is as follows:

# gzip -dc SJS_Appserver_81_agent_2.2_SUNWamas.tar.gz | tar xvf -

For other J2EE agents, the file names are different, but the naming
format is the same. To see the preceding command specific to the J2EE agent
you are using, see Example 3–3.

Issue the following command:

# pkgadd -d

By default, this command distributes the J2EE agent packages to the
following directory:

/opt/j2ee_agents

Purpose of This Task

The preceding steps unpack the archive and provide you with the agent
deliverables for Policy Agent 2.2 for Sun Java System Application
Server 8.1.

To Unpack a .zip Compressed file
of a J2EE Agent in Policy Agent 2.2

Follow the steps described in this task to unpack a compressed file
that is named in the following manner:

appserver_version_agent_2.2.zip

The following fact applies to this compressed file: It is for Windows
systems.

Issue the following command:

unzip appserver_version_agent_2.2.zip

where appserver_version represents the specific
deployment container, followed by an underscore “_”, followed
by the version.

For example, the command to unpack the archive
of Policy Agent 2.2 for Sun Java System Application Server 8.1 is
as follows:

unzip SJS_Appserver_81_agent_2.2.zip

For other J2EE agents, the file names are different, but the naming
format is the same. To see the preceding command specific to the J2EE agent
you are using, see Example 3–4.

Purpose of This Task

The preceding step unpacks the archive and provides you with the agent
deliverables for Policy Agent 2.2 for Sun Java System Application
Server 8.1.