IBM E027SLL-H Troubleshooting Guide - Page 209

Ctira_hostname

Get IBM E027SLL-H - Tivoli Monitoring - PC PDF manuals and user guides View all IBM E027SLL-H manuals
Add to My Manuals
Save this manual to your list of manuals

Page 209 highlights

be myhost1.acme.north.prod.com. Inclusion of the network domain name causes the agent name in the example above to expand to SERVER1:myhost1.acme.north.prod.com:KXX. This resulting name is 39 characters long. It is truncated to 32 characters resulting in the name SERVER1:myhost1.acme.north.prod. The agent name truncation is only a problem if there is more than one monitoring agent on the same system. In this case, the agent name truncation can result in collisions between agent products attempting to register using the same truncated name value. When truncated agent names collide on the same system, this can lead to Tivoli Enterprise Monitoring Server problems with corrupted EIB tables. The agent name collision in the Tivoli Enterprise Monitoring Server might cause a registered name to be associated with the wrong product. In general, create names that are short but meaningful within your environment. Use the following guidelines: v Each name must be unique. One name cannot match another monitoring agent name exactly. v Each name must begin with an alpha character. v Do not use blanks or special characters, including $, #, and @. v Each name must be between 2 and 32 characters in length. v Monitoring agent naming is case-sensitive on all operating systems. Create the names by completing the following steps: 1. Open the configuration file for the monitoring agent, which is located in the following path: v On Windows: &install_dir;\tmaitm6\Kproduct_codeCMA.INI. For example, the product code for the Monitoring Agent for Windows OS is NT and the file name is KNTCMA.INI. v On UNIX and Linux: /config/product_code.ini and product_code.config. For example, the file names for the Monitoring Agent for UNIX OS are ux.ini and ux.config. 2. Find the line the begins with CTIRA_HOSTNAME=. 3. Type a new name for host name that is a unique, shorter name for the host computer. The final concatenated name including the subsystem name, new host name, and agent code, cannot be longer than 32 characters. Note: You must ensure that the resulting name is unique with respect to any existing monitoring component that was previously registered with the monitoring server. 4. Save the file. 5. Restart the agent. 6. If you do not find the files mentioned in Step 1, perform the workarounds listed in the next paragraph. If you do not find the files mentioned in the preceding steps, perform the following workarounds: 1. Change CTIRA_HOSTNAME environment variable in the configuration file of the monitoring agent. v Find the KAGENT_CODEKENV file in the same path mentioned in the preceding row. v For z/OS agents, find the RKANPAR library. Chapter 10. Monitoring agent troubleshooting 191

  • 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
be myhost1.acme.north.prod.com. Inclusion of the network domain name causes
the agent name in the example above to expand to
SERVER1:myhost1.acme.north.prod.com:KXX. This resulting name is 39 characters
long. It is truncated to 32 characters resulting in the name
SERVER1:myhost1.acme.north.prod.
The agent name truncation is only a problem if there is more than one monitoring
agent on the same system. In this case, the agent name truncation can result in
collisions between agent products attempting to register using the same truncated
name value. When truncated agent names collide on the same system, this can lead
to Tivoli Enterprise Monitoring Server problems with corrupted EIB tables. The
agent name collision in the Tivoli Enterprise Monitoring Server might cause a
registered name to be associated with the wrong product.
In general, create names that are short but meaningful within your environment.
Use the following guidelines:
v
Each name must be unique. One name cannot match another monitoring agent
name exactly.
v
Each name must begin with an alpha character.
v
Do not use blanks or special characters, including $, #, and @.
v
Each name must be between 2 and 32 characters in length.
v
Monitoring agent naming is case-sensitive on all operating systems.
Create the names by completing the following steps:
1.
Open the configuration file for the monitoring agent, which is located in the
following path:
v
On Windows:
&install_dir;\tmaitm6\Kproduct_codeCMA.INI
. For example,
the product code for the Monitoring Agent for Windows OS is NT and the
file name is
KNTCMA.INI
.
v
On UNIX and Linux:
/config/product_code.ini
and
product_code.config
.
For example, the file names for the Monitoring Agent for UNIX OS are
ux.ini
and
ux.config
.
2.
Find the line the begins with
CTIRA_HOSTNAME=
.
3.
Type a new name for host name that is a unique, shorter name for the host
computer. The final concatenated name including the subsystem name, new
host name, and agent code, cannot be longer than 32 characters.
Note:
You must ensure that the resulting name is unique with respect to any
existing monitoring component that was previously registered with the
monitoring server.
4.
Save the file.
5.
Restart the agent.
6.
If you do not find the files mentioned in Step 1, perform the workarounds
listed in the next paragraph.
If you do not find the files mentioned in the preceding steps, perform the
following workarounds:
1.
Change
CTIRA_HOSTNAME
environment variable in the configuration file of the
monitoring agent.
v
Find the
K
AGENT_CODE
KENV
file in the same path mentioned in the preceding
row.
v
For z/OS agents, find the
RKANPAR
library.
Chapter 10. Monitoring agent troubleshooting
191