How to Upload a tgz File Into Opensim

OpenSim Tech Basics: OARs – Opensim region ARchives October 10, 2008

Posted by justincc in opensim, opensim-tech-basics.
trackback

OAR Basics

OpenSim archives (OARs) are designed as a mechanism for transporting whole regions from 1 simulator instance to another.  This involves transporting non merely XML information nigh the size and shapes of prims, but also the textures applied to their surfaces and the items (scripts, notecards, sounds, etc.) independent inside them.  As we are transporting a whole region, OpenSim archives likewise contain terrain information.

Here is a very simple case archive, a screenshot from which can exist seen below

So how would you load this archive?  First, you would need to starting time upward an OpenSim instance with a blank region or one that y'all don't mind losing (since loading an OAR volition supersede the entire region).  If your region simulator hosts more than than ane region yous will accept to brand the blank region the 'current region' via the command

alter region my-region

You can then load the annal with the command

load oar scene_oar.tar.gz

If your avatar is sitting in that region, you'll beginning see any existing objects all disappear.  Then the terrain will be loaded from the archive and the archived prims volition magically pop into existence (this is a chip like scenes from the Matrix except much, much slower :-).

Saving out an archive uses a similar command

relieve oar my-archive.tar.gz

More details tin can be found on the OpenSimulator wiki here.

OAR Internals

I had three chief aims when designing the file format for OpenSim athenaeum.  More details on this can again be found on the wiki.

1. Make it like shooting fish in a barrel for people to read and write different OpenSim files inside an annal.OpenSim archives are old manner UNIX tar.gz files (in the time to come they may be zips – this just requires us to sort out some license issues.  Nonetheless, the tar.gz files can be opened on Windows with software such as 7-nada).  This means that everyone can unpack them.  Moreover, the files within the archive are laid out to endeavour and make it easy to look at dissimilar types of information.  For example, if you unpack the instance oar higher up you'll come across
archive.xml
assets/
objects/
terrains/
Inside the assets directory are all the assets for that archive.  Each asset filename starts with its UUID and ends with an extension appropriate to that filetype.  For case, the single script in this archive has the filename

   e03b08f7-9bf5-43b7-839e-ba90d42d04a4_script.lsl

   This means that it can be read and even edited – though editing isn't recommended if y'all're going to reload the annal to a arrangement which already has that asset (since assets are meant to never change).

2. Make it piece of cake to compose 2 region archives into a unmarried region annal.Because assets and objects are separate files living in dissever directories, in principle one could merge two regions into a single region just by copying the contents of one directory into another.  The exception here is the terrains directory.This will be more useful for archives that are collections of objects rather than whole regions.
3. Brand it like shooting fish in a barrel to compose athenaeum from scratch.In principle one doesn't need to create an OAR by saving the contents of an existing region.  It should be possible to create one from scratch.

OAR Futures

In that location'south yet some way to go with region athenaeum.  For instance, you tin't currently save multiple regions in a single archive, or parcel information.  Patches and problems reports are very welcome.  Likewise, I'd be very interested in any links to people making their OARs publicly bachelor.

In the long term the road map is to implement inventory archives as well as region archives – in that location is now considerable code that can be reused, and people such equally Kayne have already contributed preliminary lawmaking.  This facility isn't really meant to compete with products such as Second Inventory – archives can only currently be used if one has adminstrative admission to an OpenSIm region (either directly via the region panel or through the XMLRPC Admin functionality).  Nonetheless, I feel that it's important to have a manner of transporting inventory that is free and open up, and doesn't rely on the fiddly business of extracting and recreating data via the client protocol.

schlateroneret.blogspot.com

Source: https://justincc.wordpress.com/2008/10/10/opensim-tech-basics-oars-opensim-region-archives/

Share this post