Vault - Gateway Recovery

By Chris Smith

Introduction

In the latest release of Autodesk Vault Professional, we have the option to set up a Vault gateway. The Vault gateway allows for Vault users to connect to the Vault from outside of the workgroup network without requiring a VPN. Instead, the gateway creates a secure portal between the user and the Vault server.

You can learn more on how to set up the Vault gateway from this article created by another Cadline specialist, Chris Turner - https://www.cadlinecommunity.co.uk/hc/en-us/articles/5796593971101-Autodesk-Vault-2023-Gateway

Additional information

There may come a time when we need to add the Vault gateway to another server. This could be for several reasons, like moving the server location, reinstalling the server after technical issues, or even just maintaining more than one ADMS server. When we try to create another gateway however, we will get the message below:

Cause

This error is seen when the user account that is being used as the service account already has a gateway open to another server. Only one gateway is available per Autodesk account, so to fix this issue we need to remove the gateway from the other Vault.

Solution

If the Vault that is currently using the gateway is accessible, then you can log into the ADMS console on that server and delete the gateway from that Vault.

It may not be possible to connect to the Vault with the active gateway for several reasons, and we do not have the option in our current Vault to delete the existing gateway. We do however, have a window at the bottom labelled Other Gateways so there is something we can do to get access.

To show the active gateway in the list, first close the ADMS console, and then navigate to the folder that contains the ADMS console application (Default location - C:\Program Files\Autodesk\Vault Server 20XX\ADMS Console\Connectivity.ADMSConsole.exe). You can find the location by right clicking the Vault ADMS shortcut and selecting properties.

Look for the config file for the ADMS Console (see below) and open the file in a document editor like wordpad or Notepad++.

Search the contents of the file for <appSettings> (see below) and add a line at the bottom of the list as follows:

<add key="VGShowAllOtherGatewaysInTeam" value="true"/>

NOTE- You may need to open the file as owner/administrator to make the change.

Save the file and open the ADMS console. Sign is as normal and try to create the gateway. You should now see the existing gateway in the list and an option to delete it.

Once the existing Vault gateway has been removed, the gateway on the current server can be created. Note that this will shut down the connection to the old gateway server.