Upgrade apps

To upgrade apps created in a previous version of Web AppBuilder for ArcGIS (Developer Edition) to a newer version, use the command utility.

  1. Stop all running instances of Web AppBuilder (Developer Edition) if any.
  2. Open the Command Prompt window.
  3. Browse to the \server directory of your newer version of the Web AppBuilder installation.
  4. You have the option to upgrade an individual app or all of your apps.
    • To upgrade an individual app, type
      • node_x64 upgrade < your_previous_version_Web_AppBuilder_installation_directory > <app_ id> for 64-bit Operating System, and press Enter.
      • node_x86 upgrade < your_previous_version_Web_AppBuilder_installation_directory > <app_ id> for 32-bit Operating System, and press Enter.
    • To upgrade all of your apps, type
      • node_x64 upgrade < your_previous_version_Web_AppBuilder_installation_directory > for 64-bit Operating System, and press Enter.
      • node_x32 upgrade < your_previous_version_Web_AppBuilder_installation_directory > for 32-bit Operating System, and press Enter.

    Your previous version of the Web AppBuilder installation directory is similar to C:\arcgis-web-appbuilder-1.0. The app ID is 2 for the app at http://[your host name:port number]/webappbuilder/apps/2/.

  5. Once the upgrade is complete, start the new version of Web AppBuilder to check the result. You should see all your upgraded apps.

    If the upgrade failed, see the upgrade.log file in the \server\logs directory of the Web AppBuilder installation.

Running the command multiple times will upgrade and import apps multiple times into the new version of Web AppBuilder. This is by design.

If you have custom widgets and themes in the app that were created in the previous version of Web AppBuilder, the command utility will import them into the new version as well. Your custom widgets and themes are upgraded automatically.