Product Documentation

Export and import layers

Jan 11, 2018

The Layer Import/Export feature lets you export layers from your App Layering Appliance (a.k.a. Enterprise Layer Manager (ELM)), and then import the layers into another appliance that you've installed in another location in your environment.

For example, you can import layers from a proof-of-concept environment onto a new appliance in your production environment.

Once imported, the appliance runs an analysis to determine whether the layers can be assigned elastically. This information is included in the layer details.

Before you start

Prerequisites

  • Two App Layering appliances (Enterprise Layer Managers):
    • The appliance that contains the Layers you want to export.
    • The appliance to which you want to move the Layers.  
  • A configured SMB Network File Share that meets the following requirements:
    • Both App Layering appliances must be able to reach the SMB Network file share.
    • The SMB Network File Share must have enough space for all exported Layers, plus the meta data and icons for the Layers.
       
  • Information required to export and import Layers:
    • The path, username and password for the SMB Network File Share to which you want to export the layers.
    • Administrator User name and Password for the Management Console.

If filenames on the File Share include special characters

Since the File Share does not support some special characters, Layer names containing those characters are temporarily changed to underscores (_) on the File Share, and all unsupported characters are changed.

For example, a Layer named "Notepad++" becomes "Notepad__" when exported.  When the Layers are imported onto the new appliance, the original name is restored, and it again appears as "Notepad++".

Considerations

  • Only one Import or Export should be run at a time.
  • You can copy exported Layers to a different File Share for import, but be sure to move all of the Layer files, and put them in \network-file-share\Unidesk\Exported Layers\. The appliance imports the OS Layer first, because the OS layer is required to import other layers.

Naming layers for export

All Layers are exported to the following directory on the File Share:

\network-file-share\Unidesk\Exported Layers\

The exported file names reflect the Layer Name, Layer Version Name, and Layer GUIDs.

Selecting layers

When selecting layers, the icons not only indicate which layers are selected, they also indicate whether a folder contains layers that have already been exported or imported, depending on which operation you are engaged in.

When exporting layers: 

  • If an icon is partially selected, it means that the folder includes some layers that are not selected.
  • If an icon is grayed out, it means that the layer cannot be selected for export, most likely because the layer has already been exported. Hover over the layer for a message about why it cannot be selected.

When importing layers: 

  • If an icon is partially selected, it means that the folder includes some layers that are not selected.
  • If an icon is grayed out, it means that the layer cannot be selected for import, most likely because the layer has already been imported. Hover over the layer for a message about why it cannot be selected.

Searching

The Search box allows you to quickly find all layers and versions containing the search text. Searches are not case sensitive. Remember, when you select a folder, the UI only selects the subset of layers that are visible. When a folder you select has a "partially Selected" icon, it means that although you've selected all visible items for export or import, there are some layers that have already been exported or imported. You can view any hidden layers by selecting the checkbox above the list.

Export Layers

In the App Layering Management Console, select Layers > Export

On the File Share tab, enter the path of the File Share where you want to export the layers. The App Layering software appends \Unidesk\Exported Layers\ to the Universal Naming Convention (UNC) you specify. Enter the User name and Password for an administrator with Full Access to the File 

Click Test SMB File Share. If necessary, adjust the credentials until the test is successful. You cannot proceed until there is a connection to the File Share.

On the Version Selection tab, choose the layers for export:

  1. Expand each available OS layer to reveal folders of your OS layer versions, Platform layers, and App layers.
  2. If you have already exported to the selected location, you can click the Show versions that cannot be selected checkbox to reveal the layers previously exported to this location.
  3. Select the layers and versions to export.

On the Confirm and Complete tab, verify the Layers to be exported, and make sure that the space available exceeds the estimated file size. When space is sufficient, the wizard allows you to click Export Layers. A Layer Export task is created where you can track progress.

If you cancel the export before the OS Layer is fully exported, be sure to re-export all of the Layers again, including the OS Layer. 

If you create more Layers after the initial export, run another export to the same location. Only the new Layers will be exported.

Warning

Do not attempt to edit or rename any of the exported files.

Import layers

When importing layers from one appliance into another if two Layers have the same name even though the contents of the Layer are different, the Layer that is imported has a "1" appended to the name. If other Layers with the same name are imported, the “1” is incremented.

In the App Layering Management Console, select Layers > Import. If some Layers happen to be selected, the import still applies to all unimported layers in the Import folder. You can deselect individual layers in the folder, as explained in step #4 below.

On the File Share tab, enter the path to the File Share from which you want to import the layers. This should be the File Share where you exported the layers. The App Layering software appends \Unidesk\Exported Layers\ to the URL you specify. Enter the User name and Password for an administrator with Full Acess to the File Share. 

Click Test SMB File Share. If necessary, adjust the credentials until the test is successful. 

The wizard compares the contents of the appliance with the contents of the selected File Share, and prepares to import the layers that have not yet been imported. 

On the Version Selection tab, choose the layers for import:

  1. Expand the OS layer that includes the layers you want to import, and select one of the subfolders to import. This selects every layer and version available for import in the folder. 

  2. If you want to see the layers that have already imported from this location, make them visible by clicking the checkbox Show versions that cannot be selected.

  3. If one of the folders includes layers that you do not want to import, deselect each of those layers.

On the Confirm and Complete tab: Verify the Layers to be imported. 

  • Verify the layers queued up for import. Only Layers that have not yet been imported from the File Share are listed.
  • Verify that there is enough space on the appliance's local storage for the layers. The wizard will not allow the import to proceed until there is enough space for the layers.

Important

If you cancel an OS layer import, all layer imports that rely on the OS layer are canceled.

 

When all settings are valid, click Import Layers. An Import task is created where you can track progress.

Once the layers are imported, an "Elastic Fit Analysis" is run on the layers, allowing you to see which layers can be elastically assigned.