OpenSim Archives/fr

= Introduction =

La fonction OpenSimulator Archive (OAR) existe depuis OpenSimulator 0.5.9. Cette fonction fait un travail similaire à load-xml2/save-xml2 en ce sens qu'elle sauvegarde les prims afin qu'ils puissent être rechargés ultérieurement. Cependant, les archives d'OpenSimulator (OAR) vont un peu plus loin dans la mesure où elles peuvent sauvegarder toutes les données d'assets nécessaires afin que vous puissiez restaurer entièrement le terrain, les données des parcelles des régions, les textures des objets et leurs inventaires lorsque vous les chargez sur un système complètement différent utilisant une base de données d'assets différente.

= Usage =

Depuis la console de la région, on peut taper

save oar [--noassets] [-h|--home=&lt;url&gt;] [--publish] [--perm=&lt;permissions&gt;] [--all] [&lt;filename&gt;]

pour enregistrer une archive OpenSimulator. Si aucun nom de fichier n'est donné, alors le nom region.oar est utilisé dans le répertoire courant.

EXEMPLES: save oar save oar mon.oar save oar c:/mybackups/filename.oar save oar oars/11nov.oar

Pour charger une archive, tapez

load oar [options] [&lt;path-to-oar&gt;]

à la console. L'emplacement peut être un chemin de système de fichiers (comme pour "save oar") ou une adresse HTTP pour charger un oar directement sur le web. Si aucun emplacement n'est donné, alors le serveur cherche un fichier appelé region.oar dans le répertoire courant. Voir la documentation détaillée de "load oar" à Load Oar.

EXEMPLES: load oar load oar my.oar load oar my.oar load oar --merge oars/3rd-party.oar load oar http://path.to/oarfile.oar

Par défaut, le chargement d'une archive supprime tous les objets existants dans les régions et les remplace par le contenu de l'archive. C'est comme être dans Matrix (quand ils échangent les environnements), sauf que c'est beaucoup plus lent (tous les objets de la scène sont lentement supprimés avant que le nouvel environnement ne soit chargé :-)

Lorsqu'une archive est chargée, les propriétaires seront restaurés si les uuids correspondants peuvent être trouvés dans la base de données des utilisateurs de l'installation d'OpenSimulator. Sinon, la propriété des primitives sera attribuée par défaut à l'avatar maître de la région.

Je vous recommande d'utiliser des noms de fichiers avec l'extension .oar. L'extension du nom de fichier des liens de téléchargement sur cette page est .tar.gz ce qui illustre que le format .oar est en fait un fichier tar zippé.

--publish
Si cette option est activée, les objets de l'OAR sauvegardé sont dépourvus d'informations relatives au propriétaire et au dernier propriétaire, mais les informations relatives au créateur conservées.

Ceci est utile si vous publiez des OARs (plutôt que de les utiliser pour la sauvegarde) où ces OARs pourraient être chargés dans la même grille que celle à partir de laquelle vous avez publié.

À partir d'OpenSimulator 0.7.4, cette option supprime également les informations relatives à la propriété des parcelles de terrain.

À partir d'OpenSimulator 0.8.0, cette option supprime également les informations relatives aux groupes dans l'OAR.

--noassets
Si l'option --noassets est spécifiée, l'OAR sera sauvegardé sans les assets. Cela peut être pratique si vous sauvegardez la base de données des assets séparément et que vous ne voulez pas avoir à inclure tous les assets dans chaque OAR.

--home
(anciennement connu sous le nom de --profile jusqu'à la version 0.7.3)

Si l'option --home est spécifiée, tous les noms des créateurs de ce monde seront ajoutés avec des liens vers leur monde d'origine. Il n'est pas nécessaire que le service soit opérationnel ; l'information sera ajoutée et elle sera disponible dans tous les mondes qui importent cette OAR.

est l'URL du service de profil de ce monde.

Exemple: save oar --home=http://mygrid.com my.oar

--perm
Si l'option --perm est spécifiée, les objets dont les permissions sont insuffisantes ne seront pas enregistrés dans l'OAR. L'utilisateur dont les permissions sont vérifiées est le propriétaire du domaine. Cela peut être utile pour les grilles qui autorisent leurs utilisateurs à exporter leurs régions vers des OAR, car cela garantit que l'exportation vers des OAR ne peut pas être utilisée pour contourner les permissions de contenu.

spécifie quelles sont les permissions requises. Il s'agit d'une chaîne qui contient un ou plusieurs de ces caractères :
 * "C" = Copy
 * "T" = Transfer

Exemple: save oar --perm=CT my.oar

--all
Si l'option --all est spécifiée, le fichier OAR contiendra toutes les régions du simulateur. Si cette option n'est pas spécifiée (ce qui est le cas par défaut), le fichier OAR ne contiendra que la région courante.

Chargement
Ceci est un aperçu des paramètres les plus courants. Il y en a beaucoup d'autres documentés sur la page Load Oar.

--skip-assets
Si cette option est définie, cela ne chargera pas les assets de l'OAR, mais toutes les autres données seront chargées. Cela peut être utile si vous rechargez le fichier OAR dans une grille dont vous savez qu'elle contient déjà les ressources.

--merge
Si l'option --merge est spécifiée, l'OAR sera fusionné avec les objets de la région existante à la place de les remplacer. Le terrain, les paramètres régionaux et les parcelles existants seront laissés en place.

= OAR Multi-Régions =

Par défaut, la commande save-oar enregistre uniquement la région actuelle dans le fichier OAR (en utilisant le format OAR 0.8). Cependant, si l'option --all est spécifiée, toutes les régions du simulateur sont sauvegardées dans un fichier OAR multi-régions (en utilisant le format OAR 1.0). Ceci est utile lors de la sauvegarde d'un build qui s'étend sur plusieurs régions.

La commande load-oar supporte les deux formats OAR (0.x et 1.x). Lorsqu'elle reçoit un fichier OAR 1.x, elle charge toutes les régions de l'OAR dans les régions correspondantes du simulateur, en fonction de leur position par rapport à la région racine. Si le simulateur n'a pas de région dans un emplacement qui est présent dans l'OAR, alors cette région n'est pas chargée.

For historical context, see Feature_Proposals/Multi-Region_OARs and Mantis 6105

= Exemple d'OARs =

OpenVCE 3D Assets OAR
Les assets des mondes virtuels OpenVCE.net décrits à l'adresse http://openvce.net/vwassets et fournis par Clever Zebra et l'équipe OpenVCE.net de l'AIAI de l'université d'Édimbourg sont disponibles sous forme de fichier OAR (Opensim Archive).

http://openvce.net/resources/downloads/

Chargez le fichier "opensim-openvce.oar" à partir de là (un clic droit sur le fichier dans le répertoire ci-dessus dans votre navigateur, et sélectionnez télécharger est la façon la plus simple d'obtenir les fichiers). Un ensemble "complet" des bâtiments avec un grand amphithéâtre de 400 places destiné à être placé à l'angle de 4 sims est également disponible via "opensim-openvce-full.oar". Des images des bâtiments en place dans Opensim sont disponibles à l'adresse suivante : Image 1, Image 2

Autres
N'hésitez pas à placer des liens vers d'autres environnements ici, mais vous devrez malheureusement les héberger sur un autre site.

Où trouver du contenu pour OpenSim -- Page Hypergrid Business, régulièrement mise à jour, contenant des liens vers les principaux sites OAR. Elle contient également des liens de téléchargement vers les fichiers OAR individuels.

Zadaroo.com

Outworldz.com

http://forums.osgrid.org/viewforum.php

= Outils =


 * - oarinfo.py est un script Python très basique pour imprimer des informations sur un OAR (nombre d'objets contenus, actifs, etc.).

= Informations complémentaires =


 * http://justincc.org/blog/category/oars/ - Divers articles de justincc relatifs à l'OAR, y compris des informations générales et des développements futurs possibles. (Lien cassé)

= Cas d'utilisation =

Les utilisations actuelles possibles sont :

1. Migrer des données d'une base de données régionale SQLite vers une base de données MySQL.

2. Distribuer des régions entières à d'autres personnes.

3. Sauvegarder une ou plusieurs régions.

= Limites actuelles =


 * Les performances ne sont pas très bonnes avec les grandes archives. Ce problème sera résolu à l'avenir.
 * Le chargement de gros OAR à l'aide du plugin de base de données SQLite par défaut prendra beaucoup de temps (de l'ordre de plusieurs heures). Je vous recommande vivement de passer à MySQL si vous souhaitez charger des archives volumineuses.

= Format OAR = Le format   Archivage d'une région OpenSim (OAR) a été conçu avec trois objectifs en tête :


 * 1) Faciliter la lecture et la modification d'objets individuels, d'assets, etc. dans une archive.
 * 2) Faciliter la composition de deux archives de régions en une seule archive  de région.
 * 3) Faciliter la composition d'archives à partir de zéro.

Par conséquent, toutes les différentes entités (assets, objets, terrains, etc.) sont regroupées dans des fichiers individuels (par exemple, un pour chaque asset) avec des noms de fichiers lisibles par un humain et des extensions lisibles par la machine (par exemple, .jp2 pour les textures, .txt pour les notecards).


 * OAR Format 0.1
 * OAR Format 0.2
 * OAR Format 0.6
 * OAR Format 0.7
 * OAR Format 0.8 - format de sauvegarde d'OAR par défaut actuel.
 * OAR Format 1.0

Compatibilité avec le format OAR
Tous les OARs de la version 0.x peuvent être lus par toute version antérieure d'OpenSimulator, même si une partie du contenu est ignorée.

Le format OAR 1.0 n'est pas rétrocompatible, il ne peut donc être lu que dans OpenSim 0.7.5 et plus. Cependant, puisque la plupart des instances actuelles d'OpenSim ne peuvent pas lire ce format, il y a une période de transition pendant laquelle OpenSim enregistre toujours les OARs à région unique en utilisant le format OAR 0.8. Cela signifie que le comportement le plus courant (save-oar pour une seule région) crée des OAR lisibles par toutes les instances d'OpenSim. Le nouveau format OAR 1.0 n'est utilisé que lorsque l'option --all est utilisée.

= FAQ =

1. Quel est ce format .tar.gz que vous utilisez pour le format OAR interne ? Pourquoi pas zip ?

Le format .tar.gz est une méthode Unix standard pour compresser des fichiers en un seul fichier compressé de plus grande taille pour la distribution. Les utilisateurs de Windows devraient pouvoir ouvrir ces fichiers à l'aide de programmes gratuits tels que 7-zip.

J'utilise .tar.gz parce que toutes les bibliothèques zip (et tar) pour .net sont sous licence GPL (avec exception) ou sous MSPL. Malheureusement, tous les membres de l'équipe de développement d'OpenSimulator ne sont pas à l'aise avec la MSPL, donc actuellement, ces librairies ne sont pas une option. Il est également beaucoup plus facile d'écrire du code pour créer et lire des archives tar que des archives zip.

De plus, si vous ne faites que charger et sauvegarder des OAR (plutôt que de les démonter et de les remonter), alors vous n'avez pas besoin de vous soucier du format interne :)

2. Peut-on charger et sauvegarder plusieurs régions dans une archive ?

Oui, depuis OpenSim 0.7.5. Voir OpenSim_Archives/fr.

3. Peut-on charger et sauvegarder des parties d'une région dans une archive ?

Pas encore.

= Situation actuelle =

Opérationnel. Les rapports de bug sont appréciés Justincc. 14:53, 14 septembre 2009 (UTC)

Bien que nous nous efforcions de maintenir la compatibilité des anciennes archives avec les nouvelles versions d'OpenSimulator, veuillez ne pas compter sur ces archives comme seule sauvegarde pour les régions.