Running the Package and Deploy Wizard for Workgroup Deployments

If you have a single-user or workgroup deployment, all of your project and application files are on one computer. Workstation deployments also do not change the stock Archibus applications. For these deployments, you can use the wizard to upgrade your deployment in one step.

Prerequisites

• Back up your files: The wizard sequence creates a new archibus.war file. When you deploy this file, it will change the workstations configuration; therefore, it is important to back up the workstation files, including the following before running the wizard:
  • \archibus\schema
  • \archibus\projects
  • Project database data, such as Sybase .db files, SQL Server .MDF files, or Oracle .dmp backup files
• Download the new archibus.war file from Archibus.
• Copy the new archibus.war file to the production server to replace the older version of archibus.war. This file is typically in one of these folders:
  • \webapps
  • \webapps\archibus
  • \Users\Public\Archibus
  • C:\Documents and Settings\All Users\Archibus\

Workgroup Upgrade Procedure

To upgrade a Workgroup deployment:

1. From the Web Central Navigator, select System / System Administrator / Package and Deploy Wizard.
2. Verify Backup: Back up your data and, click Next.
3. Specify Deployment Type: Select the Single-user or Workgroup option and click Next.
4. Verify Archive: Select Yes-Next to indicate that you have updated your archibus.war distribution file to the one from the newer version of Archibus

   1. Specify Update Type: Workstation deployments have created their own data, their own drawings, their own My Favorites views using the View Definition Wizard. However, they typically do not modify the stock Archibus applications.

      1. Select "All Archibus" to preserve your data, drawings, and personalizations, while updating the Archibus programs.
      2. Click Next.
5. Preserve Data: The wizard lists the project locations it finds in your active projects in your projects list (config\afm-projects.xml). If this list is incorrect, stop the wizard and correct your projects list. You do so by editing the afm-projects.xml file directly. Click Next.
6. Preserve Extensions: Workstation deployments can skip this tab by clicking Next.
7. Package Deployment: Press the Package Deployment File action to create a new archibus.warfile.

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.