...
Paramétrage interne au script
| Paramètre | Description | Valeur par défaut / Format |
|---|---|---|
| SCRIPT_BBB_SERVER_URL | Ancienne URL du serveur BigBlueButton/Scalelite | 'https://bbb.univ.fr/' |
| SCRIPT_BBB_SECRET_KEY | Clé BigBlueButton ou Scalelite LOADBALANCER_SECRET | 'xxxxxxxxxx' |
| SCRIPT_PLAYBACK_URL_23 | Est-ce que la version de BBB est supérieure à 2.3, vis-à-vis des URLs de playback ? Utile pour la lecture de présentations au format 2.0 (pour BBB <= 2.2) ou 2.3 (pour BBB >= 2.3) | True |
| SCRIPT_RECORDER_ID | Enregistreur utilisé pour obtenir les enregistrements BBB (utile avec --use-manual-claim) | 1 |
| SCRIPT_ADMIN_ID | Administrateur auquel les enregistrements seront ajoutés si les modérateurs n'ont pas été identifiés (utile avec --use-import-video) | 1 |
| DB_PARAMS | Paramètres de connexion à la base de données Moodle (utile avec --use-import-video et --use-database-moodle) | { 'host': 'bddmoodle.univ.fr', 'database': 'moodle', 'user': 'moodle', 'password': '', 'port': '', 'connect_timeout': '10' } |
| SCRIPT_INFORM | Message d'information qui sera défini dans la base de données Moodle, table mdl_bigbluebuttonbn, champ intro (utile avec --use-import-video et --use-database-moodle) | Message prévisionnel pour l'université de Montpellier |
Arguments du script
| Argument | Description | Valeur par défaut / Format |
|---|---|---|
| --use-manual-claim | Utiliser la revendication manuelle | False |
| --use-import-video | Utiliser le module d'importation vidéo pour obtenir des enregistrements | False |
| --use-database-moodle | Utiliser la base de données Moodle pour rechercher des modérateurs. N'est utile que lorsque --use-import-video a été mis à True. | False |
| --min-value-record-process | Valeur minimale des enregistrements à traiter | 1 |
| --max-value-record-process | Valeur maximale des enregistrements à traiter | 10000 |
| --dry | Simule ce qui sera réalisé | False |
Exemples et cas d'utilisation
Voici quelques exemples et cas d'utilisation de ce script, à ne lancer qu'après avoir réalisé le paramétrage interne. N'hésitez pas à faire des essais sur quelques lignes et d'utiliser le mode dry pour comprendre ce qui sera réalisé.
| Avertissement | ||
|---|---|---|
| ||
Comme dans toute migration, penser à réaliser les sauvegardes adéquates avant d'exécuter ce script sans simulation. Typiquement, à minima la base de données de Pod, voire la base de Moodle (si vous y accédez en écriture) dans le cas de --use_import-video et --use-database-moodle. |
Voici quelques exemples et cas d'utilisation de ce script, à ne lancer qu'après avoir réalisé le paramétrage interne. N'hésitez pas à faire des essais sur quelques lignes et d'utiliser le mode dry pour comprendre ce qui sera réalisé.
| Info |
|---|
Ne pas hésiter à ignorer le |
| Info |
Ne pas hésiter à ignorer le warnings en mettant -W ignore. |
...
| Info |
|---|
Avant de réaliser ces commandes, penser à exécuter ces requêtes (à adapter selon votre environnement) : cd /usr/local/django_projects/podv3 |
- Utilisation de la revendication pour tous les enregistrements, en simulation uniquement :
python -W ignore manage.py migrate_bbb_recordings --use-manual-claim --dry
...
- Utilisation de la revendication d'
...
- enregistrements pour seulement les 2 enregistrements les plus récents, en simulation uniquement :
...
- python -W ignore manage.py migrate_bbb_recordings --min-value-record-process=1
...
- --max-value-record-process=
...
- 2 --use-manual-claim --dry &
Info title Utilisation de Celery ou non ? Si vous utilisez les tâches asynchrones (CELERY_TO_ENCODE = True), sans le dry, cette commande va lancer 2 tâches d'encodage.
Si vous n'utilisez pas les tâches asynchrones (CELERY_TO_ENCODE = False), sans le dry, cette commande va réaliser directement l'encodage (sauf si le playback est au format vidéo bien entendu) de la 1° présentation, puis une fois celle-ci terminée, l'encodage de la 2° présentation.
Dans ce cas là, cela peut être long, d'où l'utilisation en arrière plan (via le & en fin de commande). - Utilisation du module d'importation vidéo externe, avec accès à la base de données Moodle pour tous les enregistrements, en simulation uniquement :
python -W ignore manage.py migrate_bbb_recordings --use-import-video --use-database-moodle --dryInfo title Pas d'encodage réalisé Sans le dry, cette commande va créer des lignes d'enregistrements externes dans la base de Pod, pour le module d'import des vidéos. Il n'y a alors aucun encodage qui est réalisé à ce moment.
Les usagers pourront retrouver ces enregistrements dans ce module d'import des vidéos et les téléverser sur Pod en tant que vidéo : c'est à ce moment que l'encodage sera réalisé.
- Utilisation du module d'importation vidéo externe,
...
- sans accès à la base de données Moodle pour
...
- les 10 enregistrements les plus récents, en simulation uniquement :
...
- python -W ignore manage.py migrate_bbb_recordings --min-value-record-process=1 --
...
- max-value-
...
- record-process=10 --use-
...
- import-
...
- video --dry
Exploitation
Interface d'administration
...