clone_info JSON file

The storage and cloning attributes must be stored in a JSON configuration file named clone_info.json. This file will be used by Db2® Mirror to automatically perform the storage cloning actions.

The following table lists the information saved in clone_info.json for IBM® storage systems.

Table 1. clone_info.json
JSON tag	Description
Clone settings
stgtype	Storage Type svc: IBM Storage Virtualize family ds8000: IBM System Storage DS8000® family internal: internal storage custom: any type of external storage
copytype	Copy Type fc: FlashCopy® rc: remote copy sr: save and restore
coldflashcopy	Clone Type 0: warm 1: cold
dbIaspAutoVaryOff	Vary off IASPs before cloning
dbIaspAutoVaryOn	Vary on IASPs after cloning
SYSBAS volume pairs
sourceid	Volume ID numbers of setup source SYSBAS volumes
targetid	Volume ID numbers of setup copy SYSBAS volumes
Independent Auxiliary Storage Pool (IASP) volume pairs
iaspname	IASP name
primary	Primary or secondary IASP indicator 0: Secondary IASP 1: Primary IASP
sourceid	Volume ID numbers of setup source IASP volumes
targetid	Volume ID numbers of setup copy IASP volumes
Hardware Management Console (HMC) information for setup source node
powerhmc	Host name or IP address of HMC
poweruser	HMC user name
powerpassword	HMC password
managedsystem	Managed system name
partitionname	Partition name
shutdownoption	How to shutdown the setup source node before cold cloning osshutdown_immed - immediate IBM i shutdown osshutdown_cntrld - controlled IBM i shutdown shutdown - HMC shutdown
HMC information for setup copy node
powerhmc	Host name or IP address of HMC
poweruser	HMC user name
powerpassword	HMC password
managedsystem	Managed system name
partitionname	Partition name
shutdownoption	How to shutdown the setup copy node before cloning osshutdown_immed - immediate IBM i shutdown osshutdown_cntrld - controlled IBM i shutdown shutdown - HMC shutdown
IBM i information for setup source node
hostname	Host name or IP address of setup source IBM i node
user	IBM i user name
password	IBM i password
vpnInfo.localAddr	Local NRG IP address (for encrypted RDMA)
vpnInfo.remoteAddr	Remote NRG IP address (for encrypted RDMA)
vpnInfo.lined	Line description for local NRG IP address (for encrypted RDMA)
vpnInfo.name	VPN name (for encrypted RDMA)
vpnInfo.description	VPN description (for encrypted RDMA)
vpnInfo.ikePolicyName	IKE policy name (for encrypted RDMA)
vpnInfo.dataPolicy	Data policy name (for encrypted RDMA)
vpnInfo.preSharedKey	Pre-shared key (for encrypted RDMA)
vpnInfo.vpnCertificate	Certificate name (for encrypted RDMA)
IBM i information for setup copy node
hostname	Host name or IP address of setup copy IBM i node
user	IBM i user name
password	IBM i password
vpnInfo.localAddr	Local NRG IP address (for encrypted RDMA)
vpnInfo.remoteAddr	Remote NRG IP address (for encrypted RDMA)
vpnInfo.lined	Line description for local NRG IP address (for encrypted RDMA)
vpnInfo.name	VPN name (for encrypted RDMA)
vpnInfo.description	VPN description (for encrypted RDMA)
vpnInfo.ikePolicyName	IKE policy name (for encrypted RDMA)
vpnInfo.dataPolicy	Data policy name (for encrypted RDMA)
vpnInfo.preSharedKey	Pre-shared key (for encrypted RDMA)
vpnInfo.vpnCertificate	Certificate name (for encrypted RDMA)
Storage information for IBM System Storage DS8000 FlashCopy and remote copy
stghmc	Host name or IP address of DS8000
stguser	DS8000 user name
stgpassword	DS8000 password
fullkeypath	DS8000 password file (Optional)
stgimg	DS8000 image ID
Storage information for IBM System Storage DS8000 remote copy
hostname	Host name or IP address of Copy Services Manager (CSM)
port	CSM port number
user	CSM user name
password	CSM password
copysitesession	Existing CSM session name (Optional)
refreshInterval	How often to check the status of the remote copy in seconds (Optional)
standbyhostname	Standby CSM host name or IP address (Optional)
standbyport	Standby CSM port number (Optional)
Storage information for IBM Storage Virtualize (SVC) FlashCopy
stghmc	Host name or IP address of SVC
stguser	SVC user name
fullkeypath	Path and name of SVC SSH private key file on managing node
copyrate	FlashCopy copy rate (Optional)
cleanrate	FlashCopy clean rate (Optional)
Storage information for SVC remote copy
stghmc	Host name or IP address of SVC for setup source node
stguser	SVC user name
fullkeypath	Path and name of SVC SSH private key file on managing node
stghmc	Host name or IP address of SVC for setup copy node
stguser	SVC user name
fullkeypath	Path and name of SVC SSH private key file on managing node
Cluster monitors
nodeName	Cluster node ID
hmcHostName	Host name or IP address of the HMC for the cluster node
hmcUser	HMC user name
hmcPassword	HMC password

If you choose to populate the clone_info.json file manually from the clone_info.json configuration file example below, then use the Qshell command db2mtool to save the clone_info.json file to the setup source system:

db2mtool action=save

For more information, see action=save

Example clone_info.json file

The following is an example of a clone_info.json file for a DS8000 warm remote copy.

{
	"sysbas": [
		{
			"sourceid": "0A44",
			"targetid": "0469"
		},
		{
			"sourceid": "0A45",
			"targetid": "046A"
		},
		{
			"sourceid": "0A46",
			"targetid": "046B"
		},
		{
			"sourceid": "0A4C",
			"targetid": "046C"
		}
	],
	"dbiasp": [
		{
			"iaspname": "IASP1",
			"primary": "1",
			"coldClone": "0",
			"iaspvolumepairs": [
				{
					"sourceid": "0A47",
					"targetid": "046D"
				},
				{
					"sourceid": "0A48",
					"targetid": "046E"
				},
				{
					"sourceid": "0A49",
					"targetid": "046F"
				},
				{
					"sourceid": "0A4A",
					"targetid": "0470"
				}
			],
			"secondary": [
				{
					"iaspname": "IASP1SEC",
					"primary": "0",
					"coldClone": "0",
					"iaspvolumepairs": [
						{
							"sourceid": "0A4B",
							"targetid": "0471"
						}
					]
				}
			]
		}
	],
	"setupsource": {
		"ds8000": {
			"stglogin": {
				"stghmc": "ds8ka.my.company.com",
				"stguser": "superuser",
				"stgpassword": "Yv/4i33sAxeBH2QfwN3WcQ=="
			},
			"stgimg": "IBM.2107-75ACK61"
		},
		"hmc": {
			"managedsystem": "a402e-9080-M9S-SNXXXXXXX",
			"partitionname": "myprdsys",
			"shutdownoption": "osshutdown_immed",
			"hmclogin": {
				"powerhmc": "db2mhmca.my.company.com",
				"poweruser": "hscroot",
				"powerpassword": "C5X+9Zzax7SAGnXMeJfNyQ=="
			}
		},
		"ibmi": {
			"login": {
				"hostname": "MYPRDSYS.MY.COMPANY.COM",
				"user": "db2m",
				"password": "UJ9ad28qpI9K7YqmEG5RAw=="
			},
			"quiesceTimeout": 300
		}
	},
	"setupcopy": {
		"ds8000": {
			"stglogin": {
				"stghmc": "ds8kb.my.company.com",
				"stguser": "superuser",
				"stgpassword": "aDAPRsW9Ve1OR4V4KdAbFA==",
			},
			"stgimg": "IBM.2107-75FPT91"
		},
		"hmc": {
			"managedsystem": "a503e-9080-M9S-SNXXXXXXX",
			"partitionname": "mysystem",
			"shutdownoption": "osshutdown_immed",
			"hmclogin": {
				"powerhmc": "db2mhmcb.my.company.com",
				"poweruser": "hscroot",
				"powerpassword": "C5X+9Zzax7SAGnXMeJfNyQ=="
			}
		},
		"ibmi": {
			"login": {
				"hostname": "MYSYSTEM.MY.COMAPNY.COM",
				"user": "db2m",
				"password": "UJ9ad28qpI9K7YqmEG5RAw=="
			},
			"quiesceTimeout": 300
		}
	},
	"coldflashcopy": "0",
	"stgtype": "ds8000",
	"copytype": "gc",
	"csm": {
		"hostname": "db2mcsm1.my.company.com",
		"port": "9559",
		"user": "db2m",
		"password": "9e5Xmv2JPVCR4DjCM/IBcg==",
		"refreshInterval": 60,
		"standbyhostname": "db2mcsm2.my.company.com",
		"standbyport": "443"
	},
	"clustermonitor": [
		{
			"nodeName": "MYPRDSYS",
			"hmcHostName": "db2mhmca.my.company.com",
			"hmcUser": "hscroot",
			"hmcPassword": "C5X+9Zzax7SAGnXMeJfNyQ=="
		},
		{
			"nodeName": "MYSYSTEM",
			"hmcHostName": "db2mhmcb.my.company.com",
			"hmcUser": "hscroot",
			"hmcPassword": "C5X+9Zzax7SAGnXMeJfNyQ=="
		}
	],
	"dbIaspAutoVaryOff": "yes",
	"dbIaspAutoVaryOn": "yes"
}