Preparing your HATS project for use as an application

After you develop and test your HATS project, you can deploy it as an application in a runtime environment. The deployment tasks differ depending on whether you are deploying a HATS Web application or a HATS rich client application. Both are discussed below.

Deploying HATS Web applications

The terms HATS Web application, WebSphere® application, and Java™ EE application can be used interchangeably to refer to a Web application created from a HATS project. It is a HATS Web application because it was developed in the HATS Toolkit. It is a WebSphere application because it will be installed and run on WebSphere Application Server. It is a Java EE application because it conforms to the Java EE standards.

Note:
HATS portlets are special cases of HATS Web applications. For more information about developing and deploying HATS portlets see the chapter, WebSphere Portal and HATS, in the HATS User's and Administrator's Guide.

To deploy your HATS Web application in a runtime environment you must:

The following sections summarize each of these tasks. For details about how to perform these tasks, see the section, Deploying HATS Web applications, in the HATS User's and Administrator's Guide.

Exporting your project as an application

To deploy your HATS Web application to a runtime environment, you must first package it as a Java EE application. To package your application as a Java EE application, from the HATS Projects view, right-click your Web project and from the pop-up menu select Export Project to launch the EAR Export wizard. The wizard can also be launched by selecting your Web project and clicking the Export HATS Project export project icon on the Rational® SDP toolbar.

Installing your application in a runtime environment

After exporting the HATS project as an application and transferring the application's .ear file to the production system, install it using the WebSphere administrative console. For more information about installing applications on WebSphere Application Server refer to the WebSphere Application Server library and select the link to the information center for your version of WebSphere Application Server. In the contents under your WebSphere Application Server product, refer to the chapter about deploying applications.

Deploying HATS rich client applications

To deploy your HATS rich client application in a runtime environment you must:

The following sections summarize each of these tasks. For details about how to perform these tasks, see the section, Deploying HATS rich client applications, in the HATS User's and Administrator's Guide.

Exporting your project as an Eclipse feature

To deploy your HATS rich client application plug-in to a runtime environment, you must first package it into an Eclipse feature. An Eclipse feature is a deployment artifact used to package associated plug-ins. To package your plug-in into an Eclipse feature, from the HATS Projects view, right-click your rich client project and from the pop-up menu select Export > Export Feature. Assuming your project is not already part of a feature, a dialog will prompt you to create the feature now. Click Yes to launch the Create a HATS Feature Project wizard.

Exporting HATS runtime features

In a production environment, a HATS rich client application feature depends on the HATS runtime features being installed on the client. When you create a HATS rich client application feature using the Create a HATS Feature Project wizard, it will automatically include a dependency on the HATS runtime features. This dependency is what causes the feature install and update process to automatically pull down the HATS runtime features from the update site when a HATS rich client application feature is installed or updated.

To export the HATS runtime features, in the HATS Projects view right-click on your HATS rich client project and from the pop-up menu select Export > Export HATS Runtime Features. This launches the Export HATS Runtime Features wizard. The wizard can also be launched from the Rational SDP menu bar by selecting File > Export > HATS > HATS Runtime Features.

Creating an update site

After exporting both your HATS application feature and the HATS runtime features, you must create an update site that can be used by the feature install and update process to deploy your application. To create an update site, from the Rational SDP menu bar, select File > New > Other. On the Select a wizard panel, select Plug-in Development > Update Site Project and click Next to launch the Update Site Project wizard.

Installing your application in a runtime environment

HATS rich client applications can run in Eclipse RCP, Lotus Notes®, and Lotus® Expeditor Client environments. The following sections summarize how to install your HATS rich client application in each of these environments.

Eclipse RCP

To install your HATS rich client application in an Eclipse rich client platform environment, the client must be configured to access the update site containing the application. By default, since automatic install and update is disabled, the user or administrator must manually install the new features or updates using the standard Eclipse Software Updates functions. To do this, on the client system, from the Eclipse main menu select Help > Software Updates.

Lotus Notes

In the Lotus Notes environment, a widget is used to install applications that are provided as features and plug-ins. The widget can later be published to a Widget catalog for others to use. For more information about widgets, see the Widgets and Live Text section in the Lotus Notes Information Center at http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.notes85.help.doc/wid_app_overview_c.html .

For details about how to create a widget to install HATS, see the section, Lotus Notes, in the HATS User's and Administrator's Guide.

Lotus Expeditor Client

In the Lotus Expeditor Client environment application management and deployment can be controlled in a number of ways:

For more information see the Assembling and Deploying Lotus Expeditor Application section in the Lotus Expeditor Information Center at http://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp.

To install your HATS rich client application in a Lotus Expeditor Client environment, the client must be configured to access the update site containing the application. To do this, on the client system, from the Lotus Expeditor Client main menu select File > Application > Install.