Follow the steps below to make sure your password management server is properly upgraded to the latest version of AuthAnvil Password Server.
Step 1 – Backup your existing data by creating a backup (.pvb) file.
- Open a command window and navigate to the C:\Program Files\Scorpion Software\AuthAnvil Password Vault\Tools\BackupTool directory.
- To run the backup, run the command aapvbackup.exe with the -b flag, followed by path to the AuthAnvil Password Server’s web.config file and SQL database.
i.e. aapvbackup.exe -b “C:\Program Files\Scorpion Software\AuthAnvil Password Vault\AAPV\web.config” .\AUTHANVIL
- Your pvb file is created and saved in the same directory. If the backup is successful, the tool will display a success message. If you receive an error confirm the path to the web.config file, verify that the AuthAnvil Password Vault database is accessible and run the backup again. Make sure to move this file to a safe location so that it is not overwritten during the upgrade.
Step 2 – Upgrade AuthAnvil Password Vault to AuthAnvil Password Server
- Download the AuthAnvil Password Server v1.7 installer from this link.
- Run the installer (AuthAnvilPWS.exe).
- Accept the Licensing Agreement and the installer will check for prerequisites.
- Select “Upgrade” to launch the in-place upgrade tool. The upgrade will run an intermediate back up, uninstall the existing files, then deploy the latest ones.
- Once the upgrade completes, the AuthAnvil Password Server login website will be launched.
NOTE: If the upgrade fails when deploying the updated files, make sure that you have permissions to write to the C:\Program Files\Scorpion Software folder tree and run the installer elevated (Right-Click -> Run as Administrator).
Step 3 – Test upgraded AuthAnvil Password Server
With all the previous configuration settings now restored, your installation should be back up and fully working.
To test that this is true for AuthAnvil Password Server, log in to AAPS using your existing email address and password / AuthAnvil passcode. The AuthAnvil Password Server should display the version 22.214.171.124
NOTE: With the rename of AuthAnvil Passowrd Vault to “AuthAnvil Password Server”, the website URL has also changed from “/AAPV/” to “/AAPS/” (i.e. https://yourdomain.com/aaps)
Once you have logged in and verified that your data has been restored, you will need to manually delete the “AuthAnvilPasswordVault” database from your previous SQL instance. The new database, “AuthAnvilPasswordServer”, will have all the information for your upgraded installation.
Step 4 – Update AuthAnvil Password Sync Agents
AuthAnvil Password Server v1.7 includes several expanded functions, including a new web service URL path (domain.com/aaps/aaps.svc) as well as the ability for Sync Agents to communicate with the web service over https using SSL. Because of these new features, you will need to remove your Sync Agents and redeploy them with the latest versions.
- Log in to the AuthAnvil Password Server and go to the Sync Agents panel.
- Make note of which machines currently have Sync Agents installed, as well as their names, if you wish to reinstall with the same recognizable title. Delete the existing Sync Agent from your server by clicking on the name of the agent, and from the Actions menu select “Delete Agent”.
- Log in to the machine where the Sync Agent is installed. Open Control Panel and uninstall both the AuthAnvil Password Sync Agent and the AuthAnvil Password Sync Agent Control Form.
- Download the latest Sync Agent files from the Sync Agents page in the AuthAnvil Password Server.
- Install the Sync Agent following the instructions in the AAPS Install Guide, under “Deploying Sync Agents”. (NOTE: Make sure to configure the Linked Credential for the new Sync Agent, if necessary)
- Reconfigure any existing passwords that used the old Sync Agent and select the newly installed Sync Agent. You can find the Sync Agent under They will not automatically detect the new installation.
- Repeat these steps for all sync agents that need to be reinstalled.
Step 5 – Backup your new AuthAnvil Password Server configuration and settings
That’s it, you’re done the upgrade! All that is left is to back up your newly configured AuthAnvil Password Server system settings.
- Open a command window and navigate to the C:\Program Files\Scorpion Software\AuthAnvil Password Server\Tools\BackupTool directory.
- To run the backup, run the command aapsbackup.exe with the -b flag, followed by path to the AuthAnvil Password Server’s web.config file and SQL database.
i.e. aapsbackup.exe -b “C:\Program Files\Scorpion Software\AuthAnvil Password Server\AAPS\web.config” .AUTHANVIL
- Your psb file is created and saved in the same directory. If the backup is successful, the tool will display a success message. If you receive an error confirm the path to the web.config file, verify that the AuthAnvil Password Server database is accessible and run the backup again.
- Remember, your psb file is created and saved in the same directory. Make sure to move this file to a safe location so you have a backup available if needed.
Using a scheduled task, you can configure it to routinely backup the data and make it available to your normal server backup sets.
You will also want to remember to routinely purge the .psb files out of that directory. Over time this could fill up your hard drive, especially if you have a lot of audit log items being recorded.