...
Ceci est possible en utilisant le paramètre --use-import-video, le paramètre --use-database-moodle (optionnel) et la configuration directement dans ce fichier.
Ce script vous permet également de :
- 3° possibilité, à partir de pod 3.6.0, vous pouvez aussi faire uniquement un export au format CSV de la liste des enregistrements BBB (ce qui vous permet de traiter ensuite ces derniers par ailleurs)
Ceci est possible en utilisant le paramètre --use-export-csv, le paramètre --use-database-moodle (optionnel) et la configuration directement dans ce fichier.
Ce script vous permet également de :
- simuler ce qui sera fait via le paramètre --dry
- de ne traiter que certaines lignes via les paramètres --min-value-record-simuler ce qui sera fait via le paramètre --dry
de ne traiter que certaines lignes via les paramètres --min-value-record-process et --max-value-record-process.
...
| 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) A partir de Pod 3.6.0, il s'agit d'un dictionnaire dont la clé est le champ bbb-origin-server-name de chaque enregistrement BBB.Si vous n'avez qu'un seul serveur Moodle, remplissez simplement le "default". | Pod 3.5.2 : 'host': 'bddmoodle.univ.fr', '{'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
...
Pod 3.6.0 : | ||
| 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 |
| IGNORED_SERVERS | Une liste de serveurs à ignorer (soi ce ne sont pas des serveurs Moodle, soit ce sont des serveurs de dev ou de test...) | ["not-a-moodle.univ.fr"] |
| USE_CACHE | Utile si vous relancez plusieurs fois le script d'affilée. En mettant USE_CACHE=True, il n'interrogera plus BBB mais la dernière réponse de ce dernier stockée dans un fichier XML | False |
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 |
--use-export-csv | Exporte la liste des enregistrements au format CSV. Ajouter --use-database-moodle pour noter dans une colonne les modérateurs. | False |
Exemples et cas d'utilisation
| 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 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 :
Bloc de code language bash 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 :
Bloc de code language bash 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
Exemples et cas d'utilisation
| 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 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 :
Bloc de code language bash 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 :
Bloc de code language bash python -W ignore manage.py migrate_bbb_recordings --min-value-record-process=1migrate_bbb_recordings --maxuse-value-record-process=2import-video --use-manualdatabase-claimmoodle --dry &
Info title Utilisation de Celery ou non ? title Pas d'encodage réalisé Sans
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)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, avec sans accès à la base de données Moodle pour tous les 10 enregistrements les plus récents, en simulation uniquement :
Bloc de code language bash python -W ignore manage.py migrate_bbb_recordings --usemin-value-importrecord-videoprocess=1 --usemax-value-databaserecord-moodle --dry
Info 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é.process=10 --use-import-video --dry
- Utilisation du module d'importation vidéo externe, sans export CSV, avec accès à la base de données Moodle pour les 10 enregistrements les plus récents, en simulation uniquement :
Bloc de code language bash pythonpython3 -W ignore manage.py migrate_bbb_recordings --use_export_csv -min-valueuse-recorddatabase-process=1moodle --max-value-record-process=10 --use-import-video --dry
Exploitation
Sortie du script migrate_bbb_recordings
...