Installing OOBC software

These steps explain how to install the OOBC software.

About this task

Install the OOBC software after you extract the OOBC installers and setup prerequisites. Navigate to the directory where you have unzipped the oobc.zip, the installer file (install.sh) is available in the same unzipped directory.

Important: Execute as a user with superuser privilege.

Procedure

Access the directory containing the OOBC installer. The location of the directory depends on where you unzipped the oobc.zip file. The path is: <OutOfBandChange>.
Run the OOBC installer by typing the following command and then clicking Enter:
```
./install.sh
```
The Installation path is requested for the new OOBC Run directory. Remember, multiple OOBC Run Directories can be installed:
```
Beginning install process for new OOBC Run directory:
/opt/OutOfBandChange/run1
```
Click Enter to accept the default path.
The installer requests Unix ownership. This user (Example: root) has to be able to read the input system log file.
```
Enter the Unix owner of the OOBC software? [root]
```
Click Enter to accept the default user provided, or enter an alternative user name.
The installer requests the Netcool Configuration Manager server name:
```
Enter the servername of the ITNCM? [FQDN]/hostname
```
Enter the server name where Netcool Configuration Manager is installed, and click Enter.
The installer asks if the Netcool Configuration Manager server is running HTTPS:
```
Is the ITNCM running a secure connection (https)? [no]
```
Type Yes or No to indicate whether Netcool Configuration Manager is being run on a server running HTTPS, and then click Enter.
The installer requests the port on which Netcool Configuration Manager is running:
```
What port is the ITNCM running on [16310]?
```
Enter the Netcool Configuration Manager port number, and click Enter.
The installer requests the user name of the user to be logged into Netcool Configuration Manager. The user has to exist with the appropriate activities assigned to the group:
```
What user do you want to login to the ITNCM as [OOBCUser]?
```
Enter the user that will be logged intoNetcool Configuration Manager, and click Enter.
The installer requests the password for the user specified in the previous step:
```
Enter clear text password:
```
Enter the Netcool Configuration Manager user password, and click Enter.
The installer requests the Worker Server (server on which Netcool Configuration Manager executes work) username:
```
Enter the worker user id ITNCM executes work as [Worker1]?
```
Click Enter to accept the default Worker User ID, and click Enter again. The value entered here will be skipped when present in the Syslog. If multiple user entries are required, additional values can be added under <ITNCM-users> after install.
The installer requests the Worker Server address:
```
Enter the worker server address[123.123.123.123]
```
Click Enter to accept the default Worker server address, or enter an alternative. Worker Servers are specified as IP addresses. If multiple Worker Server entries are required, additional values can be added under <worker-servers> after install.
The installer requests an authorized third party user ID. This user does not require notification when an activity is recorded.
```
Enter an authorized 3rd party user id that does not require notification
when activity is recorded in the syslog [3rdPartyUser]?
```
Click Enter to accept the default third Party User ID. If multiple user entries are required, then more values can be added under <authorized-users> after install.
The installer requests the path to the syslog file as input:
```
Enter the full path to the syslog file to be parsed:
[/var/log/messages]
```
Enter the path to the log, or click Enter to accept the default.
The installer requests the path to the syslog save file:
```
Enter the full path to the syslog saver file:
[/opt/OutOfBandChange/run1/log.syslog-messages]
```
Enter the path to the log, or click Enter to accept the default.

The installer displays a message similar to the following:

Example

ITNCM OOBC Install Properties:
Install Owner: root
Install Directory: /opt/OutOfBandChange/run1
ITNCM URL: iiop://FQDN/hostname:16310/
Syslog File: /var/log/messages
OOBC User: OOBCUser
User Password: d8adea5c67c7c9d4
ITNCM Worker: ITNCM
3rd Party User: 3rdPartyUser
Worker Server: 123.123.123.123
Syslog Message Storage File: /opt/OutOfBandChange/run1/log.syslog messages
Is this OK? (yes,no)
Yes

Type Yes and click Enter to accept the information.

Results

The installation proceeds and a message similar to the following displays once the install completes:

Copying Configuration Files
Setting permissions
BUILD SUCCESSFUL
Total time: 52 seconds

What to do next

If the installation of the OOBC software is successful your next task is to configure a daemon. Otherwise, read the troubleshooting installation issues to resolve the most commonly encountered OOBC installation issues.