Commandes console : comprendre et débuter
Fonctionnement des consoles OpenSimulator 0.9.3.1, aide, portée, lecture et écriture.
Quelle console utiliser ?
En mode Grid, le processus ROBUST héberge des services centraux (comptes, login, Grid, assets) ; les simulateurs hébergent les régions, objets, scripts et terrain. Chaque commande ne fonctionne que si le composant qui l'enregistre est actif. En Standalone, les commandes de services et de région peuvent partager une console.
La bonne méthode pour retrouver une commande
Tapez help dans la console concernée. Si une commande issue d'une ancienne documentation n'est pas disponible dans votre version, vérifiez help et show modules avant de l'utiliser. Les consoles sont des interfaces d'administration ; elles ne sont pas des fenêtres de chat du viewer.
Attention à la région sélectionnée
Avec un moteur multi-régions, change region <nom> définit la région active pour certaines commandes. change region root remet la portée globale : plusieurs commandes pourraient alors concerner toutes les régions de ce processus. Pour une action destructive, affichez le contexte et vérifiez deux fois la portée.
Documents d'origine et niveau de vérification
La documentation officielle des commandes console couvre plusieurs générations d'OpenSimulator, dont certaines anciennes versions 0.7.x. Les commandes présentées ici sont rapprochées du code 0.9.3.1 ; les syntaxes anciennes doivent être vérifiées avant utilisation. Les commandes propres à un module doivent toujours être confirmées dans la console de ce module.
Commandes générales
| Option | Signification | Attention |
|---|---|---|
help | Lister les commandes et leurs aides | Lecture seule, recommandé en premier |
show info | Afficher des informations sur le processus | Selon la version et la console |
show version | Afficher la version réellement lancée | Important si la grille utilise un fork |
show uptime | Afficher la durée de fonctionnement | Lecture seule |
command-script <fichier> | Exécuter les commandes d'un fichier | L'effet cumulé peut être destructeur |
get log level | Consulter le niveau de logs console | Ne garantit pas la configuration des logs disque |
set log level <niveau> | Changer la verbosité de la console | Debug peut générer beaucoup de journaux |
quit | Arrêter le processus | Interruption du service, préparez la maintenance |
shutdown | Alternative à l'arrêt | Même risque que quit, vérifier dans help |
Simulateur : navigation et inspection
| Option | Signification | Attention |
|---|---|---|
change region <nom> | Cibler une région du simulateur | Vérifier la sélection avant les actions |
change region root | Revenir au contexte global | Peut changer la portée des commandes suivantes |
show modules | Afficher les modules du simulateur | Inspection uniquement |
show regions | Afficher les régions connues du moteur | Différent du service Grid de ROBUST |
show connections | Examiner les connexions clients | Éviter la diffusion de détails de sessions |
show circuits | Examiner les circuits d'agents | Résultats sensibles ; masquer les identifiants |
show http-handlers | Examiner les gestionnaires HTTP enregistrés | Ancienne documentation : vérifier disponibilité |
show threads | Examiner les threads de longue durée | Ne reflète pas nécessairement tout le threadpool |
show caps | Lister des URL de capacités | URLs de session potentiellement sensibles |
Sources et vérification
Les références sont la documentation officielle des commandes console et le code source OpenSimulator. Certaines commandes décrites sur le wiki officiel correspondent à d'anciennes versions. Des commandes supplémentaires et certaines syntaxes ont été vérifiées dans le code 0.9.3.1 lié ci-dessous.