Sun OpenSSO Enterprise Policy Agent 3.0 Guide for Sun Java System Application Server 8.1/8.2/9.0/9.1 and GlassFish

Gathering Information to Install the Application Server and GlassFish Agent

The following table describes the information you will need to provide when you run the agentadmin program to install the Application Server and GlassFish agent. For some agentadmin prompts, you can accept the default value displayed by the program, if you prefer.

Table 1 Information Required to Install the Application Server and GlassFish Agent

Prompt Request 

Description 

Application Server Configuration Directory 

Path to the directory used by Application Server to store its configuration files. 

Applies to both default and custom installation options. 

Default: /var/opt/SUNWappserver/domains/domain1/config

Application Server Instance Name 

Name of the Application Server instance secured by this agent.  

Applies only to the custom installation option. 

Default: server

Access Manager URL 

URL where OpenSSO Enterprise is running. 

Applies to both default and custom installation options. 

For example: http://openssohost.example.com:8080/opensso

Is the agent installed on the DAS host for a remote instance? 

Default: false

See Installing the Application Server 9.1 / GlassFish 2.1 Agent on the Domain Administration Server (DAS).

Applies only to the custom installation option. 

Agent URL 

Applies to both default and custom installation options. 

Agent protected Application Server URL For example: http://agenthost.example.com:8090/agentapp

Note: The version 3.0 agentadmin program does not prompt you for the deployment URI for the agent application, because /agentapp is combined with this URL.

Encryption Key 

Key used to encrypt the agent profile password. The encryption key should be at least 12 characters long. You can accept the default key or create a new key using the agentadmin --getEncryptKey command.

Applies only to the custom installation option. 

Agent Profile Name 

A policy agent communicates with OpenSSO Enterprise using the name and password in the agent profile. 

Applies to both default and custom installation options. 

For information, see Creating an Agent Profile.

Agent profile password file 

ASCII text file with only one line specifying the agent profile password. You create the agent profile password file as a pre-installation step. 

Applies to both default and custom installation options. 

For information, see Creating a Password File.

Option to create the agent profile 

The agentadmin program displays the following prompt if the agent profile previously specified for the Agent Profile Name prompt does not already exist in OpenSSO Enterprise:

Enter true if the Agent Profile is being created into OpenSSO Enterprise by the installer. Enter false if it will be not be created by installer.

To have the installation program create the agent profile, enter true. The program then prompts you for:

  • Agent administrator who can create, update, or delete the agent profile. For example: agentadmin

    Important: To use this option, the agent administrator must already exist in OpenSSO Enterprise and must have agent administrative privileges. For information see, Creating an Agent Administrator. If you prefer, you can also specify amadmin as this user.

  • Path to the agent administrator password file. For information, see Creating a Password File.

Applies only to the custom installation option.