Administrator CLI

The StratusLab administrator command line client will help define parameters and perform the installation.

Installation

The first step is to install the StratusLab system administrator command line client from the StratusLab repository on the Front End:

$ yum install -y stratuslab-cli-sysadmin

This will install the system administrator client and all of the necessary dependencies. You can verify that it is correctly installed by doing the following:

$ stratus-config --help

Usage: stratus-config [options] [key [value]]
If the [value] is not provided, the command returns the current value
of the key.
...

Service Configuration

The command stratus-config will help you view and set the various parameters for the StratusLab installation. This is essentially an interface to the configuration file /etc/stratuslab/stratuslab.cfg and the associated reference file /etc/stratuslab/stratuslab.cfg.ref.

To list all of the defined parameters (keys) and their values use the command:

$ stratus-config --keys
...

This will display a long list of keys, their current values, and their default values, by section. You can view a single parameter by naming the parameter:

$ stratus-config frontend_system

and set it by giving a value:

$ stratus-config frontend_system centos

Each service has a parameter to determine whether the service will be installed. For example, the registration service:

$ stratus-config registration
False

is not installed by default. The values that should be set will be discussed in the following sections.

Service Installation

Once all of the service configuration parameters have been set, you can use the stratus-install command to perform the installation. This command should always be executed on the Front End. It will use SSH to access the machines (including the Front End!) where the services will be installed.

Normally, if errors occur in the installation, you can simply correct the configuration and rerun stratus-install.

This command is designed to simplify the initial installation of the cloud. It can be used also to update the cloud software, although there are some significant limitations when doing this. Notably there are certain parts of the configuration (like the address ranges) that cannot be updated automatically.