Upgrading Workgroup Deployments Using the Deployment Packager Actions

A workgroup deployment runs the database server and the application server on the same workstation. See Small Workgroup Deployment.

For other deployments, see Running the Deployment Packager Actions for Enterprise Deployments.

Flowchart of the Workgroup Upgrade Process

The following flow chart shows the process for deploying a new version of Web Central, including updated core and updated applications, without losing any extensions (new or altered views and workflow rules), or the production user data (users’ My Favorites, and graphic files).

Note that the following workflow diagram shows obtaining the stock archibs.war file from a DVD. Typically, you now obtain this by downloading it from AllBound (https://archibusserraview.allbound.com); a DVD is supplied only upon request.

Procedure

Note: The following procedure is for advanced users who prefer to directly run the deployment packager actions rather than using the Package and Deploy Wizard. Using the wizard is the simplest way to upgrade. See Using the Package and Deploy Wizard.

To upgrade a workstation deployment to a new version of Archibus Web Central, do the following on your application server:

  1. Back up the server: Run your usual backups on your application server and database data to guard against any errors in creating the packager preferences or in compressing the Web Archive (WAR) files.
  2. Edit the application-update.properties file: Edit this file to reflect the location of your extensions and project data. See Editing Your Application Update Properties.
  3. Package Extensions: Select the System / System Administrator / Package Extensionsaction. Click the Start Job action to run the Package Extensions action. This action creates the mysite-extensions.war file.
  4. Package Data: Select the System / System Administrator / Package Data action. Click the Start Job action to run the Package Data action. Use the Package Data action to back up your database and data files to the mysite-data.war file.
  5. Copy the new stock Archibus deployment:
    • Copy the stock archibus.war file (downloaded from Archibus) to one of the following locations. The folder location depends on your application server and operating system.
    • Copy the license file: If you have been issued a new license file (afm-licenses.xml), copy it to your \archibus\config subfolder to ensure that it is part of your new deployment file.
  6. Package Deployment: Select the System / System Administrator / Package Deployment task. Click the Start Job action to run the Package Deployment action. This action merges the mysite-data.war and the mysite-extensions.war into the stock archibus.war file. This creates an updated archibus.war file that contains all the files needed to re-establish your application server.

You can now redeploy Archibus using the updated archibus.war file.

Redeploying when Running Apache Tomcat

To redeploy when running Apache Tomcat:

  1. Stop your application server.
  2. Delete all files beneath the \Archibus subfolders, except for the .war files.
  3. Move the .war file that was created to \\tools\\tomcat\webapps.
  4. Restart Tomcat.

See Also

Upgrading Only the Web Central Core