The Update feature in VertiGIS Solution Manager allows you to upgrade deployed applications - such as Networks Editor, Networks Explorer, etc. - to newer versions while preserving your customizations.
The update process intelligently detects and handles conflicts between your changes and the new version's changes.
What Gets Updated
When you update an application:
•Application version is upgraded to the new release
•Your customizations are preserved where possible (e.g., brand colors, services, configurations)
•Conflicts are detected and resolved automatically based on predefined rules
•Original item IDs are maintained on the ArcGIS Portal
Prerequisites
•Access to VertiGIS Solution Manager
•A previously deployed application that you want to update
•The update package file
•Appropriate permissions on the ArcGIS Portal
Steps to Update a Package with Solution Manager
In this example, we update a package from Networks Editor v1.14.3 to Networks Editor v1.15.0.
Step 1: Initiate the Update
1.Open VertiGIS Solution Manager
2.Navigate to the Deployments Dashboard
3.Locate the application you want to update
4.Click on the application's context menu (three dots)
5.Select Update from the menu
Step 2: Upload Update Package
1.Click Load to browse for the update package
2.Select the package file for your target version (e.g., Network Editor 1.15.0)
3.The system will validate the package
Download latest packages from VertiGIS Support Portal
Step 3: Configure Data Sources
1.Review the Data Sources section
2.The system will show the default data source you selected during initial deployment
3.Confirm or modify the data source selection
4.Click Next
Step 4: Verify Web Map
1.The system displays the Web Map associated with your application
2.The update will use the same web map from your original deployment
3.Click Next
Step 5: Update Parameters
1.In the Parameters section, click Show Details
2.Review and update parameters as needed:
a.Bundle name
b.Other configuration parameters
3.Click Next
Step 6: Validation
1.The system performs validation checks
2.If errors are detected:
oReview the error messages
oCorrect any issues
oRetry validation
3.If validation passes, click Next to proceed
Step 7: Review Detected Changes
The Changes section provides a comprehensive summary of all detected changes and conflicts.
The system detects two types of changes:
•Author Wins Conflicts Tab
oConflicts resolved in favor of the update package (author)
oYour changes will be overwritten
oTypically affects application configurations
oDoes NOT typically affect brand colors, services, and similar customizations
•You Win Conflicts Tab
oConflicts resolved in your favor
oChanges from the author will be ignored
oYour customizations are preserved
Expand/Collapse Conflict Details
•Click Expand All to view detailed information about each conflict
•Click Collapse All to return to the summary view
Download Conflict Report
•Click Download Complete Conflict List to export a text file
•The file contains all conflict information from both tabs
•Useful for documentation and review purposes
Step 8: Apply the Update
1.Click Next to proceed with the update
2.The system will apply the updates to your deployment
3.You'll receive a notification: "Values Store was successfully updated"
Step 9: Verify Update Success
1.The final window displays: "Update of selected package was successful"
2.Review the list of packages that were updated
3.Click on any package to view the changes in detail
4.Click Finish to return to the Deployment Dashboard
5.Verify that the application version has been updated (e.g., from v1.14 to v1.15)
Known Limitations
•Full conflict resolution is currently only available for VertiGIS Studio Web Apps
•Other item types are updated directly without preserving customizations
•No automatic backup mechanism (manual backup required)
•Command and operation references in App JSON are not validated
Contact Support
If you encounter issues during the update process:
1.Download and review the complete conflict list
2.Check the validation error messages
3.Contact VertiGIS support with:
oPackage versions (current and target)
oConflict report
oError messages
oSteps to reproduce the issue
