Using the Connectors Tab

The sub-tabs in the Connectors tab allow you to configure local and remote Enterprise Connectors (JCR repositories).

For details on creating Enterprise Connectors, see the Sun Java System Mobile Enterprise Platform 1.0 Developer’s Guide for Enterprise Connectors.

An Enterprise Connector is a JCR repository, which is a software module that sits between the MEP Gateway and an EIS/EAI system or a database. It is responsible for executing CRUD operations (create, retrieve, update, and delete) on one or more business objects available in an EIS/EAI system or database. A local Enterprise Connector is available in the same Java Virtual Machine (JVM) as the MEP Gateway; a remote Enterprise Connector runs on a different server and connects with the MEP Gateway by means of a web services interface.

The installer automatically creates several Enterprise Connectors. These are created as local Enterprise Connectors in a single-tier installation and as remote Enterprise Connectors in a two-tier installation.

This section describes the following tasks:

• Creating, Activating, and Deleting Enterprise Connectors

• Configuring Enterprise Connectors

shows the Connectors tab.

Figure 1–3 Connectors Tab

Creating, Activating, and Deleting Enterprise Connectors

The Usage sub-tab lists all the current Enterprise Connectors. The Active checkbox is selected for all Enterprise Connectors that have been activated. This section describes how to create, activate, or delete either a local or a remote Enterprise Connectors.

• To Create and Activate a New Enterprise Connector

• To Delete an Enterprise Connector

• To Activate or Deactivate an Existing Enterprise Connector

To Create and Activate a New Enterprise Connector

In the Local Enterprise Connectors panel or the Remote Enterprise Connectors panel, follow these steps.

1. In the Name text field, type the name of the Enterprise Connector.

2. Click Add.

   The new Enterprise Connector appears in the list of repositories. The Active checkbox is selected by default, indicating that the Enterprise Connector has been activated.

   A new sub-tab for the Enterprise Connector appears. You can now configure the new Enterprise Connector.

To Delete an Enterprise Connector

Before you delete a local Enterprise Connector, delete all users associated with the remote Enterprise Connector you want to delete. See Using the Users Tab for details.

In the Local Enterprise Connectors panel or the Enterprise Connectors panel, perform the following action.

1. Click the Delete button for the Enterprise Connector you want to delete.

   The sub-tab for the deleted Enterprise Connector no longer appears.

To Activate or Deactivate an Existing Enterprise Connector

In the Local Enterprise Connectors panel or the Remote Enterprise Connectors panel, follow these steps.

1. Select or deselect the Active checkbox for the Enterprise Connector whose status you wish to change.

2. Click Save to save your changes.

Configuring Enterprise Connectors

Use the sub-tab for an Enterprise Connector to perform the following tasks:

• To Configure a Local Enterprise Connector

• To Configure a Remote Enterprise Connector

Figure 1–3 shows the sub-tab for the MusicDB Enterprise Connector.

Figure 1–4 Enterprise Connector Configuration Sub-tab

To Configure a Local Enterprise Connector

To add or edit the settings and properties for a local Enterprise Connector, follow these steps.

1. In the Local Enterprise Connector Properties panel, specify a value for the business-object-provider property.

   This value is the class name of the Enterprise Connector's implementation of the com.sun.mep.connector.api.BusinessObjectProvider class. For MusicDB, for example, the value is com.sun.mep.connector.jdbc.album.MusicAlbumProvider.

2. Click Save in the Local Enterprise Connector Properties panel.

3. In the Name field of the Local Enterprise Connector Settings panel, edit the name of the Enterprise Connector.

   The Name field contains the name of the Enterprise Connector that was specified when it was created.

4. In the Class/JNDI Name field for a local Enterprise Connector, type or edit the class name or JNDI name of the Enterprise Connector.

   This field specifies the class that implements the Enterprise Connector. If the Enterprise Connector is based on the Enterprise Connector Business Object (ECBO) library, the class name is com.sun.mep.connector.jcr.DbRepository.

5. In the Workspace Name field, type or edit the name of the workspace for the Enterprise Connector.

   The workspace name should be the same as the name specified for the workspace element in the resource file for the Enterprise Connector.

   The other fields in this panel (Remote DB Name, Content Type, Register With URL, and Default URL) are not used for MEP.

6. Click Save in the Local Enterprise Connector Settings panel.

To Configure a Remote Enterprise Connector

To add or edit the settings and properties for a remote Enterprise Connector, follow these steps.

1. In the Remote Enterprise Connector Properties panel, specify values for the properties used by the remote Enterprise Connector.

   The following table shows the properties and values that are normally specified.

   Name	Value
   ws.request.timeout	60s
   ws.cache.ttl	5m
   business-object-provider	com.sun.mep.connector.jdbc.album.MusicAlbumProvider (or the equivalent class for your Enterprise Connector)
   ws.coalesce.max	5
   ws.cache.spanSessions	false
   ws.connect.timeout	60s
   ws.endpoint.url	http://hostname:port-value/ds-jcr-webservice-server/SynchronicaUDCService
   ws.coalesce.period	20ms

2. Click Save in the Remote Enterprise Connector Properties panel.

3. In the Name field of the Remote Enterprise Connector Settings panel, edit the name of the Enterprise Connector.

   The Name field contains the name of the Enterprise Connector that was specified when it was created.

4. In the WS Endpoint URL field, type or edit the URL of the web service through which you access the remote Enterprise Connector.

   This URL has the following format:

   http://hostname:port-value/ds-jcr-webservice-server/SynchronicaUDCService

   where hostname is the name of the remote system, and port-value is the HTTP port (usually 8080 or 8181).

5. In the Workspace Name field, type or edit the name of the workspace for the Enterprise Connector.

   The workspace name should be the same as the name specified for the workspace element in the resource file for the Enterprise Connector.

   The other fields in this panel (Remote DB Name, Content Type, Register With URL, and Default URL) are not used for MEP.

6. Click Save in the Remote Enterprise Connector Settings panel.