Restoring the appliance configuration

You can restore the configuration of an IBM® MQ Appliance to the same or to a different appliance.

About this task

If you are restoring to the same appliance, it will have the same IP address and the same name. The first steps are the same as initially configuring the appliance when you first installed it.

If you are restoring to a different appliance, it must be running the same firmware level.

You copy a previously saved autoconfig.cfg file to the target IBM MQ Appliance and then restart the appliance. You must also copy any previously saved key or certificate files, or RBM XML files, that are required by the configuration before you restart the appliance.

Procedure

  1. Complete the initial configuration as described in Setting up the initial firmware configuration.
  2. Copy the autoconfig.cfg to the target appliance.

    To copy the file by using the command line interface:

    1. Connect to the IBM MQ Appliance as described in Command line access.
    2. Log in as a user in the administrators group.
    3. Type the following command to enter configuration mode: 
      config
    4. Copy your saved autoconfig.cfg to the target appliance: 
      copy scp://username@ipaddress/[/]directorypath config:///autoconfig.cfg

    To copy the file by using the IBM MQ Appliance web UI:

    1. Start the IBM MQ Appliance web UI, and click the administration icon shows the admin icon.
    2. Select Main > File Management to open the File Management window.
    3. Select Upload files from the Config folder menu.
    4. Drag and drop or browse for the file on your local system.
    5. Click Upload to upload the file to the config directory on the appliance.
  3. Copy any other files that you backed up to preserve your configuration back to their original locations, by using either the command line or the web UI.
  4. If you are not already connected to the appliance command line, connect as described in Command line access.
  5. Shut down and restart the appliance by entering the following command: 
    shutdown reboot
  6. Re-create any appliance user IDs that were previously configured. See Configuring appliance user access.