Sun GlassFish Mobility Platform 1.1 Installation Guide

Installing the Sun GlassFish Mobility Platform Server-Side Software

The following sections explain how to perform two types of installation:

Single-tier install, in which all of the Sun GlassFish Mobility Platform software is installed on one system
Two-tier install, in which the Sun GlassFish Mobility Platform Gateway engine is installed on the first system and the other Sun GlassFish Mobility Platform components, including the web service endpoint, enterprise connectors, and Sun JCA adapters are installed on a second system.

Performing a Single-Tier Installation

Complete the following steps to install all of the Sun GlassFish Mobility Platform components in a single tier.

If you are installing on a Solaris system, log in as root or use the sudo command.

Use the sudo command if you are installing on a Linux system.
Unzip the sgmp-1_1-<operating_system>.zip installation bundle appropriate for your operating system.
If you are using Oracle, download ojdbc14.jar, the Oracle JDBC driver, from http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html. Place this JAR file in the lib subdirectory under the top-level directory where you unzipped the Sun GlassFish Mobility Platform installation bundle.
Change to the directory where you unzipped the installation bundle and type the command to start the installation and run the installer appropriate for your operating system:
- install-solaris.sh on Solaris
- install-linux.sh on Linux
- install-windows.bat on Windows
When you are prompted to select the installation type (single tier, tier1, or tier2), select “1” to perform a single-tier installation.
The first step in the Sun GlassFish Mobility Platform installation process is to install Sun GlassFish Enterprise Server 2.1:
1. When you are prompted to install the Application Server, type “y”.
2. When you are prompted to display the Software License, press Enter.
3. When you are prompted to accept the Software License, type “yes”.
4. When you are prompted to accept the default location of the installation directory, press Enter. If you want to install the Application Server in another location, type the full path to that directory then press Enter.
5. If the directory does not exist, type “1” to create the directory or “2” to choose a new directory, then press Enter.
6. If the installer finds a suitable Java SDK installation, it displays that installation directory as the default. If the default is a valid JDK 6 installation directory, press Enter to accept that installation directory or type the full path name of another JDK 6 installation.
7. When you are prompted for the admin user name, type the administrator user name or press Enter to accept the default (admin).
8. When you are prompted for the admin user's password, type the password then reenter it when you are prompted to do so.
9. When you are prompted to store the username and password in a file in your home directory, press Enter or type “yes”.
10. When you are prompted to accept or override the initial Application Server port settings (Admin port, HTTP port, HTTPS port), press Enter.
11. When you are prompted to add the bin directory to the PATH, press Enter or type “yes”.
12. When you are prompted to enable the Update Center client, press Enter or type “yes”.
13. If you are prompted to create a Windows service, press Enter or type “no” to bypass creating a service or type “yes” to create a Windows service. If you opted to create a service, follow the online instructions for doing so.
14. When you are prompted to create a desktop shortcut to the autodeploy directory, press Enter or type “no” to bypass creating the shortcut or type “yes” to create the shortcut on your desktop.
15. When you are prompted to upgrade from a previous version of the Application Server, press Enter or type “no”.
16. When you are prompted to install now, start over, or exit the installation, type “1” to install the Application Server.
17. When you are prompted, press Enter to exit the installation program that just completed.
The next step in the Sun GlassFish Mobility Platform installation process is to install the Sun GlassFish Mobility Platform software:
1. When you are prompted, press Enter or type the full path to the Application Server installation directory.
2. When you are prompted to review the product license, press Enter.
  
  Press Enter repeatedly as you page through the license.
3. When you are prompted to accept the license, type “y” or “yes”.
4. When you are prompted to select the database, type “1” for MySQL or “2” for Oracle, then press Enter.
  
  If you select Oracle, you must have completed the steps in Appendix A, Configuring Oracle Databases and Database Users for Use with the Sun GlassFish Mobility Platform Software before you can proceed with the installation.
5. When you are prompted, type the database host name or press Enter to accept the default (localhost).
6. When you are prompted, type the database access port or press Enter to accept the default.
  
  The default is 3306 on MySQL and 1521 on Oracle.
7. When you are prompted, type the database JDBC driver class or press Enter to accept the default.
  
  The default is mysql.jdbc.Driver on MySQL and oracle.jdbc.OracleDriver on Oracle.
8. If you selected MySQL, when you are prompted, type the userid of the database administrator account.
  
  On MySQL, the userid is usually root.
9. If you selected MySQL, when you are prompted, type the password for the root account (or database administrator account).
  
  If you are using MySQL, the installer creates all of the necessary databases, users, and tables. No action is needed on your part.
10. When you are prompted to delete domain1, type “y” or “yes”.
11. When you are prompted, press Enter or type the name for the new Application Server domain. The default is “mep”.
12. When you are prompted, press Enter or type the Admin Port for the new domain. The default is “4848”.
13. When you are prompted, press Enter or type the HTTP port for the new domain. The default is “8080”.
14. When you are prompted, press Enter or type the HTTPS port for the new domain. The default is “8181”.
15. When you are prompted, press Enter or type the admin password for the new domain. The default is “adminpass”. The password that you type in this step should match the password that you typed in step 6h.
  
  The installer configures the new domain. No action is needed on your part.
When the installation completes successfully, the following message is displayed:
```
Install was successful

BUILD SUCCESSFUL
```