Install the Linux guest agent on your reference machines to further customize machines after deployment.

Prerequisites

  • Identify or create the reference machine.

  • The guest agent files you download contain both tar.gz and RPM package formats. If your operating system cannot install tar.gz or RPM files, use a conversion tool to convert the installation files to your preferred package format.

Procedure

  1. Navigate to the vCloud Automation Center Appliance management console installation page.

    For example: https://vcac-hostname.domain.name:5480/installer/.

  2. Download and save the Linux Guest Agent Packages.
  3. Unpack the LinuxGuestAgentPkgs file.
  4. Install the guest agent package that corresponds to the guest operating system you are deploying during provisioning.
    1. Navigate to the LinuxGuestAgentPkgs subdirectory for your guest operating system.
    2. Locate your preferred package format or convert a package to your preferred package format.
    3. Install the guest agent package on your reference machine.

      For example, to install the files from the RPM package, run rpm -i gugent-7.0.0-012715.x86_64.rpm.

  5. Configure the guest agent to communicate with the Manager Service by running installgugent.sh Manager_Service_Hostname_fdqn:portnumber ssl.

    Option

    Description

    If you are using a load balancer

    Enter the fully qualified domain name and port number of your Manager Service load balancer. For example:

    cd /usr/share/gugent
    ./installgugent.sh load_balancer_manager_service.mycompany.com:443 ssl

    With no load balancer

    Enter the fully qualified domain name and port number of your Manager Service machine. For example:

    cd /usr/share/gugent
    ./installgugent.sh manager_service_machine.mycompany.com:443 ssl

    The default port number for the Manager Service is 443.

  6. If deployed machines are not already configured to trust the Manager Service SSL certificate, you must install the cert.pem file on your reference machine to establish trust.
    • For the most secure approach, obtain the cert.pem certificate and manually install the file on the reference machine.

    • For a more convenient approach, you can connect to the manager service load balancer or manager service machine and download the cert.pem certificate.

    Option

    Description

    If you are using a load balancer

    As the root user on the reference machine, run the following command:

    echo | openssl s_client -connect manager_service_load_balancer.mycompany.com:443 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > cert.pem

    With no load balancer

    As the root user on the reference machine, run the following command:

    echo | openssl s_client -connect manager_service_machine.mycompany.com:443 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > cert.pem
  7. If you are installing the guest agent on a Ubuntu operating system, create symbolic links for shared objects by running one of the following command sets.

    Option

    Description

    64-bit systems

     cd /lib/x86_64-linux-gnu
    sudo ln -s libssl.so.1.0.0 libssl.so.10
    sudo ln -s libcrypto.so.1.0.0 libcrypto.so.10

    32-bit systems

    cd /lib/i386-linux-gnu
    sudo ln -s libssl.so.1.0.0 libssl.so.10
    sudo ln -s libcrypto.so.1.0.0 libcrypto.so.10