How to Install CQ WCM Author and Publish Instances using Quickstart


This section describes how to install CQ WCM.

Generally, when you set up CQ WCM, you need to set up an Author and a Publish instance - see the section called “Author and Publish Environments” for further details on the two types of environment.

Installation procedures for these are described in Installing an Author instance and Installing a Publish instance. If, for testing or other purposes, you need to install CQ WCM out of the box (an author instance with default settings and file names), you can use the generic procedure.

Installing an Author Instance

This procedure describes how to set up a default Author instance on port 4502 of the desired host.

To install an author instance:

  1. On the host file system, create a directory and name it author.

  2. Copy the CQ5 cq-wcm-quickstart-<version>.jar file into author/.

  3. Rename cq-wcm-quickstart-<version>.jar to cq5-author-4502.jar. If you need a different port this can be set in the filename.

  4. Copy a valid license.properties file into author/ as well (the same directory as the cq5-author-4502.jar file).

    [Note]Note

    If when starting the application, you do not provide the license.properties file, CQ WCM redirects you to the Welcome screen where you enter a valid license key. You can also request a valid license key from Day at this time.

  5. Start CQ WCM Quickstart:

    • If using a GUI file-system explorer, double-click the cq5-author-4502.jar file.

    • If using the command line, type:

      java -jar cq5-author-4502.jar
    • Use a custom script located in the crx quickstartfolder, such as server.bat to start CQ. The Start and Stop scripts are for UNIX, Linux, and Macintosh. The server.bat script is for Windows.

      [Important]Important

      You cannot use a custom script when you install the quickstart.jar file unless you expand the file first. Use the -unpack option on the command line to unpack the contents before running the script as in java -jar cq-wcm-quickstart-<version>.jar -unpack.

  6. When the installation is completed, you are automatically redirected to http://localhost:4502/bin/login.html.

    [Note]Note

    With the default settings, the syndication agent points toward the publish instance at http://localhost:4503/.

Installing a Publish Instance

To set up a publish instance on port 4503 of the desired host, you perform the same steps as in installing an author instance except that you create a directory named publish (instead of author) and you rename the quickstart.jar file as cq5-publish-4503.jar. You can select any port number.

To install a publish instance:

  1. On the host file system, create a directory and name it publish.

  2. Copy the CQ WCM cq-wcm-quickstart-<version>.jar file into publish/.

  3. Rename cq-wcm-quickstart-<version>.jar to cq5-publish-4503.jar. If you need a different port this can be set in the filename.

  4. Copy a valid license.properties file into publish/ as well (the same directory as the cq5-publish-4503.jar file).

    [Note]Note

    If when starting the application, you do not provide the license.properties file, CQ WCM redirects you to the Welcome screen where you enter a valid license key. You can also request a valid license key from Day at this time.

  5. Start CQ WCM Quickstart:

    • If using a GUI file-system explorer, double-click the cq5-publish-4503.jar file.

    • If using the command line, type:

      java -jar cq5-publish-4503.jar
    • Use a custom script located in the crx quickstartfolder, such as server.bat to start CQ. The Start and Stop scripts are for UNIX, Linux, and Macintosh. The server.bat script is for Windows.

    [Important]Important

    You cannot use a custom script when you install the quickstart.jar file unless you expand the file first. Use the -unpack option on the command line to unpack the contents before running the script as in java -jar cq-wcm-quickstart-<version>.jar -unpack.

  6. When the installation is completed, you can browse your site (for example, http://localhost:4503/content/geometrixx/en/company.html)

Installing a CQ WCM Instance - Generic Procedure

This procedure is a generic, quickstart procedure for installing CQ WCM; it installs an author instance using default settings and file names. It is often used when testing, or other scenarios when you need a quickly available instance.

[Note]Note

You do not need to perform this procedure before installing author or publish instances. To install an author or publish instance, see Installing an Author instance and Installing the Publish instance.

To install a generic CQ WCM instance (author):

  1. Copy the CQ WCM cq-wcm-quickstart-<version>.jar file (for example, cq-wcm-quickstart-5.2.0.20090319.jar) to the desired directory on the host file system.

  2. Copy a valid license.properties file into the same directory as the cq-wcm-quickstart-<version>.jar file.

    [Note]Note

    If when starting the application, you do not provide the license.properties file, CQ WCM redirects you to the Welcome screen where you enter a valid license key. You can also request a valid license key from Day at this time.

  3. Start CQ WCM Quickstart by doing one of the following:

    • If using a GUI file-system explorer, double-click the cq-wcm-quickstart-<version>.jar file. This installs and automatically starts the server.

      [Note]Note

      The repository data is stored in the subdirectory crx-quickstart/repository.

    • If using the command line, type the following:

      java -jar cq-wcm-quickstart-<version>.jar
    • Use a custom script located in the crx quickstart folder, such as server.bat to start CQ. The Start and Stop scripts are for UNIX, Linux, and Macintosh. The server.bat script is for Windows.

      [Note]Note

      You cannot use a custom script when you install the quickstart.jar file unless you expand the file first. Use the -unpack option on the command line to unpack the contents before running the script as in java -jar cq-wcm-quickstart-<version>.jar -unpack.

  4. When the installation is complete, you are automatically redirected to http://localhost:4502/bin/login.html.

    [Note]Note

    CQ WCM quickstart selects the first available port from the following list: 4502,8080,8081,8082,8083,8084,8085,8888,9362,<random>. You can also set the port number. See installing an author instance for an example on how to set a port number.