createbackupfs: create appliance storage location for back up

Allocate space for back up archive files on the appliance.

Purpose

The createbackupfs command allocates space for queue manager back ups on the Appliance RAID volume. The storage is visible in the directory mqbackup:///QMgrs.

You can also specify that the file system allocated is encrypted.

Syntax

Read syntax diagramSkip visual syntax diagram createbackupfs  -s size -e-pPassphrase

Parameters

-s size
Specifies the size of the back up allocation in GB. You can specify a value in MB by entering the value followed by the character M. For example, to specify a size of 3 GB, enter 3. To specify a size of 1024 MB, enter 1024M.
-e
Optionally specify that the back up file system created is encrypted. Use this option if your queue manager file systems are encrypted to ensure that queue manager back ups are also encrypted while stored on the appliance.
-p Passphrase
Optionally specify a passphrase for the encrypted back up file system. The passphrase can be between 1 and 512 characters. If you do not specify the passphrase here, you are prompted for it when you run the command. You should store a copy of the passphrase somewhere safe.

Usage notes

  • This command must be run from the IBM® MQ administration mode. If the system is in the IBM MQ administration mode the prompt includes mqa(mqcli)#. To enter the IBM MQ administration mode, enter mqcli on the command line. To exit the IBM MQ administration mode, enter exit on the command line.
  • You must run this command before you back up any queue managers.

Examples

  • The following command allocates 4 GB of storage in the mqbackup:///QMgrs directory. 
    createbackupfs -s 4
  • The following command allocates 1024 MB of encrypted back up storage with the passphrase 633_bales_of_hay:
    createbackupfs -s 1024M -e -p 633_bales_of_hay

Related commands