IBM 51 - Manual (Page 5)

Contents
Preface . . . . . . . . . . . . . . vii
Who should read this book . . . . . . . . . vii
Publications . . . . . . . . . . . . . . vii
Tivoli Intelligent Orchestrator library . . . . . vii
Prerequisite publications . . . . . . . . . viii
Related publications and resources . . . . . viii
Accessing publications online . . . . . . . ix
Ordering publications . . . . . . . . . . . ix
Accessibility . . . . . . . . . . . . . . ix
Tivoli software training . . . . . . . . . . . x
Support information . . . . . . . . . . . . x
Conventions used in this book . . . . . . . . x
Typeface conventions . . . . . . . . . . x
Chapter 1. Introduction to
troubleshooting . . . . . . . . . . . 1
Product and system overview . . . . . . . . 1
Product comparison . . . . . . . . . . . 2
Product architecture . . . . . . . . . . . . 3
Tivoli Intelligent Orchestrator components . . . 3
Prerequisites installed with Tivoli Intelligent
Orchestrator . . . . . . . . . . . . . 4
Built-in troubleshooting features . . . . . . . . 5
Problem classification . . . . . . . . . . . 5
Product maintenance . . . . . . . . . . . 5
Backing up the system . . . . . . . . . . 5
Performing periodic checks and maintenance . . 6
Problem resolution . . . . . . . . . . . . 6
Chapter 2. Problem determination
essentials for Tivoli Intelligent
Orchestrator . . . . . . . . . . . . . 7
Problem determination methodologies . . . . . . 7
Defining the problem . . . . . . . . . . 7
Identifying the cause of the problem . . . . . 8
Fixing the problem . . . . . . . . . . . 9
Troubleshooting methods for Tivoli Intelligent
Orchestrator and prerequisites . . . . . . . . 9
Troubleshooting the prerequisite installation . . 10
Tivoli Intelligent Orchestrator installation and
subcomponent configuration verification . . . 17
Tivoli Intelligent Orchestrator runtime problem
determination . . . . . . . . . . . . 21
Accessing the knowledge bases . . . . . . . 26
Using the available command line tools . . . . 26
Chapter 3. Log file types . . . . . . . 35
Message logs . . . . . . . . . . . . . . 35
Message ID format . . . . . . . . . . . 35
Message elements . . . . . . . . . . . 36
Trace logs . . . . . . . . . . . . . . . 37
Common Base Event logs . . . . . . . . . . 37
Chapter 4. Locating and configuring
log files . . . . . . . . . . . . . . 39
Log locations . . . . . . . . . . . . . . 39
Log directory files . . . . . . . . . . . 39
Logging levels . . . . . . . . . . . . . 40
Configuring logs with log4j . . . . . . . . . 40
log4j.prop . . . . . . . . . . . . . . 40
Log level defaults . . . . . . . . . . . 42
RollingFileAppender defaults . . . . . . . 42
Configuring log4j dynamically . . . . . . . 42
Preparing log files for review by IBM Tivoli
Support . . . . . . . . . . . . . . 43
Chapter 5. Tivoli Intelligent
Orchestrator log files . . . . . . . . 45
Log files for product setup . . . . . . . . . 45
Log files for the uninstall process . . . . . . . 45
Log files for starting and stopping the server . . . 46
Log files for the Web interface . . . . . . . . 47
Deployment engine log files . . . . . . . . . 47
Workflow logs . . . . . . . . . . . . . 48
Logs for data collection and decision making . . . 49
Automation package logs . . . . . . . . . . 49
Chapter 6. Middleware prerequisite log
files . . . . . . . . . . . . . . . . 51
Installation log files for prerequisites . . . . . . 51
Installation logs for individual prerequisites . . 51
Runtime logs for prerequisites . . . . . . . . 52
WebSphere Application Server . . . . . . . 52
DB2 Universal Database . . . . . . . . . 53
Directory Server . . . . . . . . . . . . 53
Tivoli Agent Manager . . . . . . . . . . 54
Chapter 7. Common problems and
known limitations in Tivoli Intelligent
Orchestrator . . . . . . . . . . . . 55
Problems with installation . . . . . . . . . 55
In Linux, you cannot create the user tioadmin . . 55
The system cannot connect to the IBM Tivoli
Directory Server during the Tivoli Intelligent
Orchestrator installation . . . . . . . . . 56
The installation of the DB2 Universal Database
Client on Windows 2003 system fails . . . . . 56
Installing the common agent and the agent
manager is not supported . . . . . . . . 57
The system cannot connect to the database server
during the Tivoli Intelligent Orchestrator
installation . . . . . . . . . . . . . 57
The Microsoft Active Directory installation fails 57
The Microsoft Active Directory installation fails
with invalid certificate value . . . . . . . . 58
© Copyright IBM Corp. 2003, 2006 iii