QuickGuide - Upgrading to Version 1.1 of the Altium Vault Server

Frozen Content

Related article: Altium Vault Server - Centralized Supply Chain Management

This article relates to an Altium Vault Server. This is now considered a legacy vault, superseded by Altium Vault 2.0 or later (the Altium Vault).

The following changes have been implemented in version 1.1 of the Altium Vault Server:

  • For access security reasons, the default data location has changed from \Users\<ProfileName>\AppData\Roaming\Altium\VaultServerData (in version 1.0) to \ProgramData\Altium\VaultServerData (in version 1.1).
  • Changes have been made to provide central, server based control of an approved Suppliers list, and access to internal supply chain intelligence through ODBC.

The nature of these changes requires a slightly different procedure to be followed when upgrading from version 1.0, to that typically followed when upgrading the vault installation. This QuickGuide outlines the steps to successfully upgrade your installation of the Altium Vault Server from version 1.0 (Altium Vault Server 1.0.0.27573) – the initial public release of the vault – to version 1.1 (Altium Vault Server 1.1.28346).

Changing Data Location

If you have not used the default location, you are not affected by this change – jump to the section Upgrading the Vault Installation.

  1. Disconnect Altium Designer from the Altium Vault Server (on the Data Management – Vaults page of the Preferences dialog).
  2. Stop all IIS application pools associated to the Altium Vault Server.
  3. Take a copy of the Firebird database (DXPServer.dat) and data files folder (the Revisions folder and all its content) from the default install locations (\ProgramData\Altium\VaultServerData\DXPServer.dat and \ProgramData\Altium\VaultServerData\Revisions) – so simply copy the root VaultServerData folder. 
  4. Copy the data to the new default location (\ProgramData\Altium\VaultServerData).

It can be a good idea to keep a backup of your vault data in a dedicated folder anyway – just in case data is inadvertently deleted during the uninstall phase by clicking on YES instead of NO when asked if you want to keep your existing data!

Upgrading the Vault Installation

  1. Uninstall Altium Vault Server 1.0. This is performed from the standard Programs and Features page (accessed from the Control panel) in Windows 7. Simply right-click on the entry for the Altium Vault Server 1.0.0.27573 and use the Uninstall command from the context menu – to keep existing vault data, be sure to click No when asked if you want to delete all data.
  2. Install Altium Vault Server 1.1 (run Altium Vault Server 1.1.28346.exe). Point to where the vault data is stored – either the new default location (\ProgramData\Altium\VaultServerData) or your existing custom location.

Updating Supply Chain Information

After upgrading your previous version of the vault, existing supply chain data in the vault database must be updated to make it compatible with this later version. This is achieved by using the Vault Migration Tool.

  1. Right-click on the VaultMigrationTool.exe file and elect to Run as administrator. The Vault Migration Tool dialog will appear.
  2. Enable the fourth option – Update supply chain information in Altium Vault Server 1.1.
  3. In the Vault Path field, enter the path to the target vault executable folder (\Program Files (x86)\Altium\DXP Apps Server\Vault, for a default installation).
  4. In the AltiumLive User field, enter the username (Email) element of your AltiumLive login credentials.
  5. In the AltiumLive Password field, enter the password element of your AltiumLive login credentials.
  6. Click the Run button.

Setup the Vault Migration Tool to update supply chain information in your vault database to make it compatible with the
newly-upgraded version 1.1 of the Altium Vault Server.

You are reporting an issue with the following selected text and/or image within the active document: