Windows: Create Region and Cross-Region Data Sources for PostgreSQL

Attention: This feature is in Early Adopter Product (EAP) release status. We will continue the development of additional features and provide additional interfaces via patch updates and future releases. Please contact Micro Focus SupportLine if you require further clarification.

Use these steps to create data sources on a Windows platform.

  1. Open the ODBC Data Source Administrator.
    Tip: On most newer Windows versions, click the Start Menu button, type ODBC, and then select the appropriate desktop app.
  2. On the ODBC Data Source Administrator dialog box, select the System DSN tab.
  3. Add the mandatory data sources:
    Note: In order to create or query databases, you must have an active data source connection to the postgres database. If this connection already exists, you can skip this step:
    1. Click Add.
    2. Select the appropriate ODBC driver for your database (for example, PostgreSQL ODBC Driver (ANSI) is a common one for PostgreSQL), and click Finish.
      Note: If you are planning to run both 32-bit and 64-bit applications, you are required to install an ODBC driver for each bitism.

      The PostgreSQL setup dialog box appears.

    3. In the Data Source and Description fields, enter a name and description for the data source.
      Tip: Make a note of the name, as you will need it later when configuring the MFDBFH.cfg configuration file.
    4. In the Database field, type postgres.
    5. In the Server and Port fields, enter the server name and port.
    6. In the User Name and Password fields, enter a set of valid user credentials.
    7. Click Test.

      The connection should be successful; if not, it indicates that you have a problem with your PostgreSQL installation, and should consult the vendor instructions to troubleshoot before proceeding any further.

    8. Click Save.
  4. Add a new data source for a region database:
    1. Click Add.
    2. Select the appropriate ODBC driver for your database (for example, PostgreSQL ODBC Driver (ANSI) is a common one for PostgreSQL), and click Finish.
      Note: The bitism of your driver must match the bitism of the application that will use it.

      The Create New Data Source... wizard appears.

    3. Enter a name and description for the data source, and the name of the server on which the database will reside.
    4. Click Next twice.
    5. Select the Change the default database to: option, and using the region database-specific notation, enter a database name:
      MicroFocus$CAS$Region$<region-name>

      where <region-name> is the name of the enterprise server region whose files are to be stored in the database.

    6. Click Next, and then click Finish.

      An overview of the data source details is displayed.

      Note: As the database does not yet exist, you will not be able to test the data source: do not click Test Data Source.
    7. Click OK.

      The ODBC Data Source Administrator dialog box appears again.

  5. Add a new data source for a cross-region database:
    1. Click Add.
    2. Select the appropriate ODBC driver for your database (for example, PostgreSQL ODBC Driver (ANSI) is a common one for PostgreSQL), and click Finish.
      Note: The bitism of your driver must match the bitism of the application that will use it.

      The Create New Data Source... wizard appears.

    3. Enter a name and description for the data source, and the name of the server on which the database will reside.
    4. Click Next twice.
    5. Select the Change the default database to: option, and using the cross-region database-specific notation, enter a database name:
      MicroFocus$CAS$CrossRegion
    6. Click Next, and then click Finish.

      An overview of the data source details is displayed.

      Note: As the database does not yet exist, you will not be able to test the data source: do not click Test Data Source.
    7. Click OK.

      The ODBC Data Source Administrator dialog box appears again.

  6. Click OK.

    The data sources for a region and a cross-region database are configured.