image


How to Setup Local Couch DB and its linking with DolphinPOS APP?

(Apache CouchDB)

June-29-2020, Version V2.0

Contact information: support@dolphinpos.com


Index

Page#

Apache CouchDB Setup

2-9

Link with DolphinPOS APP

9-12

Apache CouchDB Setup


Step 1: Download .Net 3.5 frame work from below link and install it (ignore it if not installed).

https://dotnet.microsoft.com/download/dotnet-framework/thank-you/net35- sp1-web-installer


Step 2: Download Apache couchdb 2.3.1 (located at bottom of the page) from below link and install it.


https://couchdb.apache.org/


While installing it does ask about credentials to be applied, please do apply below settings.

Username: admin


Password: admin


And make to select the button “verify credentials”.

Step 3: Open the URL ”http://127.0.0.1:5984/_utils/” in the browser or launch it from the launch pad like below .Once Apache CoachDB is opened apply the login credentials from Step 2.


image


image


Step 4:



image


image


Step 5: Below are instructions for database creation.


  1. Go to “Databases” from the left panel

  2. Select “create Database”

  3. Database name “dolphin” { its case sensitive }

  4. Select “Non-partitioned”

  5. Trigger “Create”


    image



    image


    image


    Step 6:


    Go to “Permissions”, and delete “_admin” for both the Roles sections.


    image

    Step 7: Find the IP Address of the Local PC, on which Apache Couch DB is running.


    1. Go to “Control Panel” “Network and Internet” ” N/W and Sharing Center”.

    2. Click on Wi-Fi to which your PC is connected, then go to “Details” to find the IP4 address which will be assigned to Couch DB.



      image


      Another way to do the same is to go to, command prompt and type in the command IP config and press “Enter” key on the Keyboard. You can see the same IPv4 Address.

      Please Note it down.


      image


      How to connect to Local Apache Couch Database with the DolphinPOS APP?


      Step 1: Install the DolphinPOS APP from the App Store/ Test flight. Once you login you will be asked to choose 1 of 2 options. To have local Apache Couch DB follow below.

      1. First Select “Multi Connect”

      2. Enter IP Address ( from above listed procedure)

      3. Select “Connect” option.


image


Step 2: Perform the day start by selecting “OK” button


image


Step 3: You can verify and edit the server IP Address from home page by selecting more setup Replication Server IP


image

Step 4: Verification - On the Apache Couch DB side you should see some records like this since you have enabled the “day start” option.


image


Sample data of the record, where employee logined into DB with his/her details in the DolphinPOS APP.


image


Important: “make sure to turn ON the firewall, on the PC where couchdb server is installed, so that all ports will be opened out”