OpenSimulator · EN

Practical guide: safe, sensitive and destructive commands

Maintenance procedures and administration examples without unnecessary risk.

Reference version: OpenSimulator 0.9.3.1. Commands from older releases must be checked with help on the relevant process. Never run destructive operations without backups.

Recommended approach

1. Identify the console. 2. Check show version, then help. 3. Identify region, service and responsible module. 4. Take appropriate backups. 5. Start with read-only commands. 6. Confirm scope before running changes.

Restart is not a universal cache clear

Restarting a region or simulator may clear some memory caches but disconnects agents and does not necessarily clear disk caches. Targeted actions such as reset user cache or fcache clearnegatives are preferable when they directly address the fault.

Some commands are interactive

Some commands prompt for confirmation. Do not automate deletion, OAR imports or estate changes until region selection and options are understood. Absence of a console error does not prove persisted writes succeeded.

Where to go next

For Flotsam, inventory or SQL specifics, use the Handbook's Caches and Databases sections. ROBUST service commands are not directly interchangeable with simulator commands.

Read-only

OptionMeaningCaution
helpDiscover commands actually registeredFirst step
show versionVerify running binaryRecord any custom branch
show regionsInspect regional scopeInterpret per process
fcache statusInspect Flotsam healthMay cause I/O
show name <UUID>Check identity mappingUserManagement source
show statsAnalyze metricsCompare several samples

State-changing

OptionMeaningCaution
reset user cacheRebuild identity cache upon future readsDoes not delete permanent databases
fcache clearnegativesRetry formerly missing assetsTargeted, usually preferable to full purge
save oar <fichier>Create region backupVerify disk and path
estate link region <estateID> <regionID>Modify estate/region mappingBack up EstateStore
restartRestart affected region(s)Disconnects and disrupts agents
load oar <fichier>Restore an OAR into a regionPotential content loss
delete object owner <UUID>Delete objectsHigh-risk action
delete-region <nom>Delete a region definitionVery high risk

References

References: official console command documentation and OpenSimulator source code. Check older entries against your installed version. OpenSimulator 0.9.3.1 source checked for the listed examples.