This article provides step-by-step instructions for GIS administrators to upgrade existing VertiGIS Studio on-premises installations. We'll cover upgrading VertiGIS Studio Web, VertiGIS Studio Workflow, VertiGIS Studio Reporting, and VertiGIS Studio Printing, including backing up your applications, upgrading the software, and updating your applications to work with the new versions.

Note: You do not need to reapply your license when performing an in-place upgrade.

Prerequisites

Before beginning the upgrade process:

• Ensure you have administrative access to both the server and ArcGIS Enterprise portal.
• If this is a production app, schedule the upgrade during a maintenance window to minimize disruption and notify users about the scheduled downtime.
• Check for any version compatibility requirements between different VertiGIS Studio products

Back Up Your Existing Studio Content

IMPORTANT: Always create backups before performing an upgrade. This ensures you can restore your applications if issues occur during or after the upgrade process.

To back up content, use the appropriate Designer application and its Export functionality to download a local copy.

• Open the application, workflow, report, or print layout
  • For Web, Navigate to File > Download App
  • For Workflow, Reporting, and Printing, Navigate to File > Export
• Save the exported files to a safe location outside the server

Your organization may have additional processes or requirements for backups, such as server snapshots. 

Upgrading VertiGIS Studio Web

Download the Installer

1. On the server where VertiGIS Studio Web Designer is installed, download the latest installer from the VertiGIS Support Center.
2. Note the version number you're upgrading to (for verification later).
3. Review the release announcement in case there are any breaking changes or critical actions to take.

Run the Installer

1. Log in to your server with administrative privileges
2. Run the downloaded installer as administrator
3. The installer will detect your existing installation and prompt you to upgrade
4. Follow the on-screen instructions to complete the upgrade process
5. When prompted, allow the installer to upgrade any required dependencies
6. Take note of any warnings or messages displayed during installation

Verify the Upgrade

1. After the installation completes, launch VertiGIS Studio Web Designer
2. Navigate to File > Help
3. Confirm that the version displayed matches the version you intended to upgrade to
4. Check the browser console logs for any error messages

You're now ready to upgrade your Web applications.

Upgrading Your Applications

After successfully upgrading your VertiGIS Studio Web Designer, upgrade your individual applications:

Open and Upgrade a Development Application

1. In VertiGIS Studio Web Designer, open one of your existing development applications
2. You should see a notification message stating "This app has been automatically upgraded"
   • This indicates that the application structure has been updated to be compatible with the new version
3. If you don't see this message, check the browser console for errors.

Save and Test the Upgraded Application

1. Save the application and test it thoroughly:
   • Test within the Designer preview
   • Launch the development version in a new browser tab or window
   • Test all critical workflows and features
   • Verify map services and data connections still function

Deploy to Other Environments

For applications with multiple deployment stages (test, staging, production):

1. Use Deployment Stages to push the new version through your environments
2. Click the Deploy button to promote the application to the next stage
3. After each deployment, verify the application works correctly in the new environment before proceeding to the next stage

Upgrading VertiGIS Studio Workflow

If you are also using VertiGIS Studio Workflow alongside VertiGIS Studio Web, you will need to update that component separately. For detailed instructions, see the Manage an On-Premises Installation documentation.

Update On-Premises Workflow

VertiGIS periodically releases updates to on-premises Workflow that include new features and other improvements to the software. To update Workflow, run the new installer.

To update an on-premises installation of VertiGIS Studio Workflow:

1. Download the installer from the VertiGIS Support Center.
2. Run the installer.
   The installer detects your existing installation and prompts you to update.
3. Click Update.
4. When the update completes, click Finish.
   The Post-Installation Configuration launches.
5. Click through the Post Installer to upgrade any dependencies.
   You should click through the Post Installer even if there are no changes to be made.

Upgrading VertiGIS Studio Reporting

If you are also using VertiGIS Studio Reporting alongside VertiGIS Studio Web and Workflow, you will need to update that component separately. For detailed instructions, see the Manage an On-Premises Installation documentation.

Update On-Premises Reporting

VertiGIS Studio periodically releases updates to on-premises Reporting that include new features and other improvements to the software. To update Reporting, run the new installer.

To update an on-premises installation of VertiGIS Studio Reporting:

1. Download the installer from the VertiGIS Support Center.
2. Run the installer.
   The installer detects your existing installation and prompts you to update.
3. Click Update.
4. When the update completes, clear the Launch VertiGIS Studio Reporting Post Installer checkbox.
   Updating does not affect the existing configuration. You do not need to run the Post Installer after updating, unless you want to change the configuration.
5. Click Finish.
   You have completed updating your on-premises installation.

Upgrading VertiGIS Studio Printing

If you are also using VertiGIS Studio Printing in your deployment, you will need to update that component separately. For detailed instructions, see the Manage an On-Premises Installation documentation.

Update On-Premises Printing

VertiGIS Studio periodically releases updates to on-premises Printing that include new features and other improvements to the software. To update Printing, run the new installer.

To update an on-premises installation of VertiGIS Studio Printing:

1. Download the installer(s) from the VertiGIS Support Center.
2. Run the installer.
   The installer detects your existing installation and prompts you to update.
   1. If upgrading the Print Engine, refer to How can I update the VSP Engine Tools if I already have an older version installed?
3. Click Update.
4. When the update completes, clear the Launch VertiGIS Studio Printing Post Installer checkbox.
   Updating does not affect the existing configuration. You do not need to run the Post Installer after updating, unless you want to change the configuration.
5. Click Finish.
   You have completed updating your on-premises installation.