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
• Copy the newarchibus.war file from your DVD or download to the production server to replace the older version of archibus.war. This file is typically in the \webapps, \webapps\archibus, \Users\Public\ARCHIBUS, or C:\Documents and Settings\All Users\ARCHIBUS\ folder.

Workgroup Upgrade Procedure

To upgrade a Workgroup deployment:

1. From the Web Central Process Navigator, select System Administration/ARCHIBUS System Administration/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

5. Specify Update Type: Workstation deployments have created their own data, their own drawings, their own My Favorites views using the View Definition Wizard, and their own dashboards using the Dashboard 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.
6. 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, or by using the Smart Client Projects dialog to edit the project list. Click Next.
7. Preserve Extensions: Workstation deployments can skip this tab by clicking Next.
8. 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. The following sections provide instructions for redeploying when running Jetty, Apache Tomcat, Oracle WebLogic, or IBM WebSphere.

Redeploying When Running Jetty

To redeploy when running Jetty:

1. Stop your application server.
2. Stop your database server.
3. Back up the database stored under \projects\hq\data before deleting the contents of the ARCHIBUS folder.
4. Delete all files beneath the \ARCHIBUS subfolders except for the WAR files and the projects folder.
5. Use WinZip to unzip the archibus.war file beneath the \ARCHIBUS folder.
6. Copy the database to \ARCHIBUS\projects\hq\data from the back-up location defined at Step 3;
7. Restart your database server and your application server.

Redeploying when Running Apache Tomcat

If you are running Tomcat Web server, redeploy using the following steps:

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.

Redeploying when Running IBM WebSphere

To redeploy when running WebSphere:

1. Stop the archibus application running on your application server;
2. Copy or move the generated archibus.war file from the \ARCHIBUS folder to another folder;
3. Uninstall the archibus application using the WebSphere Administrative console;
4. Install the new archibus application using the WebSphere Administrative console. For instructions, see Installing ARCHIBUS Web Central with IBM WebSphere.
5. Start the ARCHIBUS application.

Redeploying when Running WebLogic

To redeploy when running WebLogic:

1. Stop the ARCHIBUS application running on your application server.
2. Copy or move the generated archibus.war file from the \ARCHIBUS folder to another folder.
3. Create the ear file using the WebLogic management console. For instructions, see Installing ARCHIBUS Web Central with Oracle WebLogic.
4. Uninstall the ARCHIBUS application using the WebLogic management console.
5. Install the new ARCHIBUS application using the WebLogic management console. For instructions, see Installing ARCHIBUS Web Central with Oracle WebLogic.
6. Start the ARCHIBUS application.