Przemyslaw maciolek pmaciolek@pl ibm com
1 / 25

L2 GO Training Local TCA Install - PowerPoint PPT Presentation

  • Uploaded on
  • Presentation posted in: General

Przemyslaw Maciolek 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:

I am the owner, or an agent authorized to act on behalf of the owner, of the copyrighted work described.

Download Presentation

L2 GO Training Local TCA Install

An Image/Link below is provided (as is) to download presentation

Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author.While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server.

- - - - - - - - - - - - - - - - - - - - - - - - - - E N D - - - - - - - - - - - - - - - - - - - - - - - - - -

Presentation Transcript


L2 GO TrainingLocal TCA Install


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

Tier 1

Tier 1 – Creating The Installation Image

To create the image, you have to run the prepareTCAImage.cmd ( 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


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.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="”

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


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)

  • Login