Page 3 - Tivoli; Intelligent; Problem; Version
Tivoli ® Intelligent Orchestrator Problem Determination and Troubleshooting Guide Version 5.1 SC32-2216-00
Page 5 - Contents; iii
Contents Preface . . . . . . . . . . . . . . vii Who should read this book . . . . . . . . . vii Publications . . . . . . . . . . . . . . vii Tivoli Intelligent Orchestrator library . . . . . vii Prerequisite publications . . . . . . . . . viii Related publications and resources . . . . . viii Acces...
Page 6 - iv
The silent installation program for Tivoli Intelligent Orchestrator exits before the installation is completed . . . . . . . . . 58 Environment variables not set for user tioadmin 58 The installation of IBM Tivoli NetView on Windows fails if the password for creating a user account does not meet the...
Page 9 - Preface; vii
Preface This guide describes how to identify and resolve problems that might occur when you use Tivoli ® Intelligent Orchestrator or Tivoli Provisioning Manager. The instructions in this book apply to both Tivoli Intelligent Orchestrator and Tivoli Provisioning Manager and will clearly identify any ...
Page 10 - viii
Explains how to install and upgrade Tivoli Intelligent Orchestrator software. This guide also provides information about troubleshooting installation problems. v Tivoli Intelligent Orchestrator Migration Guide This book describes the steps to migrate from a previous version of Tivoli Intelligent Orc...
Page 11 - ix
v The Tivoli Software Library provides a variety of Tivoli publications such as white papers, datasheets, demonstrations, redbooks, and announcement letters. The Tivoli Software Library is available on the Web at: http:// publib.boulder.ibm.com/tividd/td/tdprodlist.html v The Tivoli Software Glossar...
Page 12 - Italic; Monospace; monospace
Tivoli software training For Tivoli software training information, refer to the IBM Tivoli Education Web site: http://www.ibm.com/software/tivoli/education. Support information If you have a problem with your IBM software, you want to resolve it quickly. IBM provides the following ways for you to ob...
Page 13 - Product
Chapter 1. Introduction to troubleshooting Problem determination, or troubleshooting, is a process of determining why a product is not functioning in the expected manner. This guide provides information to help you identify and resolve problems that you encounter when using Tivoli Intelligent Orches...
Page 22 - Universal; db2start
The following stages are described to the Tivoli Intelligent Orchestrator problem determination process: 1. “Troubleshooting the prerequisite installation” 2. “Tivoli Intelligent Orchestrator installation and subcomponent configuration verification” on page 17 3. “Tivoli Intelligent Orchestrator run...
Page 23 - ibmdirctl
v On Windows, launch Task Manager and check the Processes window. v On UNIX, run the following command to list all DB2 Universal Databaseprocesses: db2_local_ps The required DB2 Universal Database processes include: v db2fmd v db2dasrrm v db2fmcd v db2wdog v db2sysc v db2ckpwd v db2gds v db2syslog v...
Page 29 - tioadmin
HttpTransport A SRVE0171I: Transport https is listening on port 9,043. HttpTransport A SRVE0171I: Transport https is listening on port 9,511. HttpTransport A SRVE0171I: Transport https is listening on port 9,512. HttpTransport A SRVE0171I: Transport http is listening on port 9,513. Remote Method Inv...
Page 30 - TC
v Starts the WebSphere Application Server. v Configures the WebSphere Application Server, including: – WebSphere Application Server configuration – WebSphere Application Server deployment – WebSphere Application Server setup on UNIX, to run as user configuration v Enables security for the WebSphere ...
Page 33 - problem
c. If the ldapsearch search returns a connection error , start a Telnet session and try to connect to the IBM Tivoli Directory Server using the port number 389. d. If communication can be established with a Telnet session between the IBM Tivoli Directory Server and Tivoli Intelligent Orchestrator, c...
Page 36 - COPXXXX
3. If the IBM Tivoli Directory Server is started, check the SystemOut.log file for the following types of exceptions. For more information on the SystemOut.log file, refer to “Problem determination using SystemOut.log” on page 14: a. If authentication exceptions are found in the log file, go to “IBM...
Page 38 - Security
ssh -l username IP ’command’ 4. If running the command using the command line interface works, it is an environment issue. In your workflow source, check your .profile first. 5. If running the command using the command line interface fails, run the command directly on the managed server. 6. If runni...
Page 39 - Note
Note : The command line tools can be found on TIO_HOME/tools Table 1. Tivoli Intelligent Orchestrator command line tools Name Location Description Syntax applyNewEncryptKey.cmd applyNewEncryptKey.sh v On Windows: %TIO_HOME%\tools v On UNIX: $TIO_HOME/tools Migrates all of the existing credentials fr...
Page 47 - Message; Code
Chapter 3. Log file types Tivoli Intelligent Orchestrator produces message logs, trace logs, and Common Base Event logs that can be configured dynamically. Message logs Message logs record Tivoli Intelligent Orchestrator system events as text messages so they can be reviewed later by customers or by...
Page 52 - Logging; Configuring; Windows
Logging levels This section details the behavior of Tivoli Intelligent Orchestrator logs based on how the logging levels are defined. The logging level hierarchy for Tivoli Intelligent Orchestrator is shown in the following table: Logging level Description msg_error#com.thinkdynamics.kanaha. util.lo...
Page 60 - Workflow; workflowLogExport
Table 7. Deployment engine logs (continued) File name Location Description cbe.log Windows %TIO_LOGS%\deploymentengine UNIX or Linux $TIO_LOGS/deploymentengine This log file stores all event logs for the deployment engine component in Common Base Event standard format. deploymentengine_start.log Win...
Page 63 - GPX; WebSphere
Chapter 6. Middleware prerequisite log files This chapter describes the directory locations for the following log files: v “Installation log files for prerequisites” v “Runtime logs for prerequisites” on page 52 Installation log files for prerequisites When you install the prerequisite software for ...
Page 65 - dump; Directory
WebSphere Application Server is the last service to stop when you shut down Tivoli Intelligent Orchestrator, so this log file is useful for verifying whether the shutdown completed. It is located in the %WAS_HOME%\logs\ server1 directory on Windows systems ( $WAS_HOME/logs/server1 on UNIX or Linux)....
Page 66 - logs
v db2diag.log v ibmds_config.log v ibmds_config_err.log Tivoli Agent Manager Trace logs for the agent manager are stored in the Agent_Manager_install_dir \ logs directory, where Agent_Manager_install_dir is the installation directory for the agent manager. The log files for the Tivoli Intelligent Or...
Page 67 - Cause
Chapter 7. Common problems and known limitations in Tivoli Intelligent Orchestrator This chapter describes how to recover from the following types of Tivoli Intelligent Orchestrator problems, and describes a number of known limitations for the Tivoli Intelligent Orchestrator reports: v “Problems wit...
Page 68 - Solution
In Linux, the tioadmin user creation fails if the tioadmin group already exists before you install. No exception is thrown, so the installer cannot detect that the user creation operation has failed, and the system cannot return to a previous stage of the installation. Solution Reinstall Tivoli Inte...
Page 71 - Uninstalling
The installation of IBM Tivoli NetView on Windows fails if the password for creating a user account does not meet the system requirements Cause When installing IBM Tivoli NetView on Windows, the NetView installer creates a user account on your system for the NetView service. If the password that you...
Page 73 - AgentManager; TivoliAgentRecovery
Agent_Manager_install_dir /bin/ RunInDbEnv.sh RemoveCASTables.sh database_password Replace database_password with the DB2 database password. – Oracle a. In a command line window, change to the Agent_Manager_install_dir /db/oracle directory. b. Run the following command: - On Windows ./RemoveCASTable...
Page 75 - You; startServer
Solution 2 Run the Tivoli Directory Server Web Administration tool to check the status of the LDAP server. Note: This solution is provided for a two-node directory server installation. 1. From LDAP_Install \appsrv\bin , run: v startServer.sh in UNIX v startServer.bat in Windows and use the following...
Page 79 - workflow
Log content structure: workflow –> deployment request –> workflow execution log –> workflow execution log detail Example workflow log export: <?xml version="1.0" encoding="UTF-8"?> <workflow-execution-history> <workflow id="21" name="Test Workflow ...
Page 80 - Developing
Cannot run workflows if the PS1 environment variable is altered Cause When running scriptlets in Tivoli Intelligent Orchestrator, the system will expect that the command prompt ends in $ or # . The PS1 environment variable governs what your prompt looks like. If you change this variable on your mana...
Page 83 - application; Tools
DB2 Universal Database does not work properly with terminal server Cause The Tivoli Intelligent Orchestrator installation fails with DB2 Universal Database when terminal server is enabled. There is an db2.exe application error . The DB2 Universal Database command will not work. Solution Disable the ...
Page 85 - native2ascii
For more information, refer to the DB2 product documentation available at http://www.ibm.com/software/data/db2/udb/support/manualsv8.html. For languages other than English, the text in CSV reports imported in Microsoft Excel is garbled Tivoli Intelligent Orchestrator reports that are exported to Com...
Page 87 - AgentManager.properties; qualified
Cause The Distinguished Name (DN) syntax supported by the directory server does not support special characters. This is a known problem with the IBM Tivoli Directory Server and is described in detail in the Tivoli Directory Server Administration Guide that is available at http://publib.boulder.ibm.c...
Page 91 - toolkit
Chapter 8. Troubleshooting the agent manager This chapter contains the following sections to help you resolve problems with the agent manager: v “Log files for the agent manager” v “Determining the version of agent manager” on page 83 v “Installation and uninstallation verifications” on page 83 v “C...
Page 97 - Enabling; Disabling
3. Click Apply to list the JDBC providers for the agent manager application server. 4. In the list of providers, click AgentJDBCProvider . 5. In the Additional Properties area at the bottom of the Configuration page of the JDBC provider, click Data Sources . 6. In the Data Sources page, check the bo...
Page 98 - only
2. Click Servers –> Application Servers –> app_server_name –> Logging and Tracing –> Diagnostic Trace . Replace app_server_name with the name of the application server where the agent manager applications are installed, for example, AgentManager . 3. Ensure that Enable Trace is not check...
Page 99 - myserver
h. In the Save to Master Configuration area , click Save again to exit the Master Configuration window. 5. Optionally, clean up the agent manager objects in the database. Important: Remove the agent manager tables from the database or drop the registry database only if all products that use the regi...
Page 101 - Target
assign a different port to the administrative console. You can do this when you install WebSphere Application Server or afterwards. To change the port used by the WebSphere Administrative Console after WebSphere Application Server is installed, complete the following steps. In this example, the WebS...
Page 104 - LogPackage
v Proper contact information - your IBM Passport Advantage ® or Tivoli Customer ID, appropriate phone number or e-mail address, your preference of return correspondence: by phone or e-mail, alternate phone numbers (if possible), and if not responding to you, the name and contact information for the ...
Page 107 - Common
Chapter 10. Tivoli Intelligent Orchestrator messages This chapter lists the available Tivoli Intelligent Orchestrator messages. For more information on the conventions used to create these messages, see the section “Message logs” on page 35. Note: Variables in a message are represented by variable_n...
Page 233 - script; service
Appendix A. Common Agent serviceability tool This section describes the serviceability tool that captures information about the common agent and the machine the agent is running on. The serviceability tool is a script that can be run from the common agent installation directory, also referred to as ...
Page 238 - Contacting
4. Click the name of a fix to read the description and optionally download the fix. To receive weekly e-mail notifications about fixes and other news about IBM products, follow these steps: 1. From the support page for any IBM product, click My support in the upper-right corner of the page. 2. If yo...
Page 242 - Trademarks
IBM Canada Ltd. Office of the Lab Director 8200 Warden Avenue Markham, Ontario L6G 1C7 Canada Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available...
Page 243 - Index
Index A agent manager configuring WAS console to use a different port 88 determining version 83 disabling tracing 85 enabling tracing 85 installation and uninstallation verifications 83 log files 79 problems 79, 81, 82, 83, 84, 86, 88 recovering from incomplete uninstallation 86 registration failure...