IBM© DataPower Operations Dashboard v1.0.5.0

A newer version of this product documentation is available.

You are viewing an older version. View latest at IBM DPOD Documentation.

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 90 Next »

Non Appliance Mode Only

This steps are only applicable for Non Appliance Mode

Note: Since it is a non appliance mode, advise your Linux admin on how to perform the below commands

  • Ensure that your OS is RHEL v7.2 or CentOS v7.2 - 64 bit mode only as described in system requirements.
  • Ensure you select the correctt architecture type and make all needed resources in system requirements available.
  • 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 performed using root user.

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

Prepare your installation file and environment

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

Install from a different directory is possible. 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 /tmp directory in the Pre-installed OS server.

  •  


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

Setup your network (consult your network admin)

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

  •  


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

  • Consult your Linux and Network admin on how to configure this service.
  • Make sure the ntp RPM is installed : yum install ntp
  •  


Verify thar the /etc/hosts file includes an entry with your server name mapped to your external or  internal (127.0.0.1)  server IP
  • Run the command hostname to find your server name
  •  

Verify all required RPMs installed

Verify the existence of the following RPMs from the official RedHat/CentOS yum repositories:
  • httpd (and 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 command: yum install httpd.

If the package is not included in the repository, you will need to add the containing repository. Run the following command:

subscription-manager repos --enable=rhel-7-server-rh-common-rpms
  •  


Ensure the httpd service is enabled - use command: systemctl enable httpd.service

  •  


Ensure the httpd service is started - use command: systemctl start httpd.service 

  •  


Install mod_proxy_html
  • This RPM is not always accessible from existing repositories. Try first to install it by running 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 it yourself, using one of the following methods:
  • Method 1 - download the RPM
    • Find your httpd version: run the command: rpm -qa | grep httpd
    • The system will print something resembling httpd-2.4.6-40.el7_2.4.x86_64 . This is the mod_proxy version you need to download
    • 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 RP. Run the command :  rpm -Uvh mod_proxy_html-2.4.6-40.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:
    • subscription-manager repos --enable=rhel-7-server-optional-rpms
    • yum install mod_proxy_html


  •  

Prepare disk, mount points / file systems

and logical volume

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

You 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

The minimum file system sizes for the different installation types are described in table 2 below

  •  

Open your firewall to access to DPOD server

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

This command might 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 you need to remove access (close the port):

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


You should open ports for the DNS Server, your DataPower devices, your SMTP server and others as described in 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
/logsdata
/datadata
/sharedapp
/appapp
/installsapp


Table 2 - Prepare your file system

folder / mount point

Light Edition

free space in GB

AIO Edition - Minimal/Low/Medium/High

free space in GB

/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.0
swap3.08.0

Installation Compatibility Checks

There are two types of checks: Critical and Informational.

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

Please take time to review the checks results after installation, and perform all applicable optimizations . The compatibility checks report can be found in /installs/logsappliance_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.

Note that these system tools may affect DPOD's functionality and performance.

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







  • No labels

IBM© DataPower Operations Dashboard (DPOD) v1.0.5.0