Practical guide: safe, sensitive and destructive commands
Maintenance procedures and administration examples without unnecessary risk.
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
| Option | Meaning | Caution |
|---|---|---|
help | Discover commands actually registered | First step |
show version | Verify running binary | Record any custom branch |
show regions | Inspect regional scope | Interpret per process |
fcache status | Inspect Flotsam health | May cause I/O |
show name <UUID> | Check identity mapping | UserManagement source |
show stats | Analyze metrics | Compare several samples |
State-changing
| Option | Meaning | Caution |
|---|---|---|
reset user cache | Rebuild identity cache upon future reads | Does not delete permanent databases |
fcache clearnegatives | Retry formerly missing assets | Targeted, usually preferable to full purge |
save oar <fichier> | Create region backup | Verify disk and path |
estate link region <estateID> <regionID> | Modify estate/region mapping | Back up EstateStore |
restart | Restart affected region(s) | Disconnects and disrupts agents |
load oar <fichier> | Restore an OAR into a region | Potential content loss |
delete object owner <UUID> | Delete objects | High-risk action |
delete-region <nom> | Delete a region definition | Very 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.