Virtual Business Service-Availability User's Guide
- Overview of Virtual Business Services
- Virtualization support in Virtual Business Services
- Supported operating systems for Virtual Business Services
- Installing and configuring Virtual Business Services
- Configuring a virtual business service
- Creating virtual business services
- Editing virtual business services
- Configuring dependencies for a virtual business service
- Managing Microsoft Failover Clustering from VBS
- Virtual Business Services operations
- Starting and stopping Virtual Business Services
- Tracking VBS operations
- Logs of a virtual business service
- Virtual Business Services security
- Fault management in Virtual Business Services
- Disaster recovery in Virtual Business Services
- Upgrading Virtual Business Services
- Appendix A. Command reference
- Appendix B. Troubleshooting and recovery
- Appendix C. Known issues and limitations
- Known issues and limitations
- Known issues and limitations
Virtual Business Services commands
You can run the Virtual Business Services command line interface from nodes of the clusters that have service groups configured as part of a virtual business service.
Table: Virtual Business Services commands lists the Virtual Business Services commands and their usage.
Table: Virtual Business Services commands
Operation | Command syntax and examples |
---|---|
View the information about the Virtual Business Services that are configured. | vbssvc -display [vbs(s)] Examples # vbssvc -display vbs1 vbs2 Displays information about vbs1 and vbs2. # vbssvc -display The command displays information about the virtual business services that consist of service groups from the local cluster. |
View the states of the global service groups or remote clusters. The command output also shows the option that will be used to bring the global service group online when you start the virtual business service. | vbssvc -showplan vbs Example # vbssvc -showplan vbs1 Displays the state of the global service groups or remote clusters. |
View the availability status of virtual business services. | vbssvc -state [vbs(s)] Examples # vbssvc -state vbs1 Displays the availability status of vbs1. # vbssvc -state The command displays availability status of the virtual business services that consist of service groups from the local cluster. |
View the parent-child dependencies and fault policies for a virtual business service. | vbssvc -grpdep [vbs(s)] Example # vbssvc -grpdep vbs1 Displays the parent-child relationships and fault policies that are defined for the virtual business service vbs1. Clustering platform of each service group is also listed next to the service group. |
View states of all the service group for a given virtual business service. | vbssvc -grpstate vbs Example # vbssvc -grpstate vbs1 Displays the states of all the service groups that are part of the virtual business service vbs1. Clustering platform of each service group is also listed next to the service group. The command output also displays the list of nodes on which the service group has faulted. |
View the state of the virtual machine. | vbssvc -grpstate [-vmstate] <vbs> Example # vbssvc -grpstate -vmstate vbsA Displays information about the state of the service groups on the virtual machine. In addition, displays information about the state of the virtual machine. The command output also displays the list of nodes on which the service group has faulted. |
Start a virtual business service. | vbssvc -start vbs [-tag tag_name] Example # vbssvc -start vbs1 Starts the virtual business service vbs1 by bringing its service groups online in the required order. Generates a task ID which can be used by vbstask command to check the progress of the operation. Example # vbssvc -start vbs1 -tag mytag Starts virtual business service vbs1. Generates a task IT and also associates the tag name mytag with the operation. The -tag option can be optionally specified to associate the operation with a user defined tag name which can be alternately used with the tag ID to track the progress of the operation through vbstask command. Note: If any of the VBS tiers is in UNKNOWN state, this command provides an option to ignore such tiers and continue to start the remaining VBS tiers. |
Stop a virtual business service. | vbssvc -stop [-force] vbs [-tag tag_name] Example # vbssvc -stop vbs1 Stops the business service vbs1 by taking its service groups offline in the required order. Generates a task ID which can be used by vbstask command to check the progress of the operation. Example # vbssvc -stop vbs1 -tag mystag Stops the virtual business service vbs1. Generates a task ID and also associates the tag name mytag with the operation. The -tag option can be optionally specified to associate the operation with a user-defined tag name which can be alternately used with the task ID to track the progress of the operation through the vbstask command. The -force option lets you stop a virtual business service though one or more of its components might be shared with other virtual business services. Note: If any of the VBS tiers is down or in UNKNOWN state, this command provides an option to ignore such tiers and continue to stop the remaining VBS tiers. |
Flush a virtual business service. | vbssvc -flush vbs Example # vbssvc -flush vbs1 Flushes the start or stop operation that was initiated on the virtual business service from the command line. The command allows cancellation of the start or stop operation if it becomes unresponsive. |
View the vbssvc usage list. | vbssvc [-help] |
View the virtual machine information. | vbssvc -vminfo [<vbs(s)>] Example # vbssvc -vminfo vbsA Displays information about the service groups on the virtual machine and the virtual machine. Virtual machine information such as name, type of the virtual machine, and the enabled or disabled status of the start and stop option selected in Veritas InfoScale Operations Manager is displayed. Clustering platform of each service group is also listed next to the service group. The virtualization platform for each VM is also listed. |
View the parent-child dependencies and fault policies between service groups. | vbsgrp -dep <cluster_name:group_name>(s) Example # vbsgrp -dep clus1:sg1 clus2:sg2 Displays the parent-child relationships and fault policies that are defined for service group sg1 from cluster clus1 and for service groupsg2 from cluster clus2 as part of any virtual business service that is managed by the Management Server. Clustering platform of each service group is also listed next to the service group. Note: All dependencies for given service groups defined in the Management Server might not be visible. The command displays dependencies defined for service groups that are part of virtual business services that involve the local cluster (the cluster from where the command is executed). |
View the states of service groups. | vbsgrp -state [<cluster_name:group_name>(s)] Example # vbsgrp clus1:sg1 Displays the state of the service group sg1 in the cluster clus1. Clustering platform of each service group is also listed next to the service group. The command output also displays the list of nodes on which the service group has faulted. Note: To view the states of service groups belonging to a particular virtual business service, refer to the vbssvc -grpstate command. |
View the vbsgrp usage list. | vbsgrp [-help] |
View the information about the application recovery point and startup time for a given VBS. | vbssvc -showsla <vbs_name> Example # vbssvc -showsla vbs1 Displas the AppRecoveryPOint, startup time, and ReplicationLagInfo for each of he global service group. It also displays the effective recovery point and effective startup time for vbs1. Note: Currently, you can see the startup time and AppRecoveryPoint only for a global service group. |
Enable debug logs for the VBS daemon. | vbslog -addtags tag1 [tag2 tag3 ....] You can enable the DBG_MSG, DBG_POLICY, DBG_SECURITY, and DBG_PING tags. |
Disable debug logs for the VBS daemon. | vbslog -deltags tag1 [tag2 tag3 ....] You can disable the enabled tags. |
View the vbslog usage list. | vbslog [-help] |
View information about tasks performed on virtual business services | vbstask -display [task_id(s)] [-vbs vbs(s)] [-tag tag_name] Example vbstask -display Displays information about the tasks performed on all virtual business services in the cluster. vbstask -display {41920582-1dd2-11b2-8d2b-b518e666c59d} Displays information about the task with task ID {41920582-1dd2-11b2-8d2b-b518e666c59d} vbstask -display -vbs vbs1 Displays information about the tasks performed on the virtual business service vbs1. vbstask -display -tag mytag Displays information about the tasks associated with tag mytag. |
View information about tier-level sub-tasks | vbstask -subtasks task_id Or vbstask -substasks -tag tag_name Example vbstask -substasks {41920582-1dd2-11b2-8d2b-b518e666c59d} Displays information about the tier-level actions (sub-tasks) performed as part of the VBS task with task ID {41920582-1dd2-11b2-8d2b-b518e666c59d}. vbstask -subtasks -tag mytag Displays information about the tier-level actions (sub-tasks) performed as part of the VBS task associated with the tag mytag. |
View step-wise progress of a task | vbstask -progress task_id Or vbstask -progress -tag tag_name Example vbstask -progress {41920582-1dd2-11b2-8d2b-b518e666c59d} Displays step-wise progress of a task with task ID {41920582-1dd2-11b2-8d2b-b518e666c59d}. It includes the order in which the tier-level actions were performed and their outcomes. vbstask -progress -tag mytag Displays step-wise progress of a task associated with tag mytag. |