1. Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation L2 GO Training Local TCA Install Przemyslaw Maciolek pmaciolek@pl.ibm.com pmaciolek@pl.ibm.com

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

3. Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation Slide 3 Tier 1

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

5. Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation Slide 5 Tier 1 – Creating the Installation Image - Example  Example More messages goes here...

6. Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation Slide 6 Example: Not enough free space

7. Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation Slide 7 Example: No TCA images in repository

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

9. 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.jar subagents/any/syncml-dm.jar subagents/linux/CitScannerAgent_linux.jar subagents/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

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

11. 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\=\=

12. Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation Slide 12 Tier 2

13. 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.rsp ihscript.vbs install.sh windows/* properties/* subagents/any/* subagents/win/*

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

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

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

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

18. Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation Slide 18 Failed Local TCA Install Example

19. Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation Slide 19 Successful Local TCA Install Example Subagent installation messages...

20. Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation Slide 20 Successful Local TCA Install Example This is it!

21. Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation Slide 21 Example: AM host name not set

22. Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation Slide 22 Example: Missing JRE in image

23. Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation Slide 23 Example: No TCA installer in image

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

25. Tivoli Provisioning Manager V5.1 FP1 © 2006 IBM Corporation Slide 25 Final Steps  The final step - installed TCA & Subagents should be discovered by the TPM Server (Tivoli Common Agent Discovery)