Restoring a secure backup by using the REST interface
You can restore a secure backup of the IBM® MQ Appliance by using the REST interface on the appliance.
About this task
A secure backup creates files that contains the configuration of the appliance. The backup files are secured by a user certificate. The backup includes details of MQ users, but does not include queue manager configurations or data, or high availability or disaster recovery configuration details. For more details, see Secure backup.
You can use the secure backup and restore to migrate to another appliance, see Secure restore.
You must reinitialize an appliance (complete a factory reset) before you restore to it. See Factory reset.
When you use the REST interface for this purpose, you send HTTP requests to the REST interface port and receive JSON-formatted responses with a payload and indication of success or failure. You can incorporate requests into programs and so automate interaction with the appliance.
admin
. The password for the admin user must be changed at first login (as happens
after a factory reset of the appliance).Procedure
/mgmt/actionqueue/default
,
specifying a request payload with the following format:
{
"SecureRestore": {
"cred": {
"value": "credential"
},
"source": "source",
"validate": "on|off"
}
}
Where:- credential
- String
- source
- String
- validate
- Boolean