Check inventory script/de

Revision as of 22:57, 12 May 2022 (view source) Manni (Talk | contribs) ← Older edit		Revision as of 23:16, 12 May 2022 (view source) Manni (Talk | contribs) (→‎How to resolve issues) Newer edit →
Line 44:		Line 44:
	</div>		</div>
−	== How to resolve issues ==	+	== So lösen Sie Probleme ==
−	Inventory setup was meant to have a single root folder, called "My Inventory". All folders should be sorted underneath this folder.	+	Die Inventareinrichtung sollte einen einzelnen Stammordner namens "My Inventory" haben. Alle Ordner sollten unterhalb dieses Ordners sortiert werden.
−	The usual folders for Clothing, Objects and even Trash have specific types designed to give them their icons and provide a way to sort incoming items accordingly. Only one set of these is meant to exist, but OpenSim adds a second set of these folders to the inventory under the "My Suitcase" folder used for the HG1.0 protocol.	+	<pre style="color: red">Achtung!!! Auch wenn ihnen im Inventar Deutsche Namen der Standartverzeichnisse angezeigt werden, müssen sie beim zugriff die Englischen Namen dieser Ordner benutzen.</pre>
−	You can read more about the folder types in the [http://opensimulator.org/wiki/Inventoryfolders Database documentation]	+	Die üblichen Ordner für Kleidung, Gegenstände und sogar Papierkorb haben bestimmte Typen, die ihnen ihre Symbole geben und eine Möglichkeit bieten, eingehende Gegenstände entsprechend zu sortieren. Nur ein Satz davon soll existieren, aber OpenSim fügt einen zweiten Satz dieser Ordner zum Inventar unter dem Ordner „Mein Koffer“ hinzu, der für das HG1.0-Protokoll verwendet wird.
−	To resolve issues the inventory structure needs to be returned to the proper setup accepted by the viewers. To do this you will need to edit the inventoryfolders database table. This can be done from the command line or via external programs such as [https://dbeaver.io/ DBeaver] or [https://www.navicat.com/en/ Navicat] whichever you prefer.	+	Weitere Informationen zu den Ordnertypen finden Sie in der [http://opensimulator.org/wiki/Inventoryfolders Database documentation]
		+	Um Probleme zu lösen, muss die Bestandsstruktur auf die richtige, von den Zuschauern akzeptierte Einrichtung zurückgesetzt werden. Dazu müssen Sie die Datenbanktabelle "inventoryfolders" bearbeiten. Dies kann über die Befehlszeile oder über externe Programme wie [https://dbeaver.io/ DBeaver] oder [https://www.navicat.com/en/ Navicat] je nachdem, was Sie bevorzugen.
−	==== Create a backup ====
−	'''Using tools like sqldump or the aforementioned database tools create a backup of the inventoryfolders table first before making edits to the table!'''	+	==== Erstellen einer Sicherung ====
		+	'''Verwenden Sie Tools wie sqldump oder die oben genannten Datenbanktools, um zuerst eine Sicherungskopie der Inventoryfolders-Tabelle zu erstellen, bevor Sie Änderungen an der Tabelle vornehmen!'''
−	==== Find the user ====
−	Using either filters or an SQL query to select just the user we are concerned with filter for the "AgentID" in inventoryfolders.	+	==== Benutzer suchen ====
		+
		+	Verwenden Sie entweder Filter oder eine SQL-Abfrage, um nur den Benutzer auszuwählen, um den wir uns mit dem Filter für die "AgentID" in den Inventarordnern kümmern.
	<pre style="color: darkblue"> SELECT * FROM inventoryfolders WHERE `AgentID` = 'user-uuid' ;</pre>		<pre style="color: darkblue"> SELECT * FROM inventoryfolders WHERE `AgentID` = 'user-uuid' ;</pre>
−	==== Check the specific folders ====	+	==== Überprüfen der spezifischen Ordner ====
−	The script will check for folders that are not "-1" of type, which signifies a normal folder a user might create. To fetch just these folders add a filter to only show folders not of this type.	+	Das Skript sucht nach Ordnern, die nicht vom Typ "-1" sind, was auf einen normalen Ordner hinweist, den ein Benutzer erstellen könnte. Um nur diese Ordner abzurufen, fügen Sie einen Filter hinzu, um nur Ordner anzuzeigen, die nicht von diesem Typ sind.
	<pre style="color: darkblue"> SELECT * FROM inventoryfolders WHERE `AgentID` = 'user-uuid' AND `type` != '-1' ;</pre>		<pre style="color: darkblue"> SELECT * FROM inventoryfolders WHERE `AgentID` = 'user-uuid' AND `type` != '-1' ;</pre>
−	==== Find the duplicates ====	+	==== Duplikate finden ====
		+
		+	Die Ordner unter "My Suitcase" zu finden ist jetzt ganz einfach. Sie sollten den Ordner "My Inventory" in den ausgewählten Zeilen sehen, der auch die parentFolderID anzeigt, die ein null key sein sollte, dh "00000000-0000-0000-0000-000000000000". Sie können die folderID auch hier sehen. Diese UUID ist das, was alle richtigen anderen Inventarordner wie Clothing, Objects und Trash in ihrer jeweiligen parentFolderID anzeigen. Dadurch wird eine Hierarchie erstellt, die mit "My Inventory" beginnt und sich bis zu allen Ordnern in der Inventarstruktur erstreckt.
		+
		+	Wenn Sie die Abfrage jetzt nach dem folderName sortieren, werden die Duplikate und ihre übergeordnete parentFolderID leicht angezeigt, die nicht auf "My Inventory", sondern auf den Ordner "My Suitcase" und seine folderID zeigen.
		+
−	To find the folders under "My Suitcase" is easy now. You should see the "My Inventory" folder in the selected set of rows showing also the parentFolderID, which should be a null key i.e. "00000000-0000-0000-0000-000000000000".
−	You can see it's folderID as well here. This UUID will be what all proper other inventory folders, such as Clothing, Objects and Trash, will show in their respective parentFolderID.
−	This creates a hierarchy starting with "My Inventory" and cascading down to all folders in the inventory structure.
−
−	Now sorting the query by the folderName will easily show the duplicates and their parentFolderID pointing not to "My Inventory" but the "My Suitcase" folder and its folderID.
	<pre style="color: darkblue"> SELECT * FROM inventoryfolders WHERE `AgentID` = 'user-uuid' AND `type` != '-1' ORDER BY folderName DESC;</pre>		<pre style="color: darkblue"> SELECT * FROM inventoryfolders WHERE `AgentID` = 'user-uuid' AND `type` != '-1' ORDER BY folderName DESC;</pre>

---

Revision as of 23:16, 12 May 2022

Contents 1 Überprüfen des Inventarskript 1.1 Das Skript 1.2 Verwendungszweck 2 So lösen Sie Probleme 2.1 Erstellen einer Sicherung 2.2 Benutzer suchen 2.3 Überprüfen der spezifischen Ordner 2.4 Duplikate finden 2.5 Remove duplicates 2.6 Checking bad root folders

Überprüfen des Inventarskript

Vor 2022 akzeptierten die Viewer jede Form von Inventar.

Dies hat sich nun geändert, da Viewern neuer Code hinzugefügt wurde, um zu überprüfen, ob die Bestandsstruktur ordnungsgemäß eingerichtet ist.

Leider weisen aufgrund von Fehlern und Änderungen in OpenSim einige ältere Inventare von Benutzern, die vor 2015 erstellt wurden,

problematische Strukturen auf, die dazu führen können, dass das Inventar nicht geladen oder die Anmeldung vollständig blockiert wird.

Dieses Skript soll Grid-Betreibern eine Möglichkeit geben, das Inventar eines Benutzers oder aller Benutzer zu validieren,

um zu sehen bei welchen wahrscheinlich Probleme auftreten und was genau falsch ist.

Wir beschreiben hier auch die Schritte und Tools zur Behebung dieser Probleme.

Das Skript

Derzeit ein Github-Gist der Einfachheit halber, bitte richten Sie Probleme oder Anfragen an IRC

Check Inventory Script

Verwendungszweck

Das Skript erfordert einen Server, auf dem PHP7.4 installiert ist.

• Öffnen Sie das Skript mit Ihrem bevorzugten Editor und überprüfen Sie das oberste Setup auf $database info Variablen. Stellen Sie sie so ein, dass sie sich mit Ihrer Grid-Datenbank verbinden, die die Inventoryfolder-Tabelle enthält.

• Führen Sie das Skript über aus

   php check_inventory.php FirstName LastName 

  Dadurch wird das Skript ausgeführt, das nach schwerwiegenden Inventarfehlern sucht.

• Führen Sie das Skript über aus

   php check_inventory.php FirstName LastName true

  Führt das Skript aus und sucht nach optionalen doppelten Ordnern desselben Typs.

Das Skript kann auch für alle Benutzer ausgeführt werden, aber die Ausgabe wird ziemlich groß sein. Es ist am besten, wenn möglich, die Ausgabe in eine Datei zu leiten.

 php check_inventory.php everyone true

Führt das Skript aus und sucht nach optionalen doppelten Ordnern desselben Typs für alle Benutzer in der UserAccounts-Tabelle.

So lösen Sie Probleme

Die Inventareinrichtung sollte einen einzelnen Stammordner namens "My Inventory" haben. Alle Ordner sollten unterhalb dieses Ordners sortiert werden.

Achtung!!! Auch wenn ihnen im Inventar Deutsche Namen der Standartverzeichnisse angezeigt werden, müssen sie beim zugriff die Englischen Namen dieser Ordner benutzen.

Die üblichen Ordner für Kleidung, Gegenstände und sogar Papierkorb haben bestimmte Typen, die ihnen ihre Symbole geben und eine Möglichkeit bieten, eingehende Gegenstände entsprechend zu sortieren. Nur ein Satz davon soll existieren, aber OpenSim fügt einen zweiten Satz dieser Ordner zum Inventar unter dem Ordner „Mein Koffer“ hinzu, der für das HG1.0-Protokoll verwendet wird.

Weitere Informationen zu den Ordnertypen finden Sie in der Database documentation

Um Probleme zu lösen, muss die Bestandsstruktur auf die richtige, von den Zuschauern akzeptierte Einrichtung zurückgesetzt werden. Dazu müssen Sie die Datenbanktabelle "inventoryfolders" bearbeiten. Dies kann über die Befehlszeile oder über externe Programme wie DBeaver oder Navicat je nachdem, was Sie bevorzugen.

Erstellen einer Sicherung

Verwenden Sie Tools wie sqldump oder die oben genannten Datenbanktools, um zuerst eine Sicherungskopie der Inventoryfolders-Tabelle zu erstellen, bevor Sie Änderungen an der Tabelle vornehmen!

Benutzer suchen

Verwenden Sie entweder Filter oder eine SQL-Abfrage, um nur den Benutzer auszuwählen, um den wir uns mit dem Filter für die "AgentID" in den Inventarordnern kümmern.

 SELECT * FROM inventoryfolders WHERE `AgentID` = 'user-uuid' ;

Überprüfen der spezifischen Ordner

Das Skript sucht nach Ordnern, die nicht vom Typ "-1" sind, was auf einen normalen Ordner hinweist, den ein Benutzer erstellen könnte. Um nur diese Ordner abzurufen, fügen Sie einen Filter hinzu, um nur Ordner anzuzeigen, die nicht von diesem Typ sind.

 SELECT * FROM inventoryfolders WHERE `AgentID` = 'user-uuid' AND `type` != '-1' ;

Duplikate finden

Die Ordner unter "My Suitcase" zu finden ist jetzt ganz einfach. Sie sollten den Ordner "My Inventory" in den ausgewählten Zeilen sehen, der auch die parentFolderID anzeigt, die ein null key sein sollte, dh "00000000-0000-0000-0000-000000000000". Sie können die folderID auch hier sehen. Diese UUID ist das, was alle richtigen anderen Inventarordner wie Clothing, Objects und Trash in ihrer jeweiligen parentFolderID anzeigen. Dadurch wird eine Hierarchie erstellt, die mit "My Inventory" beginnt und sich bis zu allen Ordnern in der Inventarstruktur erstreckt.

Wenn Sie die Abfrage jetzt nach dem folderName sortieren, werden die Duplikate und ihre übergeordnete parentFolderID leicht angezeigt, die nicht auf "My Inventory", sondern auf den Ordner "My Suitcase" und seine folderID zeigen.

 SELECT * FROM inventoryfolders WHERE `AgentID` = 'user-uuid' AND `type` != '-1' ORDER BY folderName DESC;

Observe, the "My Suitcase" folder's parent folder is also "My Inventory" folder.

Remove duplicates

Unless you are running the HG1.0 protocol using the "My Suitcase" folder to share items on the hypergrid without exposing your entire inventory you don't actually need the folder or it's sub-folders.

However, removing the folder entirely when it might contain items the user placed there might not be the best idea. Instead simply change the type of each duplicate folder to "-1" to make them regular folders.

 UPDATE inventoryfolders SET `type` = '-1' WHERE `AgentID` = 'user-uuid' AND `parentFolderID` != 'folderID of My Inventory' AND `parentFolderID` != '00000000-0000-0000-0000-000000000000'; 

This will set all folders to type "-1" for that specific user if the parent folder is not "My Inventory", which will change all "My Suitcase" sub-folders.

Checking bad root folders

Newer versions of OpenSim will put the "My Suitcase" folder as a type that does not conflict, usually type "100", but older versions will have put it as type "8" or "9", which causes a fatal error. To resolve this change the type to "100".

 UPDATE inventoryfolders SET `type` = '100' WHERE `AgentID` = 'user-uuid' AND `folderName` = 'My Suitcase'; 

In some cases the "My Inventory" folder might still be of the old type "9", which will also causes issues. To resolve this it needs to be changed to type "8".

 UPDATE inventoryfolders SET `type` = '8' WHERE `AgentID` = 'user-uuid' AND `folderName` = 'My Inventory'; 

These queries can, but probably should not be, run for all users by omitting the where clause specifying the agent UUID. We strongly suggest you look at each users inventory separately and make changes as required!!