Preface, Who should read this book, Publications | IBM 51 guide

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 information or tasks that apply only to one application or the other.

Who should read this book

This book should be read by system administrators, operators, or anyone else responsible for performing orchestration and provisioning tasks with the application. The book is also addressed to all Tivoli Customer Support service engineers or developers who are responsible for providing customer support and for troubleshooting Tivoli Intelligent Orchestrator.

People reading this book should have knowledge in the following areas:

vWindows® 2000 Server or Windows Server 2003

vLinux® on Intel®

vIBM® AIX® operating system

vSun Solaris operating system

vSUSE Linux Enterprise Server 8 for Linux on iSeries™

vNetworking concepts

vBasic operating system commands

vDB2 Universal Database™ Enterprise Server Edition or Oracle9i Database operation, configuration, and maintenance

vWebSphere® Application Server

vBasic SQL commands

vXML

vThe Internet

Refer to the online help for more information on configuring and administering Tivoli Intelligent Orchestrator.

Publications

This section lists publications in the Tivoli Intelligent Orchestrator library and related documents. It also describes how to access Tivoli publications online and how to order Tivoli publications.

Read the descriptions in the Tivoli Intelligent Orchestrator library, the prerequisite publications, and the related publications to determine which publications you might find helpful. After you determine the publications you need, refer to the instructions for accessing publications online.

Tivoli Intelligent Orchestrator library

The publications in the Tivoli Intelligent Orchestrator library are:

vTivoli Intelligent Orchestrator Installation Guide

© Copyright IBM Corp. 2003, 2006

vii

Image 9

IBM 51 manual Preface, Who should read this book, Publications, Tivoli Intelligent Orchestrator library

Contents

Problem Determination and Troubleshooting Guide Page Problem Determination and Troubleshooting Guide Page Contents Troubleshooting the agent Tivoli Common Agent Page Who should read this book PrefacePublications Tivoli Intelligent Orchestrator library Related publications and resources Prerequisite publications Accessing publications online AccessibilityOrdering publications Conventions used in this book Tivoli software training Support informationTypeface conventions Monospace Product and system overview Introduction to troubleshooting Product comparison Orchestrating provisioningTivoli Intelligent Orchestrator Tivoli Provisioning Manager Tivoli Intelligent Orchestrator components Product architectureData center model Policy engine Global resource manager Objective analyzerDeployment engine Automation packages Problem classification Built-in troubleshooting featuresProduct maintenance Backing up the system Performing periodic checks and maintenance Problem resolutionClick Technical documentation on the left Defining the problem Problem determination methodologies Determining where the problem lies and what it is Identifying the cause of the problemVerifying whether the problem can be replicated Checking whether the problem has occurred before Fixing the problem DB2 Universal Database verification Troubleshooting the prerequisite installation Unix IBM Tivoli Directory Server verification Windows LDAPInstallDirectory\var\ Security.xml WebSphere Application Server verification Java.security Server.xmlSas.client.props SystemOut.log Map Tivoli Intelligent Orchestrator resource references Secure Authentication Services Ldap Http Transport Service Simple Object Access Protocol SoapApplications Tcear Application Tivoli Intelligent Orchestrator installation Remote Method Invocation RMIStartup 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 Accessing the knowledge bases Using the available command line toolsTivoli Intelligent Orchestrator command line tools Password current ChangePassword.cmdWasadmin password ChangePassword.sh user DcmQueryCommandt.sh DcmQueryCommandt.cmdDcmExport.cmd -d OutputFilename RetrieveDetails.cmd IdeviceIdRetrieveDetails.sh Packagelocation Siregister.cmdRepositoryname Repositorymountpoint UpdateCredential.cmd CommandInternaluserpassword WASAdminUser XmlImport.cmd fileURL WebSphere Application Server command line toolsFileURL xmlImport.sh FileURL fileURL Name Location Description IBM Tivoli Directory Server command line toolsPage Message logs Log file typesMessage ID format Code Subsystem Message ID Message elementsMessage text Explanation Common Base Event logs Trace logsPage Locating and configuring log files Log locationsLog directory files Logging levels Configuring logs with log4jLog4j.prop Windows Locating and configuring log files Log level defaults RollingFileAppender defaultsConfiguring log4j dynamically Example Preparing log files for review by IBM Tivoli SupportPage Log files for product setup Log files for the uninstall processTivoli Intelligent Orchestrator log files Log files for starting and stopping the server Deployment engine log files Log files for the Web interface Workflow logs Automation package logs Logs for data collection and decision making This log file stores error Installation logs for individual prerequisites Installation log files for prerequisitesMiddleware prerequisite log files WebSphere Application Server WebSphere Application Server Runtime logs for prerequisitesDirectory Server Linux and Solaris Directory Server DB2 Universal Database Tivoli Agent Manager Problems with installation Linux, you cannot create the user tioadminCause Solution Microsoft Active Directory installation fails Environment variables not set for user tioadmin Cause On AIX, Linux, and Solaris Or, to uninstall silently Problems with logging Cause SolutionYou cannot log You cannot change your password DB2 Universal Database creates a database state error Problems with workflows Solution workflowLogExport tool Shell command error Resource temporarily unavailable Syntax for Unix $TIOHOME/tools Example workflow log export Workflow does not install 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 Excel requirements Operating system requirements Common agents unable to communicate with the agent manager Device Manager limitations There is a maximum size for returnResult parameter storage Agent receives an Http Unauthorized 401 response code Known report limitationsRunning any report with too many objects selected fails Page Locating the installation log files Troubleshooting the agent managerLog files for the agent manager Packaging the log files Guid Log file name Description Locating the remote registry logs Locating the uninstallation log files Locating the runtime log files Locating the DB2 Universal Database runtime logsLog File Description Installation and uninstallation verifications Verifying that the agent manager service is runningDetermining the version of agent manager Errors starting the agent manager application server Verifying the installation of WebSphere Application ServerErrors starting the agent manager application Verifying the connection to the registry Enabling and disabling tracing Task Value in Trace Specification text boxEnabling tracing Disabling tracing Ensure that Enable Trace is not checked Click OK Registration and communication failures Common problems Cannot start the WebSphere Administrative Console Problems using the WebSphere Administrative ConsoleAs a Windows service Using a Windows command StopServer server1 startServer server1 Page General data to collect for Tivoli Support Contacting IBM Tivoli Software Support Location PackageLog ZIP toolSyntax Returned file Linux and Unix PrerequisitesPage Common subsystem messages Tivoli Intelligent Orchestrator messagesCOPCOM001E The system cannot delete the VALUE0 file COPCOM003E The system cannot find the VALUE0 dcm policy COPCOM015E The system cannot get a Jndi context COPCOM012E The server VALUE0 does not have a locale value COPCOM024E The system cannot use the VALUE0 JMS destination COPCOM016E The directory VALUE0 does not exist COPCOM041E The system failed to parse the VALUE0 XML file COPCOM040E The system failed to load the VALUE0 XML fileCOPCOM042E The system cannot read the VALUE0 XML file COPCOM050E Application VALUE0 not found COPCOM059E The system cannot find a rule at position VALUE0 COPCOM058E The system cannot find application tier VALUE0COPCOM061E The system cannot find customer VALUE0 COPCOM063E The system cannot find the DCM object ID VALUE0 COPCOM083E The system cannot find power unit VALUE0 COPCOM082E The system cannot find power outlet VALUE0COPCOM071E The system cannot find the load balancer VALUE0 COPCOM075E The system cannot find NIC VALUE0 COPCOM097E The system cannot find the VALUE0 switch COPCOM096E The system did not find the VALUE0 switch portCOPCOM090E The system cannot find the VALUE0 software stack COPCOM091E The system cannot find the VALUE0 software state COPCOM125E a Telnet error occurred COPCOM124E a Telnet error occurredCOPCOM115E There is not enough data to complete the task COPCOM116E The operation timed out COPCOM140E An error occurred VALUE0 COPCOM136E The system cannot find error VALUE0COPCOM143E a shell command error VALUE0 occurred COPCOM155E The system cannot find the VALUE0 boot server COPCOM158E The system cannot find the VALUE0 interface card COPCOM159E The system cannot find the VALUE0 access ruleCOPCOM161E The system cannot find the resource VALUE0 COPCOM170E The system cannot find this route VALUE0 COPCOM194E The system cannot find the VALUE0 storage volume COPCOM195E The system cannot find the VALUE0 volume managerCOPCOM191E The system cannot find the VALUE0 disk manager COPCOM198E The system cannot find the VALUE0 file system COPCOM197E The system cannot find the VALUE0 logical volumeCOPCOM203E The system cannot find the VALUE0 data path COPCOM204E The system cannot find the VALUE0 zone set COPCOM219E The database cannot complete the query COPCOM217E The system cannot create the output file VALUE0COPCOM226E The VALUE0 server template is not valid COPCOM230E The system cannot find the VALUE0 host platform COPCOM243E The system cannot find the VALUE0 router COPCOM237E The system cannot find the VALUE0 software module COPCOM274E The system cannot find the discoverable VALUE0 COPCOM269E The switch endpoint mode VALUE0 is not valid COPCOM282E Port VALUE0 is already connected to port VALUE1 COPCOM278E The system cannot find the VALUE0 storage manager COPCOM302E Port number VALUE0 is not unique COPCOM303E VALUE0 already existsCOPCOM305E The Vlan name cannot be null COPCOM317E The system cannot find the VALUE0 image type COPCOM321E The system cannot find the VALUE0 imageCOPCOM323E The policy type VALUE0 is not valid COPCOM354E The offering with ID VALUE0 cannot be found COPCOM353E The service with ID VALUE0 cannot be found COPCOM355E The scheduled task type VALUE0 is not valid COPCOM358E The service with name VALUE0 cannot be foundCOPCOM357E The Order of ID VALUE0 cannot be found COPCOM360E The subscription of ID VALUE0 cannot be found COPCOM377E Internal Error Null AgentGUID was specified COPCOM378E AgentManager did not find the Agent ID VALUE0COPCOM385E The system cannot find the report VALUE0 COPCOM396E The filter format is not valid. Filter VALUE0 COPCOM395E The TCM object type VALUE0 was not foundCOPCOM400E No TCM Gateways were found for Hostname VALUE0 COPCOM401E The endpoint lookup returned null for VALUE0 COPCOM407E Profile VALUE0 is not a managed profile COPCOM405E The Profile Manager is VALUE0COPCOM408E The Endpoint subscriber VALUE0 does not exist COPCOM417E The filter VALUE0 lacks a parent component COPCOM432E The access domain VALUE0 is unknown COPCOM431E The instance access role VALUE0 is unknownCOPCOM430E The instance permission VALUE0 is unknown COPCOM433E The domain role VALUE0 is unknown COPCOM443E The system cannot create the file VALUE0 COPCOM442E The type VALUE0 is not a valid filter typeCOPCOM457E An unknown event type VALUE0 occured COPCOM458E An unknown event consumer VALUE0 occured COPCOM473E The LCF installation directory is not specified COPCOM468E The SI image resource VALUE0 registers an errorCOPCOM465E a Security Group with name VALUE0 already exists COPCOM466E Bad SI package image format with VALUE0 COPCOM481E The value for Broadcast Disable must be a 0 or COPCOM480E The value for Http Disable must be a 0, 1, 2 orCOPCOM482E The Login Interval is not correct COPCOM494E Unable to connect to endpoint using RXA COPCOM503E Error converting path VALUE0 to DOS style path COPCOM499E Error copying file using RXA VALUE0COPCOM502E The system cannot create the directory VALUE0 COPCOM514E The database sequence VALUE0 does not exist COPCOM532E The server VALUE0 cannot be accessed or updated COPCOM521E Unable to read xml config file VALUE0COPCOM533E The DCM object VALUE0 cannot be updated COPCOM525E Cannot find DCM Property Id VALUE0 COPCOM539E Task VALUE0 Task Id VALUE1 failed Deployment engine subsystem messages COPDEX002E The system cannot use the VALUE0 JMS destination COPDEX001E The system cannot get a Jndi contextCOPDEX005E The VALUE0 logical operation does not exist COPDEX008E break cannot be used inside of a finally block COPDEX019E The condition VALUE0 is not valid COPDEX033E Error code for unit tests onlyCOPDEX020E The system requires the VALUE0 attribute COPDEX022E The ID VALUE0 is not an integer COPDEX039E a configuration error occurred COPDEX038E a database error occurred VALUE0COPDEX041E a deployment error occurred COPDEX040E a deployment engine exception occurred VALUE0 COPDEX062E a data insert error VALUE0 occurred COPDEX060E a workflow XML parser error VALUE0 occurredCOPDEX063E An XML data parsing error VALUE0 occurred COPDEX069E The system cannot process the data update VALUE0 COPDEX082E The system cannot find the input file VALUE0 COPDEX081E The system cannot specify an input fileCOPDEX083E The input file VALUE0 is empty COPDEX084E The operation type VALUE0 is not identifiedPage COPDEX130E The deployment request id=VALUE0 was cancelled COPDEX129E a workflow compiler error occurred VALUE0COPDEX127E The VALUE0 variable is already declared COPDEX128E The VALUE0 variable does not exist COPDEX140E The deployment request VALUE0 is not found COPDEX141E The specified LDO VALUE0 is not foundCOPDEX142E The specified workflow VALUE0 is not found COPDEX150E Unknown instance permission VALUE0 COPDEX149E No such parameter VALUE0COPDEX151E Duplicate permission VALUE0 for parameter VALUE1 COPDEX153E The size of input arrays are different COPDEX176E The parameter VALUE0 cannot be null COPDEX170E The VALUE0 Java plug-in does not existCOPDEX178E To do VALUE0 COPDEX183E DCM object VALUE0 does not have attribute VALUE1 J2ee subsystem messages Job Distribution Service JDS subsystem messages COPJEE009E This feature is not supported COPJEE035E The system cannot find the RSA credentials VALUE0 COPJEE032E The system cannot recognize the database type COPJEE050E The specified resource pool VALUE0 is not valid COPJEE049E The operating mode VALUE0 is not validCOPJEE055E No software stack is associated with VALUE0 COPJEE056E The requested object VALUE0 is already locked COPJEE068E The deployment request parameter VALUE0is missing COPJEE086E a monitoring configuration was not selected COPJEE082E The system cannot load datasource VALUE0COPJEE093E The specified position is already occupied COPJEE105E An error occurred VALUE0 COPJEE101E a user interface error occurred VALUE0COPJEE106E The upgrade type is not valid COPJEE112E a power outlet already exists COPJEE199E The upgrade type is not valid COPJEE167E The server ID is not validCOPJEE201E Both objects must be of the type DcmObject COPJEE232E The VALUE0 module type is not valid COPJEE207E a discovery technology was not selected COPJEE271E UI Exception Problem ID UIVALUE0, user=VALUE1 COPJEE272E Problem ID UIVALUE0COPJEE240E The system cannot create the deployment plan COPJEE299E The system cannot realize the deployment plan COPJEE289E The deployment request ID VALUE0 does not existPage COPJEE326E The system failed to delete deployment request COPJEE334E The access to DB driver VALUE0 is not allowedCOPJEE333E The system cannot find DB driver VALUE0 COPJEE335E Instantiation of DB driver VALUE0 failed COPJEE350E a data insert error VALUE0 occurred COPJEE345E Multiple Password credentials were returnedCOPJEE351E The system cannot process the data update VALUE0 COPJEE356E a system error VALUE0 occurred COPJEE379E The workflow was already added COPPEZ005E The system cannot create the Snmp connection Policy engines subsystem messagesCOPPEZ008E The system cannot estimate Number of servers COPPEZ009E The system cannot open the VALUE0 file COPPEZ044E VALUE0 is not valid for a VALUE1 context COPPEZ042E VALUE0 is not a valid device typeCOPPEZ047E The data acquisition thread is not working COPPEZ049E VALUE0 is not a valid VALUE1 metric COPPEZ077E An error VALUE0 occurred COPPEZ073E An Snmp IO error occurredCOPPEZ079E a resource broker error occurred COPPEZ110E a task library lookup error occurred COPPEZ115E The system cannot obtain a application tier ID Common agent subsystem messagesCOPPEZ116E The endpoint label is null or empty COPTCA001E Cannot get proxy for interface on Agent VALUE0 TC driver manager subsystem messages COPTDM009E The system cannot copy the file VALUE0 to VALUE1 COPTDM003E The application is not specified COPTDM030E The system cannot save the changes COPTDM026E The system cannot open the VALUE0 file COPTDM062E The system cannot allocate the IP address COPTDM060E The Jdbc driver caused an SQL exceptionCOPTDM063E The system cannot allocate the server COPTDM064E The system cannot allocate virtual server VALUE0 COPTDM082E The system cannot find the RSA credentials VALUE0 COPTDM089E The system cannot find the switch port ID VALUE0 COPTDM099E The system cannot reboot device ID VALUE0COPTDM098E The system cannot move port COPTDM109E The load balancing algorithm VALUE0 is not valid COPTDM108E The integer value VALUE0 is not validCOPTDM111E The SSH path is not valid COPTDM112E The SSH user name VALUE0 is not valid COPTDM131E The SecureShell SSH configuration is not valid COPTDM121E a driver error occurredCOPTDM133E The timeout value VALUE0=VALUE1 is not valid COPTDM119E No device is associated with SAP ID VALUE0 COPTDM165E a RemoteInstaller error occurred COPTDM162E a deployment error occurredCOPTDM152E The TCDriver VALUE0 is missing item VALUE1 COPTDM157E The request timed out after VALUE0 milliseconds COPTDM184E Overwriting of file VALUE0 is not allowed COPTDM183E Upgrade of TCDriver VALUE0 is not allowed Utilities subsystem messages COPUTL015E Try to obtain file VALUE0 from environment COPUTL043E Error Message VALUE0COPUTL023E Processing Migration Step VALUE0 COPUTL033E Failed SQL Message VALUE0 Compliance Messages Tivoli Intelligent Orchestrator messages Group Messages Networking Messages COPNET018E The switch port VALUE0 is already connected COPNET015E The switch endpoint mode VALUE0 is not validCOPNET026E The system cannot find the VALUE0 access rule COPNET014E The system cannot find Vlan VALUE0 CTGRI0002E Session not established RXA MessagesCTGRI0008E a unique directory could not be created CTGRI0009E pathname cannot be removed CTGRI0018E An error occurred in SCP communication CTGRI0015E The native Windows service binary cannot be readCTGRI0019E RSH could not bind to any local privileged port CTGRI0020E Could not find the remote user RemoteUser Software Distribution Messages DISSP6015E An error occurred loading the package Message Variables where file nameDISSP6016E An error occurred saving the package Correctly installed on your OS/400 DISSP6021E Failed to import file name DISSP6020E Failed to export file nameDISSP6023E Directory not found DISSP6024E Link not found DISSP6037W The configuration file specified is not valid DISSP6030W The configuration file file name was not foundDISSP6031W The sample file file name was not found DISSP6033W Unable to create the working directory DISSP6044E Enter a value in the suggested range DISSP6046E An error occurred while unpacking the SPB Password are defined in Tivoli Provisioning Manager WebUI Common Agent messages Tivoli Common Agent Services messagesBTC0006I The common agent has stopped BTC0007I The common agent MBeanServer has started Name at port number BTC1031I The common agent has been reset BTC1034I Certificate revocation list has been RenewedBTC1039I Credentials have been renewed BTC1044I command to reset the security credentials BTC1042I command to renew the certificate revocation list Tivoli Common Agent Services messages Administrator Response To correct this problem BTC1050I trueBTC1051I false BTC2205I The common agent is stopping BTC2200I The system is restarting the common agent BTC2406I command to get the locale language and/or region BTC2404I command to set the locale to the languageBTC2407E The JLog service JLogService was not found BTC2209I The common agent is being initialized BTC3004E The update target file, bundlename, was not found BTC2412I Locale was not set. The defaultBTC3005E The update source file, bundlename, was not found BTC2411I Locale was successfully set to BTC3101I The bundle was successfully updated BTC3010E The installation of the bundlename bundle failedBTC3104I Bundle was successfully Uninstalled BTC3011E Updating the bundlename bundle failed BTC3115E The post installation failed BTC3107I System has invoked preUpdate LifecycleActivator for BTC3118I command to install a bundle from the specified URL BTC3117E The preupdate of the bundle, bundlename failedBTC3119I command to update the specified bundle BTC3120I command to uninstall the specified bundle BTC3142I Bundlename bundle was Successfully updated BTC3140I Bundlename bundle was Successfully installedBTC3143I Update to the bundlename bundle Failed. cause BTC3144I Bundlename bundle was uninstalled Successfully BTC3164I Unknown common agent command BTC3163I Unknown subagent bundle commandBTC3166I Installed BTC3170I Uninstalled BTC4004I Connector service has been stopped Undeployed BTC3175I command to get the state of the specified bundle BTC4019I Commands available BTC4014I To get help for a serviceBTC4022I Connector is active BTC4023I command to check if the connector service is alive BTC4030I command to get the ID of the common agent BTC4027I command to restart the common agentBTC4032I command to regenerate the ID of the common agent BTC4028I unknown parameter BTC4047I servicename BTC4046I configfileBTC4045E The connection from IPaddress was rejected BTC5006I Processname status collection Process is starting BTC5007I Processname status collection Process is ending BTC5018I Status report for host hostname, URIWas delivered successfully BTC5043I command to upgrade a common agent and its JRE BTC5042I command to upgrade a common agentBTC5045I The common agent upgrade completed successfully BTC5027I Status has been sent Exception Page About the error that occurred BTC5073I command args Value specified is value. The defaultAdministrator Response No action required Agent Manager messages Tivoli Common Agent Services messages Page Administrator Response Contact IBM Customer CTGEM0011E The certificate authority was not initializedCTGEM0015E 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 CTGEM0151I Loading the recovery listeners CTGEM0150I Initializing the recovery serviceCTGEM0152I The recovery listener classname was loaded CTGEM0154E The recovery service cannot be initialized CTGEM0162I The recovery service received a recovery request CTGEM0155I The recovery service started successfullyCTGEM0156I The registration server was missing CTGEM0157I Registration server trust failure Tivoli Common Agent Services messages Page CTGEM2124I applicationname version version build build Page Running the serviceability tool Appendix A. Common Agent serviceability toolContents of the CASservice.zip file Components All files from config directory File name File path Html service fileMSinfo output file Windows only Key files from base directory File name File path All files from logs directory All files from logs\install directoryPage Searching knowledge bases Appendix B. Support informationSearch the Internet Obtaining fixes Contacting IBM Software Support Describe your problem and gather background information Determine the business impact of your problemSubmit your problem to IBM Software Support SeverityPage 229 Appendix C. Notices Trademarks DB2 Index Unix Windows Page Page SC32-2216-00