Lobby

A lobby for dynamically joining individual students into shared socket rooms.

Parameters

Configuration parameters are all currently located near the top of file lobby.py. Parameter names with sample values are shown below.

• targetUsersPerRoom = 4 # Target/optimal # of users for room assignment
• minUsersPerRoom = 2 # Min users for suboptimal room assignment
• maxUsersPerRoom = 5 # Max users per room
• maxWaitTimeForSubOptimalAssignment = 10 # After user waits N seconds, attempt suboptimal assignment
• maxWaitTimeUntilGiveUp = 120 # Max seconds before giving up on assigning user to a room
• maxRoomAgeForNewUsers = 300 # Max room age (sec) after which no longer acccept new users
• fillRoomsUnderTarget = True # Fill any rooms with < target users before creating new room
• overFillRooms = True # For suboptimal assignment, whether to overfill rooms (limited to maxUsersPerRoom)
• urlPrefix = "http://bazaar.lti.cs.cmu.edu/room" # A prefix for the room assignment URL
• roomPrefix = "room" # A prefix for each room number.
• nextRoomNum = 0 # The number after this will be the first room number assigned.

To run

• Download the repo.
• Navigate to the top level of the downloaded repo.
• Enter the following command:
  • docker compose up --build -d