IBM E027SLL-H Troubleshooting Guide - Page 68

Setting the trace option for the tacmd commands, Setting the trace option for the IBM Tivoli

Page 68 highlights

To trace the 2way translator, set the trace level to (UNIT: KDY ALL) (UNIT: KHD_XA ALL) in the Summarization and Pruning Agent environment file for KBB_RAS1. Setting the trace option for the tacmd commands For Windows systems, manually edit the KUIENV file in the CANDLEHOME directory with the standard KBB_RAS1 statement to include the following: KBB_RAS1=ERROR(UNIT:ksh all) (UNIT:kui all) . On UNIX systems, manually edit the $CANDLEHOME/bin/tacmd shell script to add a line like the following example: KBB_RAS1=ERROR(UNIT:ksh all) (UNIT:kui all) In order to debug KT1 as well, edit the line to be like the following example: KBB_RAS1=ERROR(UNIT:ksh all) (UNIT:kui all) (UNIT:kt1 all) Setting the trace option for the IBM Tivoli Monitoring upgrade toolkit Table 4. Setting the trace option for the Tivoli Monitoring upgrade toolkit Trace option Instructions Endpoint tracing Run the following command to set log_threshold=3 or higher on an endpoint and enable endpoint tracing: wep ep set_config log_threshold=3 Tracing in a test environment. Traces are written to lcfd.log on the endpoint in $LCF_DATDIR. A Boolean value of TRUE or FALSE default. The default is FALSE. Run the following command from a Tivoli Management Environment command prompt to enable tracing:idlcall oid _set_debug TRUE where: oid Specifies the object ID of the Upgrade Manager object. Run the wlookup Framework command to locate the Upgrade Manager object ID in the Tivoli Management Environment: wlookup -a | grep Upgrade OS Agent tracing Note: Setting the trace value to TRUE sets all Upgrade Toolkit tools to TRUE, affecting all users running Upgrade Toolkit tools. A trace file named trace_tool_timestamp.log is created in the $DBDIR/AMX/trace/ directory in XML format, with tool being 'witmscantmr', 'witmassess', and 'witmupgrade', and timestamp a time stamp that includes data and time of execution. Each record in this log contains a time stamp and message. Additionally, these tools inherit Framework FFTC mechanisms such as wtrace and odstat for transaction and method stack traces. See the Tivoli management Framework documentation for more information about the commands. OS Agent tracing is enabled at a minimum level by default. Agent tracing levels can be adjusted with agent specific settings. Logs are stored in install_dir\installITM\ on Windows agents or install_dir/logs/ on UNIX-based systems agents. These logs follow the RAS1 log format. 50 IBM Tivoli Monitoring: Troubleshooting Guide

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310

To trace the 2way translator, set the trace level to (UNIT: KDYALL) (UNIT:
KHD_XA ALL) in the Summarization and Pruning Agent environment file for
KBB_RAS1.
Setting the trace option for the tacmd commands
For Windows systems, manually edit the KUIENV file in the
CANDLEHOME
directory
with the standard KBB_RAS1 statement to include the following:
KBB_RAS1=ERROR(UNIT:ksh all) (UNIT:kui all)
.
On UNIX systems, manually edit the
$CANDLEHOME/bin/tacmd
shell script to add a
line like the following example:
KBB_RAS1=ERROR(UNIT:ksh all) (UNIT:kui all)
In order to debug KT1 as well, edit the line to be like the following example:
KBB_RAS1=ERROR(UNIT:ksh all) (UNIT:kui all) (UNIT:kt1 all)
Setting the trace option for the IBM Tivoli Monitoring upgrade
toolkit
Table 4. Setting the trace option for the Tivoli Monitoring upgrade toolkit
Trace option
Instructions
Endpoint tracing
Run the following command to set
log_threshold=3
or higher on an endpoint and enable
endpoint tracing:
wep ep set_config log_threshold=3
Traces are written to
lcfd.log
on the endpoint in
$LCF_DATDIR
.
Tracing in a test
environment.
A Boolean value of TRUE or FALSE default. The default is FALSE.
Run the following command from a Tivoli Management Environment command prompt to
enable tracing:
idlcall oid _set_debug TRUE
where:
oid
Specifies the object ID of the Upgrade Manager object.
Run the
wlookup
Framework command to locate the Upgrade Manager object ID in the Tivoli
Management Environment:
wlookup -a | grep Upgrade
Note:
Setting the trace value to TRUE sets all Upgrade Toolkit tools to TRUE, affecting all
users running Upgrade Toolkit tools.
A trace file named
trace_tool_timestamp.log
is created in the
$DBDIR/AMX/trace/
directory in
XML format, with tool being 'witmscantmr', 'witmassess', and 'witmupgrade', and timestamp
a time stamp that includes data and time of execution. Each record in this log contains a time
stamp and message. Additionally, these tools inherit Framework FFTC mechanisms such as
wtrace
and
odstat
for transaction and method stack traces. See the Tivoli management
Framework documentation for more information about the commands.
OS Agent tracing
OS Agent tracing is enabled at a minimum level by default. Agent tracing levels can be
adjusted with agent specific settings. Logs are stored in
install_dir\installITM\
on
Windows agents or
install_dir/logs/
on UNIX-based systems agents. These logs follow the
RAS1 log format.
50
IBM Tivoli Monitoring: Troubleshooting Guide