Initiating the KSYS node

Edit online

After the VM Recovery Manager DR software is installed on the KSYS LPAR, you must initiate and set up the KSYS environment before you configure the disaster recovery environment. The KSYS environment relies on Reliable Scalable Cluster Technology (RSCT) to create its cluster.

After you create the KSYS cluster, various daemons of RSCT and KSYS are activated. The KSYS LPAR can then process the commands that are required to configure the disaster recovery environment.

Note: In VM Recovery Manager DR, the KSYS operates as a one-node cluster.

To create and initiate a one-node KSYS cluster, complete the following steps:

Create a cluster and add the KSYS node to the cluster by running the following command.
```
ksysmgr add ksyscluster cluster_name 
      ksysnodes=ksys_nodename type=DR
```
Verify the KSYS cluster configuration by running the following command.
```
ksysmgr verify ksyscluster cluster_name
```
Deploy the one-node KSYS cluster by running the following command.
```
ksysmgr sync ksyscluster cluster_name
```
Note: You can perform steps 1 - 3 by running the following command:
```
ksysmgr add ksyscluster cluster_name ksysnodes=ksys_nodename 
      sync=yes type=DR
```
This command creates a cluster, adds the KSYS node to the cluster, verifies the cluster configuration, and deploys the one-node KSYS cluster.
Optional: Verify the KSYS cluster that you created by running the following command:
```
ksysmgr query ksyscluster
```
An output that is similar to the following example is displayed:
```
Name:                cluster_name
State:               Online
Type:                DR
Ksysnodes:           ksys_nodename:1:Online
KsysState:           ksys_nodename:1:Online
```
Note: These commands do not display any output until you run the ksysmgr sync command.

Creating and initializing a multi-node KSYS cluster

Edit online

You can create a multi-node KSYS cluster.

Note:

To use a multi-node KSYS cluster, VM Recovery Manager DR Version 1.7, or later must be installed on all KSYS nodes.
This release supports only a two-node KSYS cluster.
For best performance, the RSCT version on all KSYS nodes must be the same. If the RSCT version is not the same on all KSYS nodes, it's recommended to choose the node that has the lowest RSCT version as the group leader node and then create the KSYS cluster on the group leader node.

To create and initialize a multi-node KSYS cluster, complete the following procedure:

To create and deploy a multi-node KSYS cluster, run the following
```
ksysmgr add ksyscluster cluster_name ksysnodes=ksys_nodename1,ksys_nodename2 sync=yes type=<cluster_type>
```
This command creates a cluster, adds the KSYS nodes that you specified to the cluster, verifies the cluster configuration, and deploys the multi-node KSYS cluster.

Optional: Verify the KSYS cluster that you created by running the

ksysmgr
sync

command and then run the following command:

ksysmgr query cluster

An output that is similar to the following example is displayed:

Name:      hitachi
State:     Online
Type:      DR
Ksysnodes: <ksysnode_name1>:1:Online(Managing node)
           <ksysnode_name2>:2:Online
KsysState: <ksysnode_name1>:1:Online
           <ksysnode_name2>:2:Online

Modifying a multi-node KSYS cluster

Edit online

You can modify a KSYS cluster to add KSYS nodes and to remove KSYS nodes from an existing KSYS cluster.

Note:

For best performance, the RSCT version on all KSYS nodes must be the same. If the RSCT version is not the same on all KSYS nodes, it's recommended to choose the node that has the lowest RSCT version as the group leader node and then create the KSYS cluster on the group leader node.
In a configuration with a Hitachi storage system, if the storage-system related configuration changes after a discovery operation, you must manually copy the Hitachi Open Remote Copy Manager (HORCM) configuration files from the primary KSYS node to the backup KSYS node.

To add KSYS nodes to an existing KSYS cluster, run the following command:

ksysmgr modify ksyscluster cluster_name add
      ksysnodes=ksys_nodename1,ksys_nodename2

You can verify the KSYS cluster that you modified by running the ksysmgr query cluster command. An output that is similar to the following example is displayed:

Name:      test_ksys 
State:     Online 
Type:      DR
Ksysnodes: ksys_nodename1:1:Online (Managing node)
           ksys_nodename2:2:Online 
KsysState: ksys_nodename1:1:Online
           ksys_nodename2:2:Online

To remove KSYS nodes from an existing KSYS cluster, run the following command on the group leader node:
```
ksysmgr modify ksyscluster cluster_name remove ksysnodes=ksysnode_name2
```
You can verify the KSYS cluster that you modified by running the ksysmgr query cluster command. An output that is similar to the following example is displayed:
```
Name:      test_ksys
State:     Online
Type:      DR
Ksysnodes: ksys_nodename1:1:Online
KsysState: ksys_nodename1:1:Online
```