rayoffiah / mobile-travel-sample Goto Github PK

This is a step-by-step tutorial describing a Travel application for mobile platforms that supports the following capabilities

• Users can search and make flight reservations via the Couchbase Lite enabled mobile/desktop applications or through the Python web application.

  • Flight reservations made on the Couchbase Lite enabled mobile and desktop apps are available even when the app is disconnected from the server.

• Flight reservations made via any of the client apps will be automatically synced over to the remaining clients through the Sync Gateway

• Users will also be able to do a Full text Search for hotels via Couchbase Lite enabled mobile/desktop applications or through the Python web application

In addition, the Couchbase Lite enabled mobile/desktop applications mobile/desktop apps support the following functionality -

• Users can fetch listing of hotels from the Python web backend via a REST endpoint.

• Users can bookmark (and unbookmark) the hotels

• Bookmarked hotels stored locally and available even when the app is disconnected from the server.

Windows Users : If you are developing on Windows, use a Windows 10 machine. Also, note that you should also have administrative privileges on the Windows box so you can authorize the installation and running of the required executables.

• Visual C 2017 (*only Windows Users*): must install the Microsoft Visual C Compiler for Python Downloadable from here.

• Python 3.4+: downloadable from python.org. This should come packaged with pip3

  Windows Users : If you are developing on Windows, make sure that Python is included in your system’s PATH environment variable. You can follow instructions here to set your PATH variable.

• Git: downloadable from git-scm.org.

• Clone the "master" branch of the workshop source from GitHub. We are doing a shallow pull with depth as 1 to speed the cloning process.

  git clone -b master --depth 1 https://github.com/couchbaselabs/mobile-travel-sample.git

In this lesson, you will install and launch v7.1.x of Couchbase Server.

Screenshots below apply to Couchbase Server 7.1.1 and there will be some variation with CBS 7.0.x. However, equivalent functionality is available in earlier versions of server. Refer to documentation for compatible server versions.

Apple M1 Users: Install and launch v7.1.1 or later

If there is a later version available, you can download it as well bearing in mind that the instructions have been validated with the version that is specified in instructions below.

• Download and install v7.1.1 of Couchbase Server. Follow the instructions specified in the appropriate platform specific install guide to install the same.

• On the setup wizard, create an Administrator account with the user Administrator and password as password.

• As you follow the download instructions and setup wizard, make sure you keep all the services (data, query, and index) selected.

• Install the sample bucket named travel-sample because it contains the data used in this tutorial. You can add the bucket from the "Sample Buckets" tab in the "Settings" menu in the admin console.

• Create an RBAC user named admin with password password and Application Access to the travel-sample bucket. You can do this from the "Security" menu. These credentials will be used by the Sync Gateway to access the documents in this bucket.

• Create a Full text search index on travel-sample bucket called 'hotels'. You can do this from the "Search" menu. Just go with default index settings.

Try it out

• Launch Couchbase Server (if not already runnning)

• Log into the "Admin Console" (http://localhost:8091) with appropriate Administrator credentials you created during installation

• Select the "Buckets" option from the menu on the left

• Verify that you have around 31,000 documents in your travel-sample bucket

In this section, you will install and launch version 3.0.3 of Sync Gateway.

• Download Sync Gateway 3.0.3 from here for your platform.

• The Sync Gateway will have to be launched with the config file named sync-gateway-config-travelsample.json that you should have downloaded as per the instructions in the Workshop Repo section. The config file will be located in /path/to/mobile-travel-sample.

• Open the sync-gateway-config-travelsample-<platform>.json and confirm that the RBAC user credentials configured on the Couchbase Server are used by Sync Gateway for accessing the bucket

  "username": "admin",
  "password": "password",

• Launch the Sync Gateway.

  macOS

  $ cd /path/to/couchbase-sync-gateway/bin
  $ ./sync_gateway /path/to/mobile-travel-sample/sync-gateway-config-travelsample-<platform>.json

  Windows

  By default, the Sync Gateway service will install with serviceconfig.json as the configuration file at C:\Program%20Files\Couchbase\Sync%20Gateway\serviceconfig.json.

  The Sync Gateway will have to be launched with the config file named sync-gateway-config-travelsample.json that you should have downloaded as per the instructions in the Workshop Repo section. The config file will be located in C:/path/to/mobile-travel-sample.

  Open the sync-gateway-config-travelsample.json and confirm that the RBAC user credentials configured on the Couchbase Server are used by Sync Gateway for accessing the bucket.

  "username": "admin",
  "password": "password",

• Stop the Sync Gateway service (since it would be launched with the default version of config file). To stop the service, you can use the Services application (Control Panel -→ Admin Tools -→ Services).

• Replace the serviceconfig.json file with the sync-gateway-config-travelsample.json

  $ copy c:/path/to/mobile-travel-sample/sync-gateway-config-travelsample.json "C:\Program Files\Couchbase\Sync Gateway\serviceconfig.json"

• Start the Sync Gateway service with the new version of serviceconfig.json file. To start the service, you can use the Services application (Control Panel -→ Admin Tools -→ Services).

Try it out

• Access this URL http://127.0.0.1:4984 in your browser

• Verify that you get JSON response similar to one below json {"couchdb":"Welcome","vendor":{"name":"Couchbase Sync Gateway","version":"2.7"},"version":"Couchbase Sync Gateway/2.7.0(271;bf3ddf6) EE"}