HP 3PAR InForm OS 3.1.1 CLI Administrator's Manual

5 Managing HP 3PAR Virtual Domains
Overview
HP 3PAR Virtual Domains Software (domains) allows an administrator to create multiple domains,
or spaces, within a system, where each domain is dedicated to a specific application. In effect,
using Domains restricts users to a subset of the volumes and hosts in a system and prevents users
from exporting virtual volumes to hosts outside of the users’ assigned domains. For more information
about Domains, see the HP 3PAR InForm OS Concepts Guide. This chapter provides instructions
on creating domains and describes the administration tasks associated with maintaining domains.
NOTE: HP 3PAR Virtual Domains Software requires an HP 3PAR Virtual Domains Software license.
Contact your local service provider for details.
Default Domains
An InForm OS CLI user’s default domain is the domain the user accesses at the start of each CLI
session. For example, if you have Edit rights to Domains A and B and your default domain has
been set to Domain A, each time you start a new CLI session you will view and work with only
objects in Domain A (Figure 1 (page 62)). The user’s default domain can be set and reset at any
time by the administrator.
In the following example, the default domain (Domain A) can be reassigned to Domain B for the
current working session using the setclienv currentdomain <name> command. When the
currentdomain <name> is set, you are able to view and work on objects in Domain B for a
single CLI session. When that session is over, your next session is started in your default domain
(Domain A) (Figure 1 (page 62)). Thus, a current domain refers to the domain in which you are
working during a particular, single CLI session.
Figure 1 Assigned Default and Current Domains
Creating a Domain
To create a domain, issue the createdomain <domain_name> command, where
<domain_name> is the name you want to assign the domain. The <domain_name> can be a
maximum of 31 characters in length.
If you want to add an informational note to a domain during its creation, issue the createdomain
-comment <comment> <domain_name> command, where <comment> is the text of the note
you wish to add about the domain being created. The comment length is restricted to 511
characters.
• You can create up to 1,024 domains within a single system.
• You can specify the maximum retention time for a virtual volume in the domain with
the-vvretentiontimemax option.
62 Managing HP 3PAR Virtual Domains