How to configure an Documentum xDb (X-Hive/DB) Connection

 

Figure 13.16. The Configure Connection Dialog

The Configure Connection Dialog

 
  1. Go to Preferences -> Data Sources. In the Connections panel click the New button.

  2. Enter a unique name for this connection and select one of the previously configured Documentum xDb (X-Hive/DB) data sources from the Data Source combo box.

  3. Fill-in the Connection Details:

    URL

    The URL property for Documentum xDb (X-Hive/DB) connection. It is also called xhive.bootstrap and specifies the location of the Documentum xDb (X-Hive/DB) federation.

    This property can be used in two different ways:

    If the property is a URL of the form xhive://host:port, the Documentum xDb (X-Hive/DB) connection will attempt to connect to an Documentum xDb (X-Hive/DB) server running behind the specified TCP/IP port.

    If the property is the complete (or relative) path to an XhiveDatabase.bootstrap file, an Documentum xDb (X-Hive/DB) server will be started in the current JVM. Depending on the application, this can be much faster than using a remote server because the communication overhead is avoided. However, only one JVM can run an Documentum xDb (X-Hive/DB) server for a specific federation at the same time.

    For the second case (using a bootstrap file to connect) you need to add additional JAR files when you configure the data source.

    User

    User name to access the Documentum xDb (X-Hive/DB) database engine.

    Password

    Password to access the Documentum xDb (X-Hive/DB) database engine.

    Database

    The name of the database to access from the Documentum xDb (X-Hive/DB) database engine.

    Run XQuery in read/write session (with committing)

    If checked the Documentum xDb (X-Hive/DB) session ends with a commit, otherwise it ends with a rollback.

  4. Click OK.