Wprowadzenie
bbb-conf to narzędzie konfiguracyjne BigBlueButton. Ułatwia modyfikację części konfiguracji BigBlueButton, zarządzanie systemem BigBlueButton (start/stop/reset) i rozwiązywanie potencjalnych problemów z konfiguracją.
Jako uwaga historyczna, narzędzie to powstało na wczesnym etapie rozwoju BigBlueButton. Główni programiści napisali to narzędzie, aby szybko aktualizować pliki konfiguracyjne BigBlueButton na potrzeby instalacji i testowania.
bbb-conf znajduje się w /usr/bin/bbb-conf. Jeśli jesteś programistą, zalecamy przejrzenie kodu źródłowego bbb-conf (jest to skrypt powłoki), ponieważ pomoże ci to zrozumieć różne komponenty BigBlueButton i sposób ich współpracy (zobacz także Przegląd architektury).
Opcje
Jeśli wpiszesz bbb-conf bez parametrów, wydrukowana zostanie lista dostępnych opcji.
$ bbb-conf
BigBlueButton Configuration Utility - Version 2.5.2
bbb-conf [options]
Configuration:
--version Display BigBlueButton version (packages)
--setip <IP/hostname> Set IP/hostname for BigBlueButton
--setsecret <secret> Change the shared secret in /etc/bigbluebutton/bbb-web.properties
Monitoring:
--check Check configuration files and processes for problems
--debug Scan the log files for error messages
--watch Scan the log files for error messages every 2 seconds
--network View network connections on 80, 443 and 1935 by IP address. 1935 is deprecated. You will need to modify bbb-conf if you have custom ports.
--secret View the URL and shared secret for the server
--lti View the URL and secret for LTI (if installed)
Administration:
--restart Restart BigBlueButton
--stop Stop BigBlueButton
--start Start BigBlueButton
--clean Restart and clean all log files
--status Display running status of components
--zip Zip up log files for reporting an error
Uruchamiasz bbb-conf jako zwykły użytkownik. Jeśli określone polecenie wymaga uruchomienia BigBlueButton jako root, wyświetli komunikat o treści you need to run this command as root. Poniżej znajduje się opis różnych poleceń.
--version
Pokazuje wersję BigBlueButton zainstalowaną na serwerze oraz wersje komponentów BigBlueButton.
--setip <hostname_or_ip>
Ustawia adres IP/nazwę hosta dla konfiguracji BigBlueButton. Na przykład, jeśli Twój serwer BigBlueButton ma adres IP 192.168.0.211, możesz zmienić pliki konfiguracyjne BigBlueButton tak, aby używał tego adresu IP za pomocą polecenia
$ sudo bbb-conf --setip 192.168.0.211
lub, jeśli chcesz użyć nazwy hosta bbb.mybbbserver.com, użyj polecenia
$ sudo bbb-conf --setip bbb.mybbbserver.com
--clean
Ponownie uruchamia BigBlueButton i czyści wszystkie pliki dziennika podczas ponownego uruchamiania. Jest to dobre do debugowania, ponieważ usuwa poprzednie błędy w plikach dziennika.
--check
Przeprowadza serię kontroli bieżącej konfiguracji i zgłasza wszelkie potencjalne problemy. Nie wszystkie zgłaszane problemy są rzeczywistymi problemami. Na przykład, jeśli użyjesz --setip <hostname_or_IP>, wówczas bbb-conf zgłosi skargę, że nazwa hosta nie pasuje do adresu IP serwera, ale nie ma w tym nic złego, ponieważ skonfigurowałeś serwer BigBlueButton tak, aby nasłuchiwał nazwy hosta zamiast adresu IP.
--debug
Przegląda różne pliki dziennika w poszukiwaniu błędów (takich jak wyjątki w plikach dziennika Java dla Tomcat).
--network
To polecenie pokazuje liczbę aktywnych połączeń dla portów 80 (HTTP) i 443 (HTTPS) dla każdego zdalnego adresu IP.
--secret
Wyświetla aktualną sól zabezpieczeń dla API BigBlueButton. Na przykład:
$ bbb-conf --secret
URL: http://192.168.0.35/bigbluebutton/
Salt: f6c72afaaae95faa28c3fd90e39e7e6e
--setsecret <new_secret>
Przypisuje nowy sekret bezpieczeństwa dla API BigBlueButton.
--start
Uruchamia wszystkie procesy BigBlueButton.
--stop
Zatrzymuje wszystkie procesy BigBlueButton.
--watch
Sprawdza pliki dziennika pod kątem komunikatów o błędach co 2 sekundy. Użyj tego polecenia po sudo bbb-conf --clean, aby wyczyścić wszystkie pliki dziennika.
--zip
Pakuje pliki dziennika w celu zgłoszenia błędu. Ta opcja jest rzadko używana, ponieważ często łatwiej jest użyć programu pastebin do udostępnienia dziennika komunikatu o błędzie, jeśli na przykład wysyłasz post na listę mailingową bigbluebutton-dev.