Technical FAQs

Ask a Question

What are some features I need to be aware of while manipulating the config.ini file of a APC Network Management Card?


Issue

What are some features I need to be aware of while manipulating the config.ini file of a APC Network Management Card?
 


Product Line
 
  • Network Management Card 1 (NMC1) - AP9617, AP9618, AP9619
Devices with an embedded Network Management Card 1 include (but are not limited to): Metered/Switched Rack PDUs (AP78XX, AP79XX), Rack Automatic Transfer Switches (AP77XX, Environmental Monitoring Units (AP9320, AP9340, Netbotz 200)
  • Network Management Card 2 (NMC2) - AP9630/AP9630CH, AP9631/AP9631CH, AP9635/AP9635CH
Devices with an embedded Network Management Card 2 include (but are not limited to): 2G Metered/Switched Rack PDUs (AP84XX, AP86XX, AP88XX, AP89XX), Certain Audio/Video Network Management Enabled products.
 


Environment
 
  • All serial numbers
  • Firmware versions v3.X.X and higher

Cause

The config.ini file on every network management card can be downloaded using command line FTP or SCP. It is a current snapshot of what is running in the Network Management Card's flash memory.

You can make minor changes to the config file and put the file back on the card to make changes to the options on the network card or unit it is installed in. This is useful for configuring multiple units with similar settings.


Resolution

The purpose of the override keyword is to prevent a user from accidentally setting many cards to the same IP settings, thus causing IP conflicts on the network. The override keyword is located in the NetworkTCP/IP section, for example:
[NetworkTCP/IP]
Override=00 C0 B7 6A 33 56
SystemIP=159.215.xxx.xxx
SubnetMask=255.255.255.0
DefaultGateway=159.215.xxx.xxx
BootMode=Manual

When putting the config.ini file back on a network card, the override keyword MUST match the MAC address of the card for the four settings listed above to apply. They will be ignored if the override and MAC do not match.

On certain types of devices such as UPSs, there is a similar override mechanism to protect certain values. In this instance, you'll find a keyword called UPSOverride under the UPS device settings section (ex. [SmartUPS/Matrix]) and it will look similar to this at the top of the specific section with UPS values and UPSOverride:
 
[SmartUPS/Matrix]
UPSName=APC_UPS
UPSOverride="IS1314000000"
RatedOutputVoltage=230
OutputUpperVoltage=253
OutputLowerVoltage=207
Sensitivity=Normal

UPSOverride must equal or have a value of the serial number of the UPS in which the Network Management Card in this example, which is where this setting would be applied.

On newer generation Micro-link UPS devices, such as SMX, SMT, SRT, and SURTD the following keywords in config.ini are protected by UPSOverride:
  • RatedOutputVoltage
  • OutputFrequencyRange

On older generation devices, the following are protected by UPSOverride:
  • RatedOutputVoltage

These values are protected to avoid accidently setting the same potentially "site specific" settings to multiple UPSs without extra care, just as with the TCP/IP settings.

For more details on UPS "generations," refer to knowledge base FA230533.

For more information on mass configuration, please see knowledge base FA156117.

 
Was this helpful?
What can we do to improve the information ?