About klish
Once the Veritas Resiliency Platform virtual appliance is deployed and configured, you are given limited, menu-based access to the operating system and the product. You need to use Command Line Interface Shell (klish) menu to manage the configuration-related changes to the product.
Below are the Klish options:
Table: Klish main menu options
Menu option | Description |
|---|---|
manage | Manage the Veritas Resiliency Platform appliance |
monitor | Monitor the Veritas Resiliency Platform appliance activities |
network | Change some of the network configurations |
settings | Change the system settings |
hotfix | Manage the Veritas Resiliency Platform hotfixes |
support | Access the Veritas Resiliency Platform logs |
updates | Manage Veritas Resiliency Platform updates and patches |
utilities | Run the miscellaneous utilities of the appliances |
After the product configuration, whenever you log in to the Resiliency Platform appliance, you get the main menu of klish. This menu is the starting point, from which you can configure, manage, monitor, and support your application using the command line. You can reconfigure or modify some of the appliance settings that are configured through the product bootstrap. Following are the settings that you can reconfigure using klish:
Network settings:
You can reconfigure the subnet mask, IP, default gateway, DNS server, route, traceroute, SSH-enable-NIC, NIC for accessing product user interface and search domains using the klish menu. You cannot reconfigure the hostname that you had configured through the bootstrap process. In case of static DHCP, you cannot change the network settings using the klish menu. You cannot change the network settings for any component that is configured in the cloud environment.
System settings:
You can reset the time zone, perform operations related to NTP server, shut down the appliance, reboot using the klish menu. Changing the system settings can affect the product functionality if incorrect values are set. You can also perform logical volume management (LVM) operations such as adding a disk or removing a disk using the klish menu.
About updates:
You can apply patch updates on Resiliency Platform virtual appliance for update, rollback a previously prepared update and view the latest version of the Resiliency Platform. You can also configure the repository, display the current repository configuration and remove the repository.
You can press the tab key to display the menu options or you can run the help command to get detailed help on how to use klish. Use space key for auto-completion of command. If you get the Syntax Error: Illegal command line error or Syntax Error: The command is not completed error, press ? key to display detailed help on the required parameter.
If a klish command is expected to perform any operation on an entity such as start or stop services, it goes into lock mode and does not allow any other operation from any other session to be performed till the first operation gets completed. In such a scenario, you may encounter the following warning:
Warning: Try to get lock. Please wait...
After waiting for some time, if the operation still cannot be performed due to the lock, then you may encounter the following error:
Error: Can't get lock
In this case, you need to execute the same command after waiting for some time. The operation is performed if the lock gets released by that time.
At times, you may not be able to run the klish commands if the /var/opt directory is fully utilized and there is no space to run the klish commands. We now raise risks if disk space is running low on any appliance. Once this issue occurs, there is no way to recover from this situation. Hence, you need to periodically check if the space in that directory is getting fully occupied, and provision for an extra disk accordingly. See Troubleshooting: klish commands for Resiliency Manager, IMS, or Replication Gateway.