Configuration file actions
This section describes the actions that work with the JSON configuration files.
action=new
Use db2mtool action=new to interactively create and populate a new JSON configuration file. The command prompts you to enter all the required information.
- The QMRDBJSON database table in library QUSRSYS on the setup source node.
- The path and file name that is specified for parameter jsonFile on the node where the command is run.
db2mtool action=new jsonFile=/home/xxx [jsonType=clone_info|meta_data]
action=restore
Use db2mtool action=restore to download a JSON configuration file from the setup source node. This command copies the contents of a JSON configuration file from the QMRDBJSON database table in library QUSRSYS on the setup source node to the path and file name that is specified for parameter jsonFile on the node where the command is run.
db2mtool action=restore jsonFile=/home/xxx [jsonType=clone_info|meta_data]
action=retrieveuuid
If the system names of the Db2® Mirror nodes are not unique in your network, it is recommended to use both system name and partition UUID to uniquely identify the JSON configuration files for each Db2 Mirror pair. The db2mtool action=retrieveuuid command can be used to retrieve the partition UUID from the hardware management console (HMC).
db2mtool action=retrieveuuid powerHMCHost=xxx powerHMCUser=xxx
systemName=xxx partitionName=xxx
action=reversecloneinfo
The db2mtool action=reversecloneinfo command generates the clone_info.json configuration file that is used for cloning in the opposite direction and saves the resulting JSON configuration file to the setup source node in the QMRDBJSON database table in library QUSRSYS.
The clone_info.json configuration file contains the storage and cloning settings for both the setup source and setup copy nodes. However, to clone in the opposite direction, these settings must be reversed. After the clone_info.json file is updated for one direction, use this command to automatically generate the reverse.
db2mtool action= reversecloneinfo setupSrcAddress=xxx setupSrcUser=xxx
setupSrcSysName=xxx setupCpySysName=xxx
action=save
Use db2mtool action=save to upload a JSON configuration file to the setup source node. This command copies the contents of the JSON configuration file on the node where the command is run that is specified for parameter jsonFile to the QMRDBJSON database table in library QUSRSYS on the setup source node.
If the JSON files are created or updated manually instead of using db2mtool action=new or db2mtool action=update, use the db2mtool action=save command to save the JSON configuration files to the setup source node. Always store the JSON configuration files on the setup source node in the QMRDBJSON database table in library QUSRSYS for future use.
db2mtool action=save jsonFile=/home/xxx [jsonType=clone_info|meta_data]
action=update
Use db2mtool action=update to interactively update a JSON configuration file. The command prompts you to enter all the required information.
- The QMRDBJSON database table in library QUSRSYS on the setup source node.
- The path and file name that is specified on parameter jsonFile on the node where the command is run.
db2mtool action=update jsonFile=/home/xxx [jsonType=clone_info|meta_data] [section=xxx]