Versions Compared

Key

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

...

Note
titleNon Appliance Mode Only

This The steps below are only applicable for installation in Non Appliance Mode

Note

Note: Since it .

As this is a non appliance mode, you should advise your Linux admin on how to perform the below commands

  • This step is only applicable for Non Appliance Mode
  • Make sure that you Verify that OS is RHEL v7.2 or CentOS v7.2 - 64 bit mode only as described in system requirements.
  • Make sure you choose the right Ensure to select the correct architecture type and made that all needed resources available as they appear listed in system requirements are made available.
  • Make sure Ensure you have at least one Network Card installed and configured with full access to a network service - such as DNS and NTP (the same as your IDGs) - see Network requirements
#SubjectActionChecked

Prepare Admin access

Installation must be done using performed by a root user.

you can NOT run it with sudo.
you can run it after running the command: su -
  •   

Configure OS locale

The supported OS locale is en_US.UTF-8.

Use the following procedure to make sure the supported locale configuration and change it if necessary



Prepare your installation file and env.environment

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

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

    • it should have Has at least 1GB of free space
    • it can Is NOT be one of this these folders:
      • /app
      • /logs
      • /data
      • /shared
      • /installs
  •   


Download the CEF file and transfer it to the /tmp directory in the Pre-on a freshly installed OS server.

  •   


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

Setup your network (consult your network admin)

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

  •   


Setup your NTP - make sure it is has to be the same used for your IBM DataPower Gateways. You should consider run command : yum install ntp.

  • Consult your Linux and Network admin on how the proper way to configure this service.
  • make sure the ntp rpm Ensure the NTP RPM is installed. Consider executing the following command: yum install ntp.
  •   


Verify that your the /etc/hosts file includes an entry with your server name mapped to your external or  internal (127.0.0.1)  server IP
  • you can discover To find your server name by running cmd, execute the command: hostname
  •   

Verify all required RPMs are installed

Verify the existence or Install of the following RPMs from the official RedHat/CentOS yum repositories:
  • httpd (and together with the following dependencies: mailcap, apr,httpd_tools)
  • mod_ssl
  • cURL
  • wget

If these are not found on your system - you will need to install them yourself. The installation is usually done with commandperformed by executing: yum install httpd.

If this command can not find the package is on account of it not being included in the repository make sure that the following repository is enabled using , you will need to add the containing repository.
Execute the following command: subscription-manager

repos

--enable=rhel-7-server-rh-common-rpms

  •   


Make sure Ensure the httpd service is enabled - use by executing the command: systemctl enable httpd.service

  •   


Make sure Ensure the httpd service is started - use by executing the command: systemctl start httpd.service 

  •   


Install mod_proxy_html
  • by default this rpm This RPM is not always accessible from existing repositories. Try first to install it - run by executing the command: yum install mod_proxy_html.
    if If you get the error "No package mod_proxy_html available. Error: Nothing to do" than , you should download it by yourself.
  • you have 2 options:
  • Option will need to download the RPM yourself, using one of the following methods:
  • Method 1 - download the rpmyou will need to know RPM
    • Find your httpd version before downloading by run executing the command: rpm -qa | grep httpd
    • you should see result like The system will print something resembling httpd-2.4.6-40.el7_2.4.x86_64. This is your version the mod_proxy version you need to download
    • Download the mod_proxy with the correct version from here - the following url:
      https://access.redhat.com/downloads/content/mod_proxy_html/2.4.6-45.el7/x86_64/f21541eb/package
    • make sure you have download the same version as the httpd.
    • you can download with (change the version part of the url
      to match the httpd version you found above). Use wget or any other mechanism as long as at the end the rpm reach to download, and ensure to place the RPM inside the /tmp directory of the Prepre-installed OS server.
    • Install the RPM with by executing the command:  rpm -Uvh mod_proxy_html-2.4.6-40.el7_2.4.x86_64.rpm
    Option
    • (Note: your version may vary, as described above)
  • Method 2 - add a repository and install it from the repository using the commands:
    • subscription-manager

      repos

      --enable=rhel-7-server-optional-rpms

    • yum

      install

      mod_proxy_html


  •   


OPTIONAL - Install kibana (kibana-4.5.1)

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

  •   

Prepare disk, mount points / file systems and logical volume


Info

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

For both Production and Non Production

installation

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 1 below

It is strongly recommended to use logical volume manager (LVM)

especially for data disk

- particularly for data disks.

This can be done during RHEL installation by choosing Installation Destination option. You will then need to select all Local Standard drives and choose option "I will configure partitioning" under the "Other Storage Options" section.

You should follow table 2 and add all mount points with required definitions using the "+" button.

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 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 Added

  •   

Open your firewall to access to DPOD server

Open To configure your firewall to for open access to the DPOD server for port 443. use , execute the following commands:

Note

This command might 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


To If, for any reason, you need to remove this access (close the port back) - execute the following commands:

firewall-cmd

--zone=public

--remove-port=443/tcp

--permanent

firewall-cmd

--reload

iptables-save

|

grep

443


Note

You should open ports port access for the DNS Server, your DataPower devices, your SMTP server and others as described in the following firewall rules.

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




Table 1 - Prepare your disk and mount points

File system / Mount point

Disk Name

/sys
/varsys
/tmp
sys
/bootsys
swapsys
/logsdataapp
/datadata
/sharedapp
/appapp
/app/tmpapp
/installsapp


Table 2 - Prepare your file system

folder
Directory /
mount AIO
Mount point

Light Edition

free space in GB

Recommended

Disk

Standard Edition - Minimal/Low/Medium/High

free space in

GB

Mib

Device

Type

File

System

/
2.02.0/logs1.010.0/var2.04.0/tmp1.02.0/data3.4

as described in Hardware and Software Requirements

minimum of 100GB

/shared0.50.5/app2.36.0/installs3.47.0/boot2.02.0swap3.08.0
sys4096LVMXFS
swapsys8192swapXFS
/varsys4096LVMXFS
/tmpsys2048 (recommended 16384)LVMXFS
/bootsys

2048

Standard

Partition

XFS
/sharedapp512LVMXFS
/appapp8096LVMXFS
/app/tmpapp4096LVMXFS
/installsapp8096LVMXFS
/logsapp12,288 (can be on other fast disk - preferred locally)LVMXFS
/datadata

As described in Hardware and Software Requirements

minimum of 100GB

LVMXFS
/boot/efi
For UEFI installations for GPT partition

Standard

Partition

EFI System

Partition

Installation Compatibility Checks

There are two types of checks: Critical and Informational.

The critical checks are mandatory in order to install the system, the . The informational checks are highly recommended for the system optimization.

Please make sure take time to review the results of these checks results after installation, and perform all applicable optimizations. The compatibility checks report can be found in /installs/logsappliancelogs/appliance_checks-<date time>.log

Supported programs

The only supported programs for installation on the DPOD server are infrastructure / system tools like Antivirus agents, Monitor Agents, Backup Agents etc.

Please note Note that these system tools may have implication on affect DPOD's functionality and performance.

In case of functionality / If you encounter functionality or performance issues, try first to disable these system tools.