Backing up the integration node

Back up the integration node configuration and all associated resources.

Before you begin

Create the integration node.

About this task

You can back up the integration node and its resources to preserve the current state of the integration node configuration. You can use the backup file that is created to restore an integration node in an identical operating environment: the operating system must be at the same level, and the integration node and queue manager names must be identical.

You can run this command for an integration node that is active. However, you must not take a backup while the integration node is processing configuration changes and deployments; the backup file created might contain incomplete information. If the file contains partial records, you cannot use it to restore the integration node at a later time.

To ensure that the backup is complete and correct, take a backup either when the integration node is not processing a configuration change (such as a deployment or change property) or when the integration node is stopped.

Procedure

  1. If you want to back up an active integration node, check that no configuration change requests are in progress.
    For example, if you are changing integration node properties, or have initiated a deployment, wait for these actions to complete before you back up the integration node. Active message flows are unaffected by the backup process.

    If you prefer, you can stop the integration node before you take a backup by using the mqsistop command.

  2. Back up the integration node.
    Specify the integration node name and the location in which the backup file is created. You can also optionally specify the name of the backup file, and the name of a file to which a detailed trace is written.
    • Linux platformWindows platformUNIX platformRun the mqsibackupbroker command, specifying the integration node name and the directory to which the backup file is written.

      For example, to back up an integration node on Windows, enter the following command:

      mqsibackupbroker IBNODE -d c:\MQSI\BACKUP
    • z/OS platformCustomize and submit the JCL member BIPBUBK.
  3. When the command has completed successfully, you can continue to use the integration node.
    If you stopped the integration node, restart it by using the mqsistart command.

Results

The current integration node configuration is saved in the backup file. Keep the file safe so that you can restore the integration node at a later date if required.