Skip to main content
Hitachi Vantara Knowledge

Creating a namespace

You create namespaces in the Tenant Management Console. When you create a namespace, you set some of its properties. Other namespace properties have default settings that you can change only after the namespace has been created.

You can change most of the properties for existing namespaces. For information on changing namespace properties, see Configuring a namespace.


Roles: To create a namespace, you need the administrator role.



If the tenant supports Active Directory authentication, you can create a namespace only while HCP can communicate with AD.

Under certain circumstances, the current state of replication for the tenant may prevent namespace creation.

To create a namespace:

1.In the top-level menu of the Tenant Management Console, click on Namespaces.

2.On the Namespaces page, click on Create Namespace.

The Create Namespace panel opens. Below the Namespace Name field, this panel shows the number of namespaces the tenant currently owns and the number of additional namespaces currently available for the tenant to create.

The default settings that appear in the Create Namespace panel are determined by the settings on the Namespace Defaults page. For information on changing these defaults, see Changing the default settings for namespace creation.

3.In the Create Namespace panel:

oIn the Namespace Name field, type a name for the namespace. HCP derives the hostname for the namespace from this name. The hostname is used in URLs for access to the namespace.

In English, the name you specify for a namespace must be from one through 63 characters long and can contain only alphanumeric characters and hyphens (-) but cannot start or end with a hyphen. In other languages, because the derived hostname cannot be more than 63 characters long, the name you specify may be limited to fewer than 63 characters.

Namespace names cannot contain special characters other than hyphens and are not case sensitive. White space is not allowed.

Namespace names cannot start with xn-- (that is, the characters x and n followed by two hyphens).

The namespace name must be unique for the current tenant. Different tenants can have namespaces with the same name.

You can change the namespace name any time after you create the namespace, except while the CIFS or NFS protocol is enabled for the namespace. However, when you change the name, the URL for the namespace may change as well.

You can reuse namespace names that are not currently in use. So, for example, if you delete a namespace, you can give a new namespace the same name as the deleted namespace had.

oOptionally, specify an owner for the namespace:

If the owner has an HCP user account, select Local. Then type the username for the account in the Namespace Owner field.

If the owner has an AD user account, select Active Directory. Then, in the Namespace Owner field, type the account username along with the name of the AD domain in which the account is defined, in this format: username@ad-domain-name

For more information on namespace owners, see Namespace owner.

oOptionally, in the Description field, type a description of the namespace. The description can be up through 1,024 characters long and can contain any valid UTF-8 characters, including white space.

oIn the Hash Algorithm field, select the cryptographic hash algorithm for the namespace.

For information on namespace hash algorithms, see Cryptographic hash algorithm.

oIn the Hard Quota field, type the number of gigabytes or terabytes of storage to allocate to the namespace and select either GB or TB to indicate the measurement unit. Valid values are decimal numbers with up to two places after the period. The minimum is 1 (one) for GB and .01 for TB. The maximum value is the amount of space the tenant still has available to allocate to its namespaces.


Tip: To the right of the Hard Quota field, the panel shows the amount of space the tenant has already allocated to its namespaces and the amount of space it still has available to allocate.

For more information on hard quotas, see Storage quotas.

oIn the Soft Quota field, type the percent at which you want HCP to notify the tenant that free storage space for the namespace is running low. Valid values are integers in the range ten through 95.

For more information on soft quotas, see Storage quotas.

oOptionally, associate tags with the namespace:

1.Click on Tags.

2.For each tag you want to associate with the namespace:

a.In the field in the Tags section, type a text string to be used as a tag. Tags must be from one through 64 characters long, can contain any valid UTF-8 characters except commas (,), and are not case sensitive. White space is allowed.

b.Click on Add Tag.

To remove a new tag, click on the delete control ( DeleteControl.png ) for the tag.

For more information on tags, see Namespace tags.

oUnder Replication, select On to replicate the namespace along with the tenant or Off to exclude it from replication. The Replication option is present only if the tenant is allowed to create namespaces with replication enabled.


Note: Depending on current replication requirements, if the tenant is being replicated, this option may be selected automatically. In this case, you cannot deselect it.

For information on replication, see Replication.

oOptionally, if you selected On for Replication, select Allow erasure coding to allow HCP to use erasure coding to implement replication of the objects in the namespace. The Allow erasure coding option is present only while Replication is On and only if the tenant is allowed to manage erasure coding for namespaces.

When you select Allow erasure coding, the Cloud Optimized option is automatically set to On.

oUnder Cloud Optimized, select On to optimize the namespace for cloud protocols only or Off to optimize the namespace for all protocols. The Cloud Optimized option is present only if the tenant is allowed to create namespaces with replication enabled.

When you select Off while Allow erasure coding is selected, that option is automatically deselected.

For more information on cloud-optimized namespaces, see Protocol optimization.

oUnder Retention Mode, select either Enterprise or Compliance to set the retention mode for the namespace. The Retention Mode option is present only if the tenant is allowed to create namespaces in compliance mode.

For information on retention mode, see Retention mode.

oUnder Search, select On to enable search for the namespace or Off to disable search. The Search option is present only if the tenant is allowed to create namespaces with search enabled.

For information on enabling and disabling search, see Setting search and indexing options.

oIn the Service Plan field, either type the name of an existing service plan or click on the arrow control ( UpRightArrowControl.png ). If you click on the arrow control:

1.In the Service Plans window, select the service plan you want.

2.Click on Apply Service Plan.

The Service Plan field is present only if the tenant is allowed to associate service plans with namespaces.

For information on service plans, see Service plans.

oUnder Versioning, select On to enable object versioning in the namespace or Off to disable it. The Versioning option is present only if the tenant is allowed to create namespaces with versioning enabled.

When you select On, you can also enable version pruning.

To enable version pruning, in the Version Pruning section, select the Prune versions older than ... days option and, in the option field, type the number of days old versions of objects must remain in the namespace before they are pruned. Valid values are integers in the range zero through 36,500 (that is, 100 years). A value of zero means prune immediately.

Also if version pruning is enabled for a namespace, you can apply a backup policy to keep milestone versions for specified periods of time. You cannot delete versions that are under retention. The milestone versioning policy can apply to an object only when it is outside the retention policy of that object.

4.Click on Create Namespace.

If Versioning is set to On but Prune versions is not selected, a confirming message appears.

In the window with the confirming message, select I understand to confirm that you understand the consequences of your action. Then click on Update Settings.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.