OpenSim Archives/de
From OpenSimulator
(→Verwendung) |
|||
| Line 23: | Line 23: | ||
load oar [Optionen] [<Pfad-zur-oar>] | load oar [Optionen] [<Pfad-zur-oar>] | ||
| − | + | Der Speicherort kann ein Dateisystempfad sein (wie für "save oar") oder eine HTTP-Adresse, um eine oar direkt über das Web zu laden. Wenn kein Speicherort angegeben ist, sucht der Server im aktuellen Verzeichnis nach einer Datei mit dem Namen region.oar. Zum laden einer oar Datei siehe [[Load Oar]]. | |
| − | ''' | + | '''Beispiele:''' |
load oar | load oar | ||
| − | load oar | + | load oar meine.oar |
| − | + | load oar --merge oar-sicherungen/3rd-party.oar | |
| − | load oar --merge | + | load oar http://PfadZur/oarDatei.oar |
| − | load oar http:// | + | |
| − | + | Standardmäßig werden beim Laden eines Archivs alle vorhandenen Objekte in den Regionen gelöscht und durch den Archivinhalt ersetzt. Es ist wie in der Matrix (wenn sie die Umgebungen wechseln), außer es ist viel langsamer (alle Szenenobjekte werden langsam gelöscht, bevor die neue Umgebung geladen wird :-) | |
| + | |||
| + | Wenn ein Archiv geladen wird, werden Besitzer wiederhergestellt, wenn die relevanten UUIDs in der Benutzerdatenbank der OpenSimulator-Installation gefunden werden. Andernfalls wird der Prim-Besitz auf den Master-Avatar für die Region voreingestellt. | ||
| + | |||
| + | Ich empfehle, dass Sie Dateinamen mit der Endung .oar verwenden . Die Dateinamenserweiterung der Download-Links auf dieser Seite ist .tar.gz, was zeigt, dass das .oar- Format tatsächlich eine gezippte tar-Datei ist. | ||
When an archive is loaded, owners will be restored if the relevant uuids can be found in the OpenSimulator installation's user database. Otherwise, prim ownership will default to the master avatar for the region. | When an archive is loaded, owners will be restored if the relevant uuids can be found in the OpenSimulator installation's user database. Otherwise, prim ownership will default to the master avatar for the region. | ||
| Line 38: | Line 41: | ||
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. | 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. | ||
| − | == | + | == Einstellungen == |
| − | === | + | === Speichern === |
==== --publish ==== | ==== --publish ==== | ||
| − | + | Wenn diese Option aktiviert ist, werden Objekte im gespeicherten Ruder von Eigentümer- und letzten Besitzerinformationen gelöscht, jedoch nicht von Erstellerinformationen. | |
| − | + | Dies ist nützlich, wenn Sie OARs veröffentlichen (statt sie zur Sicherung zu verwenden), wenn diese OARs möglicherweise in dasselbe Grid geladen werden, aus dem Sie veröffentlicht haben. | |
| − | + | Ab OpenSimulator 0.7.4 entfernt dieser Schalter auch Eigentumsinformationen von Landparzellen. | |
| − | + | Ab OpenSimulator 0.8.0 entfernt dieser Schalter auch Gruppeninformationen von der OAR. | |
==== --noassets ==== | ==== --noassets ==== | ||
| − | + | Wenn die Option --noassets angegeben wird, wird das Ruder ohne Assets gespeichert. Dies kann nützlich sein, wenn Sie die Asset-Datenbank separat sichern und nicht die Kosten für die Aufnahme aller Assets in jede OAR möchten. | |
==== --home ==== | ==== --home ==== | ||
| − | ( | + | (früher bekannt als --profile bis 0.7.3) |
| − | + | Wenn die Option --home angegeben wird, werden allen Namen von Erstellern aus dieser Welt Links zu ihrer Heimatwelt hinzugefügt. Es ist nicht erforderlich, dass der Dienst betriebsbereit ist. Die Informationen werden hinzugefügt und in allen Welten verfügbar sein, die dieses OAR importieren. | |
| − | <url> | + | <url> ist die URL des Profilservice dieser Welt. |
Example: | Example: | ||
| − | save oar --home=http:// | + | save oar --home=http://MeinGrid.com Meine.oar |
==== --perm ==== | ==== --perm ==== | ||
| − | + | Wenn die Option --perm angegeben wird, werden Objekte mit unzureichenden Berechtigungen nicht in der OAR gespeichert. Der Benutzer, dessen Berechtigungen überprüft werden, ist der Gutsbesitzer. Dies kann für Grids nützlich sein, die es ihren Kunden ermöglichen, ihre Regionen in OARs zu exportieren, da dadurch sichergestellt wird, dass das Exportieren nach OAR nicht zum Umgehen von Inhaltsberechtigungen verwendet werden kann. | |
| − | <permissions> | + | <permissions> gibt an, welche Berechtigungen benötigt werden. Es ist eine Zeichenfolge, die eines oder mehrere dieser Zeichen enthält: |
| − | + | ||
| − | + | ||
| − | + | * "C" = Kopieren | |
| − | save oar --perm=CT | + | * "T" = Übertragung |
| + | |||
| + | Beispiel: | ||
| + | save oar --perm=CT Meine.oar | ||
==== --all ==== | ==== --all ==== | ||
| − | + | Wenn die Option --all angegeben wird, enthält das OAR alle Regionen im Simulator. Wenn diese Option nicht angegeben ist (was der Standardwert ist), enthält die OAR nur die aktuelle Region. | |
| − | === | + | === Laden === |
| − | + | Dies ist eine Übersicht der häufigsten Parameter. Es sind viel mehr bei [[Load Oar]] dokumentiert. | |
==== --skip-assets ==== | ==== --skip-assets ==== | ||
| − | + | Wenn dies festgelegt ist, wird nicht versucht, eines der Assets aus dem OAR zu laden, obwohl alle anderen Daten geladen werden. Dies kann nützlich sein, wenn Sie die OAR zurück in ein Grid laden, von der Sie wissen, dass es bereits die Assets enthält. | |
==== --merge ==== | ==== --merge ==== | ||
| − | + | Wenn die Option --merge angegeben wird, wird die oar mit den vorhandenen Regionsobjekten zusammengeführt, anstatt sie zu ersetzen. Das vorhandene Terrain, die Regionseinstellungen und die Parzellen bleiben bestehen. | |
= Multi-Region OARs = | = Multi-Region OARs = | ||
Revision as of 01:20, 5 September 2018
 |
Languages: |
|
Contents |
Einführung
Die OpenSimulator Archive (OAR) -Funktion existiert seit OpenSimulator 0.5.9. Die Einrichtung führt einen ähnlichen Job wie load-xml2 / save-xml2 aus, indem sie Terrain -, Regions - Paketdaten, die Texturen von Objekten und ihre Inventare vollständig speichert, damit sie später erneut oder in einem anderen System geladen werden können.
Verwendung
In der Konsole kann folgende eingabe gemacht werden
save oar [--noassets] [-h|--home=<url>] [--publish] [--perm=<Berechtigungen>] [--all] [<Dateiname>]
Wenn kein Dateiname angegeben wird, wird der Name region.oar im aktuellen Verzeichnis verwendet.
Beispiele:
save oar save oar meine.oar save oar c:/sicherungsverzeichnis/dateiname.oar save oar oar-sicherungen/1-1-2018-MeineRegion.oar
Um ein Archiv zu laden, geben Sie folgendes ein
load oar [Optionen] [<Pfad-zur-oar>]
Der Speicherort kann ein Dateisystempfad sein (wie für "save oar") oder eine HTTP-Adresse, um eine oar direkt über das Web zu laden. Wenn kein Speicherort angegeben ist, sucht der Server im aktuellen Verzeichnis nach einer Datei mit dem Namen region.oar. Zum laden einer oar Datei siehe Load Oar.
Beispiele:
load oar load oar meine.oar load oar --merge oar-sicherungen/3rd-party.oar load oar http://PfadZur/oarDatei.oar
Standardmäßig werden beim Laden eines Archivs alle vorhandenen Objekte in den Regionen gelöscht und durch den Archivinhalt ersetzt. Es ist wie in der Matrix (wenn sie die Umgebungen wechseln), außer es ist viel langsamer (alle Szenenobjekte werden langsam gelöscht, bevor die neue Umgebung geladen wird :-)
Wenn ein Archiv geladen wird, werden Besitzer wiederhergestellt, wenn die relevanten UUIDs in der Benutzerdatenbank der OpenSimulator-Installation gefunden werden. Andernfalls wird der Prim-Besitz auf den Master-Avatar für die Region voreingestellt.
Ich empfehle, dass Sie Dateinamen mit der Endung .oar verwenden . Die Dateinamenserweiterung der Download-Links auf dieser Seite ist .tar.gz, was zeigt, dass das .oar- Format tatsächlich eine gezippte tar-Datei ist.
When an archive is loaded, owners will be restored if the relevant uuids can be found in the OpenSimulator 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.
Einstellungen
Speichern
--publish
Wenn diese Option aktiviert ist, werden Objekte im gespeicherten Ruder von Eigentümer- und letzten Besitzerinformationen gelöscht, jedoch nicht von Erstellerinformationen.
Dies ist nützlich, wenn Sie OARs veröffentlichen (statt sie zur Sicherung zu verwenden), wenn diese OARs möglicherweise in dasselbe Grid geladen werden, aus dem Sie veröffentlicht haben.
Ab OpenSimulator 0.7.4 entfernt dieser Schalter auch Eigentumsinformationen von Landparzellen.
Ab OpenSimulator 0.8.0 entfernt dieser Schalter auch Gruppeninformationen von der OAR.
--noassets
Wenn die Option --noassets angegeben wird, wird das Ruder ohne Assets gespeichert. Dies kann nützlich sein, wenn Sie die Asset-Datenbank separat sichern und nicht die Kosten für die Aufnahme aller Assets in jede OAR möchten.
--home
(früher bekannt als --profile bis 0.7.3)
Wenn die Option --home angegeben wird, werden allen Namen von Erstellern aus dieser Welt Links zu ihrer Heimatwelt hinzugefügt. Es ist nicht erforderlich, dass der Dienst betriebsbereit ist. Die Informationen werden hinzugefügt und in allen Welten verfügbar sein, die dieses OAR importieren.
<url> ist die URL des Profilservice dieser Welt.
Example:
save oar --home=http://MeinGrid.com Meine.oar
--perm
Wenn die Option --perm angegeben wird, werden Objekte mit unzureichenden Berechtigungen nicht in der OAR gespeichert. Der Benutzer, dessen Berechtigungen überprüft werden, ist der Gutsbesitzer. Dies kann für Grids nützlich sein, die es ihren Kunden ermöglichen, ihre Regionen in OARs zu exportieren, da dadurch sichergestellt wird, dass das Exportieren nach OAR nicht zum Umgehen von Inhaltsberechtigungen verwendet werden kann.
<permissions> gibt an, welche Berechtigungen benötigt werden. Es ist eine Zeichenfolge, die eines oder mehrere dieser Zeichen enthält:
- "C" = Kopieren
- "T" = Übertragung
Beispiel:
save oar --perm=CT Meine.oar
--all
Wenn die Option --all angegeben wird, enthält das OAR alle Regionen im Simulator. Wenn diese Option nicht angegeben ist (was der Standardwert ist), enthält die OAR nur die aktuelle Region.
Laden
Dies ist eine Übersicht der häufigsten Parameter. Es sind viel mehr bei Load Oar dokumentiert.
--skip-assets
Wenn dies festgelegt ist, wird nicht versucht, eines der Assets aus dem OAR zu laden, obwohl alle anderen Daten geladen werden. Dies kann nützlich sein, wenn Sie die OAR zurück in ein Grid laden, von der Sie wissen, dass es bereits die Assets enthält.
--merge
Wenn die Option --merge angegeben wird, wird die oar mit den vorhandenen Regionsobjekten zusammengeführt, anstatt sie zu ersetzen. Das vorhandene Terrain, die Regionseinstellungen und die Parzellen bleiben bestehen.
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.
The load-oar command supports both OAR formats (0.x and 1.x). When it's given a 1.x OAR file it loads all the regions in the OAR into the corresponding regions in the simulator, according to their position relative to the root region. If the simulator doesn't have a region in a location that is present in the OAR then that region isn't loaded.
For historical context, see Feature_Proposals/Multi-Region_OARs and Mantis 6105
Example OARs
OpenVCE 3D Assets OAR
The 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.
http://openvce.net/resources/downloads/
Get file "opensim-openvce.oar" from there (right click on the file in the above directory in your browser, and select download is the easiest way to obtain the materials). A "full" set of the buildings with a large 400 seat amphitheatre intended to be placed on the corner of 4 sims is also available via "opensim-openvce-full.oar". Images of the buildings in place in Opensim are at: Image 1, Image 2
Others
Please feel free to place links to other environments here, though unfortunately you'll have to host them on some other site.
Where to get content for OpenSim -- Hypergrid Business page, regularly updated, containing links to major OAR sites. Also has download links to individual OAR files.
http://forums.osgrid.org/viewforum.php
Tools
- [1] - oarinfo.py, a very basic Python script for printing out information about an OAR (number of contained objects, assets, etc.).
Further Information
- http://justincc.org/blog/category/oars/ - various OAR related articles from justincc, including background information and possible future development.
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
- 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
The region OpenSimulator Archive (OAR) format is designed with three aims in mind:
- Make it easy for people to read and change individual objects, assets, etc. within an archive.
- Make it easy to compose two region archives into a single region archive.
- Make it easy to compose archives from scratch.
Therefore, all the different entities (assets, objects, terrains, etc.) are packaged in individual files (e.g. one for each asset) with human readable filenames and machine readable extensions (e.g. .jp2 for textures, .txt for notecards).
- OAR Format 0.1
- OAR Format 0.2
- OAR Format 0.6
- OAR Format 0.7
- OAR Format 0.8 - the current default OAR save format.
- OAR Format 1.0
OAR Format Compatibility
All version 0.x OARs can be read by any earlier version of OpenSimulator, even if some of the content is ignored.
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.
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 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 OpenSimulator 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?
Yes, since OpenSim 0.7.5. See OpenSim Archives#Multi-Region OARs
3. Can you load and save parts of a region to an archive?
Not yet.
Current Status
Operational. Bug reports are appreciated 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.
