4.2. Plug-in Installation and Configuration

Oracle Enterprise Manager

If you encounter problems during plug-in installation, verify that all prerequisites are met. See Section 2.1, “Prerequisites”.

Refer to the Oracle Enterprise Manager documentation: http://www.oracle.com/technetwork/oem/enterprise-manager/documentation/index.html.

The following documents are particularly useful if you need to install a new Oracle Enterprise Manager host:

Plug-in Connectivity

If you encounter problems when adding Oracle VDI targets, verify the settings for the communication between the Management Agent and the Oracle VDI Center Agent.

If targets are shown as down in the Oracle Enterprise Manager Console, this could be due to a timeout in the communication between the Management Agent and the Oracle VDI Center Agent. If such timeout errors occur, the All Metrics page probably displays metric collection exceptions and zero values for affected targets. The timeout errors are logged in the Management Agent logs. See Section 4.1, “Plug-in Activity Logging”.

If timeout errors occur in the plug-in connection, try to resolve them by increasing the connection timeout. The default timeout is 30 seconds.

Steps:

  1. Select the Oracle VDI Center target.

  2. In the target menu, select Target Setup, then select Monitoring Configuration.

    The Monitoring Configuration page is displayed.

  3. Set the new Connection Timeout in milliseconds, and click OK to complete the operation.

    When this field is left blank, the default connection timeout is applied.

Oracle VDI Updates

As your Oracle VDI installation evolves over time, the plug-in should be made aware of these changes. If the monitoring targets in Oracle Enterprise Manager appear to be out of sync, refresh the Oracle VDI targets. The procedure is described in Section 2.4, “Refreshing an Oracle VDI Center Target”

If the password is changed for the administrator account used by the Enterprise Manager Plug-in for Oracle VDI, you must change the monitoring credentials accordingly in Oracle Enterprise Manager.

  1. Select the Oracle VDI Center target.

  2. In the Setup menu in the top-right corner, select Security, then select Monitoring Credentials.

    The Monitoring Credentials page is displayed.

  3. Select Oracle VDI Center and click Manage Monitoring Credentials.

  4. Select your Oracle VDI Center target and click Set Credentials.

    The Enter Monitoring Credentials window is displayed.

  5. Enter the Oracle VDI administrator user name and password, confirm the password, and click Save to store the new credentials.

Oracle VDI Preferred and Fallback Hosts

The preferred host is initially the one specified to configure the Oracle VDI Center target. It serves as the main point of contact for the Management Agent. Other members of the Oracle VDI Center are added as fallback hosts. If the hosts in an Oracle VDI Center change, the list of Oracle VDI Hosts is updated accordingly when the Oracle VDI Center target is refreshed. When monitoring an Oracle VDI Center that consists of multiple hosts, you can configure the preferred and fallback hosts by setting the order in which the Management Agent contacts them.

  1. Select the Oracle VDI Center target.

  2. In the target menu, select Target Setup, then select Monitoring Configuration.

    The Monitoring Configuration page is displayed.

  3. Set the Oracle VDI Hosts in the desired order, separated by a space, and click OK to complete the operation.