This section applies only to first-time installation. If you are upgrading, see the Upgrading chapter instead.


dmBridge is a client-server system. The client is (or can be) the template engine, which drives one or more of your custom template sets. The server is the dmBridge core (HTTP API) component, which drives the template engine and the PHP API. The client can run on any server, including the CONTENTdm® server, but the server must run on the CONTENTdm® server. It's your decision on which server you want to the template engine to reside, but to keep the instructions simple, we'll put everything on the CONTENTdm® server for now. Moving it later will be as simple as moving the files and setting the new URL in the Control Panel. Extracting a downloaded dmBridge distribution will result in a single folder called something like dmbridge-x.x.x. Within it there are four folders:

The dmBridge core
Configuration data required by dmBridge (and possibly social data as well)
The template engine
The Control Panel (essentially a graphical front-end to dmBridge's main configuration file, data/config/config.xml)

Each folder is a separate component that requires a few simple installation steps, documented in the following subsections. But before we proceed, we want to move our downloaded files onto the web server:

  1. Rename the dmbridge-x.x.x folder to dm
  2. Move the dm folder into your CONTENTdm® web server's document root. (This is the same place where your current cdm4 and dmscripts folders reside.

Next, we are ready to set up our individual components.