Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note
titleNon Appliance Mode Only

The steps below are only applicable for installation in Non-Appliance mode, and should be performed by your Linux administrator.


SubjectAction
Supported operating system

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

Resources allocation

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

Network card

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.

SubjectActionPrepare Admin

Root access

Installation must be performed by a root user.

You can NOT run it with sudo.
You can run
However, you may run it after running the command: su -
Prepare disk

Disks, mount points / file systems and logical

volume

volumes


Info

Tuning requirement - define 3 Disks with LVM and with size and mount points as defined below

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

You will need to allocate the

following

mount points / file systems on the different disks as described in

table

Table 1 below

. It is strongly recommended to use logical volume manager (LVM) - particularly for data disks.

This can be done


To create the mount points / file systems during RHEL installation

by choosing Installation Destination option. You will then need to select

:

  • Choose Installation Destination option.
  • Select all Local Standard drives and choose option "I will configure partitioning" under the "Other Storage Options" section.
You should follow
  • Follow table 2 and add all mount points with required definitions using the "+" button.
to
  • To create a volume group (sys, app, data) open the "Volume Group"list box and choose "create new volume group ..."
  • This way you can partition your 3 (logical) drive exactly as stated in table 2.
The minimum file system sizes for the different installation types are described in table 2 below


After configuring the required mount points / file systems you can use the command "df -h" to make sure all free space requirements are met.

Your mount point configuration should resemble the following :

Image RemovedPrepare

Tuning requirement - define 3 Disks with LVM and with size and mount points as defined below

Store service dedicated OS user and group

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

User can use

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

Configure
OS locale

The supported OS locale is en_US.UTF-8.

Use the following procedure to check the

supported locale configuration

OS Locale Configuration and change it if necessary.

Prepare your installation

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

directory

) 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
command
  • 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

Verify all required

Required RPMs

are installed

Verify the existence of the following RPMs from the official RedHat/CentOS yum repositories:
  • 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

only -

Execute

 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

Ensure the httpd service is started by executing the command:

&& systemctl start httpd.service

 


Install mod_proxy_html:
  • 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
url
to
      • 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 (
RedHat Only
    • For RedHat only)
      • subscription-manager repos --enable=rhel-7-server-optional-rpms

      • yum install mod_proxy_html

OPTIONAL - Install kibana oss (kibana-oss-6.6.1)

Optional: Install Kibana OSS

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

.

:

6
6

Configure

kibana

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

Open your firewall to
Firewall access to DPOD server

To configure your firewall

for open

to allow access to

the

DPOD server

for

at port 443, execute the following commands:

Note

These commands may not be applicable if your system has no builtin firewall.

firewall-cmd --zone=public --add-port=443/tcp --permanent
firewall-cmd --reload
iptables-save | grep 443


If, for any reason, you need to remove this access (close the port) - execute the following commands:
firewall-cmd --zone=public --remove-port=443/tcp --permanent
firewall-cmd --reload
iptables-save | grep 443


Note

You should open port access for the DNS Server, your DataPower

devices

Gateways, your SMTP server and others as described in

firewall rules

Firewall Requirements.

Please assist your network admin and Linux admin to enable access on these ports.



Table 1 - Prepare your

...

file system

Directory / Mount
point
Point

Disk

Name/sys/var

Space in Mib

Device Type

File System

biosbootsys
/tmp
2
sys/bootsys
Standard PartitionBIOS BOOT
swapsys
/logsapp
8192LVMswap
/
data
boot
data
sys
/shared

2048

app/appapp

Standard Partition

XFS
/
app
boot/
tmp
efi
app
sys
/installsapp

Table 2 - Prepare your file system

Directory / Mount point

Recommended

Disk

Standard Edition - Minimal/Low/Medium/High

free space in Mib

Device

Type

File

System

200
(for UEFI installations for GPT partition)

Standard Partition

EFI System Partition

/sys4096LVM
XFSswapsys8192swap
XFS
/varsys4096LVMXFS
/tmpsys2048
(recommended 16384)
LVM
XFS/bootsys

2048

Standard

Partition
XFS
/sharedapp512LVMXFS
/appapp8192LVMXFS
/app/tmpapp4096LVMXFS
/installsapp8192LVMXFS
/logsapp

12,288
(can be on other fast disk - preferred locally)

LVMXFS
/datadata

As described in Hardware and Software Requirements
minimum of 100GB

LVMXFS
/boot/efidata

For UEFI installations for GPT partition

200

Standard

Partition

EFI System

Partition

Installation Compatibility Checks

...