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.

Since it As this is a non appliance mode, you should 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 correct architecture type and make that all needed resources listed in system requirements available are made 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 by a 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 Installation from a different directory is possible. Ensure 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 /tmp directory in the Pre-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 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 Consider executing the following command: yum install ntp.

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

todo:hk why do we have yum install ntp twice in here?

  •   


Verify thar that 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 To find your server name, execute the command: hostname
  •   

Verify all required RPMs are installed

Verify the existence 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, you will need to add the containing repository. Run
Execute the following command: subscription-manager

repos

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

  •   


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

  •   


Ensure the httpd service is started - use 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 running 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 it the RPM yourself, using one of the following methods:
  • Method 1 - download the RPM
    • Find your httpd version : run by executin 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 RPM by executing 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 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 - particularly for data diskdisks

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


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 ports port access 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.



...

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 results of these checks results after installation, and perform all applicable optimizations. The compatibility checks report can be found in /installs/logs/logsapplianceappliance_checks-<date time>.log

Supported programs

...

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