tivoli provisioning manager v5.1 fp1 © 2006 ibm corporation l2 go training local tca install...
DESCRIPTION
Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation Slide 3 Tier 1TRANSCRIPT
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation
L2 GO TrainingLocal TCA Install
Przemyslaw [email protected]
Tivoli Provisioning Manager V5.1 FP1
© 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
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 4
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)
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 5
Tier 1 – Creating the Installation Image - Example
Example
More messages goes here...
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 7
Example: No TCA images in repository
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 8
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)
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 9
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
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 10
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....
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 11
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\=\=
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 13
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/*
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 14
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
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 15
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
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 16
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
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 17
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
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 18
Failed Local TCA Install Example
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 19
Successful Local TCA Install Example
Subagent installation messages...
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 20
Successful Local TCA Install Example
This is it!
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 23
Example: No TCA installer in image
Tivoli Provisioning Manager V5.1 FP1
© 2006 IBM Corporation Slide 24
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)