Standard axle archive guide

What is archiving?

Archiving in axle allows users to easily copy files to a predefined location, then remove the files from the original location while retaining the proxy and metadata information in the axle database. This means that users can free up space on their main storage but not lose the information kept in axle. axle also makes it straightforward to restore files from the archive location to their original location on the storage.

Note that this section is for standard axle archives. If you are interested in archives that work with Archiware's P5 software, please see the appropriate section (under construction).

Note that assets with the following characters in their names won't archive properly:

  • :
  • /
  • \

Creating a new archive

To create an archive, go to the catalog section of the admin pages (accessible to any user with administrator permissions from the user icon in the top-right of the main axle interface). On the catalog page, click the button labeled Create archive. This will open the archive creation window. Currently, axle supports two kinds of archives (which you can select with the drop down menu at the top of the window), the default axle archive, and the Archiware archive designed to work with Archiware’s P5 archiving software. Ensure that axle is selected. There are two fields to fill in:

Archive Name: The name of the archive. Use whatever you like, this will appear in the interface and will help you distinguish between archives.

Archive File Path: This is the directory location of your archive. Make sure this folder exists before you designate it as an archive. This is where the files you chose to archive will be copied to.

addarchive.png

Archive permissions

Once you have created an archive, the archive permission will become available on the users section of the admin pages. Select the user you would like to be able to archive or restore files, select the catalog containing the files you would like them to be able to archive, check the archive permission, then click the save button. Repeat for each catalog containing files you would like to archive.

Archiving files or folders

To archive files or folders, select them by clicking the small checkbox in the bottom-left (tile view) or left (list view), then select the name of the archive you would like to copy the files to from the archive option in the selection menu. axle will immediately begin copying the selection to the chosen archive location.

selectionarchive.png

axle displays the archival status for each asset in between the selection checkbox and the approval circle. By default this is blank, but when archiving it will display two arrows in a circle.

archiveindicator1.png

Once archiving is complete, it will display a white triangle.

archiveindicator2.png

This indicates that a copy of the asset is in the archival location and in the original location on the storage. If there was an error, the archival status will show a red triangle, and you can find some error details in the archival metadata, visible in the asset information column on the right.

If you select an archive from the navigation column on the left, you will see all assets archived to that location.

Long-term storage

Once the assets have been copied to the archive location, they can be copied or moved to other locations. A common workflow is to configure LTO archiving software to automatically write the contents of the archive folder to tape. For details, please consult the documentation of your LTO archiving software.

Removing archived assets

Note that axle does not perform any kind of check on the integrity of copied files. Before removing files from the original location, you may want to verify that the files were copied correctly.

To remove archived assets from their original location, select them, then chose Delete High-res from tier-1 from the selection menu. This will immediately remove the file from the original location, leaving behind a zero-byte placeholder file.

archivedelete.png

The white triangle will be replaced with a gray triangle.

archiveindicator3.png

The proxy, metadata, and other information stored in axle's database will be unchanged. Certain actions, like downloading the high-res file, or moving the file, will be disabled.

Restoring archived assets

To restore archived assets to their original location on the storage, select the archived assets, then click Restore from Archives in the selection menu. Axle will immediately begin copying the files back to their original locations. Note that the files must be present in their original folder structure in the archive location to be restored, so you'll have to move them back there if you moved them to an LTO tape or other storage device.

archiverestore.png