IBM Support

Troubleshooting "Notice: startup config contains errors" in IBM MQ Appliance

Troubleshooting


Problem

When I log in to the CLI of an IBM MQ Appliance, I see the message:
"Notice: startup config contains errors".
How do I find out what the errors are and what to do about them?

Symptom

CLI login displays "Notice: startup config contains errors."

Cause

The MQ Appliance maintains a startup config file containing the most recent running configuration you saved (by using write mem in the CLI or "Save" button in the web UI).
If any of these recent configuration changes were invalid, the configuration instructions captured in the startup config file might not be longer valid.
Applying a new firmware that has deprecated previous commands or attributes might cause this error to occur.

Environment

Diagnosing The Problem

You can view the startup config error messages in the logtemp:///startup-errors file. 

You can view the contents of the startup config file itself with the following CLI commands:

config
show startup-config

Resolving The Problem

Compare the error messages in the startup-errors file with the configuration instructions in startup-config.
Reconfigure the objects with erroneous configurations, save the configuration (this action changes the startup-config file), and log in to the CLI again.
If the issue is related to a firmware upgrade, the problem can be resolve by saving your current configuration on the appliance (that is, perform a write mem).
If you still see "Notice: startup config contains errors", try restarting the MQ Appliance.

If the Notice still appears, repeat the diagnosis, and resolution steps to see what remains to be reconfigured and saved to startup-config.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSULQ6","label":"IBM MQ Appliance M2002"},"ARM Category":[{"code":"a8m0z000000cwq9AAA","label":"Administration-\u003EAppliance"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"},{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS2JL2","label":"IBM MQ Appliance M2001"},"ARM Category":[{"code":"a8m0z000000cwq9AAA","label":"Administration-\u003EAppliance"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"},{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSJCTQ","label":"IBM MQ Appliance M2003"},"ARM Category":[{"code":"a8m0z000000cwq9AAA","label":"Administration-\u003EAppliance"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
16 March 2023

UID

ibm16957464