Oracle Cloud Infrastructure Documentation

Remote Agent Appliance Diagnostic messages

The remote agent appliance on the VM console displays messages that can help you identify issues such as agent registration fails in OCI or an agent connected to OCI not functioning properly.

Here's a list of messages that can appear on the remote agent appliance. For information about built-in diagnostics, see Diagnosing Remote Agent Appliance Network Connectivity.

Appliance failed to acquire primary IP

The external interface of the remote agent appliance VM is not configured properly. Either no DHCP lease has been acquired or no static IP configuration is provided.

Remedy: Ensure that the VM network adapters are connected to a valid network. Change the network settings in the appliance configuration when the appliance is powered off.

Appliance was unable to resolve gateway MAC address

The remote agent appliance VM is not able to communicate with the configured default network gateway.

Remedy: Ensure that the VM network adapters are connected to a valid network. Change the network settings in the appliance configuration when the appliance is powered off.

Appliance did not receive a response from DNS servers

The remote agent appliance VM is not able to receive a response from DNS servers.

Remedy: Verify that the IP addresses of the DNS servers are configured correctly and are available. Change the network settings in the appliance configuration when the appliance is powered off.

Appliance was unable to connect to a proxy IP address

The proxy settings of the remote agent appliance VM are not configured properly.

Remedy: Verify that the proxy IP address and port is correct and proxy server is available. Change the network settings in the appliance configuration when the appliance is powered off.

Appliance has not yet successfully connected to OCI

The registration attempt failed and a connection could not be established with OCI. A network configuration issue such as a DNS lookup failure or an interrupted registration process might have occurred.

Remedy: Review the diagnostic messages to diagnose the network configuration issue. After the networking configurations are updated, the appliance attempts a connection to OCI until the date indicated, before failing permanently. A remote agent appliance with a Creating status in the OCI console can indicate an interrupted registration process. In some cases, you must reset or deploy a new appliance, and attempt the registration again

Appliance has failed to register

The registration attempt has failed permanently.

Remedy: Review the diagnostic messages for details. If the registration token has expired the registration is not attempted further. Reset or deploy a new appliance and attempt registration again.

Appliance has failed to authorize in the control plane

A registered remote agent appliance could not communicate with the service control plane.

Remedy: Review the diagnostic messages for details, and and verify that the appropriate service policies are created. The appliance attempts to re-establish the connection until successful..

Connection to OCI has failed

The previously registered and functioning remote agent appliance might be experiencing an intermittent network issue.

Remedy: Review the diagnostic messages for details. The appliance keeps retrying the connection until the date indicated, before failing permanently.

Appliance registration has expired

The registration for a previously functioning remote agent appliance has expired.

Remedy: For security reasons, expired registrations can't be renewed. Reset or deploy a new appliance and register again.