Install a Data Collector using Reinstall Option
This section discusses installing a data collector using the REINSTALL
parameter from the response file.
Install a Data Collector using Reinstall Option
You can use the REINSTALL
parameter to reinstall a data collector 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 data collector 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 data collector must be reinstalled from a stage (ZIP
file) of the same version as the data collector registered/listed in OMC. For example, if the data collector 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 a Data Collector.
-
Specify the values of the Registration Parameters for Installing Cloud Agents and Communication Parameters for Installing Cloud Agents in the response file.
-
Specify the values of the Data Collector Parameters in the response file.
-
Review the Optional Parameters for Installing Cloud Agents and Optional Data Collector 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 data collector installation using the reinstall option:
-
Log on to the host where you will install the data collector and navigate to the directory where you extracted the data collector 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
andAGENT_REGISTRATION_KEY
, and the Data Collector Parameters in the response file (agent.rsp
).Confirm that the values for the parameters:
AGENT_BASE_DIRECTORY
andAGENT_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 Data Collector for more details.
-
Run the
AgentInstall
agent installation script to install a data collector.-
If you are installing a data collector on a UNIX-based host:
./AgentInstall.sh
-
If you are installing a data collector on a Windows host, right-click and select Run as administrator to open an Administrator command prompt and run the following:
AgentInstall.bat
-
Your data collector installation using reinstall option is now complete. The data collector you just installed will attach to the old data collector you have in OMC and inherit its historical data. Next step is to Verify the Data Collector Installation.