Inventory Archives - Revision history

Tampa at 11:27, 18 March 2025

2025-03-18T11:27:40Z

Ferd Frederix: /* save iar */ added option --skipbadassets to iar save.

2025-03-16T23:32:35Z

‎save iar: added option --skipbadassets to iar save.

Acryline at 10:05, 16 October 2021

2021-10-16T10:05:59Z

AliciaRaven: /* save iar */

2014-09-27T01:34:11Z

‎save iar

Fleep: /* Usage */ - IARs are saved to the /bin directory by default and an IAR file must be located in /bin to import

2013-07-11T12:18:10Z

‎Usage: - IARs are saved to the /bin directory by default and an IAR file must be located in /bin to import

Justincc: /* Current Status */

2013-02-16T02:53:52Z

‎Current Status

Justincc at 02:53, 16 February 2013

2013-02-16T02:53:15Z

Justincc: /* Examples */

2013-02-16T02:39:47Z

‎Examples

Justincc: /* Saving an entire user's inventory */

2013-02-16T02:35:51Z

‎Saving an entire user's inventory

Justincc: /* Saving an entire user's inventory */

2013-02-16T02:35:34Z

‎Saving an entire user's inventory

← Older revision		Revision as of 11:27, 18 March 2025
Line 1:		Line 1:
−	{{Quicklinks}}	+	{{Quicklinks\|Inventory_Archives}}
	<br />		<br />

@@ Line 18: / Line 18: @@
 The command to save an IAR on the region console is
-  save iar [-h|--home=<url>] [-v|--verbose] [--noassets] [--perm=<permissions>] <user-name> <path> <password> [<filename>]
+  save iar [-h|--home=<url>] [-v|--verbose] [--noassets] [--perm=<permissions>] [--skipbadassets] <user-name> <path> <password> [<filename>]
 where
@@ Line 36: / Line 36: @@
 * <password> is the password of the user.
-* <filename> is an optional filename for the IAR. If none is supplied, then the filename user-inventory.iar is used in the current directory. I recommend that iars have the .iar extension.
+* <filename> is an optional filename for the IAR. If none is supplied, then the filename user-inventory.iar is used in the current directory. I recommend that IARs have the .iar extension.
 === Switches ===
+* If the option --skipbadassets is added, this will skip inventory items with missing or empty parts. Only in code after  0.9.3 (dev) commit #b13c4c as of [2025-02-10 22:52:53]
 * If the --noassets option is specified, then the archive 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 archive.
 * --home=<url> is the URL of this world's profile service. It is not required that the profile service is operational; the information will be saved, and it will be displayed wherever the archive will be loaded. NOTE: the older --profile option (the previous name of this switch) produced IARs that are not compatible with OpenSimulator 0.7.0.2 and earlier; do not use this option if you want to produce a compatible IAR.

@@ Line 251: / Line 251: @@
 = Downloadable IAR files =
-* http://justincc.org/downloads/iars/my-great-items.iar - justincc's initial example IAR.
+* http://justincc.org/downloads/iars/my-great-items.iar - justincc's initial example IAR. (Broken link)
-* http://www.aviefactory.com/Gene_Jacobs_Clothes.iar - Gene Jacobs Men's Clothing Collection (Original Creator)
+* http://www.aviefactory.com/Gene_Jacobs_Clothes.iar - Gene Jacobs Men's Clothing Collection (Original Creator)(Broken link)
-* http://www.aviefactory.com/Genes_Female_Stuff.iar - Female Skins and Shapes (Found off the web)
+* http://www.aviefactory.com/Genes_Female_Stuff.iar - Female Skins and Shapes (Found off the web)(Broken link)
-* http://www.gridhop.net/IAR/lightshare.iar - [[User:Thomax|txOh]]'s LightShare controller. Useful only if you have [[LightShare]] enabled in OpenSim.ini.
+* http://www.gridhop.net/IAR/lightshare.iar - [[User:Thomax|txOh]]'s LightShare controller. Useful only if you have [[LightShare]] enabled in OpenSim.ini.(Broken link)
 Please feel free to place links to other IARs here.
@@ Line 260: / Line 260: @@
 = External Links =
-[http://justincc.org/blog/category/iars/ http://justincc.org/blog/category/iars/] - articles by justincc on IARs, including tutorials, background information and possible future developments.
+[http://justincc.org/blog/category/iars/ http://justincc.org/blog/category/iars/] - articles by justincc on IARs, including tutorials, background information and possible future developments.(Broken link)
 [http://www.metaverseink.com/blog/?p=29 The OpenSimulator Library just got more interesting] - Diva Canto's article on how to extend the OpenSimulator Library using IARs.

@@ Line 18: / Line 18: @@
 The command to save an IAR on the region console is
-  save iar [-h|--home=<url>] [-v|--verbose] [--noassets] <user-name> <path> <password> [<filename>]
+  save iar [-h|--home=<url>] [-v|--verbose] [--noassets] [--perm=<permissions>] <user-name> <path> <password> [<filename>]
 where
@@ Line 43: / Line 43: @@
 * --home=<url> is the URL of this world's profile service. It is not required that the profile service is operational; the information will be saved, and it will be displayed wherever the archive will be loaded. NOTE: the older --profile option (the previous name of this switch) produced IARs that are not compatible with OpenSimulator 0.7.0.2 and earlier; do not use this option if you want to produce a compatible IAR.
 * --verbose prints out versbose saving messages
 === Examples ===

@@ Line 12: / Line 12: @@
 = Usage =
-IARs are saved and loaded from the region console.
+IARs are saved and loaded from the region console.  By default, they are saved to the /bin directory of your installation, and an IAR file must be located in the /bin directory to be imported.
 == save iar ==

@@ Line 239: / Line 239: @@
 = Current Status =
-Operational but experimental. Bug reports are appreciated and there will almost certainly be quite a few right now. Suggestions for improvement are also welcome. The best place for these right now might be [http://justincc.org/blog/2009/09/14/introducing-opensim-inventory-archives-iars/ my blog post on IARs], since I'm bound to see them then.
+Operational. Bug reports appreciated through the usual Mantis channels.
 Though we will strive to maintain compatibilty for old archives with newer OpenSimulator versions, please do not rely on these archives as your only backup for inventory.

@@ Line 220: / Line 220: @@
 * [[IAR Format 0.2]]
 * [[IAR Format 0.3]]
 = Bugs =

@@ Line 185: / Line 185: @@
+         |
          +-- Item2
 The --merge option is useful if you are restoring a saved inventory to a new user account, since the base folders (Gestures, Landmarks, Objects, etc.) will not be duplicated.
 = Use cases =

@@ Line 82: / Line 82: @@
 would save your entire inventory to user-inventory.iar (since no filename was given).  This can later be restored using the --merge switch in the load iar command.  For more details please see the "Restoring an entire user's inventory" section below.
-'''Please note that for OpenSimulator 0.7.5 and before, the path for save iar must be specified as "/*" and not just "/".  Specifying only "/" will still save the entire inventory but there will be a base folder called "My Inventory", which will be created on reload under a user's existing "My Inventory" folder.
+'''Please note that for OpenSimulator 0.7.5 and before, the path for save iar must be specified as "/*" and not just "/".  Specifying only "/" will still save the entire inventory but there will be a base folder called "My Inventory", which will be created on reload under a user's existing "My Inventory" folder.'''
-From OpenSimulator git master dev code commit d54d3180 (Sat Feb 16 00:49:06 2013), "/" will also instead save the user's entire inventory without the "My Inventory" folder.  This is because "My Inventory" is not actually a real folder but rather the name of the user's inventory.  I believe this is more intuitive and it means that inventories saved using / can be restored using the load iar --merge function as well.  This change will be in the next OpenSimulator release (0.7.6). -- [[User:Justincc|Justincc]] 02:26, 16 February 2013 (UTC)'''
+'''From OpenSimulator git master dev code commit d54d3180 (Sat Feb 16 00:49:06 2013), "/" will also instead save the user's entire inventory without the "My Inventory" folder.  This is because "My Inventory" is not actually a real folder but rather the name of the user's inventory.  I believe this is more intuitive and it means that inventories saved using / can be restored using the load iar --merge function as well.  This change will be in the next OpenSimulator release (0.7.6). -- [[User:Justincc|Justincc]] 02:26, 16 February 2013 (UTC)'''
 == load iar ==