Cisco WS-C4003 Software Guide - Page 421

Understanding the BOOT Environment Variable, Understanding the CONFIG_FILE Environment Variable

Page 421 highlights

Chapter 28 Modifying the Switch Boot Configuration Understanding How the Switch Boot Configuration Works The other bits in the configuration register function as follows when set: • Bit 5 (0x0020): Enables CONFIG_FILE recurrence. • Bit 6 (0x0040): Causes system software to clear NVRAM contents. • Bit 7 (0x0080): Enables OEM bit (not used). • Bit 8 (0x0100): Disables break. • Bit 9 (0x0200): Uses secondary bootstrap (not used by the ROM monitor). • Bit 10 (0x0400): Provides IP broadcast with all zeros (not used). • Bits 11/12 (0x0800/0x1000): These bits are always set to 0/0 (9600 baud). • Bit 13 (0x2000): Boots default Flash software if network boot fails (not used). • Bit 14 (0x4000): IP broadcasts do not have network numbers (not used). • Bit 15 (0x8000): Enables diagnostic messages and ignores NVRAM contents (not used). Understanding the BOOT Environment Variable The BOOT environment variable specifies a list of image files on various devices from which the switch can boot at startup. You can add several images to the BOOT environment variable to provide a fail-safe boot configuration. If the first file fails to boot the switch, subsequent images specified in the BOOT variable are tried until the switch boots or there are no additional images to attempt to boot. If there is no valid image to boot, the system enters ROM-monitor mode where you can manually specify an image to boot. The system stores and executes images in the order in which you added them to the BOOT variable. If you want to change the order in which images are tried at startup, you can either prepend and clear images from the BOOT variable to attain the desired order or you can clear the entire BOOT environment variable and then redefine the list in the desired order. Understanding the CONFIG_FILE Environment Variable In software release 5.2 and later, you can use the CONFIG_FILE environment variable to specify a list of configuration files on various devices to use to configure the switch at startup. You can specify one of the following functions: • Nonrecurring-When you add a list of configuration files to the CONFIG_FILE environment variable, the next time the switch is restarted, the system erases the configuration in NVRAM and uses the specified files to configure the switch. The CONFIG_FILE variable is cleared before the switch is configured. Nonrecurring is the default setting. • Recurring-When you add a list of configuration files to the CONFIG_FILE environment variable, the list is stored indefinitely in NVRAM. Each time the switch is restarted, the system erases the configuration in NVRAM and configures the switch using the configuration files specified. The CONFIG_FILE variable is not cleared. Note Remember that the CONFIG_FILE variable can be altered or its recurrence properties changed by commands in the configuration files used to configure the switch at startup. For information on specifying recurrence or nonrecurrence, see the "Setting CONFIG_FILE Recurrence" section on page 28-5. 78-12647-02 Software Configuration Guide-Catalyst 4000 Family, Catalyst 2948G, Catalyst 2980G, Releases 6.3 and 6.4 28-3

  • 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
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418
  • 419
  • 420
  • 421
  • 422
  • 423
  • 424
  • 425
  • 426
  • 427
  • 428
  • 429
  • 430
  • 431
  • 432
  • 433
  • 434
  • 435
  • 436
  • 437
  • 438
  • 439
  • 440
  • 441
  • 442
  • 443
  • 444
  • 445
  • 446
  • 447
  • 448
  • 449
  • 450
  • 451
  • 452
  • 453
  • 454
  • 455
  • 456
  • 457
  • 458
  • 459
  • 460
  • 461
  • 462
  • 463
  • 464
  • 465
  • 466
  • 467
  • 468
  • 469
  • 470
  • 471
  • 472
  • 473
  • 474
  • 475
  • 476
  • 477
  • 478
  • 479
  • 480
  • 481
  • 482
  • 483
  • 484
  • 485
  • 486
  • 487
  • 488
  • 489
  • 490
  • 491
  • 492
  • 493
  • 494
  • 495
  • 496
  • 497
  • 498
  • 499
  • 500
  • 501
  • 502
  • 503
  • 504
  • 505
  • 506
  • 507
  • 508
  • 509
  • 510

28-3
Software Configuration Guide—Catalyst 4000 Family, Catalyst 2948G, Catalyst 2980G, Releases 6.3 and 6.4
78-12647-02
Chapter 28
Modifying the Switch Boot Configuration
Understanding How the Switch Boot Configuration Works
The other bits in the configuration register function as follows when set:
Bit 5 (0x0020): Enables CONFIG_FILE recurrence.
Bit 6 (0x0040): Causes system software to clear NVRAM contents.
Bit 7 (0x0080): Enables OEM bit (not used).
Bit 8 (0x0100): Disables break.
Bit 9 (0x0200): Uses secondary bootstrap (not used by the ROM monitor).
Bit 10 (0x0400): Provides IP broadcast with all zeros (not used).
Bits 11/12 (0x0800/0x1000): These bits are always set to 0/0 (9600 baud).
Bit 13 (0x2000): Boots default Flash software if network boot fails (not used).
Bit 14 (0x4000): IP broadcasts do not have network numbers (not used).
Bit 15 (0x8000): Enables diagnostic messages and ignores NVRAM contents (not used).
Understanding the BOOT Environment Variable
The BOOT environment variable specifies a list of image files on various devices from which the switch
can boot at startup.
You can add several images to the BOOT environment variable to provide a fail-safe boot configuration.
If the first file fails to boot the switch, subsequent images specified in the BOOT variable are tried until
the switch boots or there are no additional images to attempt to boot. If there is no valid image to boot,
the system enters ROM-monitor mode where you can manually specify an image to boot.
The system stores and executes images in the order in which you added them to the BOOT variable. If
you want to change the order in which images are tried at startup, you can either prepend and clear
images from the BOOT variable to attain the desired order or you can clear the entire BOOT environment
variable and then redefine the list in the desired order.
Understanding the CONFIG_FILE Environment Variable
In software release 5.2 and later, you can use the CONFIG_FILE environment variable to specify a list
of configuration files on various devices to use to configure the switch at startup. You can specify one
of the following functions:
Nonrecurring—When you add a list of configuration files to the CONFIG_FILE environment
variable, the next time the switch is restarted, the system erases the configuration in NVRAM and
uses the specified files to configure the switch. The CONFIG_FILE variable is cleared before the
switch is configured. Nonrecurring is the default setting.
Recurring—When you add a list of configuration files to the CONFIG_FILE environment variable,
the list is stored indefinitely in NVRAM. Each time the switch is restarted, the system erases the
configuration in NVRAM and configures the switch using the configuration files specified. The
CONFIG_FILE variable is not cleared.
Note
Remember that the CONFIG_FILE variable can be altered or its recurrence properties changed by
commands in the configuration files used to configure the switch at startup.
For information on specifying recurrence or nonrecurrence, see the
“Setting CONFIG_FILE
Recurrence” section on page 28-5
.