The following section provides information on configuring a Microsoft SQL server.

Configuring a Microsoft SQL Server:

A warning will appear:

If you use an external database, you cannot use the built-in cluster functionality of this EJBCA software appliance.

After saving the database configuration you cannot change to another database type.
To change the selected database type, you must reset your Software Appliance.

After you select your external database, fill in the required information.

The following configuration options are displayed:

Database Host

  1. Database IP Address / FQDN (required): Enter the IP address or the FQDN (Fully Qualified Domain Name) of the external Microsoft SQL Server host.

  2. Database Port: The default Port 1433 is displayed, if applicable adjust the port used by the database host.

  3. Database Instance: Enter the name of your database instance.

  4. Database Name: Enter the name of your database.

Database Authentication

  1. Database Username (required): Enter the username used to connect to the database.
  2. Database Password (required): Enter the password used to connect to the database.

Additional Settings

Here you can define additional properties. These are passed to the JDBC connector via the connection URL. These properties give you better control over the database connection.

Connector Properties:

  1. Name: Enter a property name.
  2. Value: Enter a value.
  3. Confirm your entries by clicking Add Property in the column Actions.

Connectivity Check

  • With Test Connection you can check if the connection to the external database server can be established with the given configuration data.

    If the connection test fails, an Error Message with further information is displayed.

  • The connection test could fail if you enter incorrect settings like: IP Address, Database Name or Wrong Password.

If the connection test was successful your settings with information like: Hostname, Server Version and Driver Version will be displayed in a table.
You can save the configuration with Save Configuration anytime.