Autodesk recommends that every Vault upgrade start with a validated backup.
The following procedure for testing the upgrade is the preferred method for validating a backup.
The best practice is to perform a test upgrade of the Vault server on a machine that is similar to the production server. A test upgrade provides confidence that the backup is valid and identifies potential pitfalls with no impact on the production environment. Following is an overview of test environment benefits.
Test Machine Settings |
Benefits |
---|---|
Similar CPU, memory, disk space |
Provides an estimate of how long the migration can take. Gives insight into migration settings, such as time-out values to be changed. Exposes other configuration settings that may require changes. |
Database |
Test machines that need access to a vault that is 2 GB or more also need a similar version of full MicrosoftTM SQL server installed. |
Other applications that are installed on the production server |
Test for compatibility with various proxy clients, firewalls, anti-virus programs, etc. |
Operating System, Service Packs, firewalls, etc. |
Compatibility testing. |
Microsoft® Windows® Administration settings |
Check for compatibility with Windows Domain policies, login scripts, permissions, and other settings. |
If a test environment similar to production is not attainable, a low cost alternative is virtual machines like VMWare or Virtual PC from Microsoft. Virtual machines lack many of the benefits outlined above but are far better than not performing a backup and migration validation.
Use the Vault server application to restore the production backup in the test environment.
Migration Timeout
If the migration stops because of a timeout error, the following steps will help resolve the issue. In the ADMS Console look in the Console log for today’s date and search for ‘timeout’. If a timeout error is found, perform the following steps.
Look in the ADMS log file to determine if the cause is a timeout:
C:\ProgramData\Autodesk\VaultServer\Filestore\ADMSConsoleLog-YYYYMMDD.txt
Search the log file from the bottom up for ‘timeout.’ If a timeout error is found with a time stamp matching the time of the stopped migration, perform the following steps:
<timeouts connection=”120” defaultCommand=”360” longCommand=”1800” />
Example: Connectivity.ADMSConsole.Exe -Ob2bmigrate -VUadministrator -VPadmin_password -DBUsql_user -DBPsql_password Replace admin_password with the appropriate administrator password for the -VP switch.
The last two command line parameters, –DBU and –DBP, are required only if the sa password is not the default password.
Verify the filestore and databases are complete and that the restored environment is operational. Use a client to verify the content and the Vault server application to verify the configuration.
Apply the processes detailed in this paper to the test environment. Using the test environment provides a safe option to experience the migration process and discover unexpected hurdles. Although this process takes time it can, in the long run, save time and stress by avoiding impact to the production environment.