IAR archives: inventory, flags and merge
Full or selective backups, with or without assets, and restoring into an inventory folder.
Understanding IAR
An IAR backs up avatar inventory items and folders. It does not back up terrain or rezzed region objects: use OAR for those.
Saving an inventory
Back up the inventory root including assets.
save iar First Last "/" PASSWORD /backups/avatar-full.iar
Save without assets: smaller archive, but restoration relies on assets already present.
save iar --noassets First Last "/" PASSWORD /backups/avatar-noassets.iar
Permission-filtered example: export only entries matching the requested permission criteria.
save iar --perm=CTM First Last "/" PASSWORD /backups/avatar-perms.iar
Example excluding a folder named Trash. Verify the actual folder name.
save iar --excludefolder=Trash First Last "/" PASSWORD /backups/avatar-clean.iar
save iar flags
| Option | Meaning | Caution |
|---|---|---|
--noassets | Do not export asset data | Assets must be available to use objects |
--skipbadassets | Skip items whose main asset is missing | Recovery option for damaged inventory; may lose items |
--creators, -c | Preserve foreign creator information | Useful for Hypergrid content |
--home=URL, -h | Set profile service URL | Verify the URL |
--exclude=NAME/UUID, -e | Exclude an inventory item | Check name or UUID |
--excludefolder=NAME/UUID, -f | Exclude a folder and contents | Do not exclude required folders |
--perm=CTM | Filter by Copy, Transfer and Modify | Review permissions before sharing |
--verbose, -v | Show extra messages | Logs can be large |
Restoring an IAR
Restore into the account inventory. Check content and destination path first.
load iar First Last "/" PASSWORD /backups/avatar-full.iar
Tries to merge with existing folders rather than always creating new folders.
load iar --merge First Last "/" PASSWORD /backups/avatar-full.iar
| Option | Meaning | Caution |
|---|---|---|
--merge, -m | Merge existing folders when possible | Check for duplicate items after import |
Limitations and precautions
An archive without assets is not self-contained. Permissions, creator references and asset availability may affect the outcome. Keep dated backups and test with a disposable account.