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

Before you begin

  • 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.

  • Establish secure trust between the guest agent and your Manager Service machine. See Configuring the Guest Agent to Trust a Server.

Procedure

  1. Navigate to the vRealize Automation appliance management console page.

    For example: https://va-hostname.domain.com.

  2. Click Guest and software agents page in the vRealize Automation component installation section of the page.

    For example: https://va-hostname.domain.com/software/index.html.

    The Guest and Software Agent Installers page opens, displaying links to available downloads.

  3. Click Linux guest agent packages in the guest agent installers section of the page to download and save the LinuxGuestAgentPkgs.zip file.
  4. Unpack the downloaded LinuxGuestAgentPkgs.zip file to create the VraLinuxGuestAgent folder.
  5. Install the guest agent package that corresponds to the guest operating system you are deploying during provisioning.
    1. Navigate to the VraLinuxGuestAgent subdirectory that corresponds to the guest operating system to deploy during provisioning, for example rhel32.
    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-gugent-7.1.0-4201531.i386.rpm.

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

    The default port number for the Manager Service is 443. Accepted platform values are ec2, vcd, vca, and vsphere.

    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 ec2

    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 vsphere
  7. 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
  8. 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

What to do next

Convert your reference machine into a template for cloning, an Amazon Machine Image, or a snapshot that your IaaS architects can use when creating blueprints.