Sun Enterprise GlassFish Server 2.1.1 is the primary web container used by Communications Suite 7 Update 2 component products. For complete installation instructions, see Sun GlassFish Enterprise Server 2.1.1 Installation Guide. The following procedures summarize the process.
For details on downloading the software, see Get the Software.
If you are installing GlassFish Server to be the web container for Indexing and Search Service, see Step 2, To Complete the GlassFish Server 2.1.1 Configuration, before starting.
- Before installing GlassFish Server 2.1.1, check that the Java version on the system is at least Version 1.6. To check the Java 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-b03) Java HotSpot(TM) Server VM (build 20.1-b02, mixed mode)
- If you need to update your Java software, see the Java SE downloads site.
If you are using the Communications Suite installer and you do not have at least Java 1.6, Java is automatically installed for you.
- Create a directory for the GlassFish software (for example, /var/tmp), copy the GlassFish software to this directory, then launch the installer.
# cd /var/tmp # chmod +x <distribution-filename> # ./<distribution-filename> -console -javahome /usr/jdk/latest
- When prompted, press Enter to continue.
- Accept the License Agreement by typing yes when prompted.
The following table shows the options that the installation script prompts you to answer, and the default values for the options.
|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 if the Java SDK version is 1.6 or higher.
|Path to Java 2 SDK 5.0 or greater||/usr/jdk/instances/jdk1.6.0|
|Admin User's Password||—|
|Master Password for SSL Certificate||—|
|Enable Updatecenter client|| yes
|Upgrade from previous AS version||no|
- At the Ready to Install prompt, type 1 (to Install Now).
The installation begins.
- At the Installation Successful screen, press Enter to exit the installation program.
- Verify the GlassFish Server version.
- Start the GlassFish Server, for example:
Continue with the next task.
You might need to make a few additional changes to the configuration settings in the GlassFish Server installation:
- If you did not already set the location of JDK 6 during the installation, edit the asenv.conf file (by default, located in /opt/SUNWappserver/config/asenv.conf). Change the value for AS_JAVA to the location of JDK 6, for example:
- If you are using Oracle GlassFish Message Queue (which ships with Communications Suite 7 Update 2), for example, to use Indexing and Search Service, move the embedded JMQ server that comes with Glassfish Server to another port to avoid a conflict:
- Edit the /opt/SUNWappserver/domains/domain1/config/domain.xml file.
- Find the following line in the /opt/SUNWappserver/domains/domain1/config/domain.xml file:
<jms-host admin-password="<adminpwd>" admin-user-name="<admin>" host="<hostname>" name="default_JMS_host" port="7676"/>
- Change port="7676" to a value such as port="7677".
You can avoid this situation by first running the Communications Suite installer, installing the Message Queue software that is provided with the installer, then starting Message Queue before installing GlassFish Server. Then, when you install GlassFish Server, the installation automatically selects a new port if it detects an already-started JMQ running on port 7676.
- To restrict viewing the listing of the iwc_static/layout directory in Convergence, change the value of the init-param listings to false for DefaultServlet in default-web.xml, located in: /opt/SUNWappserver/domains/domain1/config/. For example:
- Restart GlassFish Server, for example: