IBM Tivoli Monitoring > Version 6.3 Fix Pack 2 > Installation Guides > Installation Guide > Install IBM Tivoli Monitoring > Install the Tivoli Authorization Policy Server and tivcmd Command-Line Interface for Authorization Policy
IBM Tivoli Monitoring, Version 6.3 Fix Pack 2
Install the tivcmd Command Line Interface for Authorization Policy using the graphical user interface
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.
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.
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 using the instructions in Install 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.
If you are using an IBM Installation Manager repository to perform the installation, you must complete the following setup steps:
- Install IBM Installation Manager from the IBM Tivoli Monitoring Dashboards for Servers and Authorization Policy Components DVD or DVD image, if it is not already installed or is at a version before V1.6.1. IBM Installation Manager version 1.6.1 is provided on the DVD under the im.<operating system>.<architecture> directories. For more details about performing the installation, see the IBM Installation Manager information center at http://pic.dhe.ibm.com/infocenter/install/v1r6/index.jsp.
- Create a repository containing the IBM Tivoli Monitoring components for a dashboard environment. See Use IBM Installation Manager to install or update components from a local repository or Use IBM Installation Manager to install or update components from a network repository.
Use the following steps to install the tivcmd Command Line Interface for Authorization Policy.
- 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.
- In the Installation Manager main window, click Install to display the available packages.
- If you are using IBM Installation Manager, perform the following 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 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 the 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.
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.
- 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.
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 the 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.
Parent topic:
Install the Tivoli Authorization Policy Server and tivcmd Command-Line Interface for Authorization Policy