Documentation Center

Installing the Cache Channel Service as a standalone Java process

Create a shell script to install the Cache Channel Service, which synchronizes caches, as a Java process. (On Windows, you can also install the service as a Windows service.) If you use RMI to synchronize caches, the Cache Channel Service must be running and listening on the configured host and port for remote synchronization to function.

Procedure

  1. Open a command prompt.
  2. Create a directory on your machine for the Cache Channel Service.
  3. Create subdirectories lib/ and config/ in this directory.
  4. Access the SDL Tridion installation media.
  5. Access the caching\java\ subfolder.
  6. Access the lib\ subfolder and copy all the JAR files into the lib/ directory.
  7. Access the third-party-lib\ subfolder and copy all the JAR files into the lib/ directory.
  8. Navigate to \Content Delivery\resources\configurations\.
  9. Copy logback.xml from that folder to the config/ directory.
  10. In the directory you created, create a shell script file that places the config/ subdirectory, as well as all the JAR files, in the classpath and then runs the Java Cache Channel Service class:
    Linux/UNIX operating systems:
    #!/bin/sh
    TRIDION_CLASSPATH=./config
    for i in ./lib/*.jar ; do
    	TRIDION_CLASSPATH=${TRIDION_CLASSPATH}:$i
    done
    java -cp $TRIDION_CLASSPATH com.tridion.cache.CacheChannelService
    Windows operating system:
    java -cp "./config;./lib/*" com.tridion.cache.CacheChannelService

    If you do not specify any command line parameter, the host is assumed to be localhost and the port 1099. To change the port number, add localhost:3030 to the last line, where 3030 is your custom port. To use an existing RMI infrastructure located on a different machine, add the host name to the last line.

    For example, to use an RMI infrastructure located on a host called neptune, port 3030, on a non-Windows operating system, change the last line of your UNIX script to:

    java -cp $TRIDION_CLASSPATH com.tridion.cache.CacheChannelService neptune:3030
  11. Run the shell script to run the Cache Channel Service.