I'm unable to install a management agent on my host
It is recommended to run Agent Installation Diagnostics in troubleshooting issues during the installation process. It displays error messages, warning messages, and debug information. The command is included in the OMA software installer and the install script, which provides valuable feedback and identifies any potential installation problems.
Before attempting installation, confirm that your host and environment meet the following prerequisites:
- Clock Synchronization: The clock on your host isn't synchronized with the OCI platform. You'll be unable to install a management agent if your host's clock is skewed more than five minutes from the OCI platform. For more information, see Maximum Allowed Client Clock Skew.
- System and JDK Requirements: Ensure you have read the Management Agent documentation and confirm that you meet the prerequisites. In particular, your host must meet the Generic Prerequisites for Deploying Management Agents, including the requirement for JDK 8 (update 281, JDK 1.8.0_281, or higher). The management agent is not compatible with any other versions of the JDK.
- Note: Oracle Management Agent Software Installer available from Download Agent Installer includes its own JDK 8, thereby eliminating the need for the host to have JDK 8 installed prior to installing Management Agents.
- Required Files Downloaded: Ensure you have downloaded all the required files as mentioned in Download Agent Installer section.
If you're unable to Install Management Agent or Deploy JMS Plug-in, verify the following:
Network Accessibility
Validation URL [https://management-agent.<region_identifier>.oci.oraclecloud.com]https://management-agent.<region_identifier>.oci.oraclecloud.com is not availableThis typically indicates that your host can't reach required OCI services due to network restrictions. If you're operating in a restricted network environment:
- Use a proxy by passing proxy parameters during agent installation.
- Ensure your organization firewall's egress allow access to:
- All public OCI IPs listed in IP Adresses Range. Select the Downloading the JSON File link to view the complete list.
- Domains: *.
oraclecloud.comand *.oci.customer-oci.com
Policies Not Configured Correctly
Missing or misconfigured policies can result in authentication failures during agent registration.
CloudRegistrationStep: The registration attempt failed with HTTP Status 401 (The required information to complete authentication was not provided or was incorrect.)
this likely indicates that required policies have not been set up properly.
Refer to Setting Up Oracle Cloud Infrastructure for Fleets to ensure the prerequisite OCI resources are created and configured as required.
Insufficient Privileges on the Host System
Ensure the user installing the agent has administrative or sudo privileges. Lack of proper privileges may prevent the installation scripts from running necessary configuration steps.