Install the Cloud Agent Using Reinstall Option

This section discusses installing the cloud agent using the REINSTALL parameter from the response file.

You can use the REINSTALL parameter to reinstall a cloud agent that has been deleted manually from a host or it was running on a host which was decommissioned or it had a hardware failure. It is very useful in environments where hosts are being provisioned and reprovisioned on demand.

The reinstall option works in the following case:

The cloud agent was not deleted from OMC before the host went down and it is still registered/listed in OMC.
The old and new hosts must have the same OS type and same host name.

Different OS types/versions or different host names are not supported.

The agent must be reinstalled from a stage (ZIP file) of the same version as the agent registered/listed in OMC. For example, if the agent from the old host had an agent with version 1.39 installed on it, then you must perform the reinstallation using the same agent software version, in this case version 1.39. Also, the values for the parameters: AGENT_PORT and AGENT_BASE_DIRECTORY need to be the same in both the old and new hosts.

Before proceeding, be sure to:

Review the Prerequisites for Installing Cloud Agents.
Specify the values of the Registration Parameters and Communication Parameters in the response file.
Review the Install the Cloud Agent from a Shared Location for environments where the agent installation is automated and you have a shared/central location to stage the agent software and/or the response file.

To perform the cloud agent installation using the reinstall option:

Log on to the host where you will install the cloud agent and navigate to the directory where you extracted the cloud agent ZIP file that you previously downloaded. See Download the Oracle Management Cloud Agent Software for more details.
Have your response file ready. Ensure that you have entered the values for the mandatory parameters: TENANT_NAME, OMC_URL and AGENT_REGISTRATION_KEY in the response file (agent.rsp).

Confirm that the values for the parameters: AGENT_BASE_DIRECTORY and AGENT_PORT are the same as the old host.

Edit the optional parameter REINSTALL and enter the value: true.

REINSTALL=true

Based on your requirement, edit any additional parameters if the default values are not in line with your best practices. See Parameters for Installing a Cloud Agent for more details.

Run the AgentInstall agent installation script to install a cloud agent.

If you are installing a cloud agent on a UNIX-based host:

./AgentInstall.sh
If you are installing a cloud agent on a Windows host, right-click and select Run as administrator to open an Administrator command prompt and run the following:

AgentInstall.bat

./AgentInstall.sh
Unzipping agent software, this may take some time...
Installing Cloud Agent...
Cloud Agent parameter validation started...
Cloud Agent pre-requisite checks started...
REINSTALL flag is enabled, attempting to re-install the Agent...
Cloud Agent base directory creation started...
Security artifacts download started...
Cloud Agent setup started...
Registering Cloud Agent...
Starting Cloud Agent...
Cloud Agent started.
Cloud Agent installation completed.
Cloud Agent post installation checks started.
Cloud Agent is up and running.
Cloud Agent is communicating to Oracle Management Cloud.
Cloud Agent is monitored in Oracle Management Cloud.
Cloud Agent post installation checks completed.
To start Cloud Agent upon Operating System restart include '/omc_agent/ca/agent_inst/bin/omcli start agent' in the start-up scripts.
For further details please refer http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/management-cloud&id=deploy_agent.

Your cloud agent installation using reinstall option is now complete. The cloud agent you just installed will attach to the old cloud agent you have in OMC and inherit its historical data. Next step is to Verify the Cloud Agent Installation.

Post installation task: Add entities to the cloud agent.

You must add all the previous entities that were being monitored before on the old host.

You can use the omcli command line utility to add entities to Oracle Management Cloud. The omcli add_entity command adds the entities to Oracle Management Cloud by reading the entity details from JSON files that you create and pass as parameters to the command.

See Typical Workflow for Adding Entities in Working with Oracle Management Cloud.