Communications Suite 7 Installation Scenario - GlassFish Enterprise Server

GlassFish Enterprise Server 2.1 is the primary web container used by Communications Suite 7 component products. For complete installation instructions, see Sun GlassFish Enterprise Server 2.1 Installation Guide. The following instructions summarize the process.

Tip If you are installing GlassFish Enterprise Server to be the web container for Indexing and Search Service, see Step 2, To Complete the GlassFish Enterprise Server 2.1 Configuration, before starting.

To Install and Configure GlassFish Enterprise Server 2.1

1. Prior to installing GlassFish Enterprise Server 2.1, check that the Java version on the system is at least Java 1.6. To check your version type the following command:

   # java -version
   

   The shell returns results that look similar to the following:

   java version "1.6.0_06"
   Java(TM) SE Runtime Environment (build 1.6.0_06-b02)
   Java HotSpot(TM) Server VM (build 10.0-b22, mixed mode)
   

2. If you need to update your Java, see: http://java.sun.com/javase/downloads/index.jsp

   Note If you are using the Communications Suite installer, and you don't have at least Java 1.6, it automatically installs Java for you.

3. Create a directory for the GlassFish software (for example /tmp/GLASSFISH21), copy the GlassFish software to this directory, then launch the installer.

   # cd /tmp/GLASSFISH21
   # chmod +x <distribution-filename>
   # ./<distribution-filename> -console -javahome /usr/jdk/entsys-j2se
   

4. When prompted, press Enter to continue.
5. Accept the License Agreement by typing yes when prompted.
   The following table shows the options that the installation script prompts you to answer.

   GlassFish Enterprise Server 2.1 Settings

   Option	[Default Value]
   Installation Directory	[/opt/SUNWappserver]
   Create Directory or Choose New	Create Directory
   Install Node Agent	[yes]
   Install High Availability Database Server	[no]
   Install Load Balancing Plugin	[no]
   Install Domain Administration Server	[yes]
   Install Sample Applications	[yes] Type no if you do not want the sample applications.
   Install or reuse Java 2 SDK	[Install] You can reuse (as long as correct version).
   Path to Java 2 SDK 5.0 or greater	[/usr/jdk/instances/jdk1.6.0]
   Admin User	[admin]
   Admin User's Password	—
   Master Password for SSL Certificate	—
   Admin Port	[4848]
   HTTP Port	[8080]
   HTTPS Port	[8181]
   Enable Updatecenter client	[yes] Type no.
   Upgrade from previous AS version	[no]

6. At the Ready to Install prompt, select 1 (Install Now).
   The installation begins.
7. At the Installation Succesfull screen, press Enter to exit the installation program.
8. Start the GlassFish Enterprise Server, for example:

   # /opt/SUNWappserver/bin/asadmin start-domain domain1
   Starting Domain domain1, please wait.
   Log redirected to /opt/SUNWappserver/domains/domain1/logs/server.log.
   Please enter the admin user name>admin
   Please enter the admin password><adminpass>
   Please enter the master password><adminpass>
   

9. Continue with the next task.

To Complete the GlassFish Enterprise Server 2.1 Configuration

You might need to make a few additional configuration settings to the GlassFish Enterprise Server installation.

1. If you didn't already set the location of JDK 6 during the installation, edit the asenv.conf file (default is /opt/SUNWappserver/config/asenv.conf).
   Change the value for AS_JAVA to the location of JDK 6, for example:

   AS_JAVA="/usr/jdk/jdk1.6.0_03"
   

2. If you are using Java Message Queue that ships with Communications Suite 7, for example, to use Indexing and Search Service, move the embedded JMQ server that comes with GlassFish Enterprise Server to another port, to avoid a conflict:
   1. Edit the /opt/SUNWappserver/domains/domain1/config/domain.xml file.
   2. Find the line: <jms-host admin-password="<adminpwd>" admin-user-name="<admin>" host="<hostname>" name="default_JMS_host" port="7676"/> in the /opt/SUNWappserver/domains/domain1/config/domain.xml file.
   3. Change port="7676" to a value such as port="37676".

      Note You can avoid this situation by first running the Communications Suite installer, installing Java Message Queue, and starting Java Message Queue before installing GlassFish Enterprise Server. Then, when installing GlassFish Enterprise Server, the installation automatically selects a new port if it detects an already started JMQ running on port 7676.

3. Restart GlassFish Enterprise Server, for example:

   # /opt/SUNWappserver/bin/asadmin stop-domain domain1
   Domain domain1 stopped.
   # /opt/SUNWappserver/bin/asadmin start-domain domain1
   Starting Domain domain1, please wait.
   Log redirected to /opt/SUNWappserver/domains/domain1/logs/server.log.
   Please enter the admin user name>admin
   Please enter the admin password>adminpass
   Please enter the master password>adminpass