Prerequisites

Prerequisite Installations

LoF Service Credentials

Make sure you have received the LoF Service credentials with client_id and client_secret

This is required to run the CCD service, Streamlit Demos and access APIs for Labs

Download and install Docker Desktop

• Download the Docker Desktop via https://www.docker.com/

• Install Docker

• Verify Docker is up and running the command docker --version You should see the docker version output like below image: Note: The docker version may vary depending on the installation.

• Enable Host Networking

  • Go to Docker Desktop --> Settings --> Resources --> Network

  • If you see the option Enable host networking

    • Make sure to select/enable it

    • Click Apply and Restart

Download and Install PgAdmin (Optional)

• For macOS: https://www.pgadmin.org/download/pgadmin-4-macos/

• For Windows: https://www.pgadmin.org/download/pgadmin-4-windows/

Download and Install Postman

https://www.postman.com/downloads/

GitHub CS595 Lab Repo

• Checkout CS595 Lab from GitHub Repo

CCD PostgreSQL DB

• Download the DB Zip file

• Copy the Zip file to <CS595 Lab Folder>/labs/ccd folder

• Extract the Zip file

Setup and Verify LOF Services

1. Open <Project Root>

2. Activate the python virtual environment

3. Go to lof folder

4. Edit .env file Update client_id and client_secret values with the credentials you have received

   client_id=
   client_secret=

5. Install Requirements pip install -r requirements.txt

6. Run services.py

   1. You should see the message : LoF Services verified successfully

Possible Error Messages and resolution:

1. Missing or Incorrect client_id

   1. Failed to get LoF auth token: 400 : {"error":"Invalid client ID"}

   2. Resolution: Update correct client_id in .env file

2. Missing or Incorrect client_secret

   1. Failed to get LoF auth token: 401 : {"error":"Unauthorized: Client authentication failed","status":401}

   2. Resolution: Update correct client_secret in .env file