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 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.