OpenSimulator - User contributions [en]

OpenSim Archives

2009-11-26T07:33:21Z

Jpirkola: /* See Also */

{{Template:Quicklinks}}
<br />

[[Technical Reference | Technical Reference]] -> [[Technical Reference/terms | Terms]] -> [[OAR_Format | OAR Format]] -> [[OpenSim_Archives | How do I use the OAR Function?]]

=How do I use the OpenSim Archive Function?=

==Introduction==

The OpenSim Archive (OAR) function has existed since OpenSim 0.5.9. Basically, it does a similar job to load-xml2/save-xml2 in that it saves prims so that they can be later reloaded. However, OpenSim archives (OAR) go a step further in that they can save all the necessary asset data so that you may fully restore the terrain, the textures of objects and their inventories when loaded onto a completely different system using a different asset database.

==Usage==

From the region console, one can type

save oar [<filename>]

to save an OpenSim archive. If no filename is given, then the name region.oar is used in the current directory

To load an archive, type

load oar [--merge] [<filename>]

at the console. If no filename is given, then the server looks for a file called region.oar in the current directory.

By default, loading an archive will delete all the existing objects in the regions and replace them with the archive contents. It's like being in the Matrix (when they swap environments), except much slower (all the scene objects are slowly deleted before the new environment is loaded :-)

If the --merge option is specified, then the oar will be merged with the existing region objects rather than replace them. The existing terrain, region settings and parcels will be left in place.

When an archive is loaded, owners will be restored if the relevant uuids can be found in the OpenSim installation's user database. Otherwise, prim ownership will default to the master avatar for the region.

I recommend that you use filenames with the extension '''.oar'''. The filename extension of the download links on this page is '''.tar.gz''' which illustrates that the '''.oar''' format is actually a zipped tar file.

==Examples==

[http://www.secondlifelab.it/downloads/cyberlandia.tar.gz cyberlandia.tar.gz] - cyberlandia landscape designed by the architect Simone Riccardi aka turboy. Contemporary architecture surrounded with a natural/synthetic context [http://www.flickr.com/photos/8905571@N05/3182585775/ image_1] [http://www.flickr.com/photos/8905571@N05/3171070049/ image_2] (work under [http://creativecommons.org/licenses/by/3.0/us/ Creative Commons by attribution]).

'''Defunct--does anyone have a backup?''' [http://www.lordfly.com/nuathens.zip nuathens.zip]- A four region combo called the Nu Athens neighborhood. [http://www.sluniverse.com/php/vb/project-development/16014-nu-athens-interactive-story-opensim-2.html#post501412 Info] (work under [http://creativecommons.org/licenses/by/3.0/us/ Creative Commons by attribution]

I have them on my server here: http://techwizworld.net/Opensim/

===OAR file from "Lusitania Tester" for all===
[http://www.worldsimterra.com/index.php?option=com_content&view=article&id=163&Itemid=100263 OAR-File.tar.gz]- Every week (on Sunday after 21:00 UTC) a OAR file from "Lusitania Tester" of WorldSimTerra-Grid is available for use of building and rezz of different avatars. All the avatars of all the grids are invited to place their free buildings and rezz to share with the OpenSim community. To get the OAR file, the member of the OpenSim community will make the registration on the site, after logging in, the downloads are available on the "Avatar Toolbox" tab (this tab is only available after you login to the site)

Please feel free to place links to other environments here, though unfortunately you'll have to host them on some other site.

Do not forget to also check out this page [http://www.opensimworlds.com/index.php?part=worlds http://www.opensimworlds.com/index.php?part=worlds]

==Further Information==

* [http://justincc.org/blog/2008/10/10/opensim-tech-basics-oars-opensim-region-archives http://justincc.org/blog/2008/10/10/opensim-tech-basics-oars-opensim-region-archives] - an overview of OAR and its file format.
* [http://justincc.org/blog/2009/05/01/a-little-bit-more-on-oar http://justincc.org/blog/2009/05/01/a-little-bit-more-on-oar] - some more background information on OAR and possible future directions.

==Use cases==

Possible current uses are

1. To migrate data from an SQLite region database to one based on MySQL

2. To distribute entire regions to other people.

==Current limitations==

* Parcel information is not currently saved. This will be addressed in the future.
* Performance is not very good, especially with large archives. This will be addressed in the future

==File Formats==

[[OAR Format|OAR File Formats]]

==FAQ==

1. What is this .tar.gz format you are using for the internal OAR format? Why not zip?

.tar.gz is a standard unix way of zipping up files into a single larger compressed file for distribution. Windows users should be able to open these files using freeware programs such as [http://www.7-zip.org/ 7-zip].

I'm using .tar.gz because all the zip (and tar) libraries for .net are licensed either under the GPL (with exception) or under the MSPL. Unfortunately, not all members of the OpenSim development team are comfortable with the MSPL, so these libaries are not currently an option. It is also significantly easier to write code to create and read tar archives than zip archives.

Also, if you're only ever loading and saving oars (rather than pulling them apart and putting them back together), then you don't need to worry about the internal format at all :)

2. Can you load and save multiple regions to an archive?

Not yet.

3. Can you load and save parts of a region to an archive?

Not yet.

==Bugs==

* Due to a possible bug in the Mono 1.2.4 libraries, this feature may cause a debug dump when used (the problem appears to be in writing out a compressed stream). Mono 1.2.6 is okay. Since Mono 1.2.4 is fairly old now, this bug will not be addressed.

==Current Status==

Operational. Bug reports are appreciated [[User:Justincc|Justincc]] 14:53, 14 September 2009 (UTC)

Though we will strive to maintain compatibilty for old archives with newer OpenSimulator versions, please don't rely on these archives as the only backup for regions.

= See Also =

* [[Status|Main Status Page]]
* [[Technical_Reference|Technical Reference Page]]
* [[OAR_Format| What is OAR Format?]]
* [[OpenSim_Archives|How to use OpenSim Archives (OAR)]]
* [[OAR Format 0.1 | OAR Format 0.1]]
* [[OAR Format 0.2 | OAR Format 0.2]]
* [http://www.rexxed.com/category/sim/ Free oar files from rexxed.com]

[[Category:Users]]
[[Category:Support]]
[[Category:Tech Reference]]
[[Category:Help]]
[[Category:Configuration]]
[[Category:Getting_Started]]
[[Category:Development]]

News

2009-06-15T20:02:52Z

Jpirkola: /* Blogs */ added Maxping.org

{{Template:Quicklinks}}
__NOTOC__

==Project News==
===May 2009===
Starting in r9562 OpenSim has a set of new configuration variables that specify how services and service connectors are set up.

Please reference the [[Services_and_Service_Connectors_Configuration | Services and Service Connectors Configuration]] page for more information.

===April 2009===
* There is a current proposal to drop Visual Studio 2005 support in OpenSim by end of May. Visual Studio 2008 will still be supported. If you have strong opinions on the matter, use the [[Mailing_Lists|mailing lists]] to make your voice heard.

* We are experimenting with a feature suggestion tracker, visit [http://www.opensimulator.org/features/ opensimulator.org/features] to suggest new feature ideas.

==Press==
===September 2008===
*[http://www-03.ibm.com/press/us/en/pressrelease/25038.wss 03 Sep 2008 - Made in IBM Labs: IBM Moves Real-Time Communication and Collaboration Into 3-D (integrated with OpenSim)]
===February 2008===
* [http://www-03.ibm.com/press/us/en/pressrelease/23565.wss 21st Feb 2008 - Made in IBM Labs: IBM 3-D Data Centers Show Virtual Worlds Fit for Business]
* [http://www.realxtend.org/realxtend_opensim_release_15_02_2008.html 15th Feb 2008 - RealXtend joins OpenSim: Team up to make open source Virtual World standard]
* [http://www.ngigroup.com/jp/press/2008/02/001264.html 5th Feb 2008 - 3Di, Inc. Creates Voice Communication Function for Its Virtual World Application "Jin-sei"]
<cleanpage title=hide cats=hide />

==RSS Feeds==
<rss>http://planet.opensim.us/rss20.xml|max=5|short|filter=opensim</rss>
<rss>http://feeds.technorati.com/search/opensim?language=en|max=5|short</rss>
<rss>http://feeds.technorati.com/search/opensim?authority=n&language=pt|max=5|short</rss>
<rss>http://feeds.technorati.com/search/opensim?authority=n&language=es|max=5|short</rss>
<rss>http://feeds.technorati.com/search/opensim?authority=n&language=fr|max=5|short</rss>

==Blogs==
* [http://www.worldsimterra.com WorldSimTerra (Português, English, Español)]
* [http://www.adamfrisby.com/blog/2008/08/resources-for-running-your-own-opensim Adam's OpenSim resources blog post] - a list of resources for running OpenSim
* [http://rock-vacirca.blogspot.com Rock Vacirca's Blog] - lots of tutorials, not only on OpenSim, but on MySQL, Hippo, Second Inventory, etc
* [http://justincc.wordpress.com justincc's blog] - A blog with a weekly OpenSim development update and regular articles on various OpenSim topics.
* [http://lbsa71.net/category/opensim/ lbsa71.net] - tidbits from an OpenSim developer.
* [http://imohax.com Mo Hax] - posts and videos about OpenSim and Second Life from beginner perspective, focus on content previewing and educational use
* [http://www.metaverse3d.com/tag/opensim/ Metaverse3d] - French blog about metaverse and OpenSim.
* [http://www.subwereld.nl/ Subwereld] - A Dutch weblog about the OpenSimulator Project, the virtual world grids and OpenSim tools.
* [http://maxping.org/ Maxping] - A web magazine that writes about open source virtual worlds.

Second Birthday

2009-01-29T12:25:21Z

Jpirkola: /* Blog Entries */

[[Image:OpenSim_2nd_Birthday_Banner.png]]

== History ==
The consensus is that OpenSim was 'born' on Jan 29 2007, when Darren Guard (MW) made his prototypical c# 3D world server publicly available. Help us celebrate this joyous occasion! Read [[History]] for some recap of the early days.

== Activities ==
Here you can add your activity, sorted by starting time GMT. Please supply at least basic information (when it starts, ends, what happens and how to get there). Also, if the activity takes place in a public hypergrid location, feel free to add link-region information so that others can link to your region.

Consider announcing your party on the opensim-users mailing list.

=== Jan 28 2009 ===
{| border="1" cellpadding="5" cellspacing="0" align="center"
!When? (GMT)
!When? (Local Time)
!Duration
!What?
!Where?
!How do I get there?
![[Hypergrid|link-region server and port]]
|-
|9:00pm
|1:00pm (PST)
|90 minutes
|Foolish Frost live from the Cornfield
|Rezzable Private Grid Alpha
|[http://rezzable.com/blog/vint-falken/opensim-2nd-birthday-celebration-foolish-frost-live-cornfield Instructions for existing & new accounts.]
|Non-hypergrid. (for now)
|}

=== Jan 29 2009 ===
{| border="1" cellpadding="5" cellspacing="0" align="center"
!When? (GMT)
!When? (Local Time)
!Duration
!What?
!Where?
!How do I get there?
![[Hypergrid|link-region server and port]]
|-
|9:00pm (GMT)
|10:00pm (Local Time)
|3 hours
|Presentation of Cyberlandia (Italian) grid, Welcome areas, outstanding building architecture tour and Dancing Party for everybody
|www.cyberlandia.net www.opensimita.org
| "Born To Learn" and "Cyberlandia" sims. At entry point will find agenda and landmark givers.
|[[Hypergrid|grid.cyberlandia.net:8002]]
|-
|20:00pm (GMT)
|21:00pm (Local Time)
|2+ hours
|Game over for SL - Dark musix party, lottery and more. switch to night before enterering.
|www.schwarze-welle.de www.osgrid.org
| SCHWARZE WELT and surounding regions in osgrid
|[[Hypergrid|87.230.89.74:9000]]
|-
|14:00pm (GMT)
|6:00am (PST)
|1 hour
|Introduction to Building - learn to build in OpenSim
|http://reactiongrid.com
| ReactionGrid Welcome Sim will have all markers and directions to which sims for each of the events.
|[[Hypergrid|http://gsquared.info:8008]]
|-
|21:00pm (GMT)
|13:00pm (PST)
|1 hour
|Introduction to Building - repeated for west coast and those who could not make it to the earlier class
|http://reactiongrid.com
| ReactionGrid Welcome Sim will have all markers and directions to which sims for each of the events.
|[[Hypergrid|http://gsquared.info:8008]]
|}

=== Jan 30 2009 ===
{| border="1" cellpadding="5" cellspacing="0" align="center"
!When? (GMT)
!When? (Local Time)
!Duration
!What?
!Where?
!How do I get there?
![[Hypergrid|link-region server and port]]
|-
|21:00pm (GMT)
|13:00pm (PST)
|1 hour
|Particle Madness - learn to make your own particle effects
|http://reactiongrid.com
| ReactionGrid Welcome Sim will have all markers and directions to which sims for each of the events.
|[[Hypergrid|http://gsquared.info:8008]]
|-
|22:00pm (GMT)
|14:00pm (PST)
|1 hour
|1939 World's Fair weekly meeting, 22:00-23:00 UTC - anyone interested in learning more and possibly participating in the reconstruction project are more than welcome to come along!
|http://reactiongrid.com
| 39FairHQ sim
|[[Hypergrid|http://gsquared.info:8008]]
|}

=== Jan 31 2009 ===
{| border="1" cellpadding="5" cellspacing="0" align="center"
!When? (GMT)
!When? (Local Time)
!Duration
!What?
!Where?
!How do I get there?
![[Hypergrid|link-region server and port]]
|-
|16:00pm (GMT)
|8:00am (PST)
|1 hour
|Creating Prim Hair - learn to make your prim hair
|http://reactiongrid.com
| ReactionGrid Welcome Sim will have all markers and directions to which sims for each of the events.
|[[Hypergrid|http://gsquared.info:8008]]
|-
|22:00pm (GMT)
|14:00pm (PST)
|til late night
|Mega Fright Night - public domain movies streamed to Reactiongrid - sit in an old time car (drive in style) or pop a squat on a tomato and pitch tomatoes at the screen and scream. A real fun time and we are planning to keep this running all night long - among movies you will see Gila Monster, House on Haunted Hill, and many more
|http://reactiongrid.com
| Tarzan sim - directions and more at Welcome sim entrance or just head to Tarzan sim and join in!
|[[Hypergrid|http://gsquared.info:8008]]
|}

=== Jan 31 - Feb 1 2009 ===
{| border="1" cellpadding="5" cellspacing="0" align="center"
!When? (GMT)
!When? (Local Time)
!Duration
!What?
!Where?
!How do I get there?
![[Hypergrid|link-region server and port]]
|-
|24:
|24:
|48 hours
|sailing DJ's live-music hypergrid freebies
|[[OSGrid]]
|http://simzee.com/event.html
|OSGrid
|}
=== Feb 3 2009 ===
{| border="1" cellpadding="5" cellspacing="0" align="center"
!When? (GMT)
!When? (Local Time)
!Duration
!What?
!Where?
!How do I get there?
![[Hypergrid|link-region server and port]]
|-
|20:00pm (GMT)
|12:00pm (PST)
|1 hour
|Photoshop CS3 for Textures
|http://reactiongrid.com
| ReactionGrid Welcome Sim will have all markers and directions to which sims for each of the events.
|[[Hypergrid|http://gsquared.info:8008]]
|-
|21:00pm (GMT)
|13:00pm (PST)
|1 hour
|Avatar Clothing Tutorial
|http://reactiongrid.com
| ReactionGrid Welcome Sim will have all markers and directions to which sims for each of the events.
|[[Hypergrid|http://gsquared.info:8008]]
|}

== Demos and Exhibits ==
Here you can add your ongoing demo and/or interesting content. Please supply a brief description of the demo and/or content. Also, if the activity takes place in a public hypergrid location, feel free to add link-region information so that others can link to your region.

{| border="1" cellpadding="5" cellspacing="0" align="center"
!Title
!Description
!Location
![[Hypergrid|link-region server and port]]

|-
|Urban Planning modules
|Traffic and pedestrian simulations in the UCI Grid, provided by [http://encitra.com/ Encitra].
|UCI Grid. Go to Gateway 7000 and use the teleporter for UCI Campus (1,1). Or link to it directly, using the info on the right.
|ucigrid01.nacs.uci.edu:9000 (centered in the 8000's)

|-
|Metaverse Illuminations Gallery
|Large gallery of high-quality Second Life documentary photography
|OSGrid: Snoopies/21/15/521 (skybox) manual link: secondlife://Snoopies/21/15/521
|(not sure!)

|-
|German welcome area
|Informationen fuer deutsche Newbies im Osgrid, Freebies in Sharkland Hills, Mitbauer willkommen, Mietregionen
|OSGrid, Sharkland Tropical 3
|regionsDE.ralf-haifisch.biz:9000

|-
|OpenSim Dutchies
|Mostly empty, but if you're lucky you catch me there for some information about interconnectivity between webinterface and virtual world, using wixtd and OpenSim
|OSN Grid
|os-networks:9000

|-
|Pseudospace - Ellis Island Welcome Center & Telehub
|Pop on by and enjoy a slice of open sourced birthday cake and punch in our lobby! Feel free to look around and explore some of the different roleplay environments we're working on and help yourself to some freebies from our content library. All sims on the grid are HyperGrid enabled so no need to worry about becoming stranded if you teleport off of Ellis Island. :)
|Pseudospace
|ellis.pseudospace.net:9000
centered at 9000,9000

|-
|OpenSimulator-Club
|Club (german language) for upcoming OpenSimulator and 3D-Internet activities. Founded to support the OpenSimulator 2nd birthday event.
| 
|http://www.talentraspel.de/index.php?option=com_content&view=article&id=53&Itemid=72

|-
|3D-Internet TV
|Web-TV channel (german language) covering news and developments for 3D-Internet activities. The OpenSimulator 2nd birthday event will be reported too.
| 
|http://www.talentraspel.de/index.php?option=com_wrapper&view=wrapper&Itemid=105

|-
|Schwarze Welle
|Club and Shops (german/english) , 3D representation of www.schwarze-welle.de dark music radio. every monday german osgrid meeting 20:00 at next region SCHWARZE WELT
|OSGrid, SCHWARZE WELT
|87.230.89.74:9000

|-
|Open Vue
|Virtual University of Edinburgh on Opensim hosted on the Virtual AIAI Grid
| 
|http://vue.ed.ac.uk/openvue/

|-
|Folk Cate Delta
|Edy Rau's Folk Cafe(german/english) , every thursday 1 to 2 hours live musicans. 20 MET (11 PST)
|Grid4Us, Folk Cafe Delta
|http://grid4us.net:9020 (centered to 8500, 8500)
|}

== Blog Entries ==
Keep a list of the 2nd Birthday Blog Entries here:
* [http://opensimulator.info/article.php/Opensim-Les-anniversaires Happy 2nd birthday Opensimulator]
* [http://www.cybertechnews.org/?p=529 CyberTech News blog post]

== Resources ==

=== Hypergrid Bridges ===

To bridge between grids in the 1000's and grids in the 10,000's, you can use 2 gateways in the UCI Grid:

* Gateway 3000, placed in position 3,000 3,000: ucigrid04.nacs.uci.edu 9003
* Gateway 7000, placed in position 7,000 7,000: ucigrid04.nacs.uci.edu 9007

=== Banners ===
This banner is suitable for inclusion on your own web page, in blogs et c:

[[Image:OpenSim_2nd_Birthday_Banner.png]]

(Courtesy [http://www.vintfalken.com Vint Falken])

=== Invitation Card ===
This image is suitable for creating your own invitation notecards:

[[Image:OpenSim_Second_Birthday_Note.png]]

(Courtesy [http://www.vintfalken.com Vint Falken])