Inventory Archives/fr

= Introduction = Les archives d'inventaire d'OpenSimulator (IAR) sont un moyen par lequel les dossiers d'inventaire et les éléments peuvent être sauvegardés hors ligne dans un fichier unique (un IAR). Ce fichier peut ensuite être chargé dans une autre installation d'OpenSimulator.

Comme les Archives OpenSim, les IARs sauvegardent toutes les données d'assets nécessaires à la restauration complète des éléments, y compris les textures, les sons, les scripts et les objets contenus dans l'inventaire d'autres objets.

Les IARs sont activés dans OpenSimulator depuis la révision Git 5a64ca (OpenSimulator 0.6.7 et plus).

= Usage = Les IAR sont sauvegardés et chargés à partir de la console de région. Par défaut, ils sont enregistrés dans le répertoire /bin de votre installation, et un fichier IAR doit se trouver dans le répertoire /bin pour être importé.

save iar
La commande pour sauvegarder un IAR sur la console de la région est la suivante

save iar [-h|--home= ] [-v|--verbose] [--noassets] [--perm= ]  [ ]

Où


 *  est le nom de l'utilisateur dont l'inventaire doit être sauvegardé


 * est le chemin d'accès à un élément ou à un dossier de l'inventaire. Si le chemin d'accès est celui d'un dossier, ce dossier et tout son contenu (dossiers et éléments descendants) sont enregistrés. Si le chemin d'accès est celui d'un élément, seul cet élément est enregistré.

Les composants du chemin sont séparés par une barre oblique ("/"). Si vous devez spécifier un chemin avec des espaces, vous pouvez entourer le tout de guillemets doubles (par exemple, "Dossier A/Dossier B").

Vous pouvez spécifier que le contenu d'un dossier doit être enregistré plutôt que le dossier lui-même en utilisant le caractère générique *. Par exemple, "a/b/*" enregistrera le contenu du dossier b mais pas le dossier b lui-même.

Si un nom ou un dossier contient une barre oblique ("/"), il est possible de l'échapper avec la barre oblique inverse (par exemple, "\/") afin qu'elle ne soit pas considérée comme un séparateur de chemin. Les barres obliques inverses doivent elles-mêmes être échappées par une autre barre oblique inversée (par exemple, "\\").

Un autre problème est qu'il n'est pas possible de faire la distinction entre des dossiers ou des éléments nommés de manière identique dans le chemin d'accès - la solution consiste à renommer vos éléments/dossiers si vous devez les spécifier dans le chemin d'accès :)


 * est le mot de passe de l'utilisateur.


 * est un nom de fichier facultatif pour l'IAR. Si aucun nom n'est fourni, alors le nom de fichier user-inventory.iar est utilisé dans le répertoire courant. Je recommande que les iars aient l'extension .iar.

Switches

 * Si l'option --noassets est spécifiée, l'archive sera sauvegardée 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 archive.
 * --home= est l'URL du service de profil de ce monde. Il n'est pas nécessaire que le service de profil soit opérationnel ; l'information sera sauvegardée, et elle sera affichée partout où l'archive sera chargée. NOTE : l'ancienne option --profile (le nom précédent de ce switch) produisait des IARs qui ne sont pas compatibles avec OpenSimulator 0.7.0.2 et antérieur ; n'utilisez pas cette option si vous voulez produire un IAR compatible.
 * --verbose affiche des messages d'enregistrement verbeux.
 * Si l'option --perm est spécifiée, les éléments avec des permissions insuffisantes ne seront pas sauvegardés dans l'IAR. Cela peut être utile pour les grilles qui permettent à leurs clients d'exporter leurs inventaires vers les IAR, car cela garantit que l'exportation vers les IAR ne peut pas être utilisée pour contourner les permissions de contenu.

spécifie quelles sont les permissions requises. C'est une chaîne qui contient un ou plusieurs de ces caractères :
 * "C" = Copie
 * "T" = Transfert
 * "M" = Modifier

Exemples
Voici un exemple. Supposons que vous ayez une structure d'inventaire comme celle-ci

Mon inventaire |  +-- DossierA |          +-- DossierB | |        | +-- ItemX |        +-- ItemY Si vous tapez

save iar Jean Dupond DossierA MOTDEPASSE mes-items.iar

alors le DossierA et tout ce qui se trouve dans le DossierA (DossierB, ItemX et ItemY) seront sauvegardés dans un IAR appelé mes-items.iar. D'autre part, si vous tapez

save iar Jean Dupond DossierA/DossierB/ItemX MOTDEPASSE mes-items.iar

alors seul ItemX sera sauvegardé.

S'il y a un espace dans le chemin d'accès à l'élément, par exemple si le dossier de Jean Dupond s'appelle "Dossier A" au lieu de "DossierA", il faut mettre des guillemets autour du chemin d'accès sur la ligne de commande :

save iar Jean Dupond "Dossier A/DossierB/ItemX" MOTDEPASSE mes-items.iar

Sauvegarde de l'inventaire complet d'un utilisateur
Avec save iar, vous pouvez sauvegarder l'ensemble de votre inventaire ainsi que le contenu de dossiers particuliers ou d'éléments individuels.

Par exemple, en tapant

save iar Jean Dupond /* motdepasse

Cela sauvegardera votre inventaire complet dans user-inventory.iar (puisqu'aucun nom de fichier n'a été donné). Ceci peut être restauré plus tard en utilisant le commutateur --merge dans la commande load iar. Pour plus de détails, veuillez consulter la section "Restauration de l'inventaire complet d'un utilisateur" ci-dessous.

'''Veuillez noter que pour OpenSimulator 0.7.5 et avant, le chemin pour sauvegarder l'iar doit être spécifié comme "/*" et pas seulement "/". En spécifiant seulement "/", l'inventaire entier sera toujours sauvegardé mais il y aura un dossier de base appelé "My Inventory", qui sera créé lors du rechargement sous le dossier "My Inventory" existant de l'utilisateur.

'''Depuis le commit git master dev code d54d3180 (Sat Feb 16 00:49:06 2013) d'OpenSimulator, "/" sauvegardera également à la place l'inventaire complet de l'utilisateur sans le dossier "My Inventory". Ceci est dû au fait que "My Inventory" n'est pas un vrai dossier mais plutôt le nom de l'inventaire de l'utilisateur. Je pense que c'est plus intuitif et cela signifie que les inventaires sauvegardés en utilisant / peuvent être restaurés en utilisant la fonction load iar --merge également. Ce changement sera dans la prochaine version d'OpenSimulator (0.7.6). -- Justincc 02:26, 16 Février 2013 (UTC).

load iar
Un IAR peut être rechargé dans une instance d'OpenSimulator avec la commande load iar

load iar [-m|--merge]  [ ]

où


 * est le nom de l'utilisateur pour qui charger l'inventaire


 * est le chemin vers lequel l'IAR doit être chargé. Il doit s'agir d'un dossier qui existe déjà dans "My Inventory". Voir la commande save iar pour plus de détails.


 * est le mot de passe de l'utilisateur.


 * [ ] est un nom de fichier facultatif pour l'IAR. Si aucun n'est spécifié, le nom de fichier est supposé être user-inventory.iar dans le répertoire courant.

Switches

 * Si l'option --merge est donnée, alors les éléments IAR sont chargés dans la structure de dossiers existante lorsque cela est possible, au lieu de toujours créer de nouveaux dossiers.

Exemples
1. Supposons que "David Hume" ait reçu le fichier mes-items.iar enregistré ci-dessus contenant DossierA, DossierB, ItemX et ItemY. David Hume a déjà une structure d'inventaire comme celle-ci.

Mon inventaire | +-- Dossier1 |         +-- Dossier2 |             +-- Dossier 3

David veut charger l'IAR dans le Dossier3, donc sur la console de la région il exécute

load iar David Hume Dossier1/Dossier3 motdepasse mes-items.iar

Au bout d'un moment, il se retrouve avec la structure de dossiers suivante

Mon inventaire | +-- Dossier 1 |         +-- Dossier 2 |       +-- Dossier 3 |             +-- Dossier A              | +-- DossierB |      |              |       +-- ItemX |             +-- ItemY où ItemX et ItemY sont prêts à être rezzés.

S'il y a un espace dans le chemin d'accès de l'item, par exemple si le dossier de David s'appelle "Dossier 1" au lieu de "Dossier1", des guillemets autour du chemin d'accès sont nécessaires sur la ligne de commande :

load iar David Hume "Dossier 1/Dossier3" motdepasse mes-items.iar

À partir d'OpenSimulator 0.7, vous pouvez également charger les IAR directement à partir d'adresses web. Par exemple :

load iar Betrand Russell Dossier2 MOTDEPASSE http://justincc.org/downloads/iars/my-great-items.iar

chargera le fichier my-great-items.iar depuis le web dans le dossier 2 de l'utilisateur "Bertrand Russell".

2. Supposons qu'un utilisateur appelé Albert Camus possède une structure d'inventaire existante

Mon inventaire | +-- DossierA |     |  |      +-- Item1 | +-- DossierC |       +-- Item2

et nous exécutons

load iar --merge Albert Camus / MOTDEPASSE mes-items.iar

avec l'IAR enregistré ci-dessus. Au lieu de créer un double du DossierA, cela donnera la structure d'inventaire suivante

Mon Inventaire | +-- DossierA |    |  |     +-- DossierB |    |      |  |     |      +-- ItemX |    |  |     +-- Item1 |    |  |     +-- ItemY | +-- DossierC |       +-- Item2

Restauration de l'inventaire complet d'un utilisateur
L'option --merge est utile si vous restaurez un inventaire sauvegardé sur un nouveau compte utilisateur, puisque les dossiers de base (Gestures, Landmarks, Objects, etc.) ne seront pas dupliqués.

Par exemple, si vous avez sauvegardé l'inventaire complet d'un utilisateur comme indiqué ci-dessus, vous pouvez le restaurer dans l'inventaire d'un utilisateur nouvellement créé avec la commande.

load iar --merge Albert Camus / MOTDEPASSE mon-inventaire.iar

= Cas d'utilisation =

Utilisations possibles

1. Pour distribuer du contenu à d'autres installations OpenSimulator sans avoir à transférer des régions entières. Un inconvénient des IAR pour ce cas d'utilisation est que les noms des créateurs ne sont pas préservés, sauf si l'utilisateur a un profil sur l'installation cible. Une solution de contournement consiste à inclure une notecard détaillant le créateur et les conditions de licence du contenu.

2. Pour sauvegarder l'inventaire d'un utilisateur. Actuellement, les IARs ne sont pas le plus pratique pour faire cela. On peut sauvegarder un inventaire entier en indiquant un chemin d'accès "/" dans la commande iar de sauvegarde. Mais le chargement de ce type d'IAR signifie que les dossiers enfants 'standard' de la racine (Objects, Textures, Clothing, etc.) seront dupliqués. Les dossiers chargés n'auront pas d'icônes de type.

NDLR : dans ce cas il faudrait utiliser --merge ?

Limites actuelles

 * Le chargement et la sauvegarde des IAR sont actuellement effectués sur un seul thread. Cela peut bloquer la console pendant un certain temps avec des IARs très volumineux. Ce problème devrait être résolu à l'avenir.


 * Les noms des créateurs ne sont pas préservés si le profil n'existe pas sur le système cible. Ce problème pourrait être résolu à l'avenir.

Format des IAR
Le format OpenSimulator Inventory Archive (IAR) est conçu avec trois objectifs en tête :


 * 1) Faciliter la lecture et la mise à jour d'éléments individuels, d'assets, etc. au sein d'une archive.
 * 2) Faciliter la composition de deux archives d'inventaire en une seule archive d'inventaire.
 * 3) Faciliter la composition d'archives à partir de zéro.

Par conséquent, toutes les différentes entités (asstes, items, etc.) sont regroupées dans des fichiers individuels (par exemple, un pour chaque asset) avec des noms de fichiers lisibles par l'homme et des extensions lisibles par la machine (par exemple, .jp2 pour les textures, .txt pour les fiches).
 * IAR Format 0.1
 * IAR Format 0.2
 * IAR Format 0.3

= Bogues =

Please search the OpenSimulator Mantis for information on current IAR bugs.

23.FÉV. 2010 :

Il y a une légère "bizarrerie" avec MySql en ce qui concerne la taille Max_Allowed_Packet, qui est par défaut de 1 Megabyte.&nbsp ; C'est trop petit pour certains des plus grands blobs de données stockées.&nbsp ; Il est recommandé d'augmenter la valeur par défaut à 16 Megabytes.

Localisez votre MY.ini pour MySql (EXEMPLE, sous Windows, il est situé à "C:\Program Files\MySQL\MySQL Server 5.1")&nbsp ; Modifiez ce fichier pour inclure ce qui suit dans la section mysqld :

[mysqld]'.

port=3306 max_allowed_packet = 16M
 * 1) Le port TCP/IP sur lequel le serveur MySQL écoutera

Référence supplémentaire:&nbsp ; dev.mysql.com/doc/refman/5.1/fr/packet-too-large.html

= Situation actuelle = Opérationnel. Les rapports de bogues sont appréciés via les canaux habituels de Mantis.

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 votre seule sauvegarde pour l'inventaire.

= Fichiers IAR téléchargeables =


 * http://justincc.org/downloads/iars/my-great-items.iar - l'exemple initial de justincc IAR.
 * http://www.aviefactory.com/Gene_Jacobs_Clothes.iar - Collection de vêtements pour hommes de Gene Jacobs (Créateur original)
 * http://www.aviefactory.com/Genes_Female_Stuff.iar - Peaux et formes de femmes (Trouvé sur le web)
 * http://www.gridhop.net/IAR/lightshare.iar - Contrôleur LightShare de txOh. Utile uniquement si vous avez activé LightShare dans OpenSim.ini.

N'hésitez pas à placer des liens vers d'autres IARs ici.

= Liens externes =

http://justincc.org/blog/category/iars/ - articles de justincc sur les IAR, y compris des didacticiels, des informations générales et des développements futurs possibles. (lien cassé)

The OpenSimulator Library just got more interesting - L'article de Diva Canto sur la façon d'étendre la bibliothèque OpenSimulator en utilisant les IAR.

= Voir aussi =


 * Comment utiliser les archives d'OpenSimulator (OAR)