Bind the Certificates to Apache CouchDB

Before you begin

  • Verify that you have installed Apache CouchDB on a Windows machine.
  • Ensure that you have retrieved the self-signed certificates such as server.crt and server.key, and then copied the certificates to the Apache CouchDB folder.

About this task

By default CouchDB runs on HTTP, you must configure the settings to run CouchDB on HTTPS. To configure the HTTPS, use the self-signed or signed certificates and perform the following steps:

Procedure

  1. In a machine where CouchDB is installed, mount the ISO file for the Plant Applications Web Client or load the DVD if you created one from the ISO file for Plant Applications.
  2. From the ISO root folder, right-click the config_couchDB.bat file, and then select Run as administrator.

    The command prompt window appears and prompts you for inputs.

  3. Enter details for the following:
    • Path of the certificate file where Apache CouchDB is installed. For example, C:\Program Files\CouchDB\certs\server.crt.
    • Path of the key file Apache CouchDB is installed. For example, C:\Program Files\CouchDB\certs\server.key.
    • Path where the Apache CouchDB is installed. For example, C:\Program Files\CouchDB.

    The Apache CouchDB settings are successfully configured, when the system does not display any error message and the command prompt window closes.

    Note:
    • To configure CouchDB with SSL, use certificates issued to the CouchDB server (machine) name.
  4. To verify that CouchDB runs on HTTPS and port number 6984, in a compatible web browser, type https://<host name or IP address of Apache CouchDB>:<port number>/_utils/. For example, https://host name or IP address of CouchDB:6984/_utils/. Ensure that you use the fully qualified domain name or the IP address.