4.2 Run the Quickstart

  1. Obtain the Customer Experience Solutions Quickstart JAR from the Adobe representative for your organization.

    You can also request for a consultation by submitting the consultation form at https://www.adobe.com/cfusion/mmform/index.cfm?name=solutions. A representative from Adobe will contact you.

    Once you have received the Quickstart JAR file, download or copy it to your machine.

  2. To integrate Customer Experience Solutions with the Document Services platform, append -ds to the JAR filename. For example, adep-solutions-quickstart-ds.jar. This configuration is required for your Customer Experience Solutions to interact with the Document Services components and services.

    The default port number for the Experience Server is 4502. You can change the default port number by renaming the JAR file as adep-solutions-quickstart-ds-p<port>.jar. Replace <port> with the port number for the CRX server.

    Important: For Correspondence Management, you must run two instances of the Quickstart in author mode and publish mode. In this case, you need to keep two copies of the JAR file in different directories for the author and publish instances, and add -author and -publish to the filename, respectively. Also, ensure to use different port number to avoid any conflict. For example, you can rename the two files as adep-solutions-author-ds-p4502.jar and adep-solutions-publish-ds-p4503.jar.
    Important: By default, the author and publish instances are configured to run on the same machine port 4502 and 4503, respectively. However, you may choose to run the two instances on different machines. Once the two instances are running on different machines, you must configure your publish instance as described in 7.3.2.1 Configure the publish instance.
  3. Do one of the following:
    • Run the Quickstart in GUI mode

      Double-click the JAR file to begin the installation program. It launches the Quickstart window, which displays the progress of the installation.

    • Run the Quickstart in CLI mode

      Execute the following command to begin the installation program.

      java -jar adep-solutions-quickstart-10-0–all-all.jar

      There are more options available with the Quickstart file to customize your installation as described in 4.4 CLI Options for the Quickstart. You can also use the -help option to view the available options.

      Note: When you fork the process using the –fork argument or the process is forked automatically in cases of lesser memory arguments passed, ensure that you specify any VM argument (for example, DataServices clustering argument) with forkargs parameter. As you start the Solutions quickstart using the java –jar command, you will find information about processes being forked on System Out.

    When the installation is complete and the Experience Server is running, the Adobe Digital Enterprise Platform - License page opens in a browser window.

    If the License page does not open automatically, go to http://[host]:[port]/. The default values for host and port are localhost and 4502, respectively.

    If you used a different port number, you can determine the port number from the stderr.log file present in the <solutions root>\log\ directory.
    Note: The first time you run the JAR file, it extracts all the files contained in it, which may take several minutes. The subsequent startups are quicker as the repository and other associated files have already been extracted and placed in the installation directory.
  4. On the Adobe Digital Enterprise Platform - License page, click Click here to obtain a free trial license.

  5. Log in using your Adobe ID and password.

  6. Click Retrieve License Key. The license key is sent to the email ID associated with your Adobe ID.

  7. Go to the Welcome page or http://[host]:[port]/. Review and accept the End User License Agreement, specify the customer name and the license key, and click Register to register your license key.

    The confirmation page with the registration details opens.

  8. Click Close on the registration details page. The Adobe Digital Enterprise Platform - Sign In page opens.

  9. Specify admin/admin as the username/password and click Sign In. The ADEP Customer Experience Solutions Welcome page opens.