Verify that your operation system is one of the supported operating systems described in System Requirements.

Ensure to select the correct architecture type and that all resources listed in System Requirements are made available.

Ensure you have at least one network card installed and configured with full access to network services such as DNS and NTP (the same as your Gateways) - see Network Preparation.

Root access

Installation must be performed by a root user.

Disks, mount points / file systems and logical volumes

For both Production and Non Production installations, the Standard Edition requires 3 disks (LUNs / physical / virtual) to support throughput.

The Store service requires a dedicated OS user and group to run.

Consider executing the following command:
groupadd storeadms && useradd -g storeadms -md /home/storeadm -s /bin/bash storeadm

The supported OS locale is en_US.UTF-8.

Use the following procedure to check the OS Locale Configuration and change it if necessary.

Installation file and environment

Ensure your /tmp directory has at least 1GB of free space

Installation from a different directory is possible. If you opt to run the install from a directory other than /tmp, ensure that this directory:

• • Has at least 1GB of free space
  • Is NOT one of these folders: /app, /logs, /data, /shared, /installs

Download the CEF file and transfer it to the installation directory (e.g. /tmp) on the pre-installed OS server.

Execute the following command from the pre-installed OS server terminal:
chmod 755 ./<File Name>

Setup your network (consult your network admin)

Setup DNS - your network admin may need to assist you with this action.

Setup NTP - it has to be the same used for your IBM DataPower Gateways.

• Consult your Linux and network admin about the proper way to configure this service.
• Ensure the NTP RPM is installed. Consider executing the following commands:
  yum install ntp
  ntpdate <ntp server hostname>
  systemctl enable ntpd.service
  systemctl start ntpd.service 

Verify that the /etc/hosts file includes an entry with your server name mapped to your external server IP.

To find your server name, you may execute the command: hostname

Required RPMs

• httpd version 2.4.6-67 and above (together with the following dependencies: mailcap, apr, httpd_tools)
• mod_ssl
• curl
• wget
• unzip
• iptables
• iptables-services
• bc
• fontconfig

The installation is usually performed by executing:
yum install httpd mod_ssl curl wget unzip iptables iptables-services bc fontconfig

If this command can not find the package on account of it not being included in the repository, you will need to add the containing repository or manually download the RPMs files and install them.
For RedHat only - consider executing the following command:
subscription-manager repos --enable=rhel-7-server-rh-common-rpms

Ensure the httpd service is enabled and started by executing the command:
systemctl enable httpd.service && systemctl start httpd.service

• This RPM is not always accessible from existing repositories. Try first to install it by executing the command: yum install mod_proxy_html
  If you get the error "No package mod_proxy_html available. Error: Nothing to do", you will need to download the RPM yourself, using one of the following methods:
  • Method 1 - download the RPM
    • Find your httpd version by executing the command: rpm -qa | grep httpd
    • The system will print something resembling httpd-2.4.6-67.el7_2.4.x86_64. This is the mod_proxy version you need to download.
    • For RedHat only - Download the mod_proxy with the correct version from the following url:
      https://access.redhat.com/downloads/content/mod_proxy_html/2.4.6-45.el7/x86_64/f21541eb/package (change the version part of the URL to match the httpd version you found above). Use wget or any other mechanism to download, and ensure to place the RPM inside the /tmp directory of the pre-installed OS server.
    • Install the RPM by executing the command:  rpm -Uvh mod_proxy_html-2.4.6-67.el7_2.4.x86_64.rpm (Note: your version may vary, as described above)
  • Method 2 - add a repository and install it from the repository using the commands (For RedHat only)
    

    • subscription-manager repos --enable=rhel-7-server-optional-rpms

    • yum install mod_proxy_html

Optional: Install Kibana OSS

This RPM is required only if you would like to manually query the Big Data store:

• Download the RPM from: https://artifacts.elastic.co/downloads/kibana/kibana-oss-6.8.1-x86_64.rpm
• Please follow instructions on https://www.elastic.co/guide/en/kibana/6.8/rpm.html#install-rpm

Configure Kibana (edit kibana.yml):

server.port: 5601
server.host: "montier-es-http"
server.basePath: "/op/kibana"
elasticsearch.hosts: "http://montier-es-http:9200"
elasticsearch.shardTimeout: 300000