This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Versioning Web Applications

Owned by Former user (Deleted)
Last updated: Jul 17, 2016
2 min read

WSO2 App Manager facilitates creating multiple versions of an application with and without the app version mentioned in the URL. Once an app is published as the default version, that particular app version can be accessed without specifying the version in the URL.

For example, let's create an app with the following information:

ProviderLahiru
App Namemyapp1
App Contextmyapp1
Version1.0
Default Versiontrue

Two synapse configuration XML files are created in the wso2appm-home/repository/deployment/server/synapse-configs/default/api directory as versioned and non versioned APIs. In this example, lahriu--myapp1.xml and lahriu--myapp1_1.0.xml. The non versioned configuration retains the default version details so that if a request is received without a version, it is redirected to the versioned app.

Note the following:
  • The non versioned configuration is only created if the published app is the default version (along with the versioned config).
  • If a non default app version is published, only the versioned configuration is created.
  • If the default app version is unpublished/deleted, the non versioned configuration is deleted along with the versioned configuration.
  • If a non default app version is unpublished/deleted, the non versioned configuration remains as it is while the versioned configuration is removed.

App Publisher: Mark an app version as the default

You can mark an app version as the default in any of the following ways:

At any given point, there can only be one default version of a published app. 
By creating a new app from scratch
  1. Start the WSO2 App Manager and log in to the App Publisher.
  2. Click Web Applications > Create New Web Application.
  3. Enter the required information.
  4. Make sure you select the Make As Default Version check box. 
  5. Save your changes.
By creating a new version of an existing app

When the new app is published, all subscriptions to the original app version are copied over to the newly published version.

  1. Start the WSO2 App Manager and log in to the App Publisher.
  2. Open the app for which you want to make a new version.
  3. Click Create New Version.
  4. Enter the required information.
  5. Make sure you select the Make As Default Version check box. 
  6. Save your changes.
By editing an existing app
  1. Start the WSO2 App Manager and log in to the App Publisher.
  2. Click the app for which you want to make a new version.
  3. Click Edit and select the Make As Default Version check box.
  4. Save your changes.

App Store: Display multiple versions of an app


There are two deployment options available for an app:
  • Display all published versions 
  • Display only the default version

Open the app-manager.xml file located in the <APPM_HOME>/repository/conf directory. If you want to display all published versions of an app, set the DisplayMultipleVersions property to true. If you want to display only the default version of an app, leave the DisplayMultipleVersions property as false.