How to Use Setup Scripts

How to Install / Upgrade SPS Using the Setup Script

To install or upgrade SPS, follow the steps below.

Interactive Mode

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

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

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

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. Change to the directory where sps.img is mounted and enter the following command. First you will need to run setup in Interactive Mode, with the “Save Configuration” (-s) option:

./setup -s <config_file>

Select the necessary packages and options and complete setup. A configuration file will be saved in the location you specified. This configuration file can be copied to other systems and used as follows.

3. On the system where you wish to perform a non-interactive install, enter the following command:

./setup -f <config_file> -q y

The “-q y” option ensures that user prompts are skipped, and the default answers given.

*Note: When using a configuration file for non-interactive installations the system on which the file is used must be configured the same as the system on which the file was generated. If the systems have too many difference the non-interactive installation may fail.

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 / 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.
Load	Loads a saved configuration 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.

• Restart NFS Service

When configuring High Availability NFS, restarting the NFS services is required. When this is selected, the services are restarted automatically after the configuration is completed.

Note: If you do not want to restart the NFS services automatically, a restart will need to be done to pick up the configuration changes before using the NFS Recovery Kit.

• Use Quorum / Witness Functions

Use Quorum / Witness for I/O fencing. For details, please refer to Quorum/Witness in the technical documentation.

• LifeKeeper Authentication

Specify the users allowed to log in to the SPS for Linux 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 SPS for Linux 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, SPS for Linux will be started when the installation is completed.

*Note: Because the SPS-L Data Replication package may install kernel modules for some of the supported OS distributions, a re-install of SPS-L may be required when the kernel is upgraded. This applies to OS distributions for RedHat, CentOS and Oracle Enterprise Linux (non-UEK kernels only) running kernel versions 3.10.0-514 or later.

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.

Repair Installation

To repair an SPS for Linux 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 <file>

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

• -s <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 <file>

Select the necessary packages and options and complete setup.

Then run:

setup -f <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 SPS for Linux.

• -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.
Networking	A group of recovery kits that protect network services in the cloud such as EC2 and Route53.
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.