OpenSim Archives - Revision history

Ferd Frederix: remove dead links, not found in the wayback machine.

2016-11-27T00:31:57Z

remove dead links, not found in the wayback machine.

Justincc: /* Usage */

2014-10-10T22:24:58Z

‎Usage

Justincc at 23:38, 14 July 2014

2014-07-14T23:38:49Z

Justincc: Remove unnecessary top title and adjust rest

2014-07-14T23:32:08Z

Remove unnecessary top title and adjust rest

Justincc: Remove bugs section for now - I'm sure nobody is running mono 1.2.4!

2014-07-14T23:27:43Z

Remove bugs section for now - I'm sure nobody is running mono 1.2.4!

Aiaustin: /* FAQ */ spacing only

2014-05-26T18:32:39Z

‎FAQ: spacing only

Aiaustin: /* Example OARs */ gave cyberlandia its own subsection for improved layout

2014-05-26T18:30:29Z

‎Example OARs: gave cyberlandia its own subsection for improved layout

Aiaustin: /* --publish */ 0.8.0 chsnges to strip group i fo in publish mode

2014-05-26T18:26:17Z

‎--publish: 0.8.0 chsnges to strip group i fo in publish mode

Justincc: Change load oar text as there are now more options on separate page

2014-05-01T22:43:31Z

Change load oar text as there are now more options on separate page

Misterblue: add references and links to 'Load Oar' page

2014-02-03T02:51:15Z

add references and links to 'Load Oar' page

@@ Line 101: / Line 101: @@
 = Example OARs =
 == OpenVCE 3D Assets OAR ==
@@ Line 122: / Line 118: @@
 [http://www.hypergridbusiness.com/2011/06/where-to-get-content-for-opensim/ Where to get content for OpenSim]&nbsp;-- Hypergrid Business page, regularly updated, containing links to major OAR sites. Also has download links to individual OAR files.
-[http://www.lindakellie.com/myoars.htm LindaKellie.com]
+[http://www.zadaroo.com/ Zadaroo.com]
-−
-[http://opensim-creations.com/category/regions/oars/ OpenSimulator Creations]
-[http://www.opensimworlds.com/index.php?part=worlds http://www.opensimworlds.com/index.php?part=worlds]
+[http://www.outworldz.com/cgi/freesculpts.plx?q=OAR- Outworldz.com]
 [http://forums.osgrid.org/viewforum.php?f=20 http://forums.osgrid.org/viewforum.php]

@@ Line 21: / Line 21: @@
 To load an archive, type
-  load oar [options] [&lt;location&gt;]
+  load oar [options] [&lt;path-to-oar&gt;]
 at the console. The location can be a filesystem path (as for "save oar") or an HTTP address to load an oar directly over the web. If no location is given, then the server looks for a file called region.oar in the current directory. See detailed "load oar" documentation at [[Load Oar]].

← Older revision		Revision as of 23:38, 14 July 2014
Line 129:		Line 129:

	[http://forums.osgrid.org/viewforum.php?f=20 http://forums.osgrid.org/viewforum.php]		[http://forums.osgrid.org/viewforum.php?f=20 http://forums.osgrid.org/viewforum.php]
		+
		+	= Tools =
		+
		+	* [https://github.com/justincc/opensimulator-tools/tree/master/analysis/oarinfo] - oarinfo.py, a very basic Python script for printing out information about an OAR (number of contained objects, assets, etc.).

	= Further Information =		= Further Information =

@@ Line 1: / Line 1: @@
 {{Quicklinks}}
-= How do I use the OpenSimulator Archive Function? =
+= Introduction =
-−
-== Introduction ==
 The OpenSimulator Archive (OAR) function has existed since OpenSimulator 0.5.9. The facility does a similar job to load-xml2/save-xml2 in that it saves prims so that they can be later reloaded. However, OpenSimulator archives (OAR) go a step further in that they can save all the necessary asset data so that you may fully restore the terrain, region parcel data, the textures of objects and their inventories when loaded onto a completely different system using a different asset database.
-== Usage ==
+= Usage =
 From the region console, one can type
@@ Line 40: / Line 38: @@
 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.
-=== Switches ===
+== Switches ==
-==== Saving ====
+=== Saving ===
-===== --publish =====
+==== --publish ====
 If set, then objects in the saved oar are stripped of owner and last owner information, though not of creator information.
@@ Line 53: / Line 51: @@
 As of OpenSimulator 0.8.0, this switch will also strip group information from the OAR.
-===== --noassets =====
+==== --noassets ====
 If the --noassets option is specified then the oar will be saved without assets. This can be handy if you're backing up the asset database separately and don't want the expense of including all the assets in each OAR.
-===== --home =====
+==== --home ====
 (formerly known as --profile up to 0.7.3)
@@ Line 68: / Line 66: @@
    save oar --home=http://mygrid.com my.oar
-===== --perm =====
+==== --perm ====
 If the --perm option is specified then objects with insufficient permissions will not be saved to the OAR. The user whose permissions are checked is the estate owner. This can be useful for grids that allow their customers to export their regions to OARs, because it ensures that exporting to OAR can't be used to bypass content permissions.
@@ Line 79: / Line 77: @@
    save oar --perm=CT my.oar
-===== --all =====
+==== --all ====
 If the --all option is specified then the OAR will contain all the regions in the simulator. If this option isn't specified (which is the default) then the OAR will contain only the current region.
-==== Loading ====
+=== Loading ===
 This is an overview of the most common parameters. There are many more documented at [[Load Oar]].
-===== --skip-assets =====
+==== --skip-assets ====
 If set, this will not attempt to load any of the assets from the OAR, though all other data will be loaded.  This can be useful if you are loading the OAR back into a grid that you know already contains the assets.
-===== --merge =====
+==== --merge ====
 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.
-== Multi-Region OARs ==
+= Multi-Region OARs =
 By default, the save-oar command saves only the current region into the OAR (using OAR Format 0.8). However, if the --all option is specified then all the regions in the simulator are saved into a multi-region OAR file (using OAR Format 1.0). This is useful when saving a build that spans multiple regions.
@@ Line 102: / Line 100: @@
 For historical context, see [[Feature_Proposals/Multi-Region_OARs]] and [http://opensimulator.org/mantis/view.php?id=6105 Mantis 6105]
-==== OAR Format Compatibility ====
+= Example OARs =
-OAR Format 1.0 isn't backwards-compatible, so it can only be read in OpenSim 0.7.5 and above. However, since most current instances of OpenSim can't read this format, there is a transition period in which OpenSim still saves single-region OARs using OAR Format 0.8. This means that the most common behavior (save-oar for a single region) creates OARs that are readable by all instances of OpenSim. The new OAR Format 1.0 is only used when using the --all option.
+== Cyberlandia Landscape OAR ==
-−
-== Example OARs ==
-−
-=== Cyberlandia Landscape OAR===
 [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]).
-=== OpenVCE 3D Assets OAR ===
+== OpenVCE 3D Assets OAR ==
 The [http://openvce.net OpenVCE.net] virtual worlds assets described at http://openvce.net/vwassets provided by Clever Zebra and the OpenVCE.net team at AIAI in the University of Edinburgh are available as an OAR (Opensim Archive) file.
@@ Line 122: / Line 116: @@
 [http://openvce.net/resources/downloads/opensim-openvce-2.jpg Image 2]
-=== Others ===
+== Others ==
 Please feel free to place links to other environments here, though unfortunately you'll have to host them on some other site.
@@ Line 136: / Line 130: @@
 [http://forums.osgrid.org/viewforum.php?f=20 http://forums.osgrid.org/viewforum.php]
-== Further Information ==
+= Further Information =
 * [http://justincc.org/blog/category/oars/ http://justincc.org/blog/category/oars/] - various OAR related articles from justincc, including background information and possible future development.
-== Use cases ==
+= Use cases =
 Possible current uses are
@@ Line 148: / Line 142: @@
 . To distribute entire regions to other people.
-== Current limitations ==
+= Current limitations =
-* Performance is not very good, especially with large archives. This will be addressed in the future
+* Performance is not very good with large archives. This will be addressed in the future
 * Loading large OARs using the default SQLite database plugin will take a very very long time (in the order of many hours). I highly recommend that you switch to MySQL if you want to load large archives.
-== OAR Format ==
+= OAR Format =
 The region [[OpenSim Archives|OpenSimulator Archive (OAR)]] format is designed with three aims in mind:
@@ Line 170: / Line 164: @@
 * [[OAR Format 1.0]]
-== FAQ ==
+== OAR Format Compatibility ==
 . What is this .tar.gz format you are using for the internal OAR format? Why not zip?
@@ Line 188: / Line 188: @@
 Not yet.
-== Current Status ==
+= Current Status =
 Operational. Bug reports are appreciated [[User:Justincc|Justincc]] 14:53, 14 September 2009 (UTC)

← Older revision		Revision as of 23:27, 14 July 2014
Line 187:		Line 187:

	Not yet.		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 ==		== Current Status ==

@@ Line 179: / Line 179: @@
 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 :)
 . Can you load and save multiple regions to an archive?
 Yes, since OpenSim 0.7.5. See [[OpenSim Archives#Multi-Region OARs]]
 . Can you load and save parts of a region to an archive?

← Older revision		Revision as of 18:26, 26 May 2014
Line 50:		Line 50:

	As of OpenSimulator 0.7.4, this switch will also strip ownership information from land parcels.		As of OpenSimulator 0.7.4, this switch will also strip ownership information from land parcels.
		+
		+	As of OpenSimulator 0.8.0, this switch will also strip group information from the OAR.

	===== --noassets =====		===== --noassets =====