Documentation for CQ 5.1 WCM
Homepage > How to install CQ5 with an Application Server

How to install CQ5 with an Application Server

Contents

WebSphere v6.1
WebLogic v10.3
Tomcat v6
JBoss v4
Generic Procedures

The following sections detail how to install CQ5 in conjunction with various application servers:

A generic overview is also given for general usage and information:

WebSphere v6.1

After installing WebSphere v6.1 you:

Install CQ5

  1. Unpack the installation files of the CQ5 Quickstart into a directory (without starting the server); the installation directory will be referred to as <cq-installation-dir>:

    1. Start the CQ5 Quickstart jar with the option -unpack; for example:

      java -jar cq-wcm-quickstart-5.1.0.jar -unpack

      This will create a folder <cq-installation-dir>crx-quickstart containing the files and folders used for installation, without actually starting the installation.

    [Important]Important

    This must be done from the command line. If you open the jar file directly you will activate the Quickstart installation and start the server.

  2. Copy the following jar files to the application server folder holding shared libraries:

    1. CRX\server\lib\container\jcr-1.0.jar

    2. CRX\server\lib\container\crx-shared.jar

  3. Restart WebSphere.

  4. Deploy the following web applications; they can be found in <cq-installation-dir>\crx-quickstart\server\webapps:

    1. CRX webapp; crx-explorer_crx.war.

      For example, deploy with the context path /crx.

    2. Launchpad webapp; crx-launchpad.war.

      For example, deploy with the context path /launchpad.

  5. Start the two applications.

  6. Register your CRX license:

    1. Access your CRX installation:

      http://<server>:<port>/<context-path>/index.jsp

      for example: http://<server>:<port>/crx/index.jsp

    2. Click the red warning message - “Click here...” (the message is a link).

    3. Enter your license key.

Configure the default JDK

WebSphere v6.1 uses JDK 1.5. By default the SAMLv2 JSP JDK source level uses JDK 1.3. As the SAMLv2 sample configuration uses the JDK 1.5 syntax, running it with the default source level will not work. The following steps should be used to configure the source level as 1.5:

  1. Within the deployed crx-explorer_crx.war, edit ibm-web-ext.xmi and add the following configuration parameter to specify the JSP engine:

    <jspAttributes xmi:id="JSPAttribute_1225281520121" name="jdkSourceLevel" value="15"/>

    [Note]Note

    The integer (n) referenced in JSPAttribute_<n> must be unique within the file.

  2. Repeat for crx-launchpad.war.

    [Note]Note

    The default configuration directory for the web module is:

    <WAS_ROOT>\profiles\profilename\config\cells\cellname\applications\enterpriseappname\ deployments\deployedname\webmodulename\WEB-INF\

    If you have already checked the option Use Binary Configuration the files are extracted to the following directory, where they can be edited:

    <WAS_ROOT>\profiles\profilename\installedApps\nodename\enterpriseappname\webmodulename\

    Where <WAS_ROOT> is the root directory of the web application server installation.

  3. Restart Websphere.

Install your Content Packages

  1. Access the CRX main console.

  2. Log in to the crx.system workspace as admin.

  3. Navigate to the Package Manager in CRX.

  4. Upload and install the following CQ5 package from <cq-installation-dir>\crx-quickstart\repository\install\system:

    1. WCM Security Content Package; cq-security-content-<cq-version>.jar.

  5. Switch to the crx.default workspace, again as admin

  6. Upload and install the following CQ5 packages from <cq-installation-dir>\crx-quickstart\repository\install in the following order:

    1. Sling Content Package; 0001-cq-wcm-sling-content-<cq-version>.jar.

    2. WCM Content Package; 0002-cq-wcm-content-<cq-version>.jar.

Enable Replication for Author instances of CQ5

For an author instance of CQ5 you must configure it to start in “author run mode” so that you can perform replications.

  1. Open the file: <cq-installation-dir>\crx-quickstart\launchpad\sling.properties for edit.

  2. Add the following two properties to the file:

    sling.jcrinstall.folder.name.regexp = .*/(install|config)(.author)?$ 
sling.run.modes = author

  3. Restart the crx-launchpad web application.

WebLogic v10.3

After installing WebLogic v10.3 and creating your domain you:

Configure the Server Locale

When you deploy CQ5 with WebLogic 10.3 you must have the server locale set to en_US to avoid errors such as:

java.lang.IllegalArgumentException: Bad date header: 'Wed, 12 Nov 2008 16:34:28 GMT'

These can occur when, for example, requesting a resource such as /libs/widgets/0.gif.

To configure the server locale on Microsoft Windows:

  1. Open the Control Panel.

  2. Open Regional and Languages Options.

  3. In the Regional Options tab, for Standards and formats select English(United States).

To configure the server locale on Linux or Unix:

  • set the environment variable LANG to en_US.

Enable Basic Authentication Headers

To enable out-of-the-box authentication of users in CQ5, authentication by the application server must be switched off:

  1. Open <WebLogic-installation-dir>/user_projects/domains/<your-domain>/config/config.xml.

  2. Locate the element <security-configuration>.

  3. Add the following child element to it: 

    <enforce-valid-basic-auth-credentials>
    false
</enforce-valid-basic-auth-credentials>

  4. If you had already started WebLogic then you will need to restart it.

Install CQ5

  1. Unpack the installation files of the CQ5 Quickstart into a directory (without starting the server); the installation directory will be referred to as <cq-installation-dir>:

    1. Start the CQ5 Quickstart jar with the option -unpack; for example:

      java -jar cq-wcm-quickstart-5.1.0.jar -unpack

      This will create a folder <cq-installation-dir>crx-quickstart containing the files and folders used for installation, without actually starting the installation.

    [Important]Important

    This must be done from the command line. If you open the jar file directly you will activate the Quickstart installation and start the server.

  2. Copy the following jar files to the application server folder holding shared libraries:

    1. CRX\server\lib\container\jcr-1.0.jar

    2. CRX\server\lib\container\crx-shared.jar

  3. Restart WebLogic.

  4. Deploy the following web applications; they can be found in <cq-installation-dir>\crx-quickstart\server\webapps:

    1. CRX webapp; crx-explorer_crx.war.

      For example, deploy with the context path /crx.

    2. Launchpad webapp; crx-launchpad.war.

      For example, deploy with the context path /launchpad.

  5. Start the two applications.

  6. Register your CRX license:

    1. Access your CRX installation:

      http://<server>:<port>/<context-path>/index.jsp

      for example: http://<server>:<port>/crx/index.jsp

    2. Click the red warning message - “Click here...” (the message is a link).

    3. Enter your license key.

Install your Content Packages

  1. Access the CRX main console.

  2. Log in to the crx.system workspace as admin.

  3. Navigate to the Package Manager in CRX.

  4. Upload and install the following CQ5 package from <cq-installation-dir>\crx-quickstart\repository\install\system:

    1. WCM Security Content Package; cq-security-content-<cq-version>.jar.

  5. Switch to the crx.default workspace, again as admin

  6. Upload and install the following CQ5 packages from <cq-installation-dir>\crx-quickstart\repository\install in the following order:

    1. Sling Content Package; 0001-cq-wcm-sling-content-<cq-version>.jar.

    2. WCM Content Package; 0002-cq-wcm-content-<cq-version>.jar.

Enable Replication for Author instances of CQ5

For an author instance of CQ5 you must configure it to start in “author run mode” so that you can perform replications.

  1. Open the file: <cq-installation-dir>\crx-quickstart\launchpad\sling.properties for edit.

  2. Add the following two properties to the file:

    sling.jcrinstall.folder.name.regexp = .*/(install|config)(.author)?$ 
sling.run.modes = author

  3. Restart the crx-launchpad web application.

Tomcat v6

After installing Tomcat v6 you:

Configure Tomcat access accounts

Tomcat enables neither admin nor manager access at installation.

Therefore you have to manually edit tomcat-users.xml to allow access for these accounts:

  1. Navigate to the Tomcat configuration folder.

  2. Edit tomcat-users.xml to include access for admin and manager. The configuration should look similar to the following example:

    <?xml version='1.0' encoding='utf-8'?> 
<tomcat-users> 
    <role rolename="manager"/> 
    <role rolename="tomcat"/> 
    <role rolename="admin"/> 
    <role rolename="role1"/> 
    <user username="both" password="tomcat" roles="tomcat,role1"/> 
    <user username="tomcat" password="tomcat" roles="tomcat"/> 
    <user username="admin" password="admin" roles="admin,manager"/> 
    <user username="role1" password="tomcat" roles="role1"/> 
</tomcat-users>

Install CQ5

  1. Unpack the installation files of the CQ5 Quickstart into a directory (without starting the server); the installation directory will be referred to as <cq-installation-dir>:

    1. Start the CQ5 Quickstart jar with the option -unpack; for example:

      java -jar cq-wcm-quickstart-5.1.0.jar -unpack

      This will create a folder <cq-installation-dir>crx-quickstart containing the files and folders used for installation, without actually starting the installation.

    [Important]Important

    This must be done from the command line. If you open the jar file directly you will activate the Quickstart installation and start the server.

  2. Copy the following jar files to the application server folder holding shared libraries:

    1. CRX\server\lib\container\jcr-1.0.jar

    2. CRX\server\lib\container\crx-shared.jar

  3. Restart Tomcat.

  4. Deploy the following web applications; they can be found in <cq-installation-dir>\crx-quickstart\server\webapps:

    1. CRX webapp; crx-explorer_crx.war.

      For example, deploy with the context path /crx.

    2. Launchpad webapp; crx-launchpad.war.

      For example, deploy with the context path /launchpad.

  5. Start the two applications.

  6. Register your CRX license:

    1. Access your CRX installation:

      http://<server>:<port>/<context-path>/index.jsp

      for example: http://<server>:<port>/crx/index.jsp

    2. Click the red warning message - “Click here...” (the message is a link).

    3. Enter your license key.

Install your Content Packages

  1. Access the CRX main console.

  2. Log in to the crx.system workspace as admin.

  3. Navigate to the Package Manager in CRX.

  4. Upload and install the following CQ5 package from <cq-installation-dir>\crx-quickstart\repository\install\system:

    1. WCM Security Content Package; cq-security-content-<cq-version>.jar.

  5. Switch to the crx.default workspace, again as admin

  6. Upload and install the following CQ5 packages from <cq-installation-dir>\crx-quickstart\repository\install in the following order:

    1. Sling Content Package; 0001-cq-wcm-sling-content-<cq-version>.jar.

    2. WCM Content Package; 0002-cq-wcm-content-<cq-version>.jar.

Enable Replication for Author instances of CQ5

For an author instance of CQ5 you must configure it to start in “author run mode” so that you can perform replications.

  1. Open the file: <cq-installation-dir>\crx-quickstart\launchpad\sling.properties for edit.

  2. Add the following two properties to the file:

    sling.jcrinstall.folder.name.regexp = .*/(install|config)(.author)?$ 
sling.run.modes = author

  3. Restart the crx-launchpad web application.

JBoss v4

After installing JBoss v4 you:

Install CQ5

  1. Unpack the installation files of the CQ5 Quickstart into a directory (without starting the server); the installation directory is referred to as <cq-installation-dir>:

    1. Start the CQ5 Quickstart jar with the option -unpack; for example:

      java -jar cq-wcm-quickstart-5.1.0.jar -unpack

      This creates a folder <cq-installation-dir>crx-quickstart containing the files and folders used for installation, without actually starting the installation.

    [Important]Important

    This must be done from the command line. If you open the jar file directly you will activate the Quickstart installation and start the server.

  2. Copy the following jar files to the application server folder holding shared libraries (<JBOSS_HOME]\server\default\lib>):

    1. CRX\server\lib\container\jcr-1.0.jar

    2. CRX\server\lib\container\crx-shared.jar

  3. Restart JBoss.

  4. Unpack the crx-explorer_crx.war file located in the <cq-installation-dir>\crx-quickstart\server\webapps folder.

    [Note]Note

    In Windows, change the .war extension to .zip and unpack like any zip file. In Linux, type jar xvf crx-explorer_crx.war to unpack.

  5. In the WEB-INF folder, open log4j.xml.

  6. Remove or comment the line <appender-ref ref="console"/> which is in the Loggers section of the file and save your changes and exit the file. This disables console logging in the CRX web application.

  7. In the WEB-INF folder, navigate to the lib folder and delete the following files:

    • jcr-1.0.jar

    • jackrabbit-api-1.4.jar

    • day-commons-naming-1.1.1.jar

    • crx-api-1.4.1.jar

  8. Pack the crx-explorer_crx.war file.

    [Note]Note

    In Windows, run the zip utility to compress it and rename the crx-explorer_crx.zip file to crx-explorer_crx.war. In Linux, type jar cvf crx-explorer_crx.war.

  9. Deploy the following web applications; they can be found in <cq-installation-dir>\crx-quickstart\server\webapps:

    1. CRX webapp; crx-explorer_crx.war.

      For example, deploy with the context path /crx.

    2. Launchpad webapp; crx-launchpad.war.

      For example, deploy with the context path /launchpad.

    JBoss supports Hot Deployment, so you can simply drag the two files to <JBOSS_HOME>\server\default\deploy.

  10. Start the two applications.

  11. Register your CRX license:

    1. Access your CRX installation:

      http://<server>:<port>/<context-path>/index.jsp

      for example: http://<server>:<port>/crx/index.jsp

    2. Click the red warning message - “Click here...” (the message is a link).

    3. Enter your license key.

Configure the JBoss Server Login Module

By default JBoss' default login configuration attempts to authenticate users against a list of users in the users.properties file. You must configure JBoss as follows to let login attempts by unknown users to pass to the web application (CRX Explorer). The web application will then process authentication by itself.

  1. Open the file for editing:

    <JBOSS_HOME>\server\default\conf\login-config.xml

  2. In the section application-policy name="other" (at the bottom of the file) add the attribute:

    unauthenticatedIdentity="nobody"

    to the login-module entry.

Install your Content Packages

Once you have installed CQ5 you will want to install content packages.

  1. Access the CRX main console:

    http://<server>:<port>/crx-explorer_crx/index.jsp

  2. Log in to the crx.system workspace as admin.

  3. Navigate to the Package Manager in CRX.

  4. Upload and install the following CQ5 package from <cq-installation-dir>\crx-quickstart\repository\install\system:

    1. WCM Security Content Package; cq-security-content-<cq-version>.jar.

  5. Switch to the crx.default workspace, again as admin

  6. Upload and install the following CQ5 packages from <cq-installation-dir>\crx-quickstart\repository\install in the following order:

    1. Sling Content Package; 0001-cq-wcm-sling-content-<cq-version>.jar.

    2. WCM Content Package; 0002-cq-wcm-content-<cq-version>.jar.

  7. Restart JBoss.

Enable Replication for Author instances of CQ5

For an author instance of CQ5 you must configure it to start in “author run mode” so that you can perform replications.

  1. Open the file: <cq-installation-dir>\crx-quickstart\launchpad\sling.properties for edit.

  2. Add the following two properties to the file:

    sling.jcrinstall.folder.name.regexp = .*/(install|config)(.author)?$ 
sling.run.modes = author

  3. Restart the crx-launchpad web application.

Generic Procedures

After installing the appropriate web application server you:

Generic Installation Procedure

This section provides generic information about installing CQ5 with an application server.

  1. Unpack the installation files of the CQ5 Quickstart into a directory (without starting the server); the installation directory will be referred to as <cq-installation-dir>:

    1. Start the CQ5 Quickstart jar with the option -unpack; for example:

      java -jar cq-wcm-quickstart-5.1.0.jar -unpack

      This will create a folder <cq-installation-dir>crx-quickstart containing the files and folders used for installation, without actually starting the installation.

    [Important]Important

    This must be done from the command line. If you open the jar file directly you will activate the Quickstart installation and start the server.

  2. Copy the following jar files to the application server folder holding shared libraries:

    1. CRX\server\lib\container\jcr-1.0.jar

    2. CRX\server\lib\container\crx-shared.jar

  3. Restart your web application server.

  4. Deploy the following web applications; they can be found in <cq-installation-dir>\crx-quickstart\server\webapps:

    1. CRX webapp; crx-explorer_crx.war.

      For example, deploy with the context path /crx.

    2. Launchpad webapp; crx-launchpad.war.

      For example, deploy with the context path /launchpad.

  5. Start the two applications.

  6. Register your CRX license:

    1. Access your CRX installation:

      http://<server>:<port>/<context-path>/index.jsp

      for example: http://<server>:<port>/crx/index.jsp

    2. Click the red warning message - “Click here...” (the message is a link).

    3. Enter your license key.

Install Content Packages

Once you have installed CQ5 you will want to install content packages.

  1. Access the CRX main console.

  2. Log in to the crx.system workspace as admin.

  3. Navigate to the Package Manager in CRX.

  4. Upload and install the following CQ5 package from <cq-installation-dir>\crx-quickstart\repository\install\system:

    1. WCM Security Content Package; cq-security-content-<cq-version>.jar.

  5. Switch to the crx.default workspace, again as admin

  6. Upload and install the following CQ5 packages from <cq-installation-dir>\crx-quickstart\repository\install in the following order:

    1. Sling Content Package; 0001-cq-wcm-sling-content-<cq-version>.jar.

    2. WCM Content Package; 0002-cq-wcm-content-<cq-version>.jar.

Enable Replication for Author instances of CQ5

For an author instance of CQ5 you must configure it to start in “author run mode” so that you can perform replications.

  1. Open the file: <cq-installation-dir>\crx-quickstart\launchpad\sling.properties for edit.

  2. Add the following two properties to the file:

    sling.jcrinstall.folder.name.regexp = .*/(install|config)(.author)?$ 
sling.run.modes = author

  3. Restart the crx-launchpad web application.

Copyright 1993-2009 Day Management AG | CQ 5.1 WCM