Sun Java System Access Manager Policy Agent 2.2 Guide for BEA WebLogic Server/Portal 9.2

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 – 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:

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 your J2EE agent, see Example 3–1.

Choose the file format that best fits your platform needs. 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:


Note –

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 needs, 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.


ProcedureTo 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 your J2EE agent, 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.

ProcedureTo 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.

  1. 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 your J2EE agent, see Example 3–3.

  2. 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.

ProcedureTo 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 your J2EE agent, 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.