Use the IBM® Tivoli® Monitoring Installation
Launchpad or IBM Installation
Manager with a local or network repository to install the tivcmd Command
Line Interface for Authorization Policy using a graphical user interface.
The Installation Launchpad is the recommended approach if you do not
have experience using IBM Installation
Manager.
Before you begin
The tivcmd CLI should be installed on the computers that administrators
use to create and work with authorization policies. The tivcmd CLI
connects to an IBM Dashboard
Application Services Hub where the Tivoli Authorization
Policy Server package is installed and configured using HTTP or HTTPS.
Therefore, it can be installed on a computer without the Dashboard
Application Services Hub and authorization policy server. You can
install the tivcmd CLI on the same computer as the authorization policy
server.
If you are installing the tivcmd CLI on a computer without
the authorization policy server and Dashboard Application Services
Hub, follow the procedure below.
If you want to install the
tivcmd CLI on the same computer as the authorization policy server
using a graphical user interface, you can install both components
at the same time by using the instructions in Installing and configuring the Tivoli Authorization Policy Server using the graphical user interface.
If you are using the IBM Tivoli Monitoring
Installation Launchpad to perform the installation, there are no prerequisites
to install.
About this task
Use the following steps to install the tivcmd Command Line
Interface for Authorization Policy.
Procedure
- If you are using the IBM Tivoli Monitoring Installation
Launchpad, perform these steps to start the installation:
- Log in to the system as the user who will run the tivcmd
CLI.
- Execute the launchpad command or script for your operating
system. The launchpad commands and scripts are located in the root
directory of the IBM Tivoli Monitoring Dashboards
for Servers and Authorization Policy Components DVD or DVD image.
- 32 bit system launchpad.exe
- 64 bit system launchpad64.exe
- launchpad.sh
- On the main launchpad panel, select one of the following
links under the Product Overview category:
- Install as administrative user: Select this link if you
want to install and run the tivcmd CLI as an administrative user on Windows or as root on Linux/UNIX.
- Install as non-administrative user: Select this link if
you do not want to install and run the tivcmd CLI as an administrative
user on Windows or as root
on Linux/UNIX.
- If you are using IBM Installation
Manager, perform these steps to start the installation:
- Log in to the computer as the user who will run the
tivcmd CLI commands.
- Start the IBM Installation
Manager:
- Double-click the IBMIM.exe file that is
located in the eclipse subdirectory in the directory where IBM Installation Manager was installed.
The default path for IBM Installation
Manager on Windows is C:\Program
Files\IBM\Installation Manager.
- Execute the IBMIM binary under /opt/IBM/InstallationManager/eclipse.
The IBM Installation Manager
window opens with several choices for managing your IBM software installations.
- In the Installation Manager main window, click Install to
see the available packages in the repositories that are configured
for IBM Installation Manager.
- Select the tivcmd Command Line Interface for
Authorization Policy package and click Next.
Note: If you are using the IBM Tivoli Monitoring Installation
Launchpad, the tivcmd Command Line Interface for Authorization
Policy package is preselected.
- If you are installing other packages at the same time,
you might be asked to accept a license agreement for the other packages.
After you accept the agreement, click Next.
- If you are using IBM Installation
Manager to perform the installation, specify the location of the Shared
Resources Directory and click Next.
You
are asked to specify a shared resources directory the first time that
you install a package on a computer. The shared resources directory
is where IBM Installation Manager
stores installation artifacts that can be used by one or more package
groups. Choose a directory on your largest drive. You cannot change
the shared resources directory location until you uninstall all packages.
- Configure the installation directory for the tivcmd Command
Line Interface package group. The default installation
directory is as follows:
- C:\IBM\TivoliMonitoring
- /opt/IBM/TivoliMonitoring.
Note: - You cannot install the tivcmd CLI under the same installation
directory as Jazz™ for Service
Management or the monitoring server, portal server, portal client,
monitoring agents, and tacmd CLI components of IBM Tivoli Monitoring.
- On a 64 bit machine, the 64 bit architecture of the tivcmd Command
Line Interface for Authorization Policy is installed by default. You
can select to switch to the 32 bit architecture. However, on zSeries® systems with Linux, you can only install the
32 bit architecture of the CLI.
Click Next to continue.
- If you are installing other packages at the same time,
you might be asked to select the translation packages to install for
those packages. After you make your selection, click Next.
Note: The language files for all supported languages are always
installed with the tivcmd Command Line Interface for Authorization
Policy package.
- Make sure that the tivcmd Command Line Interface
for Authorization Policy feature is selected and click Next.
- Configure the IBM GSKit
Security parameters. Specify the encryption key that is
used in your IBM Tivoli Monitoring environment in the GSKit
field. The default value is IBMTivoliMonitoringEncryptionKey.
Click Next to continue.
- Review the information on the Install Packages Summary
window. This is your opportunity to click Back and
make any changes before proceeding.
- Click Install to begin installing.
After installation is complete, the packages are shown in a panel
with a message confirming that they are installed. At this point,
you can review the log files.
- The Results window displays the package installation status.
Click Finish to complete the installation.
What to do next
Use the tivcmd Command Line Interface to create authorization
policies. The
IBM Tivoli Monitoring Administrator's
Guide provides
examples of creating authorization policies for common scenarios in
the
Using role-based authorization policies chapter. Steps
for configuring a dashboard environment to use authorization policies
are outlined in the
Preparing your dashboard environment chapter.
For a complete list of tivcmd CLI commands, see the
IBM Tivoli Monitoring Command Reference.