IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

mqsibackupbroker command

Use the mqsibackupbroker command to back up the current configuration of a broker.

Supported platforms

Purpose

The mqsibackupbroker command creates a record of the current configuration of a broker in a file, in compressed file format. You can use the file to restore the broker at a later time, if required.

Usage notes

The command backs up of the following persistent configuration data associated with the broker:

  • Deployed resources; message flows, dictionaries, JAR files, and other runtime resources that you have previously deployed in a BAR file.
  • Integration servers.
  • Broker configuration; for example, configurable services.

The command does not back up the following resources:

  • Transient information; for example, inflight aggregations or collections.
  • Executable code, including resources that are associated with user-defined extensions (nodes, parsers, and exits).
  • Resources required by message flows to function correctly; for example, WebSphere® MQ queues and data stored in databases.

Use the backup file to restore a broker on a computer that has an identical configuration; the operating system must be at the same level, and the broker and queue manager names must be identical.

You can run this command for a broker that is active. However, you must not take a backup while the broker 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 broker at a later time.

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

Authorization

For information about platform-specific authorizations, see the following topics: If you have enabled broker administration security, you must also set up the authority detailed in Tasks and authorizations for administration security.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-mqsibackupbroker--brokerName-- -d -- directory -------------->

>--+---------------------+--+-----------------------+----------->
   '- -a -- archiveName -'  '- -v -- traceFileName -'   

>--+------+----------------------------------------------------><
   '- -f -'   

Parameters

brokerName
(Required) The name of the broker that you want to back up. You must specify the name as the first parameter.
-d directory
(Required) The directory in which the backup file is created. You must specify a directory that is on a file system that can be accessed by the computer on which you run this command.
-a archiveName
(Optional) The name of the backup (archive) file. The file is created in compressed file format. If you do not specify this parameter, the default name brokerName_yyMMdd_HHmmss.zip is used.
-v traceFileName
(Optional) The location of a trace file that records details of the actions taken by the command.
-f
(Optional) Force incomplete backup files to be created if one or more parts of the broker configuration cannot be read.

The command creates a backup file that contains all available information; if it cannot access some configuration detail, that subset of data is not saved. For example, if a message flow required exclusive access to a deployed resource, and the message flow is running, the deployed resource might not be included in the backup file.

If you do not specify this option, the command fails if it cannot create complete backup file.

Specify this option only if directed to do so by your IBM® service representative.

Examples

The following example backs up broker IB9NODE on Windows:

mqsibackupbroker IB9NODE -d C:\MQSI\BACKUP -v C:\MQSI\BACKUP\trace.log

bn43000_.htm | Last updated Friday, 21 July 2017