DCAP Central 4.1

Installing on RHEL 7

Important

MongoDB Client 3.6 is required.

If any version of MongoDB clients/tools other than 3.6 is running on the local system, it must be replaced with MongoDB version 3.6; otherwise, compatibility issues may occur.

If it is not possible to modify the current installation, contact jSonar Support prior to moving forward with the installation.

This section describes installation procedures for DCAP Central via either package repository or static installer. Uninstall any existing Mongo tools or components and follow the installation instructions described below.

Note

After the packages are installed, the DCAP Central setup script (sonarg-setup) will prompt for several inputs (see Information Required for Setup); it is recommended to gather this information prior to running sonarg-setup.

To install DCAP Central via package repository:

  1. Enable Extra Packages for Enterprise Linux (EPEL):

    sudo rpm -U https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
  2. Add the appropriate DCAP Central repositories, as shown below.

    1. Add the jSonar Repository:

      sudo cat <<'EOF' | sudo tee /etc/yum.repos.d/jsonar.repo
      [Jsonar]
      name=Jsonar Repository
      baseurl=http://<your user name>:<your password>@rpm.jsonar.com/
      enabled=1
      priority=1
      gpgcheck=0
      EOF
    2. Add the rsyslog repository:

      sudo cat <<'EOF' | sudo tee /etc/yum.repos.d/rsyslog.repo
      [rsyslog_v8]
      name=Adiscon CentOS-$releasever - local packages for $basearch
      baseurl=http://rpms.adiscon.com/v8-stable/epel-7/$basearch
      enabled=1
      gpgcheck=0
      gpgkey=http://rpms.adiscon.com/RPM-GPG-KEY-Adiscon
      protect=1
      EOF
    3. Add the Data Analytics Acceleration Library (DAAL) repository:

      sudo cat <<'EOF' | sudo tee /etc/yum.repos.d/intel-daal-core-2018.1-163.repo
      [intel-daal-core-2018.1-163]
      name='Intel(R) Data Analytics Acceleration Library'
      baseurl=https://yum.repos.intel.com/daal
      enabled=1
      gpgcheck=1
      repo_gpgcheck=1
      gpgkey=https://yum.repos.intel.com/daal/setup/PUBLIC_KEY.PUB
      debuglevel=10
      enabled=1
      EOF
    4. Add the Math Kernel Library (MKL) analytics repository:

      sudo cat <<'EOF' | sudo tee /etc/yum.repos.d/intel-mkl-core-2018.1-163.repo
      [intel-mkl-core-2018.1-163]
      name='Intel(R) Math Kernel Libray'
      baseurl=https://yum.repos.intel.com/mkl
      enabled=1
      gpgcheck=1
      repo_gpgcheck=1
      gpgkey=https://yum.repos.intel.com/mkl/setup/PUBLIC_KEY.PUB
      debuglevel=10
      enabled=1
      EOF
    5. Add the MongoDB 3.6 repository:

      Notice

      DCAP Central requires version 3.6 of MongoDB.

      sudo cat <<'EOF' | sudo tee /etc/yum.repos.d/mongodb-org-3.6.repo
      [mongodb-org-3.6]
      name=MongoDB Repository
      baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.6/x86_64/
      gpgcheck=1
      enabled=1
      gpgkey=https://www.mongodb.org/static/pgp/server-3.6.asc
      EOF

      Note

      DCAP Central only requires "mongodb-org-shell" and "mongodb-org-tools"; these two dependencies will be installed at the same time as DCAP Central.

  3. Get PGP public keys for Analytics and MongoDB:

    Note

    This step requires wget. To find out if the wget package is installed on your system, run rpm -qi wget. If wget is not installed, install it by running the following command:

    sudo yum install wget
    wget https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS-2019.PUB
    sudo rpm --import GPG-PUB-KEY-INTEL-SW-PRODUCTS-2019.PUB
    sudo wget https://www.mongodb.org/static/pgp/server-3.6.asc
    sudo rpm --import server-3.6.asc
  4. Install DCAP Central:

    sudo yum -y install sonarg |& tee sonarg-install.out
DCAP Central Setup (Package Repository Installation)

Notice

If you are installing a HADR system, do not run setup yet; see Disaster Recovery for DCAP Central for full HADR installation instructions.

DCAP Central is now installed.

To setup/configure DCAP Central:

  1. Disable port blocking by RHEL firewall:

    sudo iptables -F
  2. Run the following command:

    sudo sonarg-setup
  3. Restart the rsyslog service:

    sudo systemctl restart rsyslog

To install DCAP Central via static installer:

  1. Download the installer / tarball to the target server.

  2. Run the install script shown below. Note: For more installation options, see step 3.

    sudo ./rhel7_install.sh |& tee install.log
  3. Tip

    Several additional options are available when running the installation script:

    • You can view the various arguments for the installation script via the following command: sudo ./rhel7_install.sh -h

    • -t/--test will run the installer in "test" mode. Nothing will be installed, and a report will be generated providing information about installation success and any potential installation issues.

    • -d/--disable_repositories will ignore all existing RHEL repositories and use only packages provided in the tarball.

    • -r/--redirect requires a target directory; this will install all non-system packages and files required for the Sonar Application to the provided directory. This will only work on a new installation, not on upgrade.

  4. When you run the install script, you will be asked to identify whether or not the installation is an upgrade, and to select a tarball for installation.

  5. You can review the install.log file to verify whether or not any errors occurred during installation.

    Note

    sudo view install.log
DCAP Central Setup (Static Installer / Tarball Installation)

Notice

If you are installing a HADR system, do not run setup yet; see Disaster Recovery for DCAP Central for full HADR installation instructions.

After the installation process is completed, run the setup script:

sudo sonarg-setup