Readme File for IBM Tioli Serice Automation Manager Extension for Workload Automation Version 8.6
ii Readme File for IBM Tioli Serice Automation Manager Extension for Workload Automation
Contents Chapter 1. TSAM Extension for Workload Automation......... 1 Chapter 2. Installation and configuration 3 Chapter 3. A business scenario.... 7 Chapter 4. Troubleshooting...... 9 iii
i Readme File for IBM Tioli Serice Automation Manager Extension for Workload Automation
Chapter 1. TSAM Extension for Workload Automation Product oeriew TSAM Extension for Workload Automation proides a solution to integrate Tioli Serice Automation Manager with Tioli Workload Automation. Tioli Serice Automation Manager assists you in the automated proisioning, management, and deproisioning of IT landscapes, comprised of hardware serers, networks, operating systems, middleware, and application-leel software. You can deploy, monitor, and manage cloud computing serices. It also proides traceable approals and processes. For more information about Tioli Serice Automation Manager, see the online information center at: http://publib.boulder.ibm.com/infocenter/tiihelp/10r1/ topic/com.ibm.tsam_7.2.1.4.doc/ic-homepage.html Tioli Workload Automation plans, monitors, and controls the flow of work through your enterprise's entire operation on both local and remote systems. From a single point of control, Tioli Workload Automation analyzes the status of the production work and dries the processing of the workload according to installation business policies. It supports a multiple-end-user enironment, enabling distributed processing and control across sites and departments within your enterprise. For more information about Tioli Workload Automation, see http:// publib.boulder.ibm.com/infocenter/tiihelp/47r1/index.jsp?topic=/ com.ibm.tioli.itws.doc_8.6/welcome_twa.html Benefits TSAM Extension for Workload Automation proides on demand proisioning and deproisioning of workload-automation ready enironments. The Extension creates pools and deploys dynamic agents when the need for new Tioli Workload Scheduler workstations arises. The benefits that can be gained from using TSAM Extension for Workload Automation are the following: No prerequisite knowledge of Tioli Workload Automation is required. All necessary information is aailable in the alidated template. Checks on prerequisites are performed only once when defining the template to be used in future installations. The template is reused in all subsequent installations. Agents are easily deployed and installed by the operator, without interention by the system administrator. Workstations are deployed on demand, on a just-in-time basis when new resources are required and can be deleted when they are no longer necessary. All new workstations are automatically installed, configured, and added to a pool, so that they are ready for scheduling, without haing to wait for the next production day. 1
The pool owner, defined when creating the pool, is automatically granted administrator priileges on the pool. 2 Readme File for IBM Tioli Serice Automation Manager Extension for Workload Automation
Chapter 2. Installation and configuration This section describes the software requirements, supported operating systems, and the installation and configuration procedures. Software requirements The following products are required: Tioli Serice Automation Manager, ersion 7.2.1.4 Tioli Workload Scheduler, ersion 8.6 Supported operating systems The following 32-bit operating systems are supported for managing irtual workstations: Microsoft Windows - Serer 2003: Standard Edition, Enterprise Edition, and Data Center Edition - Serer 2008: Standard Edition, Enterprise Edition, and Data Center Edition - XP Professional with SP3 - Vista Ultimate - Desktop Windows Vista - Vista Enterprise with FDCC - Desktop Windows Vista Enterprise with FDCC - Desktop Windows 7 Enterprise with FDCC - Desktop Windows 7 Enterprise Red Hat Enterprise Linux 5.0 - System x and eseries (AMD64 and EM64T) Kernel 32 - Desktop kernel x86-32 Red Hat Enterprise Linux 6.0 - System x Kernel 32 - Desktop kernel x86-32 SUSE Linux Enterprise Serer 10 - System x (IA32) and eseries (AMD64 and EM64T) Kernel 32 - Desktop kernel x86-32 SUSE Linux Enterprise Serer 11 - System x (IA32) and eseries (AMD64 and EM64T) Kernel 32 Preparing for installation Before you install the extension, perform the following steps: 1. Ensure that the middleware serers (for example, database and LDAP) are running and that the MXSerer application serer is up and running. 2. Back up your database. 3. Download the TEWA.zip file. 4. Unpack the TEWA.zip file into a temporary directory on the administratie serer. On a Linux system, for example, use the /tmp directory. 3
Installing To install the extension, perform the following steps: 1. On the management serer, start all middleware. a. Ensure that the middleware (including DB2, LDAP, IHS, and WebSphere Application Serer) and base serices is running. b. Log in as tioadmin and stop the Tioli Proisioning Manager deployment engine running the following command: $TIO_HOME/tools/tio.sh stop tpm 2. On the administratie serer, install the TEWA.tcdrier running the following command: $TIO_HOME/tools/tc-drier-manager.sh installdrier temp/tewa/tewa.tcdrier 3. On the administratie serer, launch the Process Solution Installer. For example maximo_installation_directory/solutioninstallergui.sh. 4. Select the language for the installation and click OK. 5. From the Introduction panel, click Next. 6. Continue with the panels displayed by the Solution Installer. When prompted for the package to install, choose temp/tewa/tewa_pmp_8.6.zip where temp Is the directory where you extracted the TEWA package. 7. Start the Tioli Proisioning Manager deployment engine running the following command: $TIO_HOME/tools/tio.sh start tpm Configuring Before using the TSAM Extension for Workload Automation, the Tioli administrator creates a properties file similar to the following and containing information about the Tioli Workload Scheduler master domain manager: hostname=nc125184.londonlab.uk.netspace.com instdir="c:\\\\program Files\\\\NTSPC\\\\TWA" admin="tws86admin" adminpwd="tws86admin" brokername="nc125184_dwb" brokerport="31116" where: hostname Is the extended host name of the Tioli Workload Scheduler master domain manager. instdir Is the installation directory of the Tioli Workload Scheduler master domain manager defined in the hostname property. admin Is the administrator of the Tioli Workload Scheduler master domain manager. adminpwd Is the password of the administrator of the Tioli Workload Scheduler master domain manager. 4 Readme File for IBM Tioli Serice Automation Manager Extension for Workload Automation
brokername Is the workload broker serer associated to the Tioli Workload Scheduler master domain manager. brokerport Is the port of the workload broker serer defined in the brokername property. The Tioli administrator sends the file to the Tioli Serice Automation Manager administrator, who performs the following steps: 1. Customize a cloud pool, as described in http://publib.boulder.ibm.com/ infocenter/tiihelp/10r1/topic/com.ibm.tsam_7.2.1.4.doc/ t_createconfigurecloudpoolobjects.html. 2. Copy the properties file receied from the Tioli Workload Scheduler administrator to the workstation where Tioli Serice Automation Manager is installed, for example in /tmp/twaconfig.properties 3. Browse to the maximo_installation_directory/solutions/installedapps/tewa_pmp folder. 4. Start the twa_config.sh script with the following syntax:./twa_config.sh -add -name MDM_name -description description -config file_name where MDM_name Is the name associated to the Tioli Workload Scheduler master domain manager. description Is the description associated to this configuration. file_name Is the fully qualified path to the configuration file proided by the Tioli Workload Scheduler administrator. The following example shows how to create a configuration with name MDMALPHA using the twaconfig.properties file:./twa_config.sh -add -name MDMALPHA -description "The master domain manager for Alpha company" -config /tmp/twaconfig.properties 5. Connect to the Tioli Serice Automation Manager administratie console at: https://tsam_hostname:9443/maximo/ui/ where TSAM_HOSTNAME Is the hostname of the Tioli Serice Automation Manager host. 6. Discoery the Tioli Workload Scheduler master domain manager associated to the configuration file imported in this procedure. 7. To see the new TSAM Extension for Workload Automation serice catalog, log in at the following address: https://tsam_hostname:9443/simplesrm/ where TSAM_HOSTNAME Is the hostname of the Tioli Serice Automation Manager host. Chapter 2. Installation and configuration 5
You can also use the twa_config.sh script to delete existing configurations:./twa_config.sh -remoe -name name where name Is the name of the configuration to be deleted. 6 Readme File for IBM Tioli Serice Automation Manager Extension for Workload Automation
Chapter 3. A business scenario The purpose of the following scenario is to show how TSAM Extension for Workload Automation can improe the business of a financial enterprise. The company The Alpha Credit financial company has recently acquired another company, the Omega Bank. The company business is spread across multiple actiities in a complex enironment comprising a high number of workstations, located in different sites or in different organizational units. The new company needs to calculate bank interest rates on accounts eery month. A dedicated system to run this critical task is required only few days a month. They need to optimize systems utilization to reduce power consumption and maintenance duty costs. A smarter and green planet campaign is in place in the company. Since before the acquisition, Omega uses the TSAM Extension for Workload Automation to proision ready-to-use scheduling enironments with just a few clicks. The operator in charge of creating the enironment creates a project using the Tioli Serice Automation Manager user interface, and submits a serice request to create a pool with name INTERESTRATES_US. Based on the requirements in the serice request, Tioli Serice Automation Manager creates a pool of dynamic agents in the specified Tioli Workload Scheduler enironment and installs the software necessary to process the interest rates. The resulting enironment is ready to use and no further interention is required. To perform this task, the operator does not need to know the following background information: Hardware infrastructure and architecture Installation prerequisites and procedures for Tioli Workload Scheduler dynamic agents Configuration details about the Tioli Workload Scheduler master domain manager. This information is proided by the Tioli Workload Scheduler administrator using a properties file, as described in Configuring on page 4. After the acquisition, the number of accounts to be processed increases dramatically by three times and all the jobs scheduled on the INTERESTRATES_US pool fail because suddenly the number of assigned resources is no longer sufficient. When the jobs fail, the operator receies an e-mail notification explaining the reason of the failure. The operator can easily resole the problem by allocating more resources in the INTERESTRATES_US project using the Tioli Serice Automation Manager user interface. 7
As soon as the resources are allocated, the operator restarts the jobs in error. 8 Readme File for IBM Tioli Serice Automation Manager Extension for Workload Automation
Chapter 4. Troubleshooting This section describes the troubleshooting information and known limitations for the TSAM Extension for Workload Automation. Troubleshooting If you encounter problems at installation time, check the logs in the following path: maximo_installation_dir/solutions/logs/tewa_pmp If you encounter problems at runtime, perform the following steps: 1. Open Tioli Serice Automation Manager administratie console 2. Start the Proisioning Workflow Status application. 3. Check the logs for the workflows associated to the TSAM Extension for Workload Automation. Limitations The following limitations apply: The TSAM Extension for Workload Automation is aailable in English language only. The underscore "_" character is not supported in the pool owner name. 9