Deployment Example 2: Federation Using SAML v2

ProcedureTo Run the J2EE Policy Agent Installer on Application Server 3

Before You Begin

You must obtain and unpack the J2EE Policy Agent software from the following Sun Microsystems web page: http://www.sun.com/download/products.xml?id=43543381.

  1. In the directory where you downloaded the J2EE Policy Agent TAR file, unpack the J2EE Policy Agent bits using the GNU untar utility. Example:


    # cd /export
    # gunzip SJS_Appserver_81_agent_2.2.tar.zip
    # gtar -xvf /usr/sfw/bin/SJS_Appserver_81_agent_2.2.tar

    Note –

    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


  2. Start the J2EE Policy Agent installer.

    # cd /export/j2ee_agents/am_as81_agent/bin
    # ./agentadmin --install
  3. When prompted, provide the following information:


    Enter the Application Server Config 
    Directory Path [/var/opt/SUNWappserver/
    domains/domain1/config]

    Accept the default value. 


    Enter the Application Server Instance name: [server]

    Accept the default value. 


    Access Manager Services Host: 

    Enter LoadBalancer-9.siroe.com.


    Access Manager Services port: [80]

    Enter 3443.


    Access Manager Services Protocol: [http]

    Enter https.


    Access Manager Services Deployment URI: [/amserver]

    Enter /federation.


    Enter the Agent Host name:

    ProtectedResource-3.siroe.com


    Is the Domain administration server 
    host remote? [false]

    Accept the default value. 


    Enter the port number for 
    Application Server instance [80]:

    Enter 8080.


    Enter the Preferred Protocol for 
    Application instance [http]:

    Accept the default value. 


    Enter the Deployment URI for 
    the Agent Application [/agentapp]

    Accept the default value. 


    Enter the Encryption Key 
    [d1ui072LoDGSD5ZEz0Z4e3bvaJN2f3wz]:

    Accept the default value. 


    Enter the Agent Profile name:

    Enter asagent.


    Enter the path to the password file:

    Enter /export/agent_profile_password.


    Is the agent being installed on the 
    DAS host for a remote instant [false]

    Accept the default value. 


    Are the Agent and Access Manager installed on 
    the same instance of Application Server? [false]:

    Accept the default value. 


    Verify your settings and decide from 
    the choices below:
    1. Continue with Installation
    2. Back to the last interaction
    3. Start Over
    4. Exit
    Please make your selection [1]:

    Accept the default value. 

  4. After the installer has finished installing the agent, verify that installation was successful. You check can for installation errors in the following log file:


    /export/j2ee_agents/am_as81_agent/logs/audit/install.log