Virtual Business Service-Availability User's Guide

Last Published:
Product(s): InfoScale & Storage Foundation (7.4.1)
Platform: AIX,Linux,Solaris,Windows
  1. Overview of Virtual Business Services
    1.  
      About Virtual Business Services
    2.  
      Features of Virtual Business Services
    3.  
      Sample virtual business service configuration
    4. Virtualization support in Virtual Business Services
      1. VMware virtualization support prerequisites for Veritas InfoScale Operations Manager Virtual Business Services
        1.  
          VMware virtualization support in VBS
    5.  
      About the Veritas InfoScale Operations Manager policy checks for Virtual Business Services
    6. Supported operating systems for Virtual Business Services
      1.  
        Internationalization (I18N) support
  2. Installing and configuring Virtual Business Services
    1.  
      About Virtual Business Services components
    2.  
      Virtual Business Services workflow
    3.  
      Support matrix for VBS
    4.  
      Prerequisites for Configuring VBS
    5.  
      Installing the Virtual Business Services package using Veritas InfoScale Operations Manager
    6. Configuring a virtual business service
      1.  
        Considerations for creating a virtual business service
      2. Creating virtual business services
        1.  
          Create Virtual Business Service panel options
      3. Editing virtual business services
        1.  
          Edit Virtual Business Service panel options
      4.  
        Deleting virtual business services
      5.  
        Virtual Business Services daemon
      6.  
        Communication among VBS daemons
      7.  
        Auto discovery of VBS Daemon on each cluster
      8.  
        Configuring auto discovery for each cluster in VBS
    7. Configuring dependencies for a virtual business service
      1.  
        Configure Virtual Business Service dependencies - Specify service group dependencies panel options
      2.  
        Link Service Groups panel options
      3.  
        Unlink Service Groups panel options
      4.  
        Specify Script Execution details panel options
      5.  
        Configure Virtual Business Service dependencies - Specify VMs start or stop panel options
    8. Managing Microsoft Failover Clustering from VBS
      1.  
        About installing VBS on Microsoft Failover Clustering nodes
      2.  
        Installing VBS on Microsoft Failover Clustering nodes
      3.  
        Upgrading VBS on the Microsoft Failover Clustering nodes
      4.  
        Uninstalling VBS from Microsoft Failover Clustering nodes
      5.  
        Viewing the ApplicationHA deployment report
    9.  
      Uninstalling the VRTSvbs package
    10.  
      Uninstalling VBS from Microsoft Failover Clusters
  3. Virtual Business Services operations
    1. Starting and stopping Virtual Business Services
      1. Starting a virtual business service
        1.  
          Virtualization workflow for virtual business service start operation
      2. Starting a virtual business service from the command line
        1.  
          Start Virtual Business Service panel options
      3. Stopping a virtual business service
        1.  
          Virtualization workflow for virtual business service stop operation
        2.  
          Stop Virtual Business Service panel options
      4.  
        Stopping a virtual business service from the command line
      5.  
        About propagation behavior for start and stop operations
    2.  
      Viewing the information on a Virtual Business Service
    3.  
      Viewing Virtual Business Services in the data center
    4.  
      Viewing the service groups associated with Virtual Business Services
    5.  
      Viewing the clusters associated with virtual business services
    6.  
      Viewing the virtual business services status from the command line
    7.  
      Viewing the information on a virtual business service in the Server perspective
    8.  
      Viewing the dependency associated with Virtual Business Services in the Server perspective
    9.  
      Viewing the dependency associated with Virtual Business Services
    10.  
      Viewing the properties of a virtual business service
    11.  
      Viewing application recovery point and startup time of a VBS
    12. Tracking VBS operations
      1. Tracking information about tasks performed on a VBS
        1.  
          Task states
      2.  
        Tracking information about tier-level sub-tasks performed as a part of a VBS task
      3.  
        Tracking step-by-step progress of a VBS task
    13. Logs of a virtual business service
      1.  
        Logs of a Virtual Business Service panel options
    14.  
      Fault management for a virtual business service
  4. Virtual Business Services security
    1. About the Virtual Business Services security model
      1.  
        Virtual Business Services security model example
      2.  
        Security mechanism for cluster C1
      3.  
        Security mechanism for cluster C2
      4.  
        Security mechanism for cluster C3
      5.  
        Authentication for start and stop operations
  5. Fault management in Virtual Business Services
    1. Fault management overview
      1.  
        VCS dependencies in Virtual Business Services
      2.  
        Parallel and failover service groups
      3.  
        Shared service groups
      4.  
        Types of faults handled
      5.  
        Fault management considerations in ApplicationHA environments
      6.  
        Fault propagation for virtual machines
      7. Custom script execution
        1.  
          Limitations of custom script execution for soft dependencies
        2.  
          Configuring custom script execution for soft dependencies
  6. Disaster recovery in Virtual Business Services
    1.  
      About disaster recovery for Virtual Business Services
    2.  
      Prerequisites
    3.  
      Sample disaster recovery configuration
    4.  
      Disaster recovery alerts
    5.  
      Disaster recovery limitations
    6.  
      About the disaster recovery plan
    7.  
      Bringing up Virtual Business Services at the DR site
    8.  
      Performing planned migration of virtual business services
    9.  
      Concurrency violation
    10.  
      Reconfiguring an ApplicationHA node
  7. Upgrading Virtual Business Services
    1.  
      Prerequisites for upgrading to VBS version 7.3
    2.  
      Upgrading the VRTSvbs package using Veritas InfoScale Operations Manager
    3.  
      Considerations for renaming a cluster
  8. Appendix A. Command reference
    1.  
      Virtual Business Services commands
  9. Appendix B. Troubleshooting and recovery
    1. Troubleshooting Virtual Business Services
      1.  
        Command line cannot connect to the VBS daemon
      2.  
        Virtual business service state is unknown
      3.  
        Disaster recovery of a virtual business service fails
    2.  
      Virtual Business Services log files
  10. Appendix C. Known issues and limitations
    1. Known issues and limitations
      1.  
        Complete cluster fault is not handled
      2.  
        Fault propagation for shared service groups
      3.  
        Veritas InfoScale Operations Manager displays stale status for a virtual business service
      4.  
        Propagation of multiple child fault or recovery events may be missed if fault action on parent service group is in progress (2745323)
      5.  
        ClusterService group having vbsapp resource does not link vbsapp to newly created gcoip (2713002)
      6.  
        CLI command returns incorrect state of the virtual machine in VBS (2789621)
      7.  
        VBS dependencies get deleted during the upgrade of ApplicationHA or SFWHA configured in a VBS [2832599]
      8.  
        VBS start operation may fail from Veritas InfoScale Operations Manager when VM start/stop is enabled [2848118]
      9.  
        Clusters running on SFWHA 5.1SP1 or 5.1SP2 configured with virtual IP addresses cannot migrate to VIP-less communication (2845412)
      10.  
        Pop up showing error message during VBS uninstallation on Windows 2008 remains hidden behind other windows (2872716)
      11.  
        Events generated for VBSD lack correct description (2833160)
      12.  
        DR fails to start in VBS 7.3 or lower for VBS formed of global service groups [3240419]
      13.  
        Installation or upgrade of VRTSsfmh or VRTSvbs package from Veritas InfoScale Operations Manager may fail if publisher is set (3306997)
      14.  
        Operation performed on service groups with disabled resources remains stuck or fails by timing out [3280718, 3288725]
      15.  
        Recover and takeover messages are not displayed during DR of a VBS with a global service group [3315435]

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.