RHEL: Install vFabric Administration Server from an RPM

VMware recommends that you install vFabric Administration Server on a Red Hat Linux Enterprise (RHEL) computer by first installing the VMware RPM repository and then using yum to perform the actual installation. See Install vFabric Administration Server from the VMware RPM Repository.

You can also download the RPM from the VMware Download page and install it on your RHEL computer using the rpm command, as described in Install vFabric Administration Server from a Downloaded RPM. This installation option is necessary if you are installing a version of vFabric Administration Server that is not yet certified for vFabric Suite, which means that it has not yet been added to the VMware RPM repository.

Install vFabric Administration Server from the VMware RPM Repository

VMware recommends that you install vFabric Administration Server on RHEL computers using the VMware RPM repository.

Note

As described in the Prerequisites section, to install vFabric Administration Server from the RPM repository,

Prerequisites

  • Verify that your system meets the supported configurations and installation requirements. See Supported Configurations and System Requirements.

  • The JAVA_HOME environment variable must be set in the root user's environment. For example, you could add the following line to /etc/profile and then open a new terminal window:

    export JAVA_HOME=/usr/java/latest

    Replace /usr/java/latest with the base directory of your JVM installation.

  • Install the vFabric repository RPM, which makes it easier for you to browse the vFabric RPMs, including the vFabric Administration Server RPM. The vFabric repository contains all RPMs that are certified with this release of vFabric Suite. You install the vFabric repository RPM on each RHEL computer on which you want to install one or more vFabric components, such as vFabric Administration Server.

    1. On the RHEL computer, start a terminal either as the root user or as an unprivileged user who has sudo privileges.

    2. Install the vFabric repository RPM using the following wget command, passing it the appropriate URL. The URL differs depending on the version of RHEL you are using.

      Important: You must run the entire wget command on a single line. Be sure you include the | sh at the end, or the RPM installation will not work.

      For RHEL 5:

      prompt# wget -q -O - http://repo.vmware.com/pub/rhel5/vfabric/5.2/vfabric-5.2-suite-installer | sh

      For RHEL 6:

      prompt# wget -q -O - http://repo.vmware.com/pub/rhel6/vfabric/5.2/vfabric-5.2-suite-installer | sh

      If necessary, use sudo to run the preceding commands if you are not logged in as the root user. For example:

      prompt$ sudo wget -q -O - http://repo.vmware.com/pub/rhel6/vfabric/5.2/vfabric-5.2-suite-installer | sh

      The command performs the following tasks:

      • Imports the vFabric GNU Privacy Guard (GPG) key.

      • Installs the vFabric 5.2 repository RPM.

      • Launches the VMware End User License Agreement (EULA) acceptance and repository configuration script.

      • Outputs the EULA for you to read; you must answer yes to accept the terms and continue.

    3. Use the yum search vfabric or yum search vmware command to view the list of vFabric components that you can install from the VMware repository. For example (output truncated for clarity):

      prompt# yum search vfabric
      ...
      ======================================== Matched: vfabric ========================================
      vfabric-administration-server.noarch : VMware vFabric Administration Server
      vfabric-rabbitmq-java-client-bin.noarch : The RabbitMQ Java Client Library
      vfabric-rabbitmq-server.x86_64 : The RabbitMQ server
      vfabric-tc-server-standard.noarch : VMware vFabric tc Server Standard
      vfabric-web-server.x86_64 : VMware vFabric Web Server
      ...

      The vFabric Administration Server RPM is called vfabric-administration-server.

Procedure

  1. On the RHEL computer on which you will install vFabric Administration Server, log in as the root user (or as an unprivileged user who has sudo privileges) and start a terminal.

  2. Execute the following yum command:

    prompt# yum install vfabric-administration-server

    The yum command begins the install process, resolves dependencies, and displays the packages it will install.

    Use sudo to run the preceding command if you are not logged in as the root user. For example:

    prompt$ sudo yum install vfabric-administration-server
  3. Enter y at the prompt to begin the actual installation.

    If the installation is successful, you see a Complete! message at the end.

  4. Start the broker and server by rebooting or by using the service command.

    prompt# service administration-broker start
    prompt# service administration-server start

    Use sudo if you are not logged in as root.

    prompt$ sudo service administration-broker start
    prompt$ sudo service administration-server start

What the yum install command does

The yum install command:

  • Installs vFabric Administration Server into the /opt/vmware/vfabric-administration-server directory and sets the owner of the directory, along with all child directories and files, to root:vfabric.

  • If the user does not already exist, adds a vas non-interactive user (in the group vfabric). VMware recommends that you run vFabric Administration Server as this user.

    You cannot log in directly as the vas user because interactive login is disabled. Rather, you must log in as the root user or as an unprivileged user using sudo, and then su - vas .

What to do next

  • If you installed vFabric Administration Server as part of vFabric Suite, you should have already activated licensing as described in the procedures for installing vFabric License Server and activating vFabric Suite licenses in Getting Started with vFabric Suite. (You may also want to read the other vFabric licensing sections in that guide, to understand how licensing works with vFabric Suite.)

  • Set up managed nodes that vFabric Administration Server will administer. Review the prerequisites for node computers and then proceed to Install and Run the Agent on Managed Nodes.

Install vFabric Administration Server from a Downloaded RPM

You can install vFabric Administration Server on RHEL by downloading the RPM from the VMware download center and executing the rpm command. This procedure is necessary if you want to install a version of vFabric Administration Server that has not yet been certified for vFabric Suite.

Prerequisites

Procedure

  1. Log in to the RHEL computer on which you will install vFabric Administration Server as the root user (or as an unprivileged user who has sudo privileges).

  2. From the VMware Download page, navigate to the VMware vFabric Suite download page and download the vFabric Administration Server RPM file to a directory on your computer. The RPM file is called vfabric-administration-server-version-RELEASE.noarch.rpm and you will find it on the Drivers and Tools tab.

  3. Start a terminal and change to the directory in which you downloaded the RPM.

  4. Execute the following rpm command to install vFabric Administration Server:

    prompt# rpm -ivhf vfabric-administration-server-version-RELEASE.noarch.rpm

    Use sudo to run the preceding command if you are not logged in as the root user. For example:

    prompt$ sudo rpm -ivhf vfabric-administration-server-version-RELEASE.noarch.rpm
  5. Start the broker and server by rebooting or by using the service command.

    prompt# service administration-broker start
    prompt# service administration-server start

    Use sudo if you are not logged in as root.

    prompt$ sudo service administration-broker start
    prompt$ sudo service administration-server start
  6. In the previous section, see What the yum install command does for post-installation information, such as the installation directory and the user that is automatically created by the RPM installation. (The yum install command corresponds to the rpm command in this procedure.)