tivoli provisioning manager v5.1 fp1 © 2006 ibm corporation l2 go training local tca install...

Tivoli Provisioning Manager V5.1 FP1

© 2006 IBM Corporation

L2 GO TrainingLocal TCA Install

Przemyslaw [email protected]

mailto:[email protected]


© 2006 IBM Corporation Slide 2

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:– Creating the image on the TPM Server and setting it up– Transferring the image onto target machine and running

the installation script



Tier 1



Tier 1 – Creating The Installation Image

– 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)



Tier 1 – Creating the Installation Image - Example

Example

More messages goes here...



Example: Not enough free space



Example: No TCA images in repository



Where are the logs?

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)



Tier 1 – The Installation Image Contents 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



How to set up the image?

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....



How to set up the image? cont'd

The subagent property files (automatically created by the prepareTCAImage.cmd/.sh scripts) should be reviewed. They might be found in the properties/ subdirectory.

In registrationPassword:– Instead of putting plain registration passsword in caInstall.rsp,

you can put MD5 encrypted password here, eg:ojZGPitgSox4rdy6UKJAHQ\=\=



Tier 2



The Image Deployment

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/*



Prerequisites - Ports

Ports that must be available on the local machine– AgentPort: 9510– NonstopPort1: 9514– NonstopPort2: 9515

Ports on the remote (Agent Manager) server– RegistrationPort: 9511– PublicPort: 9513

Port numbers might be configured in caInstall.rsp



Prerequisites – Windows Specific

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



Tier 2 – Running the Local TCA Installer

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



TCA Installer – Other Logs

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



Failed Local TCA Install Example



Successful Local TCA Install Example

Subagent installation messages...



Successful Local TCA Install Example

This is it!



Example: AM host name not set



Example: Missing JRE in image



Example: No TCA installer in image



Uninstallation

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)



Final Steps

The final step - installed TCA & Subagents should be discovered by the TPM Server (Tivoli Common Agent Discovery)

tivoli provisioning manager v5.1 fp1 © 2006 ibm corporation l2 go training local tca install...

Documents