Recover Shared Storage Password

Last Updated: January 07, 2026

The Shared Storage password for your Virtual Appliance is only accessible during the web portion of the Host upgrade. This topic provides steps to recover a lost Shared Storage password, which are the same steps to upgrade the Host version. However, you can stay with your current Host build version if you do not wish to upgrade to a newer version.

Requirements

  • Virtual Appliance Host and Application files are no longer available on the Admin Guide site. To obtain these files please create a support ticket with our team and include:
    • Latest Host / Application Files Request in the subject field.
    • Your current Host and Application versions (Support & Training then About PrinterLogic) in the description.
    • Hypervisor file type (OVA, VMDK, VHD, QCOW2) in the description.
  • Review the Minimum System Requirements for environmental specifics and version compatibility before upgrading your Host version.
  • Note the network information of the existing Virtual Appliance. Upgrades require the information re-entered as network settings do not carry over during an upgrade.

Backup the Virtual Appliance

Before upgrading the Virtual Appliance, it is crucial to back up the database. Failure to do so can result in irreversible data loss. For more information on comprehensive backup guidelines, reference Database Backup Recommendations.

Host Build 1.0.757 and Earlier

For customers on Host build 1.0.757 and earlier and using the Virtual Appliance internal MySQL server, you are required to run the following query on the server before upgrading.

Copy Code 
SET PERSIST innodb_fast_shutdown=0;

 

Access the Virtual Appliance Database to Run Query

Here is a quick overview of the instructions on how to access the Virtual Appliance. You can find more detailed instructions in the PrinterLogic Knowledge Base.

  1. Download and install a MySQL editor of your choice (e.g. MySQL, MySQL Workbench, HeidiSQL, PHPMyAdmin).
  2. Run the MySQL Editor.
  3. Set the host to the IP address of your Virtual Appliance.
  4. Set the user / username to admin.

  5. Set the password to the password that was designated during the Virtual Appliance configuration.

    Find the database password in the secrets.env file on the share drive. It is listed as the DB_PASSWORD parameter.

Password Recovery

1. Create New Virtual Appliance

  1. Create a support ticket with our team to acquire the Host files. See the Requirements section above for ticket details.
  2. Download the latest host upgrade file for your hypervisor.
  3. Gracefully shut down the Virtual Appliance Guest operating system (OS).
  4. Run a backup of the virtual machine.

  5. In the hypervisor console, make a clone of the persistent storage disk containing your Virtual Appliance data.

    This is generally the second disk created when spinning up the Virtual Appliance.

    1. DO NOT delete the disk from storage.
    2. Note the name so you can attach the clone to the new host.
    3. Alternatively, you may detach the disk from the virtual machine (if it does not contain snapshots) and attach it to the new virtual machine, but we don't recommend this method.
  6. Using the file downloaded in Step 1, create a new Virtual Appliance but do not boot it up. For minimum system requirements and steps on creating a new Virtual Appliance, see the Virtual Appliance Installation and the related hypervisor subtopics.
  7. Attach the cloned disk to the new Virtual Appliance.
    1. If you detached the persistent storage disk rather than cloning it, attach it to the new Virtual Appliance.
  8. Start the Virtual Appliance Guest OS.

2. Configure Network Settings

Once the virtual machine spins up, use the web console to configure the network settings.

For environments using a fully qualified domain name (FQDN) when accessing the Virtual Appliance. Configure the FQDN in your Domain Name System (DNS) and assign it the IP Address shown in the web console. The licensed URL in the license file provided by Vasion must match the chosen FQDN.

The Virtual Appliance starts as a Dynamic Host Configuration Protocol (DHCP) client. You can leave the DHCP default and configure TCP / IP settings via DHCP Reservations. Alternatively, use the steps below to configure a static IP Address and adjust the private IP Address Range the Virtual Appliance uses for internal services to avoid conflict with existing subnets.

  1. In the hypervisor, open the web console to access the Virtual Appliance Linux terminal interface.

  2. Log in to the terminal using the network credentials supplied in the terminal banner.

    VA web console showing basic settings with the network settings credentials highlighted.

  3. Enter "Y" to change the network settings.
  4. Enter "Y" to change the network mode.

  5. Enter the TCP / IP settings.

    The image below is just an example. Ensure you use the settings specific to your network.

    VA web console, after logging in with network settings credentials, with the adjustable network settings all displayed and highlighted.

  6. If the existing address pool does not conflict with any subnets in the environment, enter “N”. Otherwise, enter “Y” to set a different address range.

    VA web console, Would you like to change the unassigned address pool for your network setting highlighted.

  7. Configure the address range. If you need to adjust IP addresses, be sure to read and understand the network range options you are presented with. Any range used must have a netmask < 20.

    VA web console, with the network range IP requirements highlighted.

  8. Press any key to exit.
  9. Copy the IP address located at the top of the terminal interface in the To continue with this configuration please visit field.

3. Launch the Virtual Appliance Wizard

  1. In your preferred, supported browser, paste or enter the Virtual Appliance IP Address including port 8080. Example: 192.168.10.20:8080

  2. Once the setup wizard displays, select Let's Do This.

    VA configuration wizard with the orange Lets do this button in the lower middle.

  3. Select the Storage Type dropdown and select VM-Attached Virtual Disk.

    Orange Continue button highlighted in the upper right of the VA wizard Configure Storage window.

    If you are presented with options to Format Attached Storage do not select the button. Formatting is for new disks, and seeing this option during an upgrade means something is incorrect and the disk settings and order should be reviewed.

  4. Select Continue.

  5. On the Updated Host Detected window, select the Change Settings option.

    Virtual Appliance wizard showing the options to continue with previous settings or to change settings.

  6. On the General Settings tab, review the information and update the Shared Storage Password. Document and save this password. It is only available to view or edit during this step.

    Passwords can contain any alphanumeric character (a-z, A-Z, 0-9), the following special characters (%^()_-+={}[]<>,.;), and up to 128 characters.

  7. Review any other needed settings and Continue through the wizard. If you are only changing the shared storage password, no other values need changing.
  8. Select Finish Setup.

  9. Allow time for the Virtual Appliance wizard to finish.

    Please do not refresh the page during the installation procedure.

  10. Once the setup is complete you can log into your Virtual Appliance.