OpenSimulator · EN

Archive, asset and cache commands

Back up and restore OAR/IAR, inspect assets and manage Flotsam safely.

Reference: OpenSimulator 0.9.3.1. Commands documented for older releases (including 0.7.x) may have changed: check help and loaded modules. Back up before write or delete operations.

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

OptionMeaningCaution
save oar [options] <fichier>Export region contents to OARConfirmed; --noassets precedes path
save oar --noassets <fichier>Export an OAR without embedded assetsRestore will depend on available assets
save oar --all <fichier>Use the all-scope OAR optionVerify exact scope in current version
load oar <fichier>Load an OARMay replace current content
load oar --merge <fichier>Merge an archive with existing contentCheck collisions and object state
save iar <prénom> <nom> <dossier> <motdepasse> <fichier>Archive a user's inventoryCheck help and permissions for installed version
load iar <prénom> <nom> <dossier> <motdepasse> <fichier>Restore inventory archiveMay alter inventory; test first
save xml2 <fichier>Export objects to XML2Legacy format, not an OAR backup
load xml2 <fichier>Import objects from XML2Duplicate risk; source verified
save prims xml2 <nom> <fichier>Export a named primTargeted export, not a region backup

Flotsam and texture tools

OptionMeaningCaution
fcache statusShow cache metricsCan enumerate millions of files
fcache clearnegativesClear negative lookup entriesTargeted for newly restored assets
fcache clear memoryClear Flotsam memory cacheAlso clears negatives in source
fcache clear fileClear Flotsam disk cachePotentially heavy reloading
fcache clearClear enabled Flotsam cachesBroad operation; plan maintenance
fcache assetsPreload assets used by scenesCan generate substantial network and I/O
fcache expire <date>Expire files before a dateDate parsing depends on process locale
j2k decode <UUID>Test JPEG2000 asset decodingOptional diagnostic module
dump asset <UUID>Dump an asset from the asset serviceVerify 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.