Przemyslaw Maciolek [email protected] L2 GO Training Local TCA Install. Overview. The Local TCA Installer contents: IBM JRE IBM Tivoli Common Agent TPM Subagents and their configuration The installation is actually a two tier process:
Przemyslaw [email protected]
The Local TCA Installer contents:
IBM Tivoli Common Agent
TPM Subagents and their configuration
The installation is actually a two tier process:
Creating the image on the TPM Server and setting it up
Transferring the image onto target machine and running the installation script
To create the image, you have to run the prepareTCAImage.cmd (prepareTCAImage.sh in case of *NIX) command on the TPM Server
Usage: prepareTCAImage.cmd output_dir[repository_dir]
output_dir – required parameter - the directory where the image will be created (the directory will be created by the script, there must be at least 1000 MB of free space)
repository_dir – optional parameter, specifying repository location (by default it's set to %TIO_HOME%\repository)
More messages goes here...
prepareTCAImage.* screen output
Contains output of various commands used by the script as well as error and information messages (like “Copying installation scripts and subagents to c:\image”, etc.)
Logs of CLI commands (used by prepareTCAImage)
%TIO_LOGS%/extract-tcainstaller-filenames.log(Extracts TCA installer filenames from the DB)
%TIO_LOGS%/extract-subagent-list-and-properties.log(Extracts subagents list, their properties and fills the properties, using the DB)
The generated image contents:
aix, hp-ux, linux390, linux86, linux_ppc, solaris, windows – respective platform JRE and common agent installer
subagents – subagent files, grouped by platform, eg.:subagents/any/syncml-core.jarsubagents/any/syncml-dm.jarsubagents/linux/CitScannerAgent_linux.jarsubagents/linux/SCMCollectorAgent_linux.jar...
properties – subagent property files (*.properties)
install.sh, install.bat, ihscript.vbs – installation scripts
caInstall.rsp – the common agent installer response file
registrationPassword – empty file, which may contain MD5 encrypted registration password for the common agent
readme.txt – just a readme
Before deploying onto the target machines, the image MUST be set up.
Minimally, you want to edit the caInstall.rsp file:
Agent Manager Hostname, for example:-W CASInstall.AgentManagerHostname="server.myhost.org”
The Registration Password:-W CASInstall.RegistrationPassword="changeMe"
(Optionally) TCA Install location, eg.:-P installLocation="/opt/ep"
(Optionally) Truststore type, eg.: -W CASInstall.TruststoreType="copy"-W CASInstall.TruststoreLocation="/var/tpmcert"
(Optionally) Other options....
The subagent property files (automatically created by the prepareTCAImage.cmd/.sh scripts) should be reviewed. They might be found in the properties/ subdirectory.
Instead of putting plain registration passsword in caInstall.rsp, you can put MD5 encrypted password here, eg:ojZGPitgSox4rdy6UKJAHQ\=\=
The installation images must be transferred to the target machines.
You can use network mount, CD's, DVD's, ... – whatever fits best your organization
To save time and space you may remove the non-used platforms files, for example if the Local TCA Installer is run only on Windows machines, you may delete everything BUT:caInstall.rspihscript.vbsinstall.shwindows/*properties/*subagents/any/*subagents/win/*
Ports that must be available on the local machine
Ports on the remote (Agent Manager) server
Port numbers might be configured in caInstall.rsp
To install the TCA on Windows:
An user that runs the installer must have administrator rights (=be a member of the Administrators group)
To run the TCA service on Windows:
An user that runs the TCA service should be a member of the Administrators group. It also must have following rights:
Act as a part of operating system
Log on as a service
It might be a domain user
On the target machine, log on as superuser and run install.bat (Windows) or install.sh (*NIX). The silent installation will start. You must have at least 300 MB of free disk space.Typical installation time: 5-10 minutes.
The installation logs might be found in: (COMMON_AGENT_INSTALL_DIR)/install.log
If the file was not created, then probably script didn't have rights to do so, or the Common Agent installation path was invalid
If installation goes well, you should find this line in the logs:Fri Nov 24 15:25:24 CET 2006 Info: The installation has succesfully finished
In (COMMON_AGENT_INSTALL_DIR)/runtime/agent/logs/preinstall.log and agentinstall.log – logs created by TCA installer – useful when something fails during Common Agent installation
In (COMMON_AGENT_INSTALL_DIR)/runtime/agent/logs/epInstallStatus.log – holds status of the Common Agent installer. Value other than 0 mean that installer has failed.
(COMMON_AGENT_INSTALL_DIR)/logs/rcp.log.0 – contains TCA messages – good for checking for reasons of Common Agent registration failure or problems with subagent installation
Subagent installation messages...
This is it!
To uninstall the TCA and Subagents:
Uninstall the TCA first. You can do this either using Control Panel/Add or Remove Programs, or by running the uninstaller: (COMMON_AGENT_INSTALL_DIR)/_uninst/uninstaller.exe or(COMMON_AGENT_INSTALL_DIR)/_uninst/uninstaller.bin
Remove the TCA directory contents (TPM Subagents, logs and temporary files take ~200 MB of disk space)
The final step - installed TCA & Subagents should be discovered by the TPM Server (Tivoli Common Agent Discovery)