Pre-requisites for Monitoring the Oracle VirtualBox in an Agent-based Manner

General Pre-requisites

Enable the eG agent to communicate with the eG manager port (default: 7077).

Pre-requisites for Auto-Discovering VMs and Obtaining their Outside View

  1. Ensure that the eG agent is able to connect to the target VirtualBox via SSH. 

  2. Make sure that the SSH port (default: 22) is opened for communication between the eG agent and the Oracle VirtualBox.

  3. Configure all the tests that the eG agent executes with the name and password of a user who has the right to access the target Oracle VirtualBox via SSH.

  4. To enable the eG agent to run VDA commands on the VirtualBox, install the sudo package on the VirtualBox. To install this package, do the following:

    • Login to the Solaris system hosting the VirtualBox as a root user.

    • To download the sudo package, connect to the URL: http://sysinfo.bascomp.org/solaris/installing-sudo-on-solaris/

    • If the Solaris processor is Intel based, download the file TCMsudo-1.8.2-i386.pkg.gz from the web site mentioned above. On the other hand, if the Solaris host uses a SPARC processor instead, download the file TCMsudo-1.8.2-sparc.pkg.gzfrom the web site.

    • Download the chosen file to any location on the VirtualBox host (say, /tmp).

    • From the Solaris prompt, switch to the directory hosting the downloaded package and unzip the compressed package using the following command:

      gunzip <package_name>

      For instance:

      gunzip TCMsudo-1.8.2-sparc.pkg.gz

    • Then, install the package by issuing the following command at the prompt:

      pkgadd  -d <package name>

      For instance:

      pkgadd –d TCMsudo-1.8.2-sparc.pkg

    • Once installation is complete, you will find that the package is installed in the /usr/local/ folder on the Solaris host.

  5. All the tests run by the eG agent should be configured with the full path to the install directory of the sudo package;

Pre-requisites for Obtaining the Inside View of Windows VMs, using the eG VM Agent

  1. Install the eG VM Agent on each Windows VM. For details on how to install the eG VM Agent, refer to Section 1.5 of this document.

  2. Enable the eG agent to communicate with the port at which the eG VM Agent listens (default port: 60001).

  3. Set the Inside View Using flag for all the “inside view” tests to eG VM Agent (Windows).

Pre-requisites for Obtaining the Inside View of VMs, without using the eG VM Agent

  1. Ensure that the eG agent has IP connectivity to at least one of the network interfaces of the VMs.

  2. Typically, the Windows File and Print Sharing port is 139. Enable the eG agent to communicate with this port.

  3. The admin$ share should be enabled for all Windows-based virtual guests being monitored and the administrative account must have permissions to this share drive. Refer to Enabling ADMIN$ Share Access on Windows Virtual Guests for a step-by-step procedure to achieve this.

  4. To enable the eG agent to communicate with the Windows VMs, an administrative account login and password (either a local account or a domain account) must be provided when configuring the eG monitoring capabilities. 

  5. In case of VMs with the Windows 2012 (or above versions)/Windows 8(or above versions) operating systems, the firewall on the guest should be explicitly configured to allow Windows File and Print Sharing services which are required for the agent to communicate with the guest operating system. Refer to Configuring Windows Firewalls to Allow File and Print Sharing for a step-by-step procedure to achieve this.

  6. Set the inside view using flag for all the “inside view” tests to Remote connection to VM (Windows).

  7. For monitoring a Linux/Solaris VM, the SSH port (TCP port 22) must be enabled for communication between the eG agent and the VM being monitored.