OpenSimulator · FR

Commandes console : comprendre et débuter

Fonctionnement des consoles OpenSimulator 0.9.3.1, aide, portée, lecture et écriture.

Référence : OpenSimulator 0.9.3.1. Certaines commandes documentées pour les anciennes versions (notamment 0.7.x) ont pu évoluer : vérifier help et les modules réellement chargés. Sauvegarder avant toute opération d'écriture ou de suppression.

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

OptionSignificationAttention
helpLister les commandes et leurs aidesLecture seule, recommandé en premier
show infoAfficher des informations sur le processusSelon la version et la console
show versionAfficher la version réellement lancéeImportant si la grille utilise un fork
show uptimeAfficher la durée de fonctionnementLecture seule
command-script <fichier>Exécuter les commandes d'un fichierL'effet cumulé peut être destructeur
get log levelConsulter le niveau de logs consoleNe garantit pas la configuration des logs disque
set log level <niveau>Changer la verbosité de la consoleDebug peut générer beaucoup de journaux
quitArrêter le processusInterruption du service, préparez la maintenance
shutdownAlternative à l'arrêtMême risque que quit, vérifier dans help

Simulateur : navigation et inspection

OptionSignificationAttention
change region <nom>Cibler une région du simulateurVérifier la sélection avant les actions
change region rootRevenir au contexte globalPeut changer la portée des commandes suivantes
show modulesAfficher les modules du simulateurInspection uniquement
show regionsAfficher les régions connues du moteurDifférent du service Grid de ROBUST
show connectionsExaminer les connexions clientsÉviter la diffusion de détails de sessions
show circuitsExaminer les circuits d'agentsRésultats sensibles ; masquer les identifiants
show http-handlersExaminer les gestionnaires HTTP enregistrésAncienne documentation : vérifier disponibilité
show threadsExaminer les threads de longue duréeNe reflète pas nécessairement tout le threadpool
show capsLister des URL de capacitésURLs 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.