On UNIX, startup
scripts are available to automatically start the process agent when
the system starts.
Before you begin
You can modify the startup scripts before you install them, if required.
Tivoli Netcool/OMNIbus Version 8.1.0.23
supports systemd style startup scripts, used on RHEL V7 and SuSE V12 onwards.
On Linux versions that are based on
init.d startup scripts, such as RHEL V6 and
SuSE V6 and previous versions, modify the startup script called
nco for the
version of Linux® that you are using. The script contains
sections for either the Red Hat and SUSE versions of Linux, and these sections are delimited with
comments within the script as
follows:
### REDHAT ONLY
...
### END REDHAT ONLY
### SUSE ONLY
...
### END SUSE ONLY
Note
that the script contains a number of separate sections for the Red Hat and SUSE versions of Linux.
Also on Linux, modify
the nco script if you are using Plugable Authentication
Modules (PAM) for authentication by adding the -authentication
PAM argument to the script. For the default UNIX authentication,
you do not need to add anything.
About this task
These scripts are located in the following directory:
$NCHOME/omnibus/install/startup
This directory contains one of the following installation scripts, depending on the operating
system:
- aix5install
- solaris2install
- linux2x86install
- linux2s390install
To use the process agent startup scripts, you must run
the appropriate installation script for your operating system. (You
might need to make the script executable before running it.)
To install the process agent startup scripts:
Procedure
- Run the installation script as the root user.
Linux x86: To install the scripts on Linux
x86, run linux2x86install from the
$NCHOME/omnibus/install/startup location.
The following output
is displayed:
Enter value for $NCHOME [/opt/IBM/tivoli/netcool]:
Press Enter to
accept the default $NCHOME location or enter another $NCHOME location. The following output is
displayed:
Install systemd scripts? Enter 'n' to install init.d instead (y/n)? [y]
Press
Enter to accept the default value or
'n' to attempt to install the
init.d.
Note: If selecting 'n' to try and use
init.d, the required checks will fail on some newer versions of Linux as a required
executable does not exist.
The following output is
displayed:
This script copies a startup script into the /etc/systemd/system directory to enable
you to automatically start and stop Netcool/OMNIbus processes.
It does this by:
Copying linux2x86/etc/systemd/system/nco.service to /etc/systemd/system
Running "systemctl enable nco"
Do you wish to continue (y/n)? [y]
Press Enter to accept the default value and
continue or 'n' to abort the startup script installation process.
The following
output is displayed:
Name of the Process Agent Daemon
[NCO_PA]
Solaris: To install the scripts on
Solaris, run solaris2install from the
$NCHOME/omnibus/install/startup location.
The following output
is displayed:
Name of the Process Agent Daemon [NCO_PA]
- Press Enter to accept the default process agent server
name NCO_PA or enter another server name.
The following
output is displayed:
Should pa_name run in secure mode (y/n)? [y]
- Press Enter to include the -secure command-line option when starting the
process agent.
Secure mode controls the authentication of connection requests with a
user name and password.
The following message is
displayed:
Enter value for environment variable NETCOOL_LICENSE_FILE,
if required [27000@localhost]:
Note: Although Tivoli Netcool/OMNIbus does not require a
license key in order to run, some probes and gateways that have not been through a recent
maintenance cycle still require license keys. If you are running these older probe or gateway
packages, they will still require the NETCOOL_LICENSE_FILE environment variable to be set, and the
availability of a Netcool® license server.
For Linux x86 systems, the following message is
displayed:
Authentication mode
1. UNIX
2. PAM
3. none
4. Do not specify
Please enter value [1-4][1]:
Note: Option 3 (none) is only recommended for testing
purposes.
- If you do not use a license server, you can safely press Enter to run the script. If you
have a license server, either press Enter to accept the default
value, or enter another value.
Results
Each installation script copies or links the required configuration files into the system
startup directory. On some systems (for example, Solaris),
the ability to stop the processes at system shutdown is also provided.
What to do next
For information about modifying startup scripts, see your
specific operating system documentation.