Pliki konfiguracyjne

Przegląd

Ten dokument zawiera przegląd plików konfiguracyjnych BigBlueButton.

Zalecamy dokonanie zmian tylko w plikach override (/etc/bigbluebutton), aby podczas aktualizacji do nowszej wersji BigBlueButton zmiany konfiguracyjne nie zostały nadpisane przez nowe pakiety.

Lokalne nadpisania ustawień konfiguracyjnych

Począwszy od BigBlueButton 2.3 wiele plików konfiguracyjnych ma lokalne nadpisania, więc administrator może określić lokalne odpowiedniki. Zalecamy dokonanie zmian tylko w plikach override (/etc/bigbluebutton), aby podczas aktualizacji do nowszej wersji BigBlueButton zmiany konfiguracyjne nie zostały nadpisane przez nowe pakiety.

Tabela jest szersza od ekranu. Przewiń ją w poziomie.

W przypadku bbb-web.properties ustawieniami są para nazwa/wartość. Na przykład następujący bbb-web.properties zastępuje ustawienia bigbluebutton.web.serverURL i securitySalt (wspólny sekret).

#
# Use this file to override default entries in /usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties
#

bigbluebutton.web.serverURL=https://droplet-7162.meetbbb.com
securitySalt=UsanRxRk938d02cTWfAqSM9Cvin7bnzsREfqFfzpf2U

To zastąpienie zapewni, że bbb-web użyje powyższych wartości niezależnie od zmian wprowadzonych przez skrypty pakujące aktualizację.

W przypadku bbb-apps-akka i bbb-fsesl-akka plik ustawień ma format pokazany poniżej. Na przykład plik bbb-apps-akka.conf zastępuje ustawienia dla /usr/share/bbb-apps-akka/conf/application.conf.

// include default config from upstream
include "/usr/share/bbb-apps-akka/conf/application.conf"

// you can customize everything here. API endpoint and secret have to be changed
// This file will not be overridden by packages

services {
  bbbWebAPI="https://bbb.example.com/bigbluebutton/api"
  sharedSecret="UsanRxRk938d02cTWfAqSM9Cvin7bnzsREfqFfzpf2U"
}

Klient HTML5

Pliki konfiguracyjne

Dla bbb-html5.yml plik ustawień jest w formacie YAML. Każde ustawienie w tym pliku zastępuje odpowiednie ustawienie w /usr/share/bigbluebutton/html5-client/private/config/settings.yml. Na przykład następujący bbb-html5.yml zastępuje wartości public.kurento.screenshare.constraints.audio na true.

public:
  kurento:
    screenshare:
      constraints:
        audio: true

Pliki dziennika

Monitorowanie dziennika dzienników serwera (bbb-html5)

W BigBlueButton 3.0 zmodyfikowaliśmy architekturę, aby odsunąć obciążenie od starych pul bbb-html5 frontendu i backendu usługi. Logi nowych usług można znaleźć poprzez:

journalctl -f -u bbb-html5.service

Akka-apps jest odpowiedzialna za większość logiki, więc kluczowe informacje można uzyskać poprzez

journalctl -f -u bbb-apps-akka.service

SYSTEMD_LESS=FRXMK journalctl -u bbb-graphql-middleware.service -f też może się przydać.

Dzienniki wysyłane bezpośrednio od klienta

Aby pomóc w monitorowaniu i debugowaniu, klient HTML5 może wysyłać swoje logi do serwera BigBlueButton za pośrednictwem funkcji logger. Oto przykład jego użycia:

Rejestrator klienta akceptuje dwa cele dla logów: console i external.

Tabela jest szersza od ekranu. Przewiń ją w poziomie.

Wartości domyślne to:

clientLog:
  console:
    {
      enabled: true,
      level: debug,
      enableRuntimeErrorLogging: false,
    }
  external:
    {
      enabled: false,
      level: info,
      url: https://LOG_HOST/html5Log,
      method: POST,
      throttleInterval: 400,
      flushOnClose: true,
    }

Zauważ, że opcja external jest domyślnie wyłączona - możesz ją włączyć na własnym serwerze po kilku zmianach konfiguracyjnych.

Po włączeniu wyjścia rejestrowania external, klient BigBlueButton wyśle ​​zdarzenia dziennika w trybie POST do punktu końcowego adresu URL dostarczonego przez url. Aby utworzyć powiązany punkt końcowy na serwerze BigBlueButton dla żądania POST, utwórz plik /etc/bigbluebutton/nginx/html5-client-log.nginx o następującej zawartości:

location /html5Log {
    access_log /var/log/nginx/html5-client.log postdata;
    echo_read_request_body;
}

Następnie utwórz plik w /etc/nginx/conf.d/html5-client-log.conf o następującej zawartości:

log_format postdata '$remote_addr [$time_iso8601] $request_body';

Następnie zainstaluj pełną wersję nginx.

$ sudo apt-get install nginx-full

Konieczne może być również utworzenie zewnętrznego pliku wyjściowego i nadanie mu odpowiednich uprawnień i własności:

$ sudo touch /var/log/nginx/html5-client.log
$ sudo chown www-data:adm /var/log/nginx/html5-client.log
$ sudo chmod 640 /var/log/nginx/html5-client.log

Uruchom ponownie BigBlueButton za pomocą sudo bbb-conf --restart i uruchom klienta HTML5 BigBlueButton w nowej sesji. Powinieneś zobaczyć logi pojawiające się w /var/log/nginx/html5-client.log w następujący sposób:

99.239.102.0 [2018-09-09T14:59:10+00:00] [{\x22name: .. }]

Możesz śledzić logi na serwerze za pomocą komendy

$ tail -f /var/log/nginx/html5-client.log | sed -u -e 's/\\x22/"/g' -e 's/\\x5C/\\/g'

Oto przykładowy wpis dziennika

      "requesterUserId":"w_klfavdlkumj8",
      "fullname":"Ios",
      "confname":"Demo Meeting",
      "externUserID":"w_klfavdlkumj8"
   },
   "url":"https://demo.bigbluebutton.org/html5client/users",
   "userAgent":"Mozilla/5.0 (iPad; CPU OS 11_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/11.0 Mobile/15E148 Safari/604.1",
   "count":1
}

nginx

Pliki konfiguracyjne

Znajduje się w /etc/nginx/sites-enabled/bigbluebutton

To konfiguruje nginx do użyj /var/www/bigbluebutton-default/assets jako witryny domyślnej. (src)

Pliki dziennika

Tabela jest szersza od ekranu. Przewiń ją w poziomie.

bbb-web

Pliki konfiguracyjne

 /usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties
 /etc/bigbluebutton/bbb-web.properties

Jest to jeden z głównych plików konfiguracyjnych aplikacji BigBlueButton.

https://github.com/bigbluebutton/bigbluebutton/blob/v4.0.x-release/bigbluebutton-web/grails-app/conf/bigbluebutton.properties

Pliki dziennika

Zlokalizowane w /var/log/bigbluebutton/bbb-web

Tabela jest szersza od ekranu. Przewiń ją w poziomie.

FreeSWITCH

Pliki konfiguracyjne

/opt/freeswitch/conf/vars.xml

Ustaw wartości hosta i zewnętrznego adresu IP.

/opt/freeswitch/conf/autoload_configs/conference.conf.xml

Skonfiguruj właściwości konferencji głosowej.

/opt/freeswitch/conf/dialplan/default
/opt/freeswitch/conf/dialplan/public

Nagrywanie

Pliki dziennika

Dla każdego przepływu pracy i spotkania mamy inny plik dziennika, mają one postać: <workflow>-<meetingId>.log, jak określono poniżej:

Tabela jest szersza od ekranu. Przewiń ją w poziomie.