Embed Size (px)
Citation preview
Local Apache Couch Data Base setup for DolphinPOS APP
DolphinPOS User Guide Page 1
How to Setup Local Couch DB and its linking with
DolphinPOS APP?
(Apache CouchDB)
June-29-2020, Version V2.0
Contact information: [email protected]
Index Page#
Apache CouchDB Setup 2-9
Link with DolphinPOS APP 9-12
Local Apache Couch Data Base setup for DolphinPOS APP
DolphinPOS User Guide Page 2
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”.
Local Apache Couch Data Base setup for DolphinPOS APP
DolphinPOS User Guide Page 3
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.
Local Apache Couch Data Base setup for DolphinPOS APP
DolphinPOS User Guide Page 4
Step 4:
Go to “Configuration” from the left panel
o Under “main config”
Change “bind_address” to 0.0.0.0 and trigger the green button
to Save
Make sure “port” number is “5984”
o CORS
It should say “CORS is currently enabled”
“All domains” should be selected
Local Apache Couch Data Base setup for DolphinPOS APP
DolphinPOS User Guide Page 5
Step 5: Below are instructions for database creation.
I. Go to “Databases” from the left panel
II. Select “create Database”
Local Apache Couch Data Base setup for DolphinPOS APP
DolphinPOS User Guide Page 6
III. Database name “dolphin” { its case sensitive }
IV. Select “Non-partitioned”
V. Trigger “Create”
Local Apache Couch Data Base setup for DolphinPOS APP
DolphinPOS User Guide Page 7
Step 6:
Go to “Permissions”, and delete “_admin” for both the Roles sections.
Local Apache Couch Data Base setup for DolphinPOS APP
DolphinPOS User Guide Page 8
Step 7: Find the IP Address of the Local PC, on which Apache Couch DB is running.
a) Go to “Control Panel” “Network and Internet” ” N/W and Sharing
Center”.
b) 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.
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.
Local Apache Couch Data Base setup for DolphinPOS APP
DolphinPOS User Guide Page 9
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.
I. First Select “Multi Connect”
II. Enter IP Address ( from above listed procedure)
III. Select “Connect” option.
Local Apache Couch Data Base setup for DolphinPOS APP
DolphinPOS User Guide Page 10
Step 2: Perform the day start by selecting “OK” button
Local Apache Couch Data Base setup for DolphinPOS APP
DolphinPOS User Guide Page 11
Step 3: You can verify and edit the server IP Address from home page by
selecting more setup Replication Server IP
Local Apache Couch Data Base setup for DolphinPOS APP
DolphinPOS User Guide Page 12
Step 4: Verification - On the Apache Couch DB side you should see some records like
this since you have enabled the “day start” option.
Sample data of the record, where employee logined into DB with his/her details in
the DolphinPOS APP.
Important: “make sure to turn ON the firewall, on the PC where couchdb server is
installed, so that all ports will be opened out”
