Home

Welcome to the ScrumLords wiki!

To get started with the weather forecast app, you'll need to run all the backend servers first, followed by creating pubsub topics and subscriptions using Google Pubsub emulator, and finally the frontend.

For starters, you'll need to open 7 tabs in your terminal, first 5 of which should be cd'd to each of the backend services: manager, session_manager, weather_data_retrieval, model_execution and post_processing. The remaining two tabs should both be cd'd into manager service: one will be responsible for running the pubsub emulator, with the other one running the pubsub setup script that creates the topics and subscriptions.

Each of the 7 tabs above need to opened in a conda environment (highly suggest) and/or a virtual environment (virtualenv) called manager. Once the environment is created, activate it using:

conda activate manager

In the first tab, after activating the environment, run this one-time command:

pip install -r requirements-dev.txt

This will make sure all required python packages are installed and ready to use.

The next step would be to start each server. In each of the first 4 tabs, depending on your OS and shell type, run:

zsh runserver.sh or bash runserver.sh or ./runserver.sh or sudo ./runserver.sh

For the 5th tab, i.e. the post_processing service, assuming that your machine has java installed, run the following command to start the server:

./mvnw spring-boot:run

If you've reached till this step, you're doing great! You're more than halfway there.

The next step is to turn on the pubsub emulator and create the topics and subscriptions. For that, you need to have gcloud (Google Cloud SDK) installed on your machine. Most likely you won't have that pre-installed, so instructions on how to do that are given here. Once you have gcloud up and running, you'll need to run the following command to start the local emulator in the 7th tab:

gcloud beta emulators pubsub start

The above command should start running the emulator on port 8085. Next step is to run the following command in the 6th tab, again depending on your OS and shell type:

zsh pubsub_setup.sh or bash pubsub_setup.sh or ./pubsub_setup.sh or sudo ./pubsub_setup.sh

That's it! The backend is ready to roll.

For frontend...