Oracle Cloud Infrastructure Documentation

Diagnosing Remote Agent Appliance Network Connectivity

Use the text-based user interface (TUI) application in the remote agent appliance to diagnose potential connectivity issues in Oracle Cloud Migrations.

The TUI application runs in the default console of the VM. This application automatically performs the following network connectivity checks to help diagnose potential issues:
  • Network interface configuration
  • Gateway functionality
  • DNS functionality
  • Proxy functionality (if used)
  • Registration status

The application also provides interactive troubleshooting checks for DNS lookup and TCP connectivity to selected endpoints.

Accessing the application

To access this application, log on to vCenter using a vSphere client and select the remote agent appliance VM. You can use either the Launch Remote Console or Launch Web Console option found on the VM details page.

Note

The diagnostic tool automatically displays information related to the configuration of the remote agent appliance, including networking information, agent OCID, and diagnostic output. Only the users with access to the VM console in vSphere can view these details.

Understanding the diagnostic output

The diagnostic output of this application is divided into three parts, as described in the following table:
Diagnostic Output Description
Software versions Displays the version numbers of the remote agent appliance and the plugins.
Appliance Status Displays the IP address and overall status of the appliance.
Diagnostics Displays the output that denotes the status of an unhealthy appliance.

For details on diagnostic output and their root cause, see Remote Agent Appliance Diagnostic Messages.

Running interactive network troubleshooting checks

In addition to the automatic diagnostic checks, the remote agent appliance Console provides interactive troubleshooting options for validating specific network endpoints. From the diagnostic Console, press t to open the troubleshooting menu. The following options are available:

  • DNS lookup

    Enter a hostname to verify that the remote agent appliance can resolve it through its configured DNS settings. The result shows whether the lookup succeeded, any resolved IP addresses, and the time taken to complete the check.

  • TCP connection check

    Enter a hostname and one of the supported ports shown in the prompt. The diagnostic Console displays the allowed ports in the following format:
    Port (80, 443, 902, 54323):
    The result shows whether the appliance can establish a TCP connection to the specified host and port, and the time taken to complete the check.
To return to the previous diagnostic output, press q from the troubleshooting menu.
Note

The TCP connection check is limited to the ports displayed in the prompt. If you enter a port that isn't supported, the check returns a validation error and doesn't try the connection.
Note

If you interrupt the diagnostic Console with Ctrl+C, it might take about one minute for the monitoring service to restart and show the diagnostic screen again.