Backing up and Restoring Your Altium Vault Installation

Old Content - see latest equivalent

An Altium Vault can hold a broad range of valuable design data. A key requirement of ensuring the long-term integrity of this design data, is backing it up. The standard Altium Vault installation includes a backup and restore tool, accessed via a command prompt.

The default location of the backup tool is in the folder C:\Program Files (x86)\Altium\Altium Vault\BackupTool\.

The name of the backup tool is avbackup.exe

This image shows each command and their switches.

NOTE: You must run the command prompt in administrator mode to be able to use the Backup and Restore tool.

TIP: While it is not possible to paste into a command prompt using Ctrl+V, you can paste via the right-click menu. Copy the required strings from this page and paste using this technique to save time and avoid mistakes.

Contents of the Zip Archive

The tool backs up the entire Vault and user-data, including:

  • Full database backup, including: models, components, managed sheets, released designs & installations acquired via the Network Installation Service.
  • All revisions of above
  • Repositories and included managed designs
  • Search index
  • User-defined settings

Accessing the Backup/Restore Tool

To use the tool:

  1. Launch a Windows Command Prompt.
  2. Navigate to the correct folder: cd C:\Program Files (x86)\Altium\Altium Vault\BackupTool\
  3. To run the tool and list the available options, at the Command Prompt, type: avbackup ?

Note the ?, including this displays help on the functions available in the backup tool, the functions include:

  • backup — Backup data to ZIP archive
  • restore — Restore data from ZIP archive, the Restore point is automatically created
  • help — display this help screen (? can be used instead of the string help)

Backup Syntax and Switches

avbackup [backup] [-z] [-i]

  • -z filename for the zip file, can include a path. Enclose in quotes if there are spaces in the string.
  • -i path and location of the LocalVault.ini file, the INI file details the current location of the Altium Vault to be backed up. Default location of the INI file is C:\Program Files (x86)\Altium\Altium Vault\

Example

avbackup backup -z "C:\Backups\Altium Vault\201405_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium Vault\LocalVault.ini"

This will backup the Altium Vault into the file named 201405_Backup.zip, writing the file to the folder C:\Backups\Altium Vault\

NOTES: Any folders specified must already exist. Also, existing files are overwritten if the new file has the same name as an existing file.

Restore Syntax and Switches

avbackup [restore] [-z] [-i]

  • -z path and filename of the backup zip file. Enclose in quotes if there are spaces in the string.
  • -i path and location of the LocalVault.ini file, the Vault location specified in the INI file is where the Altium Vault will be restored to. Default location of the INI file is C:\Program Files (x86)\Altium\Altium Vault

Example

avbackup restore -z "C:\Backups\Altium Vault\201405_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium Vault\LocalVault.ini"

The Function of the Restore Point

The backup tool automatically creates a restore point before commencing to restore the Vault. To do this, the backup tool performs a backup on the existing Vault, and copies the restore ZIP into the following location:

C:\Program Files (x86)\Altium\Altium Vault\BackupTool\Backups\

The ZIP is named from the current date and time.

Errors During Backup or Restore

Errors that occur during a backup or restore are written to the file:

C:\Program Files (x86)\Altium\Altium Vault\BackupTool\errors.log

 

You are reporting an issue with the following selected text and/or image within the active document:
ALTIUM DESIGNER FREE TRIAL
Altium Designer Free Trial
Let’s get started. First off, are you or your organization already using Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

In that case, why do you need an evaluation license?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You actually don’t need an evaluation license for that.

Click the button below to download the latest Altium Designer installer.

Download Altium Designer Installer

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Please fill out the form below to get a quote for a new seat of Altium Designer.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

If you are on Altium Subscription, you don’t need an evaluation license.

If you are not an active Altium Subscription member, please fill out the form below to get your free trial.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Why are you looking to evaluate Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

You came to the right place! Please fill out the form below to get your free trial started.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Sounds exciting! Did you know we offer special discounted student licenses? For more information, click here.

In the meantime, feel free to request a free trial by filling out the form below.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

That’s great! Making things is awesome. We have the perfect program for you.

Upverter is a free community-driven platform designed specifically to meet the needs of makers like you.

Click here to give it a try!

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.