Using the GlassFish ESB Installation GUI

Installing GlassFish ESB Using the GlassFish ESB Installer

This procedure installs the following:

NetBeans 6.1 ML
GlassFish v2 Update Release 2 (UR2)
Open ESB core components
Java Business Integration (JBI) service engines
Java Business Integration (JBI) binding components
Java Business Integration (JBI) component tooling

Although you can change the defaults, accepting most of them is a good practice, especially the port numbers.

Caution –

GlassFish ESB does not support spaces in the installation directory path.

To Install GlassFish ESB Components Using theGlassFish ESB Installer

Before You Begin

When installing GlassFish ESB on UNIX systems, such as Solaris machines, you need to set the DISPLAY variable to install in GUI mode. How you do this depends on how you connect to your system.

If you receive the error message “No X11 DISPLAY variable was set, but this program performed an operation which requires it” and you use the SSH command to connect to your system from another UNIX machine, you need to set the DISPLAY variable.
- C shell with localhost as the host name
  
  setenv DISPLAY localhost:0.0
- Korn shell with localhost as the host name
  
  DISPLAY localhost:0.0
  
  export DISPLAY
If you use X Windows software, such as Exceed, the DISPLAY variable is set for you automatically.

Do not use telnet if you install on a Windows system.

Download the installation executable file for your platform from www.glassfish-esb.org.

Extract the installer file for your platform to a temporary directory.

Exit from all programs prior to beginning the installation.

You can cancel the installation at any time during the process.

To start the installation, initiate the appropriate executable file:
- For Linux or Solaris, change the execution mode with the command chmod a+x [installer_file].sh, then start the installation with the command ./[installer_file].sh.
- For Macintosh, place the [installer_file].tgz under $HOME/Desktop, double—click the [installer_file].tgz from the Desktop, and double-click the extracted file [installer_file].command from the Desktop.
- For Windows, double-click the file [installer_file].exe

When the GlassFish ESB Installer wizard appears, click Next on the Introduction page to begin the installation.

Tip –
Use the Next and Previous buttons to navigate forward and backward in the installation.

On the License Agreement page, read the license agreement carefully, select “I accept the terms of the License Agreement” and then click Next.

Verify the location for the NetBeans IDE, and verify the location of its associated Sun JDK. If you are satisfied with the default locations, click Next.

NetBeans and GlassFish require the Sun JDK for installation. For more information, see Installing the JDK Software and Setting JAVA_HOME.

Verify the location for GlassFish, verify the location of its associated Sun JDK. accept the default server properties, and click Next.

The default server properties are described in this table:

Setting	Description	Default
Admin user name	The name you use when you log in as administrator.	`admin`
Admin password	The password you use when you log in as administrator.	`adminadmin`
HTTP port number	The port on which GlassFish listens for HTTP requests for web applications that you deploy.	`8080`
Secure HTTPS port number	The port on which GlassFish listens for HTTPS requests for web applications that you deploy.	`8181`
Admin port number	The port on which GlassFish listens for administrative HTTP requests.	`4848`

Note –

The default Admin Password is adminadmin

Caution –

If you select a Java Runtime Environment (JRE^TM), you cannot install or configure GlassFish.

When the Pre-Installation Summary page appears, verify each component of the installation and click Install. If you need to make changes, use the Previous button to return to a previous screen.

Note –
If a firewall blocks any of the components from installing, remove the block and continue installing the component.

After verifying your available disk space and whether you need a desktop icon and Start Menu item, click Install.

Note –
The installation process can take several minutes, depending on the speed of your system.

When the Registration Screen appears, you can choose any of the following:
- Sign up for a Sun Online Account
  
  The Registration form appears. It asks for general information, such as name, email address, and so on. It requires that you set up a password for your account. Once you have filled out the form to your satisfaction, click Submit.
  
  Note –
  You must have a Sun Online account set up before you can register GlassFish ESB and receive the benefits of registration.
- Provide your Sun Online Account registered email address with password
- Skip registration now and register later
When you register, the following benefits become available to you:
- Notification of new versions, patches, and updates
- Special offers on Sun developer products, services, and training
- Ability to track and manage your registered products on the Sun Inventory site

Click Next, and when the Successful Installation screen appears, read the comments and then click Finish.

GlassFish ESB is configured for your system. For additional details about the installation, see the installation logs. Use the NetBeans Plugin Manager to change installed components or add NetBeans plugins.