Install and Configure Apache CouchDB

About this task

Apache CouchDB is a document storage application that stores the documents used in discrete applications.

Plant Applications support Apache CouchDB 2.3.1.

To install Apache CouchDB, download CouchDB for Windows at http://archive.apache.org/dist/couchdb/binary/win/2.3.1/.

Note: If you experience problems while downloading the files from the Apache CouchDB website, then click here to download the files.

Use this procedure to install and configure ApacheCouchDB.

We recommend to install Apache CouchDB on the following nodes:

  • In Standard Edition Plant Applications, install Apache CouchDB on the Plant Applications Web Client node.
  • In Enterprise Edition Plant Applications, install Apache CouchDB on the Operations Hub node.

Procedure

  1. Right-click apache-couchdb, and then select Install.

    The Apache CouchDB Setup page appears.

  2. Select Next.

    The License Agreement page appears.

  3. Select the I accept the terms in the License Agreement checkbox, then select Next.

    The Installation Directory Warning page appears.

  4. Select Next.

    The Destination Folder page appears.

  5. Select Next to install Apache CouchDB to the default folder or select Change to select a different location in the Destination Folder window.

    The Ready to install Apache CouchDB page appears.

  6. Select Install.

    The Installing CouchDB page appears and displays the progress bar.

    When installation is complete, the Completed the Apache CouchDB Setup Wizard appears.

  7. Select Finish to close the setup wizard.
    Note:

    CouchDB uses 5986 for internal communications. If you are not able to access CouchDB, then verify if port 5986 is used by any other applications (for example, Azure Resource Manager uses port 5986). If it is used by other application then change the httpd port number from 5986 to 5987 in the default.ini file located under CouchDB/etc, then start the CouchDB service.

    Note: To authenticate users before accessing the documents database, you must manually set the option require_valid_user to True under Configuration settings of CouchDB.