bbb
/
stress-test
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'master'
${ noResults }
stress-test/README.md

1.8 KiB
Raw Permalink Blame History

A stress testing tool for BigBlueButton

Overview

This is a stress testing tool for BigBlueButton.

It simulates client activity in a BBB conference thanks to Puppeteer.

Getting Started

Preparation

  1. Clone this repository

  2. Run make bootstrap

  3. Update the generated .env file to specify BBB_URL and BBB_SECRET.
    You can get these values by running bbb-conf --secret on your BBB server.

Ready to launch your test?

  1. Manually start a meeting on your BBB server.

  2. Get the meeting ID by running make list-meetings

  3. Update your .env file to set the following variables :

    • BBB_MEETING_ID : the meeting ID
    • BBB_CLIENTS_LISTEN_ONLY: the number of simultaneous clients to connect in "Listen only" mode
    • BBB_CLIENTS_MIC : the number of simultaneous clients to connect with an active microphone
    • BBB_CLIENTS_WEBCAM : the number of simultaneous clients to connect with an active webcam and microphone
    • BBB_TEST_DURATION : the duration of the test in seconds

  4. Run make stress to launch the test suite

heroku

https://devcenter.heroku.com/articles/build-docker-images-heroku-yml

heroku login
heroku create --region eu bbb-stress-test
heroku stack:set container
git push heroku master

Change env with heroku config:set ENV=DATA.
Restart with heroku ps:restart.

Contributing

This project is intended to be community-driven, so please, do not hesitate to get in touch if you have any question related to our implementation or design decisions.

We try to raise our code quality standards and expect contributors to follow the recommandations from our handbook.

License

This work is released under the MIT License (see LICENSE).