Configure for Enterprise Drawings in a Virtual Directory

You may want to store files in a virtual directory that is located either in the same server, or--more likely--in another server. You may wish to do this because:

  • IT policy precludes writing files dynamically to the application server.
  • You want to share a virtual directory between different application servers in a cluster.
  • You have space limitations on the application server drive.

You can store enterprise graphics in a virtual directory. The standard configuration has the Enterprise Graphics directory on the local server at archibus\projects\hq\enterprise-graphics . However, it is possible to have enterprise graphics in external directories,

If you decide to use a virtual directory, you must:

  • configure the Virtual Directory using any Web Server
  • instruct Web Central to point to the Virtual Directory to retrieve the drawings
  • set up security in both the application server hosting Web Central and the Web Server where the Virtual Directory is located.

The communication between the server hosting Web Central and the Web server where the Virtual Directory is located must be http protocol. Typically, sites secure the servers by configuring them to respond only to requests from internal servers that have specific IP addresses.

This topic includes the following sections for configuring the virtual directory for various configurations:

How to set up Tomcat to host Virtual Directory

In the Tomcat server hosting the graphics:

  1. Create a C:\drawings directory on your hard drive, and copy all the files from Archibus\projects\enterprise-graphics .
  2. Open the CATALINA_HOME location, which is where you have installed Tomcat.
  3. Locate and change this directory to conf\Catalina\localhost
  4. Inside \localhost create a file called drawings.xml.
  5. Inside the above xml file, put the following line:
    <Context docBase="C:/drawings"></Context>
  6. Restart the Tomcat server.
  7. Check that you can see a drawing from the virtual directory by opening a browser and giving this URL, which will display the 18th floor drawing: http://<server-name>:<port>/drawings/hq18.swf
  8. Add the file crossdomain.xml in the root directory: C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\ROOT . This file has the following content:

    <?xml version="1.0"?> <!DOCTYPE cross-domain-policy SYSTEM "http://www.adobe.com/xml/dtds/cross-domain-policy.dtd"> <cross-domain-policy> <site-control permitted-cross-domain-policies="master-only"/> <allow-access-from domain="*.<your domain>"/> <allow-access-from domain="localhost"/> </cross-domain-policy>

  1. Restart Tomcat

In the server hosting Archibus Web Central:

  1. Go to the machine where Web Central is deployed.
  2. In \ archibus\Web-inf\config and edit afm-projects.xml , replace the line:

    enterpriseGraphicsFolder="/#Attribute%//@webAppDirectory%/projects/hq/enterprise-graphics"

    with the line:

    enterpriseGraphicsFolder= "http://<server-name>:<port>/drawings "

How to setup IIS to host Virtual Directory

  1. Install IIS and configure Roles checking the following:
  • Application Development: CGI, ISAPI Extensions, ISAPI Filters
  • Security: Windows Authentication
  1. Download and configure WebApps specific connectors.
  2. In the case of Tomcat, download it from http://apache.org/dist/tomcat/tomcat...aries/windows/
  3. Unzip and unblock the DLL by right-mouse clicking on the DLL and clicking Unblock button in the Properties/General windows.
  4. Unzip jk-properties-file in the same folder.
  5. In isapi_redirect.properties , replace the default directory with current one.
  6. In workers.properties , replace the IP with Tomact server IP or fully qualified domain name -worker.ajp13.host=10.1.99.168.
  7. Open IIS Manager and double-click on ISAPI and CGI restrictions.
  8. Right mouse click – ADD:
  • In ISAPI or CGI path, enter <full-path>isapi_redirect.dll .
  • In Description, enter "Tomcat".
  • Check the box for "Allow extension path to execute."
  1. Double click ISAPI filters:
  • In Filter Name, enter "Tomcat".
  • In Executable, enter <full-path>isapi_redirect.dll
  1. (For SSO only). Click on Authentication. Enable windows Authentication, and disable Anonymous.
  2. Right mouse click on Default Web Site, and choose ADD Virtual Directory. In the physical path enter the full path where you unzip the connector. Enter an alias.
  3. Double-click on handler Mappings. Actions/Edit Feature Permissions: Check Read, Script and Execute.
  4. Restart IIS
  5. Create a SWF folder under IIS and place all the graphics files
  6. Make sure the file extensions that are opened on client side are added to IIS. Double click on MIME Types and add the files below.
  • .emf => MIME type - application/emf
  • .zlib => application/x-deflate
  1. Open afm-projects.xml and edit the line: enterpriseGraphicsFolder=http://<ISS server>/swf
  2. (For SSO only). On the Tomcat server, in server.xml , add the following:
  • <!-- Define an AJP 1.3 Connector on port 8009 -->
  • <Connector port="8009" protocol="AJP/1.3" redirectPort="8443 tomcatAuthentication="false" />