RHEL Only: Install vFabric SQLFire from an RPM

If your operating system is Red Hat Enterprise Linux (RHEL), you have the option to use to install vFabric SQLFire from an RPM.

The RPM installation process can be used whether you have purchased vFabric Suite or only the vFabric SQLFire product. In either case, VMware recommends that you install vFabric SQLFire by first installing the VMware RPM repository and then using yum to perform the actual installation. See Getting Started with vFabric Suite for more information.

Prerequisites

See Supported Configurations and System Requirements for specific host machine requirements for Linux systems.

Procedure


  1. On the RHEL computer, start a terminal either as the root user or as an unprivileged user who has sudo privileges.
    Note: If you are not logged in as the root user, you must use the sudo command to run the commands in the following steps.
  2. Run the appropriate command to install the vFabric repository RPMs. The specific URL and command depend on the version version of vFabric you have purchased, as well as the version of RHEL you are using.

    For vFabric Suite 5.2:

    Use this command for RHEL 5:
    wget -q -O - http://repo.vmware.com/pub/rhel5/vfabric/5.2/vfabric-5.2-suite-installer | sh
    Use this command for RHEL 6:
    prompt# 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.

    For vFabric Suite 5.1:

    Use these commands for RHEL 5:
    rpm -Uvh http://repo.vmware.com/pub/rhel5/vfabric/5.1/vfabric-5.1-repo-5.1-1.noarch.rpm
    rpm -Uvh http://repo.vmware.com/pub/rhel5/vfabric-all/vfabric-all-repo-1-1.noarch.rpm

    Use these commands for RHEL 6:

    rpm -Uvh http://repo.vmware.com/pub/rhel6/vfabric/5.1/vfabric-5.1-repo-5.1-1.noarch.rpm
    rpm -Uvh http://repo.vmware.com/pub/rhel6/vfabric-all/vfabric-all-repo-1-1.noarch.rpm

    For vFabric Platform 5.0:

    Use the command:
    rpm -Uvh http://repo.vmware.com/pub/rhel5/vfabric/5/vfabric-5-repo-5-2.noarch.rpm
    rpm -Uvh http://repo.vmware.com/pub/rhel5/vfabric-all/vfabric-all-repo-1-1.noarch.rpm
  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):
    yum search vfabric
    ...
    ======================================== Matched: vfabric ========================================
    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
    ...
  4. Execute the yum install command to install vFabric SQLFire:
    yum install vfabric-sqlfire
    Note: The yum install command installs the most recent version of the vFabric SQLFire RPM that it finds in all installed repository. If you want to install another version, you must explicitly specify that version with the yum install command. Use yum search vfabric-sqlfire --showduplicates to find all versions that are available in the installed repositories.

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

    If this is the first time that you install a vFabric component on the VM, the yum command also installs the vfabric-eula RPM and prompts you to accept the VMware license agreement.

  5. Enter y at the prompt to begin the actual installation.

  6. The installer may prompt you to install a GNU Privacy Guard (GPG) key for the vFabric repositories. Enter y at each prompt to continue the installation.
  7. Press Space to scroll and read the license agreement. When you reach the end of the agreement, enter yes to accept the license.

    The installer displays Complete! when the installation process is finished.

  8. If you have not already done so, download and install a compatible JDK or JRE on the RHEL computer or VM.
  9. (Optional.) Specify that the vfabric-sqlfire process should automatically start when the operating system starts by running the following command:

    chkconfig --level 35 vfabric-sqlfire on
  10. (Optional.) Specify the configuration of the vfabric-sqlfire process by editing the file /etc/sysconfig/sqlfire, which is the file sourced by the script that you will later use to start the SQLFire process (/etc/init.d/vfabric-sqlfire.)

    The /etc/sysconfig/sqlfire file includes many comments to help you decide whether you need to modify it. Here are additional pointers:
    • If you do not modify the /etc/sysconfig/sqlfire file but simply use the one installed by default, the vfabric-sqlfire process starts up a server instance in a multicast configuration.

    • If you want the vfabric-sqlfire process to start up using a locator-based configuration, change the LOCATOR property in the /etc/sysconfig/sqlfire file to local, as shown:
      LOCATOR=local

      This configuration allows a local locator process to start along with a local server instance. To add additional remote locators, add their IP address and port to the LOCATOR_IP_STRING as shown in the configuration file as a commented-out example.

    • If you want to start up only a local locator process and not a local server instance, set the LOCATOR property to locator_only. This sets up a redundant locator configuration; be sure you add the locator IP addresses and port numbers to the LOCATOR_IP_STRING; an example is shown in the configuration file.

    • Finally, set the LOCATOR property to remote if you want to start a local server instance that relies on having locator processes running on one or more remote hosts. Specify these remote hosts using the LOCATOR_IP_STRING property.

  11. Start the processes associated with SQLFire by running the following command:
    /etc/init.d/vfabric-sqlfire start

    By default, the process uses an evaluation license; if you have purchased a production license, see Activating vFabric SQLFire Licensing for information about configuring it in the /opt/vmware/vfabric-sqlfire/vFabric_SQLFire_10x/sqlfire.properties file. The RPM installation process creates a skeleton sqlfire.properties file to get you started.

    To stop, restart, and get status about the processes, pass the stop, restart, and status parameters, respectively, to the /etc/init.d/vfabric-sqlfire script:

    /etc/init.d/vfabric-sqlfire status