Automated Versioning Manager (AVM)

Overview

The Automated Versioning Manager is a tool that helps manage Appian applications and database DDL files in a version control system. Given an Appian application ZIP file, the Automated Versioning Manager performs the following actions:

  • Unzips the application and organizes the artifact XML files in the repository.
  • Automates the check-in and check-out operations with the version control system.
  • Generates application packages for import in Appian based on the contents of the repository and a range of changes to include.

This tool is frequently used with the native, external deployment APIs (https://docs.appian.com/suite/help/22.1/Deployment_Rest_API.html) or the Automated Import Manager (AIM) (https://community.appian.com/w/the-appian-playbook/198/deployment-automation). Unless you are doing deployments for the Admin Console, we suggest using the native APIs.

Key Features & Functionality

  • Version Control integration (Git, SVN)
  • Supports Appian applications and packages
  • Generate import package from hash ranges
  • Folder Listener to add contents to Version Control
  • Supports GitHub, GitLab, and BitBucket for Version Control

You can access the source code for AVM by exploding the ZIP file after download.

Note: This utility does not support Java version 9.0. 

Anonymous
Parents
  • Hi,

    When trying to install this for Appian on Appian Government Cloud (version 24.3.900.0) using the "Use this utility for Appian Versions below 25.1.zip" in the extracted zip, we encounter this error message.

    2025-04-22 19:28:05,740 [Appian Plugin Hot Deploy] ERROR com.atlassian.plugin.loaders.ScanningPluginLoader - Unable to deploy plugin 'null' from 'Unit: /usr/local/appian/_admin/plugins/Automated Versioning Manager (AVM) 2.5.33.zip (1745349997000)'. 2025-04-22 19:28:05,740 [Appian Plugin Hot Deploy] ERROR com.atlassian.plugin.loaders.ScanningPluginLoader - Because of the following exception: com.appiancorp.plugins.component.ComponentPluginParseException: COMPONENT_PLUGIN_ERROR_TOKENCould not parse zip file - make sure it is formatted properly at com.appiancorp.plugins.component.ComponentPluginXmlResolver.isDeprecatedDefinitionXml(ComponentPluginXmlResolver.java:53) at com.appiancorp.plugins.component.ComponentPluginXmlResolver.getPluginXml(ComponentPluginXmlResolver.java:33) at com.appiancorp.plugins.component.ComponentPluginFactory.canCreate(ComponentPluginFactory.java:85) at com.appiancorp.plugins.osgi.LoggingPluginFactoryDecorator.canCreate(LoggingPluginFactoryDecorator.java:28) at com.atlassian.plugin.loaders.ScanningPluginLoader.deployPluginFromUnit(ScanningPluginLoader.java:142) at com.atlassian.plugin.loaders.ScanningPluginLoader.loadFoundPlugins(ScanningPluginLoader.java:113) at com.appiancorp.plugins.loaders.UnloadingDirectoryPluginLoader.loadFoundPlugins(UnloadingDirectoryPluginLoader.java:55) at com.appiancorp.plugins.loaders.PluginVersion2DefaultLoader.loadFoundPlugins(PluginVersion2DefaultLoader.java:47) at com.atlassian.plugin.loaders.PermissionCheckingPluginLoader.loadFoundPlugins(PermissionCheckingPluginLoader.java:31) at com.atlassian.plugin.manager.DefaultPluginManager.lambda$scanForNewPlugins$14(DefaultPluginManager.java:881) at com.atlassian.plugin.manager.PluginTransactionContext.wrap(PluginTransactionContext.java:63) at com.atlassian.plugin.manager.DefaultPluginManager.scanForNewPlugins(DefaultPluginManager.java:877) at com.appiancorp.plugins.AppianPluginManager.scanForNewPlugins0(AppianPluginManager.java:193) at com.appiancorp.plugins.AppianPluginManager.scanForNewPlugins(AppianPluginManager.java:185) at com.appiancorp.plugins.HotDeployerRunnable.run(HotDeployerRunnable.java:28) at java.base/java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:539) at java.base/java.util.concurrent.FutureTask.runAndReset(FutureTask.java:305) at java.base/java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:305) at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1136) at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:635) at java.base/java.lang.Thread.run(Thread.java:840) 2025-04-22 19:28:05,741 [Appian Plugin Hot Deploy] ERROR com.appiancorp.plugins.LoggingPluginEventListener - Failed to load Component Plug-in 'Automated Versioning Manager (AVM) 2.5.33.zip': Could not parse zip file - make sure it is formatted properly

Comment
  • Hi,

    When trying to install this for Appian on Appian Government Cloud (version 24.3.900.0) using the "Use this utility for Appian Versions below 25.1.zip" in the extracted zip, we encounter this error message.

    2025-04-22 19:28:05,740 [Appian Plugin Hot Deploy] ERROR com.atlassian.plugin.loaders.ScanningPluginLoader - Unable to deploy plugin 'null' from 'Unit: /usr/local/appian/_admin/plugins/Automated Versioning Manager (AVM) 2.5.33.zip (1745349997000)'. 2025-04-22 19:28:05,740 [Appian Plugin Hot Deploy] ERROR com.atlassian.plugin.loaders.ScanningPluginLoader - Because of the following exception: com.appiancorp.plugins.component.ComponentPluginParseException: COMPONENT_PLUGIN_ERROR_TOKENCould not parse zip file - make sure it is formatted properly at com.appiancorp.plugins.component.ComponentPluginXmlResolver.isDeprecatedDefinitionXml(ComponentPluginXmlResolver.java:53) at com.appiancorp.plugins.component.ComponentPluginXmlResolver.getPluginXml(ComponentPluginXmlResolver.java:33) at com.appiancorp.plugins.component.ComponentPluginFactory.canCreate(ComponentPluginFactory.java:85) at com.appiancorp.plugins.osgi.LoggingPluginFactoryDecorator.canCreate(LoggingPluginFactoryDecorator.java:28) at com.atlassian.plugin.loaders.ScanningPluginLoader.deployPluginFromUnit(ScanningPluginLoader.java:142) at com.atlassian.plugin.loaders.ScanningPluginLoader.loadFoundPlugins(ScanningPluginLoader.java:113) at com.appiancorp.plugins.loaders.UnloadingDirectoryPluginLoader.loadFoundPlugins(UnloadingDirectoryPluginLoader.java:55) at com.appiancorp.plugins.loaders.PluginVersion2DefaultLoader.loadFoundPlugins(PluginVersion2DefaultLoader.java:47) at com.atlassian.plugin.loaders.PermissionCheckingPluginLoader.loadFoundPlugins(PermissionCheckingPluginLoader.java:31) at com.atlassian.plugin.manager.DefaultPluginManager.lambda$scanForNewPlugins$14(DefaultPluginManager.java:881) at com.atlassian.plugin.manager.PluginTransactionContext.wrap(PluginTransactionContext.java:63) at com.atlassian.plugin.manager.DefaultPluginManager.scanForNewPlugins(DefaultPluginManager.java:877) at com.appiancorp.plugins.AppianPluginManager.scanForNewPlugins0(AppianPluginManager.java:193) at com.appiancorp.plugins.AppianPluginManager.scanForNewPlugins(AppianPluginManager.java:185) at com.appiancorp.plugins.HotDeployerRunnable.run(HotDeployerRunnable.java:28) at java.base/java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:539) at java.base/java.util.concurrent.FutureTask.runAndReset(FutureTask.java:305) at java.base/java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:305) at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1136) at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:635) at java.base/java.lang.Thread.run(Thread.java:840) 2025-04-22 19:28:05,741 [Appian Plugin Hot Deploy] ERROR com.appiancorp.plugins.LoggingPluginEventListener - Failed to load Component Plug-in 'Automated Versioning Manager (AVM) 2.5.33.zip': Could not parse zip file - make sure it is formatted properly

Children
No Data