Example Single-User Installation

Overview

As of Archibus V.25.1, you do not install Archibus through a full Setup program. This topic details the alternative way to install Archibus using the Microsoft SQL Server Express database server and the Tomcat application server. Both of these are available free of charge.

See Deployment Strategies for Archibus for information how to configure this standard single-user installation for other databases and workgroups.

This topic has these sections:

Note: The single-user installation described in this topic is also the first step for the small workgroup configuration. See Single-Server Deployment for a Small Workgroup: Smart Client-Only Installation.

Note: If you are installing from the Archibus DVD, you will not download Archibus files from AllBound, as directed below. Instead, you will find the files on the DVD.

Note: As an optional step, you can install the Archibus online help locally. This procedure is for sites that do not want to access the Archibus online help from the Archibus web site. See Installing the Archibus Help Locally.

Installation Procedure

Step 1: Uninstall previous Archibus software, if installed.

If you have previous copies of Archibus Web Central or of Web Central and the Smart Client, uninstall them.

Note: If you have the Archibus Windows Client/Server program, you do not need to uninstall it.

To uninstall the Smart Client:

To remove Web Central:

To remove the sample database, if Microsoft SQL Express

Step 2: Install Microsoft SQL Server Express

The install package is available online. Follow Microsoft's instructions.

Step 3: Attach the Microsoft SQL database.

For details, see Attach the Microsoft SQL Database.

Step 4: Install Tomcat and deploy the Archibus WAR file

Example for Windows 10:

  1. Ensure you have Java JRE or JDK installed, and the JRE_HOME or JAVA_HOME environment variable defined.
  2. Download the 64-bit Windows .zip file from https://tomcat.apache.org
  3. Expand contents of the zip file into a folder. .
  4. Download the archibus.war file from https://archibusserraview.allbound.com
  5. Copy archibus.war to the C:/apache-tomcat-<version>/webapps folder.
  6. Start Tomcat.
  7. Wait until Tomcat deploys the WAR file. This takes one to two minutes.
  8. Stop Tomcat.
  9. You will have received a license file from Archibus. Copy the ai-licenses.bin file to the C:/apache-tomcat-<version>/webapps/archibus/WEB-INF/config folder.

  10. Configure the project. Use a text editor to edit \webapps\archibus\WEB-INF\config\afm-projects.xml and make these changes:

    • Disable any active project databases by changing <active="true"> to <active="false">
    • Locate the following section of the file, which specifies MS SQL Express properties:

    <project> <preferences name="HQ-SQL Server Express" title="Headquarters-SQL Server Express"

    • In this section, activate this project by setting <active="true">.
    • Set your MSSQL Server IP address and port by editing <jdbc url="jdbc:sqlserver://127.0.0.1:1433;databaseName=HQ"/>. For example: <jdbc url="jdbc:sqlserver://<your IP address>:<your-port>;databaseName=HQ"/>
  11. Start Tomcat.
  12. Test that you can log in to Web Central on localhost. Sign in as a sample user. For information, see Sample Users.

Step 5: Install Smart Client

Download the Smart Client executable from https://archibusserraview.allbound.com, double-click, and follow the on-screen instructions.

Configure AutoCAD or Revit

If you have AutoCAD or Revit installed, you can configure the Archibus Extension for AutoCAD or the Archibus Extension for Revit.

Note: After installing AutoCAD, you must launch the application before setting it as the default CAD tool. If you do not first launch the application, it does not appear in the list of CAD applications to select as a preference. However, it is not necessary to launch Revit before selecting it as a preference.

To do so:

  1. In Smart Client, invoke the Preferences command.
  2. Click the CAD Application option; it lists all of the AutoCAD or Revit versions installed on your workstation.
  3. Set the CAD Application value to the program you wish to use.  The Smart Client will register the Smart Client Extension with that application.
  4. Start AutoCAD or Revit.

If you use multiple CAD applications (say both AutoCAD and Revit), set the preference before you use each application. You do not need to restart the Smart Client.

If you start AutoCAD or Revit very quickly after changing the CAD Application preference, the preference will not yet be written to the registry, and the Extensions will not load. If this happens, just restart AutoCAD or Revit to pick up the registry changes.

Note: To use the Extension for AutoCAD or Extension for Revit, a user must sign into an account that has its Use CAD/BIM License? property set to "Yes - Extensions". Web Central users can see whether they have this license from the My Profile command. Administrators can set which users have this license from the System / Archibus Administrator / Add or Edit Users task.

Note: If you uninstall and reinstall Archibus, on startup AutoCAD may show a dialog stating "An executable file was found outside of the specified trusted locations". If so, press the "Load" button on that dialog. You can resolve the situation by re-selecting your AutoCAD version as the "CAD Application" from the Archibus Smart Client Preferences command. Alternately, you can use the Files tab of AutoCAD PREFERENCES command, and add your Archibus location (e.g. "c:\Program Files (x86)\archibus\2x.x\SmartClient\acad\" ) to your list of Trusted Locations.

Installing License Files for Add-On Orders

Some orders are add-on orders in which you add additional seats of the product, but do not change versions or revisions of the software. For instance, if you had nine Application Connection Point licenses, but then add five additional seats in an add-on order; we will send you a new license file with all of the old licenses, plus the five new ones.

In this case, you do not need to reinstall the software. Copy the ai-licenses.bin file to your \archibus\WEB-INF\config folder and restart the application server.