Add a Storage Group

To start this process you need to access the Storage Groups entity and click the + Add New Storage Groups button to access a wizard.

  1. You're addressed first with the Storage Group Details options. Here you define basic information for the Storage Group.
  2. Next in the process, you set up Geo Replication Settings. These allow you to determine where your content will be replicated for added stability and increased availability.
  3. You can optionally add Additional Domains. You can use additional domains to target specific regions.
  4. The Directory Settings are presented next in the process. Here, you establish a root directory (an "Upload Directory") to be used with the storage group.
  5. Optionally, you can set up Automatic Purge Routines. These allow you to target directories in your storage group and have content automatically deleted once certain conditions have been met.
  6. Finally, you need to review the Summary. All of the settings you've applied for the group are revealed, and you use this window to save them.
Note: You can edit an existing storage group to modify settings as necessary. However, you must wait for a new storage group to complete provisioning before you can edit it.

Storage Group Details

Create a "Name" for the storage group to serve as an identifier, and define a unique Domain Name value for use in identifying points of access for the group.

  • Access Control Group: An Access Control Group (ACG) is a grouping of products associated with a specific contract. (NetStorage is the product, in this case.) ACGs determine how service usage is logged and billed (if applicable), so ensure that the appropriate ACG is selected. If only one ACG is associated with your account, it will be default selected here.
  • Storage Group Name: Input a desired name for the Storage Group. This is how it is identified throughout the UI. You should use a unique, easy-to-remember value. (For example, name the group based on the type or classification of media you wish to store in it.)
  • Domain Name: This value serves as a unique prefix for each of the Domain Names used to access this Storage Group. For example, it will be included in your Upload Domain Names for the various protocols, as well as the Domain Name used to access this Storage Group via the NetStorage HTTP API (if in use).

Geo Replication Settings

Replicate your data in at least two different geographic regions (zones) for added stability. For best performance, ensure that both regions are geographically close. In general replica location should be tailored to where uploads come from, and where delivery performance is most important.
Note: The default No Capacity Action will temporarily Spill Outside of your zone if there's no capacity available. This is the default action. Contact if your account representative if you would like to Deny Upload to other zones.
  1. Click the + Add Replica button.
  2. For Replica No. 1, use the Zone drop-down to select the region that is closest to where the content will be served or accessed.
  3. Click Save.
  4. Click the + Add Replica again.
  5. For Replica No. 2, use the Zone drop-down to select a region outside the first, yet still close to Replica No. 1.
  6. Click Save.

You should see a message stating "Valid zone combination" if you have selected appropriately. By default, only two replicas are supported.

Three-way Replication and NetStorage

Storage groups default to the use of two replicas, or "two-way replication." NetStorage offers support for three-way replication, but it's not a standard offering. It can be provided after a valid business case consideration. If you have implemented it, be aware you'll have lower limits on the number of write operations per hour than standard two-way replication. This may delay serving content when requested.

Contact your Account Representative for additional details and availability information.

Note: The term "write operation" includes any successful change to content or metadata stored in a Storage Group. This includes uploads, explicit directory creation, symlinks, renames, timestamp changes and deletes.
Supported Geo Replication Zones

Replicas should be nearby for best performance and stability.

Note: Available zones may change over time. Contact your account rep to make changes to existing replication configurations.
Zone Description
AU Australia
IN India
JP Japan
KR Korea
SG Singapore
asia Asia
europe Europe
global Not recommended. Choosing this zone can't guarantee where your replica will reside.
us United States
useast United States - East
uswest United States - West

Additional Domains

You can mitigate temporary connectivity issues by using additional domains to target specific regions to have specific domains access a specific region. You can add additional domains during the creation or editing of a storage group.

Each additional domain is appended to your primary Domain Name.

Example additional domain configuration

In this example, we append each region to the domain, and upload traffic is allowed and restricted as needed.

Upload Directory

An upload directory is a root directory in a storage group, represented by a CP code that has been provisioned for use with NetStorage. This is also referred to as a "CP code root". The CP code is used to track billing usage as well as a reference for your use in reporting and gathering statistical data. When adding or editing a storage group, you use the Upload Directory field to select a CP code for use.

  • If only a single CP code is available it will be default selected. In this case, a single CP code has been provisioned and is available for use as an upload directory.
  • If multiple CP codes are available, select the appropriate one. In this case, multiple CP codes have been provisioned for use as an upload directory. Ensure that you select the appropriate one for use. (Speak to your NetStorage Administrator to determine the proper one, or contact your Account Representative.)
  • If no CP codes are available, you have multiple options. If there is nothing available in this drop-down, you currently have no CP codes provisioned. Perform either of the following:
    1. Contact your Account Representative.You can work with your representative to get one or more new codes provisioned. Once provisioning completes, you can restart this process and select the new CP code for use.
    2. Continue with creation of the storage group. Leave this field blank. After you finish and save the storage group, a CP code will be generated and applied to it for use as the upload directory. (The code is added internally during the storage group's provisioning. This provisioning can take roughly 60-120 minutes.)

Automatic Purge Routines

Automatic purge routines perform a routine scan of a target directory, and once a specified capacity is reached, the system will begin to purge files that are older than a date you specify.