28.6 Open SSO Remote Registration versus Remote Updates

The update request file passes specific values to the remote registration tool, oamreg. The primary differences between the update template and the original registration template is that the update template.

Table 28-12 Delta: OpenSSO Remote Registration versus Remote Updates

Delta	Element
Adds	<startDate>yyyy_mm_dd</startDate> element to track changes
Adds	<homeUrl> element that specifies the agent_base_url_port
Omits	<hostidentifier>
Omits	<agentbaseURL>

See Also:

• Table 28-7

• Updating OpenSSO Agents Remotely

28.6.1 Updating OpenSSO Agents Remotely

You can update, validate, and delete OSSO Agents using remote registration templates and modes.

For more information, see "Remote Agent Update Modes and Templates".

To remotely update OAM 10g Agent registration

1. Set up the registration tool as described in, "Acquiring and Setting Up the Remote Registration Tool".

2. Update Agent:

   1. Create your update request using the OAMUpdateAgentRequest.xml template.

   2. On the computer hosting the Agent, run the following command with agentUpdate mode specify your own *Request*.xml as the input file. For example:

      ./bin/oamreg.sh agentUpdate input/OpenSSOUpdateAgentRequest.xml
      

   3. Provide the registration Administrator user name and password when asked.

   4. Confirm success with on-screen messages.

   5. Relocate to the agent host OpenSSOAgentBootstrap and OpenSSOAgentConfiguration.properties files:

      From the AdminServer (Console) host: /rreg/output/Agent_Name/

      To the OpenSSO Agent host Web server $OHS_dir/config. For example:

      • $WebTier_MW_HOME/Oracle_WT1/instances1/config/OHS/ohs1/config/*.properties

   6. Restart the OAM Server that is hosting this agent

3. Validating Agent:

   1. On the Agent host, run the following command in agentValidate mode. For example:

      ./bin/oamreg.sh agentValidate agentname
      

   2. Provide the registration Administrator user name and password when asked.

   3. Confirm success with on-screen messages.

4. Deleting an Agent:

   1. On the computer hosting the Agent, run the following agentDelete command. For example:

      ./bin/oamreg.sh agentDelete agentname
      

   2. Provide the registration Administrator user name and password when asked.

   3. Confirm success with on-screen messages.

      Success: On-screen message confirms

      AgentDelete process completed successfully!