Deploying the Java version of the Crystal Enterprise web desktop

To deploy the Java version of the Crystal Enterprise web desktop, you must create virtual path mappings on your Java web application server. They must map specific URLs to the web application archives (.war files) that implement the Crystal Enterprise User Launchpad and the Crystal Enterprise Admin Launchpad.

Once you have deployed the Launchpads and the Web Component Adapter, set the context path for the WCA in the Crystal Applications area of the Crystal Management Console. Setting the context path ensures that users can view reports using the Active X viewer and the Java viewer shipped with Crystal Enterprise.

Note:    You cannot use the shortcuts in the Crystal Enterprise program group to access the Crystal Enterprise Launchpads deployed on your Java web application server. To access them, you must include the port number of the Java web application server in your URL. That is, to access the Crystal Enterprise User Launchpad running on your Java web application server, type:

http://server01:portnum/crystal/enterprise10/desktoplaunch/en/default.htm

To access the Crystal Enterprise Admin Launchpad running on your Java web application server, type:

http://server01:portnum/crystal/enterprise10/adminlaunch/en/default.htm

where server01 is the name of the server, and portnum is the port number of the Java web application server.

To deploy the Crystal Enterprise Launchpads on Tomcat
  1. Shut down Tomcat if it is running. Type %CATALINA_HOME%\bin\shutdown in the Command Prompt window.
  2. Open the file %CATALINA_HOME%\conf\server.xml, in a text editor such as Notepad.
  3. Add the following lines directly above the line <!-- Tomcat Examples Context -->:

    <Context path="/crystal/enterprise10/adminlaunch"

    docBase="C:\Program Files\Crystal Decisions\Enterprise 10\
    java\applications\admin.war"

    debug="0" reloadable="false"/>

    <Context path="/crystal/enterprise10/desktoplaunch"

    docBase="C:\Program Files\Crystal Decisions\Enterprise 10\
    java\applications\desktop.war"

    debug="0" reloadable="false"/>

    Note:    If you install Crystal Enterprise in a location other than the default installation directory of C:\ProgramFiles\Crystal Decisions\Enterprise 10, adjust the path descriptions to match your actual install directories.

  4. Save the file.
  5. Restart Tomcat by typing %CATALINA_HOME%\bin\startup at the command prompt.
  6. To test the Crystal Enterprise User Launchpad, open a web browser and type http://servername:8080/crystal/enterprise10/desktoplaunch in its address bar. For servername, substitute the name of the machine where you installed Tomcat.

    The Crystal Enterprise User Launchpad should open.

  7. To log on to the Java version of the Crystal Enterprise web desktop, click the Crystal Enterprise link.
  8. To test the Crystal Enterprise Admin Launchpad, open a web browser and type http://servername:8080/crystal/enterprise10/adminlaunch in its address bar. For servername, substitute the name of the machine where you installed Tomcat.

    The Crystal Enterprise Admin Launchpad should open. Do not click the link to the Crystal Management Console. You must configure the Web Component Adapter before the CMC can start. See Deploying the Web Component Adapter for instructions.

  9. Once you have deployed the CMC, ensure that the context path for the WCA is set correctly in the Crystal Applications area of the CMC. See Deploying the Web Component Adapter for instructions.
To deploy the Crystal Enterprise Launchpads on BEA WebLogic
  1. Open a web browser, and type http://servername:7001/console in its address bar to open the BEA WebLogic Administrative Console.

    Note:    For servername, substitute the name of the machine where you installed BEA WebLogic. By default, BEA WebLogic uses port 7001. If you configured your application server to use a different port number, substitute that port number in the URL.

  2. Deploy the Crystal Enterprise User Launchpad as a new web application. Use the .war file found at C:\Program Files\Crystal Decisions\Enterprise 10\java\applications\desktop.war, and set the context root to /crystal/enterprise10/desktoplaunch
  3. To test the Crystal Enterprise User Launchpad, type http://servername:7001/crystal/enterprise10/desktoplaunch in the address bar of a web browser.

    The Crystal Enterprise User Launchpad should open.

  4. To log on to the Java version of the Crystal Enterprise web desktop, click the Crystal Enterprise link.
  5. Deploy the Crystal Enterprise Admin Launchpad as a new web application. Use the .war file found at C:\Program Files\Crystal Decisions\Enterprise 10\
    java\applications\admin.war    , and set the context root to /crystal/enterprise10/adminlaunch
  6. To test the Crystal Enterprise Admin Launchpad, open a web browser and type http://servername:8080/crystal/enterprise10/adminlaunch in its address bar. For servername, substitute the name of the machine where you installed BEA WebLogic.

    The Crystal Enterprise Admin Launchpad should open. Do not click the link to the Crystal Management Console (CMC). You must configure the Web Component Adapter before the CMC can start. See Deploying the Web Component Adapter for instructions.

  7. Once you have deployed the CMC, ensure that the context path for the WCA is set correctly in the Crystal Applications area of the CMC. See Deploying the Web Component Adapter for instructions.
To deploy the Crystal Enterprise Launchpads on IBM WebSphere
  1. Start the IBM WebSphere Administrative Console. (http://servername:9090/admin/).
  2. Install the Crystal Enterprise User Launchpad as a new application. Use the .war file found at C:\Program Files\Crystal Decisions\Enterprise 10\
    java\applications\desktop.war    , and set the context root to /crystal/enterprise10/desktoplaunch
  3. Start the new application.
  4. To test the Crystal Enterprise User Launchpad, type http://servername:9080/crystal/enterprise10/desktoplaunch/launchpad.html in the address bar of a web browser.

    The Crystal Enterprise User Launchpad should open.

  5. To log on to the Java version of the Crystal Enterprise web desktop, click the Crystal Enterprise link.
  6. Install the Crystal Enterprise Admin Launchpad as a new application. Use the .war file found at C:\Program Files\Crystal Decisions\Enterprise 10\
    java\applications\admin.war    , and set the context root to /crystal/enterprise10/adminlaunch
  7. Start the new application.
  8. To test the Crystal Enterprise Admin Launchpad, type http://servername:9080/crystal/enterprise10/adminlaunch/launchpad.html in the address bar of a web browser.

    The Crystal Enterprise Admin Launchpad should open. Do not click the link to the Crystal Management Console. You must configure the Web Component Adapter before the CMC can start. See Deploying the Web Component Adapter for instructions.

  9. Once you have deployed the CMC, ensure that the context path for the WCA is set correctly in the Crystal Applications area of the CMC. See Deploying the Web Component Adapter for instructions.

Crystal Decisions
http://www.crystaldecisions.com/
Support services
http://support.crystaldecisions.com/