Installing the Software

This document will guide you through the installation of the LifeKeeper for Linux and assumes the user has basic knowledge of the Linux operating system. Please refer to the LifeKeeper for Linux product documentation for more information.

Pre-Installation Requirements

Before installing LifeKeeper for Linux, please check the following:

• LifeKeeper for Linux Release Notes -The Release Notes include supported platforms, operating systems, applications, and storage. They also include the latest features and Bug Fixes.
• TCP/IP Connection and Name Resolution – In order to use the GUI function, both cluster nodes need to be able to resolve the name. Use the DNS service or /etc/hosts for name resolution. Also, localhost needs to be resolved to 127.0.0.1.
• Firewall – The following ports are used:
  • Communication Path (TCP): 7365/tcp
  • Communication of a GUI Server: 81/tcp、82/tcp
  • RMI Communication between the GUI Server and Client: all the ports after 1024/tcp
  • Synchronization of DataKeeper (when using DataKeeper): “10001+<mirror number>+<256 * i>”

More Firewall Information

• The port used for communication with the GUI server and a client needs to be open on the cluster node where LifeKeeper is installed and on all systems where the GUI client runs.
• The ports used by DataKeeper can be calculated using the formula above. The value of i starts at 0 and uses an unused port when found. For example, in an environment where a DataKeeper resource with mirror number 0 exists, if port 10001 is being used by another application, port 10257 will be used.
• For communication between the GUI server and a client, Java RMI (Remote Method Invocation) randomly uses ports 1024 and above. When applying access control etc. to a cluster system, packet filtering needs to be performed considering these ports. If this specification is an issue from a security standpoint, you can use ssh X forwarding. Please refer to the Technical Documentation for the setting details.
• Add the following to the port numbers you are using: WebGUI server process and policy setting with the lkpolicy command : 778(SSL) /tcp

• Check the SELinux Setting
  • Enabled (enforcing or permissive mode)
    • LifeKeeper installer will set mmap_low_allowed to “on”.
    • Please make sure that the application(s) to be run on the cluster support the SELinux mode. While LifeKeeper has been tested with some ARKs in permissive and enforcing mode it is important for the system administrator to validate the SELinux mode supported by all applications in the cluster.
      • SELinux enforcing mode has been tested on the following ARKs: DataKeeper / IP / Filesystem / EC2
      • SELinux permissive mode has been tested on the following ARKs: SAP / SAP MaxDB / Sybase / Oracle / DB2 / NFS / DataKeeper / NAS / EC2 / IP / FileSystem / MQ
      • Refer to Linux Dependencies for required packages.
  • Disabled
  • For more information refer to SELinux
• The sg3_utils package is required for environments using recovery kits for Multipath such as the DMMP Recovery Kit and the PowerPath Recovery Kit. This is not required for environments where recovery kits for Multipath are not used.

• Check Known Issues – Please make sure that there are no known issues for your environment.

Installing LifeKeeper for Linux

Install the LifeKeeper software on each server in the LifeKeeper configuration.

Packages that LifeKeeper is dependent on are installed automatically because the LifeKeeper installation setup script uses package manager tools (yum or zypper) to ensure installation of all dependent packages.

!IMPORTANT:  A functional yum or zypper configuration is required for the successful installation of LifeKeeper. A non-functional configuration can result in an installation failure (see Installation Known Issues for more information). Additionally, the package manager repo or rpm database must not be locked as that could cause the install to hang. If the dependent packages cannot be installed automatically via the package manager, refer to Linux Dependencies and install the necessary packages in advance.

The LifeKeeper for Linux image file (sps.img) provides a set of installation scripts designed to perform the user interactive system setup tasks that are necessary when installing LifeKeeper on your system (see Interactive Mode for more information). A non-user interactive install can be performed as well (see Non-interactive Mode for more information).

A licensing utilities package is also installed providing utilities for obtaining and displaying the Host ID or Entitlement ID of your server. Host IDs and/or Entitlement IDs are used to obtain valid licenses for running LifeKeeper. Refer to Licensing for information on how to obtain and install your licenses.

*Note: These installation instructions assume that you are familiar with the Linux operating system installed on your servers.

!IMPORTANT:
• Installing LifeKeeper on your shared storage is not supported. Each server should have its own copy installed on its local disk.
• All LifeKeeper packages are installed in the directory /opt/LifeKeeper.

LifeKeeper will be installed through the command line regardless of the Linux distribution you are operating under.

• Please refer to How to Use Setup Scripts for the installation activities.
• For upgrade installations, see Upgrading LifeKeeper.