Archive, asset and cache commands
Back up and restore OAR/IAR, inspect assets and manage Flotsam safely.
OAR: option order matters
In 0.9.3.1, source registers save oar with options including --noassets, --publish, --perm and --all. Place options before the output path. Consult help save oar for exact options and behavior in your version.
Take care with load oar
Without the appropriate options, load oar may replace region content. Source includes --merge, --skip-assets and other merge-related options. Back up the region and check selected scope before any restore.
Do not confuse caches with permanent assets
fcache manages a simulator's temporary Flotsam cache. ROBUST's persistent asset databases or FSAssets are different. The service-level dump asset command is not equivalent to exporting the whole authoritative asset store.
Archives
| Option | Meaning | Caution |
|---|---|---|
save oar [options] <fichier> | Export region contents to OAR | Confirmed; --noassets precedes path |
save oar --noassets <fichier> | Export an OAR without embedded assets | Restore will depend on available assets |
save oar --all <fichier> | Use the all-scope OAR option | Verify exact scope in current version |
load oar <fichier> | Load an OAR | May replace current content |
load oar --merge <fichier> | Merge an archive with existing content | Check collisions and object state |
save iar <prénom> <nom> <dossier> <motdepasse> <fichier> | Archive a user's inventory | Check help and permissions for installed version |
load iar <prénom> <nom> <dossier> <motdepasse> <fichier> | Restore inventory archive | May alter inventory; test first |
save xml2 <fichier> | Export objects to XML2 | Legacy format, not an OAR backup |
load xml2 <fichier> | Import objects from XML2 | Duplicate risk; source verified |
save prims xml2 <nom> <fichier> | Export a named prim | Targeted export, not a region backup |
Flotsam and texture tools
| Option | Meaning | Caution |
|---|---|---|
fcache status | Show cache metrics | Can enumerate millions of files |
fcache clearnegatives | Clear negative lookup entries | Targeted for newly restored assets |
fcache clear memory | Clear Flotsam memory cache | Also clears negatives in source |
fcache clear file | Clear Flotsam disk cache | Potentially heavy reloading |
fcache clear | Clear enabled Flotsam caches | Broad operation; plan maintenance |
fcache assets | Preload assets used by scenes | Can generate substantial network and I/O |
fcache expire <date> | Expire files before a date | Date parsing depends on process locale |
j2k decode <UUID> | Test JPEG2000 asset decoding | Optional diagnostic module |
dump asset <UUID> | Dump an asset from the asset service | Verify service and version |
Sources and verification
References include the official console command documentation and OpenSimulator source code. Some commands on the official wiki refer to older versions. Additional commands and some syntax were checked in the linked 0.9.3.1 code.