Configuring zone resource in a parallel service group with the hazonesetup utility

Last published : Jun 10, 2026
The hazonesetup utility helps you configure a zone under VCS. This section covers typical scenarios based on the location of the zone root.
In the case of a zone resource in parallel service group, the zone root can be on local or shared storage that the node owns.
Consider an example in a two-node cluster (sysA and sysB). Zone local-zone1 is configured on sysA and local-zone2 is configured on sysB.
To configure a zone under VCS control using the hazonesetup utility when the zone root is on local storage
  1. Boot the local zone on all the nodes outside VCS.
    sysA# zoneadm -z local-zone1 boot
    sysB# zoneadm -z local-zone2 boot
    1. To use the hazonesetup utility, ensure you have a IP configured for the non-global zone and hostname of the global zone is resolvable from non-global zone.
    2. Run the hazonesetup utility with correct arguments on all the nodes successively.
    sysA# hazonesetup -g zone_grp -r zone_res -z local-zone1\
    -p password -a -l -s sysA,sysB
    sysB# hazonesetup -g zone_grp -r zone_res -z local-zone2\
    -p password -a -l -s sysA,sysB
Note: If you want to use a particular user for password-less communication use-uoption of thehazonesetupcommand. If-uoption is not specified a default user is used for password-less communication.
  1. Running the hazonesetup utility on first node adds parallel zone service group and zone resource in VCS configuration. Running the hazonesetup utility on other nodes detect that the zone service group and zone resource are already present in VCS configuration and update the configuration accordingly for password-less communication.
    Note: Run thehazonesetuputility on all the nodes in the cluster that have a zone running on that node. This is required ashazonesetupruns thehalogincommand inside the local zone that enables password-less communication between local zone and global zone.
You can use the same user for multiple zones across systems. Specify the same user name using the -u option while running the hazonesetup utility for different zones on different systems. When you do not specify a user name while running the hazonesetup utility, the utility creates a user with the default user name z_resname_hostname for a non-secure cluster and z_resname_clustername for a secure cluster.
To configure a zone under VCS control using the hazonesetup utility when the zone root is on shared storage that the node owns
  1. Configure a parallel service group with required storage resources (DiskGroup, Volume, Mount, etc.) to mount the zone root on the nodes. Set the required dependency between storage resources (DiskGroup->Volume->Mount). Make sure that you configure all the required attributes of all the storage resources to bring them online on cluster node. You may have to localize certain attributes of storage resources to online them in parallel on all the nodes of the cluster. If you have a parallel Service Group and you use a Diskgroup resource, the attributes for this resource must be localized, otherwise you may end up importing the same diskgroup on 2 nodes at the same time on a non-CVM environment.
    sysA# hagrp -add zone_grp
    sysA# hagrp -modify zone_grp Parallel 1
    sysA# hagrp -modify zone_grp SystemList sysA 0 sysB 1
    sysA# hares -add zone_dg DiskGroup zone_grp
    sysA# hares -add zone_vol Volume zone_grp
    sysA# hares -add zone_mnt Mount zone_grp
    sysA# hares -link zone_mnt zone_vol
    sysA# hares -link zone_vol zone_dg
    See the Cluster Server Bundled Agents Reference Guide for more details on configuring storage resources.
    1. Bring the service group online on all the nodes. This command mounts the zone root on all the nodes.
    sysA# hagrp -online zone_grp -any
  2. Boot the local zone on all the nodes outside VCS.
    sysA# zoneadm -z local-zone1 boot
    sysB# zoneadm -z local-zone2 boot
    1. Run the hazonesetup utility with correct arguments on all the nodes successively.
    sysA# hazonesetup -g zone_grp -r zone_res -z \
    local-zone1 -p password -a -l -s sysA,sysB
    sysB# hazonesetup -g zone_grp -r zone_res -z \
    local-zone2 -p password -a -l -s sysA,sysB
Running the hazonesetup utility on first node adds parallel zone service group and zone resource in VCS configuration. Running the hazonesetup utility on other nodes detect that the zone service group and zone resource are already present in VCS configuration and update the configuration accordingly for password-less communication.
Note: If you want to use a particular user for password-less communication use-uoption of thehazonesetupcommand. If-uoption is not specified a default user is used for password-less communication.
  1. Set the proper dependency between the Zone resource and other storage resources. The Zone resource should depend on storage resource (Mount->Zone).
sysA# hares -link zone_res zone_mnt
Note: Run thehazonesetuputility on all the nodes in the cluster that have a zone running on that node. This is required as thehazonesetuputility runs the halogin command inside the local zone that enables password-less communication between local zone and global zone.
You can use the same user for multiple zones across systems. Specify the same user name using the -u option while running the hazonesetup utility for different zones on different systems. When you do not specify a user name while running the hazonesetup utility, the utility creates a user with the default user name sz_resname_hostname for a non-secure cluster and z_resname_clustername for a secure cluster.
Related information