Installing CQ On App Server

Installing CQ

Installing CQ on Application Server

CQ version 5.6 supports following application servers

We will cover how to install CQ on Tomcat 7 (As it is open source)

1) Get CQ war file from Adobe

2) Install tomcat 7 on your machine

3) Copy the CQ .war file (cq-quickstart-5.5.0-20120220.war) to <Tomcat Install folder>\webapps\

4) Remove the folder \ROOT from <Tomcat Install folder>\webapps\

5) Rename cq-quickstart-5.5.0-20120220.war to ROOT.war

6) Using a zip utility such as WinZIP or WinRAR, extract the file web.xml in ROOT.war (ROOT.war\WEB-INF\web.xml) onto the filesystem and edit it.

7) Create a folder “crx” on your server.

8) Change “init-param” from the default “sling.home” to the location of the crx folder you created in the previous step. <Tomcat Install Folder>\crx\

9) If this will be a CQ “Publish” instance, change the value for “sling.run.modes” to “publish” from the default “author”.

10) Save the file web.xml and insert it back into ROOT.war

11) Make a copy of catalina.bat in C:\Programs\Apache\apache-tomcat-7.0.27\bin and name it setenv.bat

12) Clear it and then add the following lines to it

@echo off

rem —————————-

rem Default JVM options

rem —————————-

set JAVA_OPTS=%JAVA_OPTS% -server

set JAVA_OPTS=%JAVA_OPTS% -Djava.awt.headless=true

set JAVA_OPTS=%JAVA_OPTS% -XX:NewRatio=1

set CQ_JVM_OPTS=%CQ_JVM_OPTS% -XX:+UseAdaptiveGCBoundary

set JAVA_OPTS=%JAVA_OPTS% -XX:+UseParallelGC

set JAVA_OPTS=%JAVA_OPTS% -XX:+UseParallelOldGC

set JAVA_OPTS=%JAVA_OPTS% -XX:ParallelGCThreads=4

set JAVA_OPTS=%JAVA_OPTS% -Xms4096m

set JAVA_OPTS=%JAVA_OPTS% -Xmx4096m

set JAVA_OPTS=%JAVA_OPTS% -XX:PermSize=128m

set JAVA_OPTS=%JAVA_OPTS% -XX:MaxPermSize=128m

rem —————

rem CQ options

rem —————

set CQ_JVM_OPTS=%CQ_JVM_OPTS% -Dcrx.memoryMaxUsage=80

set JAVA_OPTS=%JAVA_OPTS% -Dorg.apache.jackrabbit.core.state.validatehierarchy=true

set JAVA_OPTS=%JAVA_OPTS% -Dcom.day.crx.persistence.tar.IndexMergeDelay=0

rem Uncomment line below for debugging

rem JAVA_OPTS=%JAVA_OPTS% -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=30303

rem —————————

rem JConsole Profiling

rem —————————

set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.port=50055

set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.authenticate=false

set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.ssl=false

13) Start Tomcat by running startup.bat from a command prompt. startup.bat will invoke catalina.bat which in turn will invoke setenv.bat You should see an INFOrmational message such as below:

INFO: Deploying web application archive <Tomcat Install Folder>\webapps\ROOT.war

14) Watch the folder <Tomcat Install Folder>\crx\ Folders such as follows will be created in the following order:

- launchpad

- logs

- repository

15) After about 5 minutes, verify that CQ is running by pointing the browser to the Tomcat server instance (Eg. http://HOST:8080/). Enter license information.

16) Also check the CQ log at C:\Programs\Apache\apache-tomcat-7.0.27\crx\logs\error.log and make sure that everything is working.

Tomcat can be shutdown by running shutdown.bat

More details about installing CQ on different application server can be found from here