Modifying the KSYS configuration

Growing business requirements might need changes in your current configuration, for example, adding a specific virtual machine or an entire host to your environment. After the VM Recovery Manager DR solution is implemented in your environment, the KSYS subsystem continues to monitor any changes in the KSYS configuration. If you want to modify the current configuration in your environment, you can run the ksysmgr discover command to discover and validate the changes in the KSYS configuration immediately.

Notes:

If you want to add a new virtual machine to the KSYS configuration, ensure that the corresponding host and the managing HMC are also added to the KSYS configuration. Also, you must add a corresponding host and managing HMC to the backup site so that you can create a host pair across sites.
When you add a host to the KSYS configuration, by default all the virtual machines are included in the KSYS configuration.
If you want to add a disk array to the KSYS configuration, you must add corresponding storage agents to the corresponding site. Also, you must add equal number of storage disks with the same disk size to the backup site so that disk pair can be created by the KSYS subsystem during the discovery operation.

To add a specific VM to the KSYS configuration after the initial KSYS subsystem setup, complete the following steps:

Add the managing HMC and the managed host, which contains VM, to the active site by running the following command:

ksysmgr add hmc Site1_HMC3 login=hscroot hostname=Site1_HMC3.testlab.ibm.com site=Site1

ksysmgr add host Site1_host3 site=Site1

Add the managing HMC and the managed host to the backup site by running the following command. These managing HMC and managed hosts can be used to create host pairs.
```
ksysmgr add hmc Site2_HMC3 login=hscroot hostname=Site2_HMC3.testlab.ibm.com site=Site2

ksysmgr add host Site2_host3 site=Site2
```
Create a host pair between these added hosts by running the following command:
```
ksysmgr pair host Site1_host3 pair=Site2_host3
```
If you want to exclude some virtual machines during a recovery operation, run the following command for each VM that you want to exclude:
```
ksysmgr unmanage vm name=vmname host=hostname | uuid=lparuuid | 
                    ALL host=hostname | ALL host_group=hg_name
```
If the virtual machines use storage disks that are not yet added to the KSYS configuration, add the corresponding disks to the existing storage arrays in the corresponding sites.
Note: You must add a corresponding disk in the backup site so that the KSYS can create a disk pair across sites for replication during the discovery operation.

If you are adding a storage array to a site, you must create storage agents in the KSYS configuration by running the following command:

ksysmgr modify storage_agent strg_agent_name
      site=sitename
      serialnumber=serialnumber
      storagetype=emc|ds8k|svc|hitachi
      [ip=new_ip]

Discover and verify these added resources by running the following command:
```
ksysmgr discover site Site1 verify=yes
```
The KSYS starts to monitor the modified configuration in the active site.

Modifying the attributes of the added resources

In addition to adding new resources, you can also modify the attributes of an existing resource in the KSYS configuration.

You can change the resource attributes as shown in the following examples:

To change the site name, use the following syntax:

ksysmgr modify site old_site_name 
      [name=new_site_name]

To update the HMC name, login credentials, or IP address, use the following syntax:

ksysmgr modify hmc hmcname
      [name=new_hmcname]
      [login=new_username]
      [password=new_password]
      [hostname|ip=new_hostname|new_ip]

To change the storage agent details, use the following syntax:
```
ksysmgr modify storage_agent old_sa name=new_sa
```
Note: You can change only the name of an existing storage agent.
To update the contact details for the KSYS notification, use the following syntax:
```
ksysmgr modify notify oldcontact=old_username newcontact=new_username
ksysmgr modify notify oldcontact=old_email_address newcontact=new_email_address
```
For more information about the KSYS notifications, see Managing the KSYS notifications.
To update the system tunable attributes, use the following syntax:
```
ksysmgr modify system attribute=new_value
```
For more information about the system tunable attributes, see Managing the system attributes.

To update the priority of virtual machines, use the following syntax:

ksysmgr modify VM name1[,name2,name3,...] | file=filepath
   [uuid=uuid_value]
   [host=hostname]
   [priority=low|medium|high]

Note: You cannot update any attributes of an existing host in the KSYS configuration. Any modifications in the host details are registered in the HMC, and the KSYS subsystem discovers these changes during the discovery operation.