test

Project WebSynergy Milestone 4 Getting Started Guide

ProcedureTo Install WebSynergy Software With GlassFish v2

  1. (Mac OS X systems only) Configure your Java environment.

    • If using JDK 1.6, use the Java Preferences application to specify the correct JDK version.

      Also be sure to set JAVA_HOME to point to JDK 1.6.


      export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home

    • If using JDK 1.5, rename the 14compatibility.jar file.

      The 14compatibility.jar file includes some aspects of the Xalan XSLT processor and the Crimson XML parser that conflict with newer versions of the classes bundled with WebSynergy Milestone 4.

      Use the following commands to rename the 14compatibility.jar file:


      cd /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/ \
Classes/.compatibility
sudo mv 14compatibility.jar 14compatibility.jar.orig
cd /System/Library/Frameworks/JavaVM.framework/Versions/A/Resources/.compatibility
sudo mv 14compatibility.jar 14compatibility.jar.orig

  2. Download the websynergy-gfv2-platform.zip file for the platform of your choice to the directory of your choice.

    For the remainder of these instructions, the directory in which the ZIP file is unpacked is referred to as ws_install_dir.

  3. (Solaris and Linux systems only) When installation is complete, change to the ws_install_dir directory and make the files in the ant/bin directory executable.


    cd ws_install_dir
chmod -R 755 ./ant/bin

  4. Run the Ant setup.xml script.


    ws_install_dir/ant/bin/ant -f ws_install_dir/glassfish2/setup.xml

    The required GlassFish domain and database configuration proceeds. When the “BUILD SUCCESSFUL” message is displayed, the WebSynergy installation is complete.

  5. Change to the ws_install_dir/glassfish2/bin directory and start the GlassFish application server.


    cd ws_install_dir/glassfish2/bin
./asadmin start-domain

    This starts the GlassFish server, database server, and the WebSynergy sample site using the default configuration settings.

    Note –

    You may receive the following error when starting the server:


    Domain (domain1) did not respond in 90 seconds. It means it is still coming up or
it has failed to come up. Check server.log for details.

    This message can in most cases be ignored, but it may indicate that there will be a delay of several minutes before the server is actually available.

  6. (Mac OS X systems only) Configure the domain.xml file 64–bit JVM.

    When running any 64-bit JVM such as JDK 1.6 (which runs by default in 64-bit mode on Mac OS X), you need to edit the domain.xml file in the GlassFish domain1/config directory.

    1. Stop the GlassFish domain1 server.


      cd ws_install_dir/glassfish/bin
./asadmin stop-domain

    2. Edit the domain.xml file for domain1, changing the PermSize and MaxPermSize property values.

      This domain.xml file is located in ws_install_dir/domains/domain1/config. Change the PermSize and MaxPermSize values as follows:

      • -XX:PermSize=192M to -XX:PermSize=256M

      • -XX:MaxPermSize=192M to -XX:MaxPermSize=256M

    3. Restart domain1.


      ws_install_dir/glassfish/bin/asadmin start-domain

  7. (All operating systems) Open the WebSynergy sample site.

    Point your Web browser to http://localhost:8080.

    Note –

    The page may take a long time to load the first time after server start. If you see the default GlassFish “Your site is installed” page or a mostly empty page with a single text link titled “Welcome,” wait a few minutes and then refresh the page. Subsequent page loads should proceed more rapidly.