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.
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:
http://www.gnu.org/software/tar/tar.html
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:
SJS_Appserver_81_agent_2.2.tar.gz SJS_Appserver_81_agent_2.2.zip SJS_Appserver_81_agent_2.2_SUNWamas.tar.gz
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:
To Unpack Non-Package Formatted Deliverables of a J2EE Agent in Policy Agent 2.2
To Unpack Package Formatted Deliverables of a J2EE Agent in Policy Agent 2.2
To Unpack a .zip Compressed file of a J2EE Agent in Policy Agent 2.2
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.
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.
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.
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 - |
is the name of the specific deployment container, followed by an underscore “_”, followed by the version
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
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.
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.
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.