OpenSimulator · EN

Complete OAR and IAR walkthroughs

Choose the right format, make a backup, test an import and validate the result.

Choose OAR versus IAR

An OAR backs up a region, an IAR backs up inventory. For rezzed region builds, use OAR. For objects stored in avatar inventory, use IAR. Neither format alone is a complete backup of a grid database.

Walkthrough 1: full OAR backup

1. Identify the intended region in the console. 2. Check disk space. 3. Choose a dated file path. 4. Run save oar without --noassets. 5. Wait for completion and verify the file exists. 6. Periodically restore on an isolated test region.

Command or example (adapt to your installation)

save oar /backups/Region-2026-11-09.oar

Walkthrough 2: OAR without assets

Use --noassets only when referenced assets are guaranteed to remain available. Such an archive is smaller but less portable. When moving to another grid, including assets is generally preferable.

Command or example (adapt to your installation)

save oar --noassets /backups/Region-light.oar

Walkthrough 3: restore without damaging production

1. Create an isolated test region with suitable dimensions. 2. Back it up. 3. Load the OAR. 4. Check terrain, parcels, textures, objects, scripts and permissions. 5. Review log messages. 6. Deploy to production only after validation.

Command or example (adapt to your installation)

save oar /backups/TestRegion-before.oar
load oar /backups/Region-2026-11-09.oar

Walkthrough 4: merging builds

The --merge option imports into a region that already has objects. Duplicates and collisions remain possible. If content should be repositioned, add --displacement and ensure resulting coordinates fit inside the region.

Command or example (adapt to your installation)

load oar --merge --displacement "<256,0,0>" /backups/Build.oar

Walkthrough 5: backing up avatar inventory

Verify that the intended items are in inventory, choose the root "/" or a specific folder, and include assets for portability. The resulting archive may contain sensitive object information; do not publish it.

Command or example (adapt to your installation)

save iar First Last "/" PASSWORD /backups/Inventory-full.iar

Walkthrough 6: restoring without duplicate folders

On a test account, import an IAR with --merge to reuse existing folders when possible. Afterwards, check duplicates, folder structure and asset availability.

Command or example (adapt to your installation)

load iar --merge First Last "/" PASSWORD /backups/Inventory-full.iar

Retention and disaster recovery

A serious strategy combines dated OARs, appropriate account IARs, database backups and service configurations. Keep at least one copy off the live server, record the software version and rehearse end-to-end recovery.

Source / Reference