Manual update of the CouchDB

The session database on Pointsharp Access Gateway is used to share session information, memory cache, between multiple processes/servers. The database used to handle this is Apache CouchDB.

This guide describes how to manually update the CouchDB on the Gateway Server if needed.

Download new version

Download the latest version (or any specific version suggested by Pointsharp Support) from the Apache website.

Database user

Before uninstallation of current version:

  1. Open the Access Gateway Admin GUI and go to Database on the left-hand side.

  2. Note the Username. If not changed, it is by default psadmin. Take note if any other name is used.

    session database

  3. Now proceed with uninstalling the current CouchDB.

Installation of new version

  1. The CouchDB MUST be installed on this location C:\CouchDB.

  2. If a question about cookies pops up during the installation, choose to create it automatically.

  3. Enter the psadmin (or if any other is used) as a user, and a password when prompted.

After installation

  1. Open the Access Gateway Admin GUI and go to Database on the left-hand side.

  2. Enter the password set during installation.

  3. Click Publish.

The upgrade of the CouchDB is now completed.