Documentation Center

Installing Synchronization components on Java Web site

You need to install tracking and synchronization JAR files and perform configuration files to deploy synchronization for Online Marketing Explorer on a Synchronization Server.

Before you begin

  • Content Delivery API Server Role installed in your Web application (for database access).
  • It is recommended to install Synchronization components in a separate Web application.

About this task

The installation instructions require a Java Web application with the following folder structure:
root/
    +--WEB-INF/
           +--classes/
           +--lib/
    +--syncComponent/
  • You need to install tracking JARs to the lib directory.
  • You need to add configuration files to the classes directory.
  • You need to add the webtrackingsync Web page to a directory, for example syncComponent/, in your Web application.

If your Presentation Server is running on the same machine as Content Delivery, you can put the configuration files in your TRIDION_HOME\config directory and put the Content Delivery JAR files, and third-party JAR files, in your TRIDION_HOME\lib directory.

Procedure

  1. Create a new Web site.
  2. Install the Content Delivery API Server Role—for more information, see the SDL Tridion suite documentation available on the documentation portal.
  3. On Oracle WebLogic Server only, remove the xalan.jar from the lib subdirectory (installed as part of your Content Delivery installation).
  4. Access the Online Marketing Explorer installation media.
  5. Navigate to the folder Content Delivery\roles\synchronization\java\lib and copy the following JAR file to the lib subdirectory:
    • tracking_core.jar
  6. Download the JDBC driver (JAR file) required for your specific database vendor and Java version, and copy it into the lib folder:
    Database vendorJDBC DriverFile to download when using Java 5File to download when using Java 6
    Microsoft SQL ServerMicrosoft SQL Server JDBC Driver 3.0sqljdbc.jarsqljdbc4.jar
    Oracle

    Oracle JDBC driver 11.2.0.2.0 or

    Oracle JDBC driver 11.2.0.1.0 (deprecated)

    ojdbc5.jarojdbc6.jar
  7. Navigate to the Content Delivery\resources\configuration\ directory and copy the following configuration files to the config subdirectory:
    • cd_storage_conf_sample.xml (and rename to cd_storage_conf.xml)
    • logback.xml
    • tracking_conf_sample.xml (and rename to tracking_conf.xml)
  8. Configure the Tracking database—see Configuring the Content Data Store for Tracking
  9. Configure logging—see Configuring logback.xml
  10. Configure synchronization—see Configuring tracking_conf.xml file
  11. Navigate to the folder Content Delivery\roles\synchronization\java and copy the webtrackingsync.jsp file to a directory in your Web application, for example syncComponent/.
  12. Restart your Web application server.
  13. Check that you synchronization Web site is correctly configured by entering:
    http://localhost:8080/webtrackingsync.jsp
    You should get following message: No known configuration errors were found