Preparing log files for review by IBM Tivoli Support

The Tivoli Intelligent Orchestrator application server automatically reloads the log4j configurations 60 seconds after you save the properties file. You do not need to restart the Tivoli Intelligent Orchestrator server. The updated log4j configuration will implement after 60 seconds.

Example:

To enable the TC driver manager to append to its log file located in the %TIO_LOGS%\tcdrivermanager directory, complete these steps:

1.Open log4j-util.prop in a text editor.

2.Change the default log4j.appender.file.append=false to log4j.appender.file.append=true.

3.Save the file.

Preparing log files for review by IBM Tivoli Support

Tivoli Intelligent Orchestrator includes packageLog, a log management tool that simplifies the problem determination process. For more information, see “packageLog ZIP tool” on page 92.

Chapter 4. Locating and configuring log files 43

Page 55

Image 55

IBM 51 manual Preparing log files for review by IBM Tivoli Support, Example

Contents

Problem Determination and Troubleshooting Guide Page Problem Determination and Troubleshooting Guide Page Contents Troubleshooting the agent Tivoli Common Agent Page Tivoli Intelligent Orchestrator library PrefaceWho should read this book Publications Related publications and resources Prerequisite publications Accessibility Accessing publications onlineOrdering publications Monospace Tivoli software training Support informationConventions used in this book Typeface conventions Product and system overview Introduction to troubleshooting Orchestrating provisioning Product comparisonTivoli Intelligent Orchestrator Tivoli Provisioning Manager Policy engine Product architectureTivoli Intelligent Orchestrator components Data center model Automation packages Objective analyzerGlobal resource manager Deployment engine Backing up the system Built-in troubleshooting featuresProblem classification Product maintenance Problem resolution Performing periodic checks and maintenanceClick Technical documentation on the left Defining the problem Problem determination methodologies Checking whether the problem has occurred before Identifying the cause of the problemDetermining where the problem lies and what it is Verifying whether the problem can be replicated 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 SystemOut.log Server.xmlJava.security Sas.client.props Map Tivoli Intelligent Orchestrator resource references Secure Authentication Services Ldap Tcear Application Simple Object Access Protocol SoapHttp Transport Service Applications Remote Method Invocation RMI Tivoli Intelligent Orchestrator installationStartup 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 basesTivoli Intelligent Orchestrator command line tools ChangePassword.sh user ChangePassword.cmdPassword current Wasadmin password OutputFilename DcmQueryCommandt.cmdDcmQueryCommandt.sh DcmExport.cmd -d IdeviceId RetrieveDetails.cmdRetrieveDetails.sh Repositorymountpoint Siregister.cmdPackagelocation Repositoryname WASAdminUser CommandUpdateCredential.cmd Internaluserpassword FileURL fileURL WebSphere Application Server command line toolsXmlImport.cmd fileURL FileURL xmlImport.sh Name Location Description IBM Tivoli Directory Server command line toolsPage Code Subsystem Log file typesMessage logs Message ID format Explanation Message elementsMessage ID Message text Common Base Event logs Trace logsPage Log locations Locating and configuring log filesLog directory files Windows Configuring logs with log4jLogging levels Log4j.prop Locating and configuring log files RollingFileAppender defaults Log level defaultsConfiguring log4j dynamically Example Preparing log files for review by IBM Tivoli SupportPage Log files for the uninstall process Log files for product setupTivoli 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 WebSphere Application Server Installation log files for prerequisitesInstallation logs for individual prerequisites Middleware prerequisite log files Linux and Solaris Runtime logs for prerequisitesWebSphere Application Server Directory Server Directory Server DB2 Universal Database Tivoli Agent Manager Linux, you cannot create the user tioadmin Problems with installationCause 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 loggingYou 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 Known report limitations Agent receives an Http Unauthorized 401 response codeRunning any report with too many objects selected fails Page Packaging the log files Troubleshooting the agent managerLocating the installation log files Log files for the agent manager Guid Log file name Description Locating the remote registry logs Locating the uninstallation log files Locating the DB2 Universal Database runtime logs Locating the runtime log filesLog File Description Verifying that the agent manager service is running Installation and uninstallation verificationsDetermining the version of agent manager Verifying the connection to the registry Verifying the installation of WebSphere Application ServerErrors starting the agent manager application server Errors starting the agent manager application Disabling tracing Task Value in Trace Specification text boxEnabling and disabling tracing Enabling tracing Ensure that Enable Trace is not checked Click OK Registration and communication failures Common problems Using a Windows command Problems using the WebSphere Administrative ConsoleCannot start the WebSphere Administrative Console As a Windows service StopServer server1 startServer server1 Page General data to collect for Tivoli Support Contacting IBM Tivoli Software Support Returned file PackageLog ZIP toolLocation Syntax Linux and Unix PrerequisitesPage COPCOM003E The system cannot find the VALUE0 dcm policy Tivoli Intelligent Orchestrator messagesCommon subsystem messages COPCOM001E The system cannot delete the VALUE0 file 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 COPCOM050E Application VALUE0 not found COPCOM040E The system failed to load the VALUE0 XML fileCOPCOM041E The system failed to parse the VALUE0 XML file COPCOM042E The system cannot read the VALUE0 XML file COPCOM063E The system cannot find the DCM object ID VALUE0 COPCOM058E The system cannot find application tier VALUE0COPCOM059E The system cannot find a rule at position VALUE0 COPCOM061E The system cannot find customer VALUE0 COPCOM075E The system cannot find NIC VALUE0 COPCOM082E The system cannot find power outlet VALUE0COPCOM083E The system cannot find power unit VALUE0 COPCOM071E The system cannot find the load balancer VALUE0 COPCOM091E The system cannot find the VALUE0 software state COPCOM096E The system did not find the VALUE0 switch portCOPCOM097E The system cannot find the VALUE0 switch COPCOM090E The system cannot find the VALUE0 software stack COPCOM116E The operation timed out COPCOM124E a Telnet error occurredCOPCOM125E a Telnet error occurred COPCOM115E There is not enough data to complete the task COPCOM155E The system cannot find the VALUE0 boot server COPCOM136E The system cannot find error VALUE0COPCOM140E An error occurred VALUE0 COPCOM143E a shell command error VALUE0 occurred COPCOM170E The system cannot find this route VALUE0 COPCOM159E The system cannot find the VALUE0 access ruleCOPCOM158E The system cannot find the VALUE0 interface card COPCOM161E The system cannot find the resource VALUE0 COPCOM195E The system cannot find the VALUE0 volume manager COPCOM194E The system cannot find the VALUE0 storage volumeCOPCOM191E The system cannot find the VALUE0 disk manager COPCOM204E The system cannot find the VALUE0 zone set COPCOM197E The system cannot find the VALUE0 logical volumeCOPCOM198E The system cannot find the VALUE0 file system COPCOM203E The system cannot find the VALUE0 data path COPCOM230E The system cannot find the VALUE0 host platform COPCOM217E The system cannot create the output file VALUE0COPCOM219E The database cannot complete the query COPCOM226E The VALUE0 server template is not valid 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 COPCOM303E VALUE0 already exists COPCOM302E Port number VALUE0 is not uniqueCOPCOM305E The Vlan name cannot be null COPCOM321E The system cannot find the VALUE0 image COPCOM317E The system cannot find the VALUE0 image typeCOPCOM323E 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 COPCOM360E The subscription of ID VALUE0 cannot be found COPCOM358E The service with name VALUE0 cannot be foundCOPCOM355E The scheduled task type VALUE0 is not valid COPCOM357E The Order of ID VALUE0 cannot be found COPCOM378E AgentManager did not find the Agent ID VALUE0 COPCOM377E Internal Error Null AgentGUID was specifiedCOPCOM385E The system cannot find the report VALUE0 COPCOM401E The endpoint lookup returned null for VALUE0 COPCOM395E The TCM object type VALUE0 was not foundCOPCOM396E The filter format is not valid. Filter VALUE0 COPCOM400E No TCM Gateways were found for Hostname VALUE0 COPCOM417E The filter VALUE0 lacks a parent component COPCOM405E The Profile Manager is VALUE0COPCOM407E Profile VALUE0 is not a managed profile COPCOM408E The Endpoint subscriber VALUE0 does not exist COPCOM433E The domain role VALUE0 is unknown COPCOM431E The instance access role VALUE0 is unknownCOPCOM432E The access domain VALUE0 is unknown COPCOM430E The instance permission VALUE0 is unknown COPCOM458E An unknown event consumer VALUE0 occured COPCOM442E The type VALUE0 is not a valid filter typeCOPCOM443E The system cannot create the file VALUE0 COPCOM457E An unknown event type VALUE0 occured COPCOM466E Bad SI package image format with VALUE0 COPCOM468E The SI image resource VALUE0 registers an errorCOPCOM473E The LCF installation directory is not specified COPCOM465E a Security Group with name VALUE0 already exists COPCOM494E Unable to connect to endpoint using RXA COPCOM480E The value for Http Disable must be a 0, 1, 2 orCOPCOM481E The value for Broadcast Disable must be a 0 or COPCOM482E The Login Interval is not correct COPCOM514E The database sequence VALUE0 does not exist COPCOM499E Error copying file using RXA VALUE0COPCOM503E Error converting path VALUE0 to DOS style path COPCOM502E The system cannot create the directory VALUE0 COPCOM525E Cannot find DCM Property Id VALUE0 COPCOM521E Unable to read xml config file VALUE0COPCOM532E The server VALUE0 cannot be accessed or updated COPCOM533E The DCM object VALUE0 cannot be updated COPCOM539E Task VALUE0 Task Id VALUE1 failed Deployment engine subsystem messages COPDEX008E break cannot be used inside of a finally block COPDEX001E The system cannot get a Jndi contextCOPDEX002E The system cannot use the VALUE0 JMS destination COPDEX005E The VALUE0 logical operation does not exist COPDEX022E The ID VALUE0 is not an integer COPDEX033E Error code for unit tests onlyCOPDEX019E The condition VALUE0 is not valid COPDEX020E The system requires the VALUE0 attribute COPDEX040E a deployment engine exception occurred VALUE0 COPDEX038E a database error occurred VALUE0COPDEX039E a configuration error occurred COPDEX041E a deployment error occurred COPDEX069E The system cannot process the data update VALUE0 COPDEX060E a workflow XML parser error VALUE0 occurredCOPDEX062E a data insert error VALUE0 occurred COPDEX063E An XML data parsing error VALUE0 occurred COPDEX084E The operation type VALUE0 is not identified COPDEX081E The system cannot specify an input fileCOPDEX082E The system cannot find the input file VALUE0 COPDEX083E The input file VALUE0 is emptyPage COPDEX128E The VALUE0 variable does not exist COPDEX129E a workflow compiler error occurred VALUE0COPDEX130E The deployment request id=VALUE0 was cancelled COPDEX127E The VALUE0 variable is already declared COPDEX141E The specified LDO VALUE0 is not found COPDEX140E The deployment request VALUE0 is not foundCOPDEX142E The specified workflow VALUE0 is not found COPDEX153E The size of input arrays are different COPDEX149E No such parameter VALUE0COPDEX150E Unknown instance permission VALUE0 COPDEX151E Duplicate permission VALUE0 for parameter VALUE1 COPDEX183E DCM object VALUE0 does not have attribute VALUE1 COPDEX170E The VALUE0 Java plug-in does not existCOPDEX176E The parameter VALUE0 cannot be null COPDEX178E To do VALUE0 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 COPJEE056E The requested object VALUE0 is already locked COPJEE049E The operating mode VALUE0 is not validCOPJEE050E The specified resource pool VALUE0 is not valid COPJEE055E No software stack is associated with VALUE0 COPJEE068E The deployment request parameter VALUE0is missing COPJEE082E The system cannot load datasource VALUE0 COPJEE086E a monitoring configuration was not selectedCOPJEE093E The specified position is already occupied COPJEE112E a power outlet already exists COPJEE101E a user interface error occurred VALUE0COPJEE105E An error occurred VALUE0 COPJEE106E The upgrade type is not valid COPJEE167E The server ID is not valid COPJEE199E The upgrade type 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 COPJEE272E Problem ID UIVALUE0 COPJEE271E UI Exception Problem ID UIVALUE0, user=VALUE1COPJEE240E The system cannot create the deployment plan COPJEE299E The system cannot realize the deployment plan COPJEE289E The deployment request ID VALUE0 does not existPage COPJEE335E Instantiation of DB driver VALUE0 failed COPJEE334E The access to DB driver VALUE0 is not allowedCOPJEE326E The system failed to delete deployment request COPJEE333E The system cannot find DB driver VALUE0 COPJEE356E a system error VALUE0 occurred COPJEE345E Multiple Password credentials were returnedCOPJEE350E a data insert error VALUE0 occurred COPJEE351E The system cannot process the data update VALUE0 COPJEE379E The workflow was already added COPPEZ009E The system cannot open the VALUE0 file Policy engines subsystem messagesCOPPEZ005E The system cannot create the Snmp connection COPPEZ008E The system cannot estimate Number of servers COPPEZ049E VALUE0 is not a valid VALUE1 metric COPPEZ042E VALUE0 is not a valid device typeCOPPEZ044E VALUE0 is not valid for a VALUE1 context COPPEZ047E The data acquisition thread is not working COPPEZ110E a task library lookup error occurred COPPEZ073E An Snmp IO error occurredCOPPEZ077E An error VALUE0 occurred COPPEZ079E a resource broker error occurred COPTCA001E Cannot get proxy for interface on Agent VALUE0 Common agent subsystem messagesCOPPEZ115E The system cannot obtain a application tier ID COPPEZ116E The endpoint label is null or empty 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 COPTDM064E The system cannot allocate virtual server VALUE0 COPTDM060E The Jdbc driver caused an SQL exceptionCOPTDM062E The system cannot allocate the IP address COPTDM063E The system cannot allocate the server 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 VALUE0COPTDM098E The system cannot move port COPTDM112E The SSH user name VALUE0 is not valid COPTDM108E The integer value VALUE0 is not validCOPTDM109E The load balancing algorithm VALUE0 is not valid COPTDM111E The SSH path is not valid COPTDM119E No device is associated with SAP ID VALUE0 COPTDM121E a driver error occurredCOPTDM131E The SecureShell SSH configuration is not valid COPTDM133E The timeout value VALUE0=VALUE1 is not valid COPTDM157E The request timed out after VALUE0 milliseconds COPTDM162E a deployment error occurredCOPTDM165E a RemoteInstaller error occurred COPTDM152E The TCDriver VALUE0 is missing item VALUE1 COPTDM184E Overwriting of file VALUE0 is not allowed COPTDM183E Upgrade of TCDriver VALUE0 is not allowed Utilities subsystem messages COPUTL033E Failed SQL Message VALUE0 COPUTL043E Error Message VALUE0COPUTL015E Try to obtain file VALUE0 from environment COPUTL023E Processing Migration Step VALUE0 Compliance Messages Tivoli Intelligent Orchestrator messages Group Messages Networking Messages COPNET014E The system cannot find Vlan VALUE0 COPNET015E The switch endpoint mode VALUE0 is not validCOPNET018E The switch port VALUE0 is already connected COPNET026E The system cannot find the VALUE0 access rule CTGRI0009E pathname cannot be removed RXA MessagesCTGRI0002E Session not established CTGRI0008E a unique directory could not be created CTGRI0020E Could not find the remote user RemoteUser CTGRI0015E The native Windows service binary cannot be readCTGRI0018E An error occurred in SCP communication CTGRI0019E RSH could not bind to any local privileged port Software Distribution Messages Correctly installed on your OS/400 Message Variables where file nameDISSP6015E An error occurred loading the package DISSP6016E An error occurred saving the package DISSP6024E Link not found DISSP6020E Failed to export file nameDISSP6021E Failed to import file name DISSP6023E Directory not found DISSP6033W Unable to create the working directory DISSP6030W The configuration file file name was not foundDISSP6037W The configuration file specified is not valid DISSP6031W The sample file file name was not found DISSP6044E Enter a value in the suggested range DISSP6046E An error occurred while unpacking the SPB Password are defined in Tivoli Provisioning Manager WebUI BTC0007I The common agent MBeanServer has started Tivoli Common Agent Services messagesCommon Agent messages BTC0006I The common agent has stopped Name at port number BTC1034I Certificate revocation list has been Renewed BTC1031I The common agent has been resetBTC1039I Credentials have been renewed BTC1044I command to reset the security credentials BTC1042I command to renew the certificate revocation list Tivoli Common Agent Services messages BTC1050I true Administrator Response To correct this problemBTC1051I false BTC2205I The common agent is stopping BTC2200I The system is restarting the common agent BTC2209I The common agent is being initialized BTC2404I command to set the locale to the languageBTC2406I command to get the locale language and/or region BTC2407E The JLog service JLogService was not found BTC2411I Locale was successfully set to BTC2412I Locale was not set. The defaultBTC3004E The update target file, bundlename, was not found BTC3005E The update source file, bundlename, was not found BTC3011E Updating the bundlename bundle failed BTC3010E The installation of the bundlename bundle failedBTC3101I The bundle was successfully updated BTC3104I Bundle was successfully Uninstalled BTC3115E The post installation failed BTC3107I System has invoked preUpdate LifecycleActivator for BTC3120I command to uninstall the specified bundle BTC3117E The preupdate of the bundle, bundlename failedBTC3118I command to install a bundle from the specified URL BTC3119I command to update the specified bundle BTC3144I Bundlename bundle was uninstalled Successfully BTC3140I Bundlename bundle was Successfully installedBTC3142I Bundlename bundle was Successfully updated BTC3143I Update to the bundlename bundle Failed. cause BTC3170I Uninstalled BTC3163I Unknown subagent bundle commandBTC3164I Unknown common agent command BTC3166I Installed BTC4004I Connector service has been stopped Undeployed BTC3175I command to get the state of the specified bundle BTC4023I command to check if the connector service is alive BTC4014I To get help for a serviceBTC4019I Commands available BTC4022I Connector is active BTC4028I unknown parameter BTC4027I command to restart the common agentBTC4030I command to get the ID of the common agent BTC4032I command to regenerate the ID of the common agent BTC5006I Processname status collection Process is starting BTC4046I configfileBTC4047I servicename BTC4045E The connection from IPaddress was rejected BTC5018I Status report for host hostname, URI BTC5007I Processname status collection Process is endingWas delivered successfully BTC5027I Status has been sent BTC5042I command to upgrade a common agentBTC5043I command to upgrade a common agent and its JRE BTC5045I The common agent upgrade completed successfully Exception Page About the error that occurred Agent Manager messages Value specified is value. The defaultBTC5073I command args Administrator Response No action required Tivoli Common Agent Services messages Page CTGEM0011E The certificate authority was not initialized Administrator Response Contact IBM CustomerCTGEM0015E 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 CTGEM0154E The recovery service cannot be initialized CTGEM0150I Initializing the recovery serviceCTGEM0151I Loading the recovery listeners CTGEM0152I The recovery listener classname was loaded CTGEM0157I Registration server trust failure CTGEM0155I The recovery service started successfullyCTGEM0162I The recovery service received a recovery request CTGEM0156I The registration server was missing Tivoli Common Agent Services messages Page CTGEM2124I applicationname version version build build Page Components Appendix A. Common Agent serviceability toolRunning the serviceability tool Contents of the CASservice.zip file Key files from base directory File name File path Html service fileAll files from config directory MSinfo output file Windows only File name File path All files from logs directory All files from logs\install directoryPage Obtaining fixes Appendix B. Support informationSearching knowledge bases Search the Internet Contacting IBM Software Support Severity Determine the business impact of your problemDescribe your problem and gather background information Submit your problem to IBM Software SupportPage 229 Appendix C. Notices Trademarks DB2 Index Unix Windows Page Page SC32-2216-00