Problem Determination and Troubleshooting Guide
Page
Problem Determination and Troubleshooting Guide
Page
Contents
Troubleshooting the agent
Tivoli Common Agent
Page
Preface
Who should read this book
Publications
Tivoli Intelligent Orchestrator library
Prerequisite publications
Related publications and resources
Accessibility
Accessing publications online
Ordering publications
Tivoli software training Support information
Conventions used in this book
Typeface conventions
Monospace
Introduction to troubleshooting
Product and system overview
Orchestrating provisioning
Product comparison
Tivoli Intelligent Orchestrator Tivoli Provisioning Manager
Product architecture
Tivoli Intelligent Orchestrator components
Data center model
Policy engine
Objective analyzer
Global resource manager
Deployment engine
Automation packages
Built-in troubleshooting features
Problem classification
Product maintenance
Backing up the system
Problem resolution
Performing periodic checks and maintenance
Click Technical documentation on the left
Problem determination methodologies
Defining the problem
Identifying the cause of the problem
Determining where the problem lies and what it is
Verifying whether the problem can be replicated
Checking whether the problem has occurred before
Fixing the problem
Troubleshooting the prerequisite installation
DB2 Universal Database verification
IBM Tivoli Directory Server verification
Unix
Windows LDAPInstallDirectory\var\
WebSphere Application Server verification
Security.xml
Server.xml
Java.security
Sas.client.props
SystemOut.log
Secure Authentication Services Ldap
Map Tivoli Intelligent Orchestrator resource references
Simple Object Access Protocol Soap
Http Transport Service
Applications
Tcear Application
Remote Method Invocation RMI
Tivoli Intelligent Orchestrator installation
Startup Complete
Verifying subcomponent configuration
Check the IBM Tivoli Directory Server schema
Page
Component-based problem determination
Check the tioldap authentication
Task-based problem determination
Page
Debug
Using the available command line tools
Accessing the knowledge bases
Tivoli Intelligent Orchestrator command line tools
ChangePassword.cmd
Password current
Wasadmin password
ChangePassword.sh user
DcmQueryCommandt.cmd
DcmQueryCommandt.sh
DcmExport.cmd -d
OutputFilename
IdeviceId
RetrieveDetails.cmd
RetrieveDetails.sh
Siregister.cmd
Packagelocation
Repositoryname
Repositorymountpoint
Command
UpdateCredential.cmd
Internaluserpassword
WASAdminUser
WebSphere Application Server command line tools
XmlImport.cmd fileURL
FileURL xmlImport.sh
FileURL fileURL
IBM Tivoli Directory Server command line tools
Name Location Description
Page
Log file types
Message logs
Message ID format
Code Subsystem
Message elements
Message ID
Message text
Explanation
Trace logs
Common Base Event logs
Page
Log locations
Locating and configuring log files
Log directory files
Configuring logs with log4j
Logging levels
Log4j.prop
Windows
Locating and configuring log files
RollingFileAppender defaults
Log level defaults
Configuring log4j dynamically
Preparing log files for review by IBM Tivoli Support
Example
Page
Log files for the uninstall process
Log files for product setup
Tivoli Intelligent Orchestrator log files
Log files for starting and stopping the server
Log files for the Web interface
Deployment engine log files
Workflow logs
Logs for data collection and decision making
Automation package logs
This log file stores error
Installation log files for prerequisites
Installation logs for individual prerequisites
Middleware prerequisite log files
WebSphere Application Server
Runtime logs for prerequisites
WebSphere Application Server
Directory Server
Linux and Solaris
DB2 Universal Database
Directory Server
Tivoli Agent Manager
Linux, you cannot create the user tioadmin
Problems with installation
Cause
Solution
Microsoft Active Directory installation fails
Environment variables not set for user tioadmin
Cause
On AIX, Linux, and Solaris
Or, to uninstall silently
Cause Solution
Problems with logging
You cannot log
You cannot change your password
Problems with workflows
DB2 Universal Database creates a database state error
Shell command error Resource temporarily unavailable
Solution workflowLogExport tool
$TIOHOME/tools
Syntax for Unix
Workflow does not install
Example workflow log export
Other common problems
On Windows, Tivoli Intelligent Orchestrator does not start
XML import does not work properly
Capacity of the file system is not large enough
Last line in the log is
Solution
Operating system requirements
Excel requirements
Common agents unable to communicate with the agent manager
There is a maximum size for returnResult parameter storage
Device Manager limitations
Known report limitations
Agent receives an Http Unauthorized 401 response code
Running any report with too many objects selected fails
Page
Troubleshooting the agent manager
Locating the installation log files
Log files for the agent manager
Packaging the log files
Log file name Description
Guid
Locating the uninstallation log files
Locating the remote registry logs
Locating the DB2 Universal Database runtime logs
Locating the runtime log files
Log File Description
Verifying that the agent manager service is running
Installation and uninstallation verifications
Determining the version of agent manager
Verifying the installation of WebSphere Application Server
Errors starting the agent manager application server
Errors starting the agent manager application
Verifying the connection to the registry
Task Value in Trace Specification text box
Enabling and disabling tracing
Enabling tracing
Disabling tracing
Ensure that Enable Trace is not checked Click OK
Common problems
Registration and communication failures
Problems using the WebSphere Administrative Console
Cannot start the WebSphere Administrative Console
As a Windows service
Using a Windows command
StopServer server1 startServer server1
Page
Contacting IBM Tivoli Software Support
General data to collect for Tivoli Support
PackageLog ZIP tool
Location
Syntax
Returned file
Prerequisites
Linux and Unix
Page
Tivoli Intelligent Orchestrator messages
Common subsystem messages
COPCOM001E The system cannot delete the VALUE0 file
COPCOM003E The system cannot find the VALUE0 dcm policy
COPCOM012E The server VALUE0 does not have a locale value
COPCOM015E The system cannot get a Jndi context
COPCOM016E The directory VALUE0 does not exist
COPCOM024E The system cannot use the VALUE0 JMS destination
COPCOM040E The system failed to load the VALUE0 XML file
COPCOM041E The system failed to parse the VALUE0 XML file
COPCOM042E The system cannot read the VALUE0 XML file
COPCOM050E Application VALUE0 not found
COPCOM058E The system cannot find application tier VALUE0
COPCOM059E The system cannot find a rule at position VALUE0
COPCOM061E The system cannot find customer VALUE0
COPCOM063E The system cannot find the DCM object ID VALUE0
COPCOM082E The system cannot find power outlet VALUE0
COPCOM083E The system cannot find power unit VALUE0
COPCOM071E The system cannot find the load balancer VALUE0
COPCOM075E The system cannot find NIC VALUE0
COPCOM096E The system did not find the VALUE0 switch port
COPCOM097E The system cannot find the VALUE0 switch
COPCOM090E The system cannot find the VALUE0 software stack
COPCOM091E The system cannot find the VALUE0 software state
COPCOM124E a Telnet error occurred
COPCOM125E a Telnet error occurred
COPCOM115E There is not enough data to complete the task
COPCOM116E The operation timed out
COPCOM136E The system cannot find error VALUE0
COPCOM140E An error occurred VALUE0
COPCOM143E a shell command error VALUE0 occurred
COPCOM155E The system cannot find the VALUE0 boot server
COPCOM159E The system cannot find the VALUE0 access rule
COPCOM158E The system cannot find the VALUE0 interface card
COPCOM161E The system cannot find the resource VALUE0
COPCOM170E The system cannot find this route VALUE0
COPCOM195E The system cannot find the VALUE0 volume manager
COPCOM194E The system cannot find the VALUE0 storage volume
COPCOM191E The system cannot find the VALUE0 disk manager
COPCOM197E The system cannot find the VALUE0 logical volume
COPCOM198E The system cannot find the VALUE0 file system
COPCOM203E The system cannot find the VALUE0 data path
COPCOM204E The system cannot find the VALUE0 zone set
COPCOM217E The system cannot create the output file VALUE0
COPCOM219E The database cannot complete the query
COPCOM226E The VALUE0 server template is not valid
COPCOM230E The system cannot find the VALUE0 host platform
COPCOM237E The system cannot find the VALUE0 software module
COPCOM243E The system cannot find the VALUE0 router
COPCOM269E The switch endpoint mode VALUE0 is not valid
COPCOM274E The system cannot find the discoverable VALUE0
COPCOM278E The system cannot find the VALUE0 storage manager
COPCOM282E Port VALUE0 is already connected to port VALUE1
COPCOM303E VALUE0 already exists
COPCOM302E Port number VALUE0 is not unique
COPCOM305E The Vlan name cannot be null
COPCOM321E The system cannot find the VALUE0 image
COPCOM317E The system cannot find the VALUE0 image type
COPCOM323E The policy type VALUE0 is not valid
COPCOM353E The service with ID VALUE0 cannot be found
COPCOM354E The offering with ID VALUE0 cannot be found
COPCOM358E The service with name VALUE0 cannot be found
COPCOM355E The scheduled task type VALUE0 is not valid
COPCOM357E The Order of ID VALUE0 cannot be found
COPCOM360E The subscription of ID VALUE0 cannot be found
COPCOM378E AgentManager did not find the Agent ID VALUE0
COPCOM377E Internal Error Null AgentGUID was specified
COPCOM385E The system cannot find the report VALUE0
COPCOM395E The TCM object type VALUE0 was not found
COPCOM396E The filter format is not valid. Filter VALUE0
COPCOM400E No TCM Gateways were found for Hostname VALUE0
COPCOM401E The endpoint lookup returned null for VALUE0
COPCOM405E The Profile Manager is VALUE0
COPCOM407E Profile VALUE0 is not a managed profile
COPCOM408E The Endpoint subscriber VALUE0 does not exist
COPCOM417E The filter VALUE0 lacks a parent component
COPCOM431E The instance access role VALUE0 is unknown
COPCOM432E The access domain VALUE0 is unknown
COPCOM430E The instance permission VALUE0 is unknown
COPCOM433E The domain role VALUE0 is unknown
COPCOM442E The type VALUE0 is not a valid filter type
COPCOM443E The system cannot create the file VALUE0
COPCOM457E An unknown event type VALUE0 occured
COPCOM458E An unknown event consumer VALUE0 occured
COPCOM468E The SI image resource VALUE0 registers an error
COPCOM473E The LCF installation directory is not specified
COPCOM465E a Security Group with name VALUE0 already exists
COPCOM466E Bad SI package image format with VALUE0
COPCOM480E The value for Http Disable must be a 0, 1, 2 or
COPCOM481E The value for Broadcast Disable must be a 0 or
COPCOM482E The Login Interval is not correct
COPCOM494E Unable to connect to endpoint using RXA
COPCOM499E Error copying file using RXA VALUE0
COPCOM503E Error converting path VALUE0 to DOS style path
COPCOM502E The system cannot create the directory VALUE0
COPCOM514E The database sequence VALUE0 does not exist
COPCOM521E Unable to read xml config file VALUE0
COPCOM532E The server VALUE0 cannot be accessed or updated
COPCOM533E The DCM object VALUE0 cannot be updated
COPCOM525E Cannot find DCM Property Id VALUE0
Deployment engine subsystem messages
COPCOM539E Task VALUE0 Task Id VALUE1 failed
COPDEX001E The system cannot get a Jndi context
COPDEX002E The system cannot use the VALUE0 JMS destination
COPDEX005E The VALUE0 logical operation does not exist
COPDEX008E break cannot be used inside of a finally block
COPDEX033E Error code for unit tests only
COPDEX019E The condition VALUE0 is not valid
COPDEX020E The system requires the VALUE0 attribute
COPDEX022E The ID VALUE0 is not an integer
COPDEX038E a database error occurred VALUE0
COPDEX039E a configuration error occurred
COPDEX041E a deployment error occurred
COPDEX040E a deployment engine exception occurred VALUE0
COPDEX060E a workflow XML parser error VALUE0 occurred
COPDEX062E a data insert error VALUE0 occurred
COPDEX063E An XML data parsing error VALUE0 occurred
COPDEX069E The system cannot process the data update VALUE0
COPDEX081E The system cannot specify an input file
COPDEX082E The system cannot find the input file VALUE0
COPDEX083E The input file VALUE0 is empty
COPDEX084E The operation type VALUE0 is not identified
Page
COPDEX129E a workflow compiler error occurred VALUE0
COPDEX130E The deployment request id=VALUE0 was cancelled
COPDEX127E The VALUE0 variable is already declared
COPDEX128E The VALUE0 variable does not exist
COPDEX141E The specified LDO VALUE0 is not found
COPDEX140E The deployment request VALUE0 is not found
COPDEX142E The specified workflow VALUE0 is not found
COPDEX149E No such parameter VALUE0
COPDEX150E Unknown instance permission VALUE0
COPDEX151E Duplicate permission VALUE0 for parameter VALUE1
COPDEX153E The size of input arrays are different
COPDEX170E The VALUE0 Java plug-in does not exist
COPDEX176E The parameter VALUE0 cannot be null
COPDEX178E To do VALUE0
COPDEX183E DCM object VALUE0 does not have attribute VALUE1
Job Distribution Service JDS subsystem messages
J2ee subsystem messages
COPJEE009E This feature is not supported
COPJEE032E The system cannot recognize the database type
COPJEE035E The system cannot find the RSA credentials VALUE0
COPJEE049E The operating mode VALUE0 is not valid
COPJEE050E The specified resource pool VALUE0 is not valid
COPJEE055E No software stack is associated with VALUE0
COPJEE056E The requested object VALUE0 is already locked
COPJEE068E The deployment request parameter VALUE0is missing
COPJEE082E The system cannot load datasource VALUE0
COPJEE086E a monitoring configuration was not selected
COPJEE093E The specified position is already occupied
COPJEE101E a user interface error occurred VALUE0
COPJEE105E An error occurred VALUE0
COPJEE106E The upgrade type is not valid
COPJEE112E a power outlet already exists
COPJEE167E The server ID is not valid
COPJEE199E The upgrade type is not valid
COPJEE201E Both objects must be of the type DcmObject
COPJEE207E a discovery technology was not selected
COPJEE232E The VALUE0 module type is not valid
COPJEE272E Problem ID UIVALUE0
COPJEE271E UI Exception Problem ID UIVALUE0, user=VALUE1
COPJEE240E The system cannot create the deployment plan
COPJEE289E The deployment request ID VALUE0 does not exist
COPJEE299E The system cannot realize the deployment plan
Page
COPJEE334E The access to DB driver VALUE0 is not allowed
COPJEE326E The system failed to delete deployment request
COPJEE333E The system cannot find DB driver VALUE0
COPJEE335E Instantiation of DB driver VALUE0 failed
COPJEE345E Multiple Password credentials were returned
COPJEE350E a data insert error VALUE0 occurred
COPJEE351E The system cannot process the data update VALUE0
COPJEE356E a system error VALUE0 occurred
COPJEE379E The workflow was already added
Policy engines subsystem messages
COPPEZ005E The system cannot create the Snmp connection
COPPEZ008E The system cannot estimate Number of servers
COPPEZ009E The system cannot open the VALUE0 file
COPPEZ042E VALUE0 is not a valid device type
COPPEZ044E VALUE0 is not valid for a VALUE1 context
COPPEZ047E The data acquisition thread is not working
COPPEZ049E VALUE0 is not a valid VALUE1 metric
COPPEZ073E An Snmp IO error occurred
COPPEZ077E An error VALUE0 occurred
COPPEZ079E a resource broker error occurred
COPPEZ110E a task library lookup error occurred
Common agent subsystem messages
COPPEZ115E The system cannot obtain a application tier ID
COPPEZ116E The endpoint label is null or empty
COPTCA001E Cannot get proxy for interface on Agent VALUE0
TC driver manager subsystem messages
COPTDM003E The application is not specified
COPTDM009E The system cannot copy the file VALUE0 to VALUE1
COPTDM026E The system cannot open the VALUE0 file
COPTDM030E The system cannot save the changes
COPTDM060E The Jdbc driver caused an SQL exception
COPTDM062E The system cannot allocate the IP address
COPTDM063E The system cannot allocate the server
COPTDM064E The system cannot allocate virtual server VALUE0
COPTDM082E The system cannot find the RSA credentials VALUE0
COPTDM099E The system cannot reboot device ID VALUE0
COPTDM089E The system cannot find the switch port ID VALUE0
COPTDM098E The system cannot move port
COPTDM108E The integer value VALUE0 is not valid
COPTDM109E The load balancing algorithm VALUE0 is not valid
COPTDM111E The SSH path is not valid
COPTDM112E The SSH user name VALUE0 is not valid
COPTDM121E a driver error occurred
COPTDM131E The SecureShell SSH configuration is not valid
COPTDM133E The timeout value VALUE0=VALUE1 is not valid
COPTDM119E No device is associated with SAP ID VALUE0
COPTDM162E a deployment error occurred
COPTDM165E a RemoteInstaller error occurred
COPTDM152E The TCDriver VALUE0 is missing item VALUE1
COPTDM157E The request timed out after VALUE0 milliseconds
COPTDM183E Upgrade of TCDriver VALUE0 is not allowed
COPTDM184E Overwriting of file VALUE0 is not allowed
Utilities subsystem messages
COPUTL043E Error Message VALUE0
COPUTL015E Try to obtain file VALUE0 from environment
COPUTL023E Processing Migration Step VALUE0
COPUTL033E Failed SQL Message VALUE0
Compliance Messages
Tivoli Intelligent Orchestrator messages
Group Messages
Networking Messages
COPNET015E The switch endpoint mode VALUE0 is not valid
COPNET018E The switch port VALUE0 is already connected
COPNET026E The system cannot find the VALUE0 access rule
COPNET014E The system cannot find Vlan VALUE0
RXA Messages
CTGRI0002E Session not established
CTGRI0008E a unique directory could not be created
CTGRI0009E pathname cannot be removed
CTGRI0015E The native Windows service binary cannot be read
CTGRI0018E An error occurred in SCP communication
CTGRI0019E RSH could not bind to any local privileged port
CTGRI0020E Could not find the remote user RemoteUser
Software Distribution Messages
Message Variables where file name
DISSP6015E An error occurred loading the package
DISSP6016E An error occurred saving the package
Correctly installed on your OS/400
DISSP6020E Failed to export file name
DISSP6021E Failed to import file name
DISSP6023E Directory not found
DISSP6024E Link not found
DISSP6030W The configuration file file name was not found
DISSP6037W The configuration file specified is not valid
DISSP6031W The sample file file name was not found
DISSP6033W Unable to create the working directory
DISSP6046E An error occurred while unpacking the SPB
DISSP6044E Enter a value in the suggested range
Password are defined in Tivoli Provisioning Manager WebUI
Tivoli Common Agent Services messages
Common Agent messages
BTC0006I The common agent has stopped
BTC0007I The common agent MBeanServer has started
Name at port number
BTC1034I Certificate revocation list has been Renewed
BTC1031I The common agent has been reset
BTC1039I Credentials have been renewed
BTC1042I command to renew the certificate revocation list
BTC1044I command to reset the security credentials
Tivoli Common Agent Services messages
BTC1050I true
Administrator Response To correct this problem
BTC1051I false
BTC2200I The system is restarting the common agent
BTC2205I The common agent is stopping
BTC2404I command to set the locale to the language
BTC2406I command to get the locale language and/or region
BTC2407E The JLog service JLogService was not found
BTC2209I The common agent is being initialized
BTC2412I Locale was not set. The default
BTC3004E The update target file, bundlename, was not found
BTC3005E The update source file, bundlename, was not found
BTC2411I Locale was successfully set to
BTC3010E The installation of the bundlename bundle failed
BTC3101I The bundle was successfully updated
BTC3104I Bundle was successfully Uninstalled
BTC3011E Updating the bundlename bundle failed
BTC3107I System has invoked preUpdate LifecycleActivator for
BTC3115E The post installation failed
BTC3117E The preupdate of the bundle, bundlename failed
BTC3118I command to install a bundle from the specified URL
BTC3119I command to update the specified bundle
BTC3120I command to uninstall the specified bundle
BTC3140I Bundlename bundle was Successfully installed
BTC3142I Bundlename bundle was Successfully updated
BTC3143I Update to the bundlename bundle Failed. cause
BTC3144I Bundlename bundle was uninstalled Successfully
BTC3163I Unknown subagent bundle command
BTC3164I Unknown common agent command
BTC3166I Installed
BTC3170I Uninstalled
BTC3175I command to get the state of the specified bundle
BTC4004I Connector service has been stopped Undeployed
BTC4014I To get help for a service
BTC4019I Commands available
BTC4022I Connector is active
BTC4023I command to check if the connector service is alive
BTC4027I command to restart the common agent
BTC4030I command to get the ID of the common agent
BTC4032I command to regenerate the ID of the common agent
BTC4028I unknown parameter
BTC4046I configfile
BTC4047I servicename
BTC4045E The connection from IPaddress was rejected
BTC5006I Processname status collection Process is starting
BTC5018I Status report for host hostname, URI
BTC5007I Processname status collection Process is ending
Was delivered successfully
BTC5042I command to upgrade a common agent
BTC5043I command to upgrade a common agent and its JRE
BTC5045I The common agent upgrade completed successfully
BTC5027I Status has been sent
Exception
Page
About the error that occurred
Value specified is value. The default
BTC5073I command args
Administrator Response No action required
Agent Manager messages
Tivoli Common Agent Services messages
Page
CTGEM0011E The certificate authority was not initialized
Administrator Response Contact IBM Customer
CTGEM0015E Use a secure connection Https for this request
CTGEM0016E The parametername parameter cannot be Null
Tivoli Common Agent Services messages
Page
Tivoli Common Agent Services messages
Guid Guid
Tivoli Common Agent Services messages
Page
AuthXMLAddUser userID password typename typename
Page
CTGEM0150I Initializing the recovery service
CTGEM0151I Loading the recovery listeners
CTGEM0152I The recovery listener classname was loaded
CTGEM0154E The recovery service cannot be initialized
CTGEM0155I The recovery service started successfully
CTGEM0162I The recovery service received a recovery request
CTGEM0156I The registration server was missing
CTGEM0157I Registration server trust failure
Tivoli Common Agent Services messages
Page
CTGEM2124I applicationname version version build build
Page
Appendix A. Common Agent serviceability tool
Running the serviceability tool
Contents of the CASservice.zip file
Components
File name File path Html service file
All files from config directory
MSinfo output file Windows only
Key files from base directory
All files from logs\install directory
File name File path All files from logs directory
Page
Appendix B. Support information
Searching knowledge bases
Search the Internet
Obtaining fixes
Contacting IBM Software Support
Determine the business impact of your problem
Describe your problem and gather background information
Submit your problem to IBM Software Support
Severity
Page
Appendix C. Notices
229
Trademarks
Index
DB2
Unix
Windows
Page
Page
SC32-2216-00