HALDOMSETUP(1M)

NAME

haldomsetup - Configure VCS service group to include the LDom resource

SYNOPSIS

haldomsetup -g sg_name -r res_name -l ldom_name | -c cfg_file [-a] [-p] [-u user_name ] [-P password ] -s systems

AVAILABILITY

VRTSvcsag

DESCRIPTION

The haldomsetup command allows users to create service groups in a VCS cluster to manage the logical domain (LDom) in an Oracle VM server for SPARC environment. The command performs various checks before creating the service groups and its resources for a logical domain in VCS. Ensure that you create the logical domain in the cluster before you execute the haldomsetup command.

You can use the command to create a failover service group (default service group type) or a parallel service group to manage logical domains in VCS.

OPTIONS

-g sg_name
  Create a logical domain service group with the name sg_name in the VCS configuration file, if the sg_name service group is not present.
-r res_name
  Create a LDom resource with the name res_name in the VCS configuration file.
The command may exit in any of the following conditions even if the res_name resource is already present:
o The service group is different from the sg_name service group.
o The resource type is not set to LDom
-l ldom_name
  Name of the logical domain that you want VCS to manage.
-c cfg_file
  Absolute path of the configuration file for the logical domain ldom_name.

Run the following command to create the configuration file for a logical domain.

# /usr/sbin/ldm list-constraints -x ldom_name > /config.xml

-a Populate the value for the AutoStartList attribute of the service group sg_name. When you start VCS the values populated in the attribute enables the service group to come online on a system (defined as part of the systems parameter). If you configured a parallel group, the group comes online on multiple nodes.
-p Configure a parallel service group for the logical domain ldom_name. If the -p option is not specified, the command creates a failover service group by default.
-u user_name
  User who is authorized to perform migration of the logical domain from another host to the current host. If no user name is specified, the default user name used is root.
-P password
  Password set for the user user_name. The command encrypts the password before configuring the LDom resource.
-s systems
  Modify the SystemList attribute to include the systems you specified. System names must be specified as a comma-separated (,) list.

The command sets the ldom_name value you specified as the value of the LDomName attribute for the LDom resource.

The command sets the cfg_file value as the value of the CfgFile attribute for the LDom resource. This file is used to create the LDom during online of the LDom resource.

The command uses the user_name and password values specified to configure the UserName and Password attributes. These credentials are used to migrate the LDom from the source node to the target node when a migration is invoked by the hagrp command. If the values set for the UserName and Password attributes are different for different systems in the cluster, localize the attributes UserName and Password manually and configure these attributes. Symantec does not recommend having different credentials for the UserName and Password attributes for each system in the cluster.

RETURN VALUES

The command returns 1 for incorrect usage of the command, failures, or VCS is down. The command returns 0 after a successful operation.

SEE ALSO

hagrp (1M)

hares (1M)

COPYRIGHTS

Copyright (c) 2014 Symantec.

All rights reserved.


VCS 6.2 HALDOMSETUP(1M)