meta_data JSON file

The setup copy node configuration settings must be stored in a JSON configuration file named meta_data.json. This file will be used by Db2® Mirror to automatically configure the setup copy node during the first IPL after the storage clone.

The following table lists the information saved in meta_data.json.

Table 1. meta_data.json
JSON tag Description
General configuration
hostname Host and domain name for setup copy node
name System name of setup copy node
chained_ntp Configure chained time server: true or false
external_ts A list of time servers
ntpListenInterface IP address for NTP client
Network configuration information for each setup copy IP address
dns_search Domain search list
dns_nameservers Up to three Domain Name Server (DNS) IP addresses
ipv6 or ipv4 IPv4 or IPv6 interface
broadcast Subnet-directed broadcast address
netmask Subnet mask (for IPv4 only)
cmnlocation Ethernet port location
lind Line description
address Internet address
gateway Internet address of an internet protocol (IP) router or gateway
prefixLen Prefix length (for IPv6 only)
vlanID Virtual LAN identifier (for IPv6 only)
Network Redundancy Group (NRG) configuration information for each Db2 Mirror NRG
groupName NRG name: MIRROR_DATABASE, MIRROR_IFS, MIRROR_RESYNC, MIRROR_OTHER, MIRROR_ENGINE
groupDescription NRG description
loadBalLinkCount Load balance link count
localAddr IP address on the setup copy node
remoteAddr IP address on the setup source node
pairPriority Priority of the link
Start of changepairTypeEnd of change Start of changeRDMA protocol type
  • 0: RoCE v1
  • 1: RoCE v2
  • 2: Encrypted RoCE v2
End of change
localLind Line description for the IP address on the setup copy node (required for IPv6 link-local addresses only)
localVLANID Virtual LAN identifier for the IP address on the setup copy node (required for IPv6 link-local addresses only)
Routing Information for each routed RDMA link
destination IP address on the setup source node
gateway Internet address of an IP router or gateway
submask Subnet mask (for IPv4 only)
prefixLength Prefix length (for IPv6 only)
bindingInterface IP address on the setup copy node
bindingLined Line description of the IP address on the setup copy node

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

db2mtool action=save

For more information, see action=save

Example meta_data.json file

The following is an example of a meta_data.json file.

{
	"mrdb": true,
	"hostname": "MYSYSTEM.MY.COMPANY.COM",
	"name": "MYSYSTEM",
	"network_config": {
		"content_path": "/latest/meta_data.json",
		"name": "network_config",
		"details": [
			{
				"device": "eth0",
				"hwaddress": "ff: ff: ff: ff: ff: ff",
				"dns_search": [
					"MY.COMPANY.COM"
				],
				"auto": true,
				"ipv6": false,
				"dns_nameservers": [
					"10.5.175.8"
				],
				"broadcast": "10.5.57.255",
				"netmask": "255.255.255.0",
				"bootproto": "static",
				"cmnlocation": "U9119.MHE.109CD87-V22-C2-T1",
				"lind": "ETHLINE",
				"ipcategory": "eth",
				"ipgroup": 1,
				"ipv4": true,
				"address": [
					"10.5.57.154"
				],
				"gateway": "10.5.57.1"
			},
			{
				"device": "eth1",
				"hwaddress": "ff: ff: ff: ff: ff: ff",
				"dns_search": [
					"MY.COMPANY.COM"
				],
				"auto": true,
				"ipv6": false,
				"dns_nameservers": [
					"10.5.175.8"
				],
				"broadcast": "192.168.10.255",
				"netmask": "255.255.255.0",
				"bootproto": "static",
				"cmnlocation": "U9119.MHE.109CD87-V22-C4-T1",
				"lind": "RDMA10",
				"ipcategory": "eth",
				"ipgroup": 1,
				"ipv4": true,
				"address": [
					"192.168.10.22"
				]
			},
			{
				"device": "eth2",
				"hwaddress": "ff: ff: ff: ff: ff: ff",
				"dns_search": [
					"MY.COMPANY.COM"
				],
				"auto": true,
				"ipv6": false,
				"dns_nameservers": [
					"10.5.175.8"
				],
				"broadcast": "192.168.20.255",
				"netmask": "255.255.255.0",
				"bootproto": "static",
				"cmnlocation": "U9119.MHE.109CD87-V22-C6-T1",
				"lind": "RDMA20",
				"ipcategory": "eth",
				"ipgroup": 1,
				"ipv4": true,
				"address": [
					"192.168.20.22"
				]
			},
			{
				"device": "eth3",
				"hwaddress": "ff: ff: ff: ff: ff: ff",
				"dns_search": [
					"MY.COMPANY.COM"
				],
				"auto": true,
				"ipv6": false,
				"dns_nameservers": [
					"10.5.175.8"
				],
				"broadcast": "192.168.30.255",
				"netmask": "255.255.255.0",
				"bootproto": "static",
				"cmnlocation": "U9119.MHE.109CD87-V22-C7-T1",
				"lind": "RDMA30",
				"ipcategory": "eth",
				"ipgroup": 1,
				"ipv4": true,
				"address": [
					"192.168.30.22"
				]
			},
			{
				"device": "eth4",
				"hwaddress": "ff: ff: ff: ff: ff: ff",
				"dns_search": [
					"MY.COMPANY.COM"
				],
				"auto": true,
				"ipv6": false,
				"dns_nameservers": [
					"10.5.175.8"
				],
				"broadcast": "192.168.40.255",
				"netmask": "255.255.255.0",
				"bootproto": "static",
				"cmnlocation": "U9119.MHE.109CD87-V22-C8-T1",
				"lind": "RDMA40",
				"ipcategory": "eth",
				"ipgroup": 1,
				"ipv4": true,
				"address": [
					"192.168.40.22"
				]
			},
			{
				"device": "eth5",
				"hwaddress": "ff: ff: ff: ff: ff: ff",
				"dns_search": [
					"MY.COMPANY.COM"
				],
				"auto": true,
				"ipv6": false,
				"dns_nameservers": [
					"10.5.175.8"
				],
				"broadcast": "192.168.50.255",
				"netmask": "255.255.255.0",
				"bootproto": "static",
				"cmnlocation": "U9119.MHE.109CD87-V22-C9-T1",
				"lind": "RDMA50",
				"ipcategory": "eth",
				"ipgroup": 1,
				"ipv4": true,
				"address": [
					"192.168.50.22"
				]
			},
			{
				"device": "eth6",
				"hwaddress": "ff: ff: ff: ff: ff: ff",
				"dns_search": [
					"MY.COMPANY.COM"
				],
				"auto": true,
				"ipv6": false,
				"dns_nameservers": [
					"10.5.175.8"
				],
				"broadcast": "192.168.60.255",
				"netmask": "255.255.255.0",
				"bootproto": "static",
				"cmnlocation": "U9119.MHE.109CD87-V22-C10-T1",
				"lind": "RDMA60",
				"ipcategory": "eth",
				"ipgroup": 1,
				"ipv4": true,
				"address": [
					"192.168.60.22"
				]
			},
			{
				"device": "eth7",
				"hwaddress": "ff: ff: ff: ff: ff: ff",
				"dns_search": [
					"MY.COMPANY.COM"
				],
				"auto": true,
				"ipv6": false,
				"dns_nameservers": [
					"10.5.175.8"
				],
				"broadcast": "192.168.70.255",
				"netmask": "255.255.255.0",
				"bootproto": "static",
				"cmnlocation": "U9119.MHE.109CD87-V22-C11-T1",
				"lind": "RDMA70",
				"ipcategory": "eth",
				"ipgroup": 1,
				"ipv4": true,
				"address": [
					"192.168.70.22"
				]
			},
			{
				"device": "eth8",
				"hwaddress": "ff: ff: ff: ff: ff: ff",
				"dns_search": [
					"MY.COMPANY.COM"
				],
				"auto": true,
				"ipv6": false,
				"dns_nameservers": [
					"10.5.175.8"
				],
				"broadcast": "192.168.80.255",
				"netmask": "255.255.255.0",
				"bootproto": "static",
				"cmnlocation": "U9119.MHE.109CD87-V22-C12-T1",
				"lind": "RDMA80",
				"ipcategory": "eth",
				"ipgroup": 1,
				"ipv4": true,
				"address": [
					"192.168.80.22"
				]
			},
			{
				"device": "eth9",
				"hwaddress": "ff: ff: ff: ff: ff: ff",
				"dns_search": [
					"MY.COMPANY.COM"
				],
				"auto": true,
				"ipv6": true,
				"dns_nameservers": [
					"10.5.175.8"
				],
				"bootproto": "static",
				"cmnlocation": "U9119.MHE.109CD87-V48-C8-T1",
				"lind": "ETHLINE2",
				"ipcategory": "eth",
				"ipgroup": 1,
				"ipv4": false,
				"address": [
					"2002:905:150e:501:9:5:90:192"
				],
				"prefixLen": "64",
				"vlanID": "*NONE"
			}
		]
	},
	"nrgs": [
		{
			"groupName": "MIRROR_DATABASE",
			"groupType": 1,
			"groupDesc": "Database Replication",
			"loadBalLinkCount": 8,
			"nrgIPAddrPairs": [
				{
					"localAddr": "192.168.10.22",
					"localLind": "RDMA10",
					"localVLANID": 0,
					"remoteAddr": "192.168.10.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.20.22",
					"localLind": "RDMA20",
					"localVLANID": 0,
					"remoteAddr": "192.168.20.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.30.22",
					"localLind": "RDMA30",
					"localVLANID": 0,
					"remoteAddr": "192.168.30.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.40.22",
					"localLind": "RDMA40",
					"localVLANID": 0,
					"remoteAddr": "192.168.40.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.50.22",
					"localLind": "RDMA50",
					"localVLANID": 0,
					"remoteAddr": "192.168.50.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.60.22",
					"localLind": "RDMA60",
					"localVLANID": 0,
					"remoteAddr": "192.168.60.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.70.22",
					"localLind": "RDMA70",
					"localVLANID": 0,
					"remoteAddr": "192.168.70.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.80.22",
					"localLind": "RDMA80",
					"localVLANID": 0,
					"remoteAddr": "192.168.80.23",
					"pairPriority": 1,
					"pairType": 0
				}
			],
			"pairCount": 8
		},
		{
			"groupName": "MIRROR_OTHER",
			"groupType": 1,
			"groupDesc": "System Object Replication",
			"loadBalLinkCount": 8,
			"nrgIPAddrPairs": [
				{
					"localAddr": "192.168.10.22",
					"localLind": "RDMA10",
					"localVLANID": 0,
					"remoteAddr": "192.168.10.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.20.22",
					"localLind": "RDMA20",
					"localVLANID": 0,
					"remoteAddr": "192.168.20.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.30.22",
					"localLind": "RDMA30",
					"localVLANID": 0,
					"remoteAddr": "192.168.30.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.40.22",
					"localLind": "RDMA40",
					"localVLANID": 0,
					"remoteAddr": "192.168.40.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.50.22",
					"localLind": "RDMA50",
					"localVLANID": 0,
					"remoteAddr": "192.168.50.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.60.22",
					"localLind": "RDMA60",
					"localVLANID": 0,
					"remoteAddr": "192.168.60.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.70.22",
					"localLind": "RDMA70",
					"localVLANID": 0,
					"remoteAddr": "192.168.70.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.80.22",
					"localLind": "RDMA80",
					"localVLANID": 0,
					"remoteAddr": "192.168.80.23",
					"pairPriority": 1,
					"pairType": 0
				}
			],
			"pairCount": 8
		},
		{
			"groupName": "MIRROR_IFS",
			"groupType": 1,
			"groupDesc": "IFS Replication",
			"loadBalLinkCount": 8,
			"nrgIPAddrPairs": [
				{
					"localAddr": "192.168.10.22",
					"localLind": "RDMA10",
					"localVLANID": 0,
					"remoteAddr": "192.168.10.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.20.22",
					"localLind": "RDMA20",
					"localVLANID": 0,
					"remoteAddr": "192.168.20.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.30.22",
					"localLind": "RDMA30",
					"localVLANID": 0,
					"remoteAddr": "192.168.30.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.40.22",
					"localLind": "RDMA40",
					"localVLANID": 0,
					"remoteAddr": "192.168.40.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.50.22",
					"localLind": "RDMA50",
					"localVLANID": 0,
					"remoteAddr": "192.168.50.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.60.22",
					"localLind": "RDMA60",
					"localVLANID": 0,
					"remoteAddr": "192.168.60.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.70.22",
					"localLind": "RDMA70",
					"localVLANID": 0,
					"remoteAddr": "192.168.70.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.80.22",
					"localLind": "RDMA80",
					"localVLANID": 0,
					"remoteAddr": "192.168.80.23",
					"pairPriority": 1,
					"pairType": 0
				}
			],
			"pairCount": 8
		},
		{
			"groupName": "MIRROR_RESYNC",
			"groupType": 1,
			"groupDesc": "Resynchronization",
			"loadBalLinkCount": 8,
			"nrgIPAddrPairs": [
				{
					"localAddr": "192.168.10.22",
					"localLind": "RDMA10",
					"localVLANID": 0,
					"remoteAddr": "192.168.10.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.20.22",
					"localLind": "RDMA20",
					"localVLANID": 0,
					"remoteAddr": "192.168.20.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.30.22",
					"localLind": "RDMA30",
					"localVLANID": 0,
					"remoteAddr": "192.168.30.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.40.22",
					"localLind": "RDMA40",
					"localVLANID": 0,
					"remoteAddr": "192.168.40.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.50.22",
					"localLind": "RDMA50",
					"localVLANID": 0,
					"remoteAddr": "192.168.50.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.60.22",
					"localLind": "RDMA60",
					"localVLANID": 0,
					"remoteAddr": "192.168.60.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.70.22",
					"localLind": "RDMA70",
					"localVLANID": 0,
					"remoteAddr": "192.168.70.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.80.22",
					"localLind": "RDMA80",
					"localVLANID": 0,
					"remoteAddr": "192.168.80.23",
					"pairPriority": 1,
					"pairType": 0
				}
			],
			"pairCount": 8
		},
		{
			"groupName": "MIRROR_ENGINE",
			"groupType": 1,
			"groupDesc": "Db2 Mirror Environment Manager",
			"loadBalLinkCount": 8,
			"nrgIPAddrPairs": [
				{
					"localAddr": "192.168.10.22",
					"localLind": "RDMA10",
					"localVLANID": 0,
					"remoteAddr": "192.168.10.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.20.22",
					"localLind": "RDMA20",
					"localVLANID": 0,
					"remoteAddr": "192.168.20.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.30.22",
					"localLind": "RDMA30",
					"localVLANID": 0,
					"remoteAddr": "192.168.30.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.40.22",
					"localLind": "RDMA40",
					"localVLANID": 0,
					"remoteAddr": "192.168.40.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.50.22",
					"localLind": "RDMA50",
					"localVLANID": 0,
					"remoteAddr": "192.168.50.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.60.22",
					"localLind": "RDMA60",
					"localVLANID": 0,
					"remoteAddr": "192.168.60.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.70.22",
					"localLind": "RDMA70",
					"localVLANID": 0,
					"remoteAddr": "192.168.70.23",
					"pairPriority": 1,
					"pairType": 0
				},
				{
					"localAddr": "192.168.80.22",
					"localLind": "RDMA80",
					"localVLANID": 0,
					"remoteAddr": "192.168.80.23",
					"pairPriority": 1,
					"pairType": 0
				}
			],
			"pairCount": 8
		}
	]
}