How to Use Setup Scripts

To install or upgrade LifeKeeper SSP, follow the steps below.

How the Setup Scripts Works

1. Interactive installation
   Configure and install LifeKeeper from the menu.
   If you save the configuration information at this time, it can be used for the non-interactive installation described below.

2. Non-interactive installation
   Install LifeKeeper using the saved configuration information.
   Since no inquiry to the user occurs, you can perform this using a building tool (e.g. Ansible).

How in Install / Upgrade LifeKeeper SSP Using the Setup Script

Interactive Installation

1. After logging in as the root user, use the following command to mount the sps.img file:

mount <PATH/IMAGE_NAME> <MOUNT_POINT> -t iso9660 -o loop

Where PATH is the path to the image
IMAGE_NAME is the name of the image
MOUNT_POINT is the path to mount location

2. Change to the directory where sps.img is mounted and enter the following:

./setup [-s <response_file>]

When the -s option is specified, you can save your configuration information in the response_file, which is used for a non-interactive installation.

3. The script collects information about the system environment and determines what you need to do to install LifeKeeper SSP.

If the system requirements for installation or upgrade are not satisfied, then an error message is displayed and the installation / upgrade is cancelled.

Also, if some restrictions arise or a configuration change is required, a warning message will be displayed requiring the user to decide whether to continue or abort the installation.

4. Select the LifeKeeper SSP features and Application Recovery Kits (ARKs) to install via the main dialog screen.

Please refer to How to Use the Dialog Screen.

5. Once all the required LifeKeeper SSP features and ARKs have been selected, select <Done> to begin the installation.

If any notifications are output when the installation completes, please take the necessary actions to correct them.

Non-interactive Installation

1. After logging in as root user, use the following command to mount the sps.img file:

mount <PATH/IMAGE_NAME> <MOUNT_POINT> -t iso9660 -o loop

PATH is the path to the image
IMAGE_NAME is the name of the image
MOUNT_POINT is the path to mount location

2. After copying the configuration file to the system where you want to install LifeKeeper, run the following command:

./setup -f <response_file> -q y

The “-q y” option gives the answer that the warning has been noted.

*If you use a configuration file saved with the -s option for a non-interactive installation, the system on which the file is used must be configured the same way as the system on which the file was generated. If the systems have too many differences the non-interactive installation may fail. The configuration file created with the create_response_file script has no such restrictions.

How to Use the Dialog Screen

The dialog screen is displayed below.

Use the following keys to navigate the menu.

↑ ↓	Navigate between menu items
←　→	Navigate between the menu buttons at the bottom of the screen
ENTER	Open the selected sub menu
Y / N / ENTER / SPACE	Turn on, turn off or invert the selected item

The menu buttons at the bottom of the screen are used for the following operations.

Select	Opens a sub menu dialog screen
Done	Closes the current screen and returns to the previous screen. Selecting this button on the main screen completes the configuration.
Help	Displays help for the highlighted item
Save	Saves the current settings in a configuration file. The saved configuration file can be used for non-interactive installations. The full path to the file where the configuration information is to be saved should be specified. (Disabled for create_response_file)
Load	Loads a saved configuration file (Disabled for create_response_file)

The “Save” and “Load” menu buttons display a dialog screen asking for a configuration file name for use in saving the current configuration or for loading a saved configuration. If you want to change the default file name provided, move to the file name field using the [TAB] key, and enter a new name. Note: The “Save” operation will prompt for confirmation before overwriting a file with the same name.

The items listed below are configurable during installation. During an upgrade only items that can be configured are listed. Using the hotkey <Z> will show those items that will remain unchanged during the upgrade.

• Install Java Runtime (JRE)

Install the Java runtime environment used by the LifeKeeper GUI.

• LifeKeeper Authentication

Specify the users allowed to log in to the LifeKeeper SSP GUI along with their privilege levels. Multiple user accounts can be specified by separating them with blanks. For details, refer to GUI User Settings.

• Install License Key File(s)

Install the licenses required to start LifeKeeper SSP by entering the path name of the license file to install. Multiple files can be specified by separating them with spaces.

Please refer to Licensing for details.

• Recovery Kit Selection

Select the Application Recovery Kits to install.

Application Recovery Kits are broken into several categories based on common functionality.

Please refer to Categories for Application Recovery Kits for details.

• LifeKeeper Startup After Install

When selected, LifeKeeper SSP will be started when the installation is completed.

Adding / Removing Application Recovery Kits

To add Application Recovery Kits after completing an installation, simply execute setup, select the Recovery Kit in the Recovery Kit Selection, followed by the Application Recovery Kit Category and then select the desired kit.If you deselect an Application Recovery Kit which is no longer necessary, that kit will be removed. However, since the kit cannot be removed for the resources in use, delete the resources in advance.

Repair Installation

To repair a LifeKeeper SSP installation run setup with the “—force” option. A repair installation will update the installation replacing any lost or corrupted files.

setup Script Options

The setup script can be executed with the following options:

• -f <response_file>

Install non-interactively. <response_file> contains the configuration information to use during the installation.

• -s <response_file>

Save a configuration file containing your menu selections. This file can then be used with the “-f” option to install the same LifeKeeper configuration to another system. For example, run:

setup -s <response_file>

Select the necessary packages and options and complete setup.

Then run:

setup -f <response_file> -q y

to run a silent installation of LifeKeeper (on another system) with the same options that were selected the first time setup was run.

• —force

Forcibly reinstall LifeKeeper SSP.

• -q <y/n>

Specifies the response to any confirmation questions that may arise during non-interactive installation.

Categories for Application Recovery Kits

Category	Description
Application Suite	A group of recovery kits that protect applications such as SAP and IBM MQ.
Database	A group of recovery kits that protect database applications, including, but not limited to, Oracle, PostgreSQL, and MaxDB.
File Sharing	A group of recovery kits that protect file sharing services such as NFS and Samba.
Mail Server	A group of recovery kits that protect email services such as Postfix.
Storage	A group of recovery kits that protect data storage methods, including, but not limited to, DataKeeper (replication), Device Mapper (DM) Multipath (DMMP), and Network Attached Storage (NAS).
Web Server	A group of recovery kits that protect web services such as Apache.

Copyright © 2024 SIOS TECHNOLOGY CORP.