Pre-Installation Tasks

Download Quantum Fabric Installer

Download QuantumFabricSetup.tar.gz file from downloads site and extract the file. To download Quantum Fabric installer from the community portal, follow these steps:

  1. Log in to Downloads. You can obtain a user name and password from your sales representative or partner.
  2. Click the Quantum Fabric tab.
  3. Select the specific release version from the Quantum Fabric Installer (Consolidated Installer for all features) drop-down list and then click on the specific release related files you want to download. For example, if you want to download Quantum Fabric 9.0.0.0 GA installer, select the 9.0.0.0 GA version from the drop-down list, and then click the Installer_Linux link. .

    The QuantumFabricSetup.tar.gz file contains the following files:

    • QuantumFabricInstaller-x.x.x.x_GA.bin
    • installer.properties - This file is required for silent installation.
    • README.txt

Memcached Server

Memcached is a high-performance, distributed memory object caching system, generic in nature, but intended for use in speeding up dynamic web applications by alleviating database load.

libevent (memcached dependency)

The libevent API provides a mechanism to execute a callback function when a specific event occurs on a file descriptor or after a timeout has been reached. Furthermore, libevent also support callbacks due to signals or regular timeouts.

libevent is meant to replace the event loop found in event driven network servers. An application just needs to call event_dispatch() and then add or remove events dynamically without having to change the event loop. For more information, refer to http://libevent.org/

To install libevent (memcached dependency), follow these steps:

  1. First, check whether libevent is installed on your computer. To check, type the following command in your Linux terminal:
    whereis libevent
  2. If you do not find libevent on your system, download and install libevent-1.4.8-stable.tar.gz. For more information, refer to http://libevent.org/
  3. Extract the downloaded archive file.
  4. In your Linux terminal, type the following commands:
    cd libevent-1.4.8-stable

./configure
make
make install
  5. Type the following command to create a symlink to libevent.
    ln -s /usr/local/lib/libevent-1.4.so.2 /usr/lib

Now that you have installed the dependencies, install the memcached server.

Install Memcached Server

To install Memcached Server, follow these steps:

  1. Download the Memcached server. For more information, refer to https://memcached.org/
  2. Extract the downloaded archive file.
  3. Open the Linux terminal.
  4. Go to the ../memcache directory.
  5. Run the following command:
    tar xfz memcached-1.2.6.tar.gz
cd memcached-1.2.6
./configure
make
make install
memcached -d -m 1024 -u root -l 127.0.0.1 -p 11211

    IMPORTANT: Run Memcached as a daemon (d = daemon, m = memory, u = user, l = IP to listen to, p = port)

Configure Load Balancers for Sending Host Information in Multinode

When user is installing Quantum Fabric on multinode environment, the user should check whether the parameter: proxypreserveHost is set to On in the Loadbalancer configuration file to send host in the headers.

If the proxypreserveHost is not configured, the loadbalancer will not send host in the headers. Users cannot launch Quantum Fabric Console.

The above configuration is based on the loadbalancer.

For example:

  • For Apache: preserveHost On
  • For HAProxy: preserve host flag is not required.

Steps before installing (or) upgrading Fabric with an existing database

Perform the following activities before installing (or) upgrading Quantum Fabric with the existing database:

  • Take a backup of your database.
  • Make sure you have a previously installed directory.
  • Take a backup of the applications that are deployed at the server level. After the installation is complete, take a backup of the changes that were made to the binaries.
  • After the installation or upgrade process is complete, replace the old authService.key, workspaceService.key, and ACCOUNTS_ENCRYPTION_KEY keys.
    This is only applicable for the identity and workspace components.

Create /tmp Folder

Quantum Fabric Installer requires a /tmp folder in a Linux environment to unpack the installer. When the /tmp folder is not found, the Installer displays an I/O exception at the time of unpack exception.

This must be specified in the pre-req of installation. Installation requires temp folder to unpack MF installer (either default / custom temp folder).

 

For Database and App Server related pre-installation tasks, refer to the following sections: