How to Reset Admin Password for VP Server

In the event that the admin password for your existing VP Server is lost and cannot be retrieved, there is a way to reset it. This tutorial will show you how.

For VP Server older than version 5.3, please refer here.

Before you start, please note…

Shutdown the running VP Server. If you have installed the server as system service, you can then stop the service of your running server. For Microsoft Windows you can go to Control Panel > Administrator Tool > Service, then locate the VPServer service to stop it. Note that you may need administrator permission on your Windows in order to access to the Windows system service.

Stop VP Server system service

Alternatively if your server is just started with the startup script, then you can simply execute the shutdown script inside the scripts folder of VP Server to stop it.

Stop VP Server with shutdown script

Step 1 – Prepare Script

1. Go to scripts folder of VP Server.
2. Make a copy of the script file, suppose we use the migrate.bat as the source. Right click migrate.bat and select Copy.
   

   Copy the script file

   In the same folder, right click on white space and select Paste.

   

   Paste the script file

3. Press F2 on your keyboard while you are selecting the file, or right click the file copy and select Rename, then name it as password.bat.
   

   Rename the script file

4. Open password.bat (or however you named it above) in a text editor. Towards the end of the file, change the very last parameter value from migration.ExportVPServerMain to v.ResetAdmin and then save the file.
   

   Replace the main class to v.ResetAdmin

Step 2 – Run Script

1. Open command prompt, and change your directory to the VP Server’s script folder.
   Example:
   cd D:\VPServer\scripts
   

   Change to the scripts folder of VPServer directory

2. Execute the following command.
   password.bat < path >
   Example:
   password.bat “D:\VPServer\webserver\webapps\ROOT”
   (Note: There is no “\” after ROOT)
   

   Execute the command to run script

3. To confirm proceeding with the reset indeed, you will be given a math problem to solve.
   

   Prompted to confirm with a math question

4. Upon entering the correct calculation result, a new admin password will be generated for you.
   

   Enter the calculation result to confirm and be given a new password

Step 3 – Delete Script

To avoid accidental changes, delete the script file (e.g. password.bat) after use.

Step 4 – Login with the New Password

1. Start the VP Server again.
2. Open the browser and go to your VP Server.
   

   Access to VP Server with browser

3. Login to server as the administrator with login name “Admin” and the password we just reset in step2.
   

   Login to server as administrator

4. Once you logged in, you can change the password back to your preferred one by select Reset Admin. Password from the top right hand corner of the admin portal.
   

   After login with temp password, change your admin password