Pre-Installation Tasks

Before beginning the installation, the system must have been set up according to the System Requirements section of the documentation here. Additionally, the installation instructions described below assume that the volumes / partitions have been configured as listed in the Default Filesystem Layout section of the documentation here.

Important: The foothold distribution file (received by email) is required to get started. The email also includes a required password to unzip the foothold file. This file should be provided by Stibo Systems.

User Account Controls

If using Windows, the Use Account Control must be disabled during installation.

  1. Go to Control Panel > User Accounts > Change User Account Control settings and set notification to 'Never notify'.
  2. Restart server to activate settings.

Deploying the Installation Package

The foothold distribution file must be placed in a specific directory on the server to get started. This directory is referred to as STEP_HOME.

Important: The steps described in this topic must be executed on all servers included in the setup: Database, Application, and DTP servers.

Create STEP_HOME Directory

On Linux (as a root user)

  1. Go to /opt directory:
cd /opt
  1. Create stibo/step directories:
mkdir -p stibo/step

On Windows

  1. Go to E: drive
  2. Create stibo\step directories using Explorer or from command line:
mkdir stibo\step

Unzip Foothold Distribution File

The foothold zip file (<customer-name>-foothold.zip) must now be placed in the STEP_HOME folder. This can be done using SCP/SFTP (Linux) and FTP, or copy / paste through RDP (Windows).

On Linux (as root user)

  1. Go to the STEP_HOME directory created above:
cd /opt/stibo/step
  1. Unzip the foothold file using the supplied password:
unzip –P <password> <customer-name>-foothold.zip

On Windows

  1. Go to the STEP_HOME directory created above:
E: <enter>
cd stibo\step <enter>
  1. Unzip the foothold file by right-clicking the file and selecting Extract All. Enter the supplied password when prompted.

Now that the foothold distribution file has been deployed on all servers, the user can download and install third-party software and the STEP software.

Prepare SPOT and Download Installation Scripts

Prepare SPOT for the first time and download the installation scripts.

On Linux

Run the following commands:

[root@test step]# ./spot --wrapper
Generating wrapper /opt/stibo/step/spot with baked in JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.191.b12-1.el7_6.x86_64/jre
[root@test step]# ./spot --install
To apply this recipe 1 bundle(s) need to be installed.
The prepared recipe was stored as: /opt/stibo/step/admin/spot/recipes/prepared/2019-01-11-20-19-55.spr

On Windows

Run the following commands:

E:\stibo\step>spot --wrapper
Generating wrapper E:\stibo\step\spot.bat with baked in JAVA_HOME=E:\java\jdk8u192-b12
 
E:\stibo\step>spot --install
To apply this recipe 1 bundle(s) need to be installed.
The prepared recipe was stored as: E:\stibo\step\admin\spot\recipes\prepared\2019-01-11-20-19-55.spr

Results

After the last command has run, the following STEP_HOME/admin folder will be created:

STEP_HOME/
	|-- admin/
		|-- install/
		|      |-- apache-http-server/
		|      |-- config/
		|      |-- documentation/
		|      |-- oracle-database-11g/
		|      |-- oracle-database-12c/
		|      |-- oracle-instant-client/
		|      |-- oracle-single-server/
		|      |-- os-prerequisites/
		|      |-- pm/
		|      |-- step-audit
		|      |-- step/
		|      |-- step-database/
		|      |-- toolbox-backup/
		|      |-- toolbox-db/
		|      |-- tools/
		|-- install.pl
		|-- spot/
		|-- var/
			|-- <servername>/

These installation scripts comprise what is known as the Installation Package.