Configuring the Tutorial Environment

Before you deploy your composite application, the application server and the appropriate JBI components must be configured correctly and must be running.

The following software is required for this tutorial:

• GlassFish ESB (Installation Instructions) includes the following:

  • GlassFish V2 Update Release 2 (UR2)

  • NetBeans IDE 6.1

  • Open ESB core components

  • Java Business Integration (JBI) service engines

  • Java Business Integration (JBI) binding components

  • Java Business Integration (JBI) component tooling

• JDK (Java Development Kit) 6

Glassfish ESB installer installs all the components including NetBeans IDE. To download only the NetBeans IDE, see NetBeans IDE Download.

You must have the JDK (Java Development Kit) software installed and JAVA_HOME set as an environment variable, prior to installing the GlassFish ESB or the installation will halt midway. See Installing the JDK Software and Setting JAVA_HOME for details.

Starting the GlassFish Software

The Java EE Service Engine starts together with GlassFish. Before deploying and performing test runs of a Composite Application project in the NetBeans IDE, make sure that the GlassFish Application Server is started.

To Check the Status of the GlassFish V2 Application Server in the NetBeans IDE

1. If the Services window is not visible, on the NetBeans IDE menubar choose Window -> Services.

2. In the Services window, expand the Servers node.

   The Servers node should contain a GlassFish V2 subnode. If the GlassFish V2 node is not visible, see To Register the GlassFish V2 Application Server with the NetBeans IDE.

   If a green arrow icon appears on the GlassFish V2 node, the server is running. If no green arrow icon appears, see To Start the GlassFish V2 Application Server in the NetBeans IDE.

To Register the GlassFish V2 Application Server with the NetBeans IDE

1. If the Services window is not visible, on the NetBeans IDE menubar choose Window -> Services.

2. In the Services window, right-click the Servers node and choose Add Server from the pop-up menu.

   The Add Server Instance dialog box opens.

3. In the Choose Server page of the dialog box, select GlassFish V2 from the Server drop-down list.

4. If you want to change the server name that the IDE uses to identify the server, type it in the Name field.

5. Click Next .

   The Platform Location Folder page opens.

6. In the Platform Location field, click Browse and select the installation location of the application server.

7. Select the Register Local Default Domain option and click Next.

8. Type the user name and password for the domain's administrator.

   If you accepted the default values during the installation, the user name is admin and the password is adminadmin.

9. Click Finish.

To Start the GlassFish V2 Application Server in the NetBeans IDE

1. On the NetBeans IDE page, in the Services window, right-click the GlassFish V2 node and choose Start.

2. Wait until the following message appears in the Output window:

   "Application server startup complete."

   When the server is running, the IDE displays a green arrow icon on the GlassFish V2 node.

   The Java EE Service Engineis represented as sun-javaee-engine in the Services window of the IDE, under the GlassFish V2->JBI->Service Engines nodes.

Enabling the JBI Framework

In some cases, you might have to enable the JBI framework to deploy a Java EE Service Engine component. The following command enables the JBI framework:

asadmin enable --user adminuser JBIFramework