Product Documentation

System storage

Jan 11, 2018

Check the amount of free space in the appliance's local storage

The appliance's local storage is a Layer Repository where the appliance creates, composites, and stores Layers and Layered Images. You can see how much disk space is used in the System module of the Management Appliance.

Log into the Management Console and select System > Manage Appliance.

In the Services table, the Local Storage for the Layering Service shows how much space is used and how much is free. 

Note

  • Disk space is shown in 1024-based Gigabytes, not metric.
  • Free space is updated every time a Layering Service job completes. If you want to make sure the page has been refreshed, click the Refresh icon just above the Manage Appliance subtab.
  • When creating a Layer or adding a Version to it, extra space is temporarily required to build the Packaging Disk. You can calculate the amount of space needed during Layer creation by adding the following Layer sizes:
    • The size of the OS Layer Version you're using.
    • The size of the writable disk you want for the App Layer.
    • The size of any Prerequisite Layers (if you have any). 

Add space to an existing disk in locally attached storage

You can add storage space to an existing local storage disk as follows.

  1. Log into your hypervisor's management console, and follow the normal procedure to increase the size of the local storage disk. (You may have more than one of these disks, and can expand each one of them.)
  2. Log into the Management Console and select System > Manage Appliance.
  3. Select Expand Storage. A list of expanded disks is displayed. (You might also see attached disks that are not yet part of the layer repository, but you can ignore those.)
  4. Notice that the New Size of the disk you expanded is larger than the Current Size.
  5. Select the check box for the disk that you want to expand to the New Size.
  6. On the Confirm and Complete tab, click Expand Storage.

Add a disk to locally attached storage

When you install the appliance, it comes equipped with an additional 200 GB data disk that is used as a Layer Repository. You can expand the appliance's local storage by adding another disk to it.

  1. Log into your management console.
  2. Select System > Manage Appliance.
  3. Select Expand Storage. The Disk Selection tab is displayed of disks that are attached to the system and are not part of the layer repository.
  4. Select the check box for each disk that you want to use to expand the layer repository. If a check box is grayed out and a yellow icon with an ! (exclamation point) is displayed, it means that the attached disk is not eligible for use (for example, if the disk is not blank). Once the attached disk is blank and unpartitioned, you will be able to use it to expand the appliance's local storage.
  5. On the Confirm and Complete tab, click Expand Storage.

Add storage locations for User layers

When you enable User Layers on a Layered Image, the data and settings for each user are persisted between sessions.

When deploying with User Layers enabled, you must add storage locations for those Layers, rather than allowing user data to be saved on the appliance's main file share.

The main file share is used to:

  • Package Layers using the NFS connector, rather than a connector for your hypervisor.
  • Publish Layered Images to the NFS file share, rather than a connector for your publishing platform.
  • Serve Elastic Layers.
  • Upgrade the App Layering software.

When configuring storage locations:

  • You can assign Groups of users to each location. 
  • The first storage location added to the appliance becomes the default location for User Layers not associated with any other storage location.
  • Storage locations are listed in priority order.
  • If a user belongs to more than one group and those groups are assigned to different storage locations, the person's User Layer will be stored in the highest priority storage location. Once the person's User Layer is saved to the highest priority location, if you change the priority order of the storage locations that the user is assigned to, data saved up until that point will remain in the previously highest priority location. To preserve the person's User Layer, you must copy the their User Layer to the new highest priority location.

Create Storage Locations

To add a storage location:

  1. Log into the management console.
  2. Select System > Storage Locations.
  3. Select Add Storage Location. A list is displayed of file shares, except for the appliance's main file share.
  4. Select Add Storage Location, and enter a Name and Network Path for the new location. 
  5. On the User Layer Assignments tab, expand the directory tree and select the check box(es) for one or more groups to add to the new storage location.
  6. On the Confirm and Complete tab, click Add Storage Location.

Once the Storage Locations are added, you must set security on the User Layer Folders.

Configure security on user layer folders

Storage locations allow you to have more than one location specified for your User Layers. For each Storage Location (including the default location) you need to create a /Users subfolder and secure that location.

The security on each User Layer folder must be set to the following values by a domain administrator:

Creator Owner

Setting name Value Apply to

Creator Owner

Modify

Subfolders and Files only

Owner Rights

Modify

Subfolders and Files only

Users or group:

  • Create Folder/Append Data
  • Traverse Folder/Execute File
  • List Folder/Read Data
  • Read Attributes

Selected Folder Only

System

Full Control

Selected Folder, Subfolders and Files

Domain Admins, and selected Admin group

Full Control

Selected Folder, Subfolders and Files

Set security on the User Layer folders

  1. Log into the management console.
  2. Select System > Storage Locations. The file shares displayed are the storage locations defined for User Layers. For example, say you've defined three Storage Locations so that you can more easily manage storage for Group1 and Group2 separate from everyone else in the organization:
    • Default location - \\MyDefaultShare\UserLayerFolder\
    • Group1 - \\MyGroup1\Share\UserLayerFolder\
    • Group2 - \\MyGroup2\Share\UserLayerFolder\
      Note: The appliance's main file share, which is used for storing OS, App, and Platform Layers, is not listed as a User Layer Storage Location.
  3. Create a \Users subdirectory under each file share:
    • \\MyDefaultShare\UserLayerFolder\Users\
    • \\MyGroup1Share\UserLayerFolder\Users\
    • \\MyGroup2Share\UserLayerFolder\Users\ 
  4. Apply the security settings listed above to each /Users subdirectory.