DB Server Setup Procedure

General

Roommates DB server serves as the unit for organizing collections of data relevant to the operation of the Roommates platform. It interacts with the back-end unit and provides it load/store capabilities. The database program used by Roommates platform is MongoDB which uses JSON like documents (more information about MongoDB is available on our Wiki). The following document describes the setup procedure of the unit.

Pre-requisites

• A machine with Linux Ubuntu 16.04 and root privileges
• ubuntu_16_04_db_server_automated_deployment.sh script (available as part of the project. Browse the deployment directory).
• Internet connectivity.

Procedure

• Copy the ubuntu_16_04_db_server_automated_deployment.sh script to a temp location on the Ubuntu machine.

• Provide the script with execution permissions by the following command:

  chmod +x ubuntu_16_04_db_server_automated_deployment.sh

• Run the script as a Root by the following command:

  sudo ./ubuntu_16_04_db_server_automated_deployment.sh

• The script will download and install MongoDB program with all the dependencies. Make sure that you have an internet connectivity.

• Once installed, you will be prompted for the desired configuration.

• The first configuration you will be asked for is the port you wish the DB program will listen on. You can choose any available port on the system which isn't reserved (we recommend using the default one – 27017).

• Then the script is going to ask you whether you want to allow remote connections – please choose yes if the roommates back-end server is stored separately (to allow the communication between the modules).

• Wait until the configuration finishes. Make sure that you are prompted that the installation completed successfully.

Firewall

• Configure your firewall (the one that protecting the Ubuntu machine) to allow TCP connections in/out to/from the chosen port (the same as provided during the configuration). Note! This step is required only if the roommates back-end server is stored separately.