PCampBot/de - Revision history

Manni at 11:42, 4 December 2023

2023-12-04T11:42:41Z

Manni: /* Schritt 5: Bots trennen */

2021-11-11T10:01:47Z

‎Schritt 5: Bots trennen

Manni: /* Schritt 2: pCampbot starten */

2021-11-11T09:54:49Z

‎Schritt 2: pCampbot starten

Manni: /* Optional pCampbot.ini configuration */

2021-11-11T09:42:23Z

‎Optional pCampbot.ini configuration

Manni: /* Verwendung von pCampbot ab OpenSimulator 0.7.6 */

2021-11-11T09:32:11Z

‎Verwendung von pCampbot ab OpenSimulator 0.7.6

Manni: /* Beispiel */

2021-11-11T09:31:05Z

‎Beispiel

Manni: /* Verwendung von pCampbot ab OpenSimulator 0.7.6 */

2021-11-11T09:17:58Z

‎Verwendung von pCampbot ab OpenSimulator 0.7.6

Manni: Created page with "{{Quicklinks}} = Verwendung von pCampbot ab OpenSimulator 0.7.6 = pCampBot hat sich im OpenSimulator-Entwicklungscode erheblich geändert. Hier ist die aktuelle Verwendungsan..."

2021-11-11T09:07:42Z

Created page with "{{Quicklinks}} = Verwendung von pCampbot ab OpenSimulator 0.7.6 = pCampBot hat sich im OpenSimulator-Entwicklungscode erheblich geändert. Hier ist die aktuelle Verwendungsan..."

New page

{{Quicklinks}}

= Verwendung von pCampbot ab OpenSimulator 0.7.6 =
pCampBot hat sich im OpenSimulator-Entwicklungscode erheblich geändert. Hier ist die aktuelle Verwendungsanweisung, die Sie erhalten, wenn Sie pCampBot.exe ab OpenSimulator 0.7.6 ausführen.

<pre>
Verwendung: pCampBot <-loginuri loginuri> [OPTIONS]
Spawnt eine Reihe von Bots, um eine OpenSim-Region zu testen

-l, -loginuri - loginuri für Grid/Standalone (erforderlich)
-s, -start - Startposition für Bots (optional). Kann "last", "home" oder ein bestimmter Ort mit oder ohne Koordinaten sein (zB "region1" oder "region2/50/30/90"
-firstname - Vorname für die Bots (erforderlich)
-lastname - Nachname für die Bots (erforderlich). An jeden Nachnamen wird _<bot-number> angehängt, zB Ima Bot_0
-password - Passwort für die Bots (erforderlich)
-n, -botcount - Anzahl der zu startenden Bots (Standard: 1) (optional)
-f, -from - Startnummer für Login-Bot-Namen, zB 25 wird Ima Bot_25, Ima Bot_26 usw. anmelden (Standard: 0) (optional)
-c, -connect - alle Bots beim Start verbinden (optional)
-b, behaviours - Verhaltens für Bots. Komma getrennt, zB p,g. Standard ist p (erforderlich)
aktuelle Optionen sind:
p (Physik - Bots bewegen und springen ständig herum)
g (grab - Bots klicken zufällig auf Prims, egal ob sie anklickbar sind oder nicht)
n (keine - Bots tun nichts)
t (teleportieren - Bots teleportieren sich regelmäßig zwischen Regionen im Netz)
-wear - Ordner, aus dem die Erscheinungsdaten geladen werden, "no", wenn kein solcher Ordner vorhanden ist (Standard: no) (optional)
-h, -help - diese Nachricht anzeigen.
</pre>

You must have already created all the necessary bot accounts in the simulator before using pCampbot. It does not create these accounts on the fly.

Because pCampbot connects bots using the [http://lib.openmetaverse.org libopenmetaverse] library in the same manner that an ordinary viewer program would connect, you can use the pCampbot in 0.7.6 or later to test earlier versions of OpenSimulator.

The -wear option almost certainly doesn't work. The others are operational.

On using this facility you'll get a console command line similar to the one in OpenSimulator and Robust. Type "help" at this prompt to see further commands.

== Optional pCampbot.ini configuration ==
pCampbot has some further optional configuration options relating to detailed bot behaviour in pCampbot.ini.example. To change these from the defaults

cp pCampbot.ini.example pCampbot.ini

and change pCampbot.ini accordingly.

== Caveats ==

* A pCampBot synthetic bot load is still an extremely poor proxy for a 'real' connection (i.e. a real human being logging in with a viewer and doing all the things they expect to be able to do in a virtual world). Real connections are very likely to place different stresses on the simulator so real-world performance may be considerably different and poorer than synthetic load tests would suggest.

* There are some things you can do to improve this in pCampbot. For instance, if you have RequestObjectTextures set in pCampbot.ini then pCampbot will request textures for all objects it sees. This is both much less stressful than a real scenario (since for a particular sets of bots textures are only requested once) and more stressful (since there is never any caching).

* pCampbot does currently not work well if there are any surrounding regions. Avatars will currently just walk off into oblivion. You must either build fences or remove such regions. In testing so far, the presence of neighbouring regions does not have any great impact on performance in the region occupied by bots. However, these tests were performed with blank surrounding regions - surrounding regions containing objects will place more initial stress on the bot connections as object data is downloaded (and textures if this option is active).

== Example ==
Okay, let's suppose that we're on Linux and want to create a 5 bot synthetic load test on a region called myregion1. Depending on your bandwidth and the bot settings you can connect quite a large number of bots but for this example we will stick with 5. Here are the steps to take.

=== Step 1: Create bot accounts ===
The first step is to create 5 bot accounts, all with the same password. Each bot account must have the same first name and the same last name prefix. But each bot must also have its last name prefix appended with an underscore (_) and its bot number, starting from 0. In this case, we want five bots, and lets suppose we will call them "ima bot". Then the five accounts that we want are

ima bot_0
ima bot_1
ima bot_2
ima bot_3
ima bot_4

The classic way to create a user account is to do it by using the "create user" command on the OpenSimulator standalone or Robust service console, depending on whether one is running in standalone or grid mode. However, this can be laborious, particularly if one needs hundreds of bot accounts. There's a very basic python script at https://github.com/justincc/opensimulator-tools/blob/master/create-user-line-generator/src/culg.py ( dead link ) which will generate the user lines needed, giving each account a non-random UUID for later debugging purposes. The lines that this script generated can be pasted directly into the OpenSimulator console.

=== Step 2: Start pCampbot ===
The next step is to start up pCampbot with the required connection parameters. Let us suppose that you want to test against a region called "r1" on a local grid with a loginuri of <nowiki>http://192.168.1.2:8002</nowiki>. Let us assume that you've given the bots the password "plentyofruth". The command to run is then

mono --debug pCampBot.exe -loginuri <nowiki>http://192.168.1.2:8002</nowiki> -s r1 -firstname ima -lastname bot -password plentyofruth

This will start up pCampbot and you'll see a familiar console command line as you would on a simulator or Robust console. As with the other consoles, you can type "help" to get a list of commands.

As of OpenSimulator 0.7.6, pCampbot by default starts without automatically connecting the bots.

=== Step 3: Connect the bots ===
Once you're ready, type the command

conn

to start connecting the bots. You will see the connection messages on the console and if all goes well you'll see the bots appear on the region. The default bot behaviour is "physics", so the bots will start walking and jumping around to test and load up region physics.

A client connection is a complicated affair so you'll probably see many warnings and debug messages of different severity on the console. But as long as the bot it present in the region you can assume that the connection has succeeded.

=== Step 4: Assess performance ===
Now this is quite tricky, since there's currently no automated way of assessing simulator or connection performance. Manual ways to assess this include logging in a viewer to the same region to get a feel for avatar movement (e.g. is it jerky, is there rubberbanding, is chat delayed, etc.) and to see [[Client_side_monitoring|viewer statistics]] such as Ping Sim, Packet Loss, Physics Time (frame) and Spare Time (frame).

However, one needs to be extremely careful if logging in using a viewer on the same machine from which the bots are running. The bots should really be running from a different machine or ideally even from a different network in order to get a more accurate picture of current simulator performance.

One can also look at [[Monitoring|server side monitoring]], particularly "show stats clientstack" which will show various client stack related statistics (this is the part of the OpenSimulator code that handles receiving and sending of UDP messages from viewers). In particular, the InboxPacketsCount should be constantly 0 or near 0 - a build up here means that your simulator is receiving UDP packets quicker than it can process them.

=== Step 5: Disconnect bots ===
Once you've finished, you can disconnect the bots in an orderly fashion with the command

disconn

Once all the bots are disconnected you can exit pCampbot with the command

quit

or reconnect the bots if you want. You can also see the current connection status of bots with the command

show bots

at any time.

[[Category:Testing]]

← Older revision		Revision as of 11:42, 4 December 2023
Line 1:		Line 1:
−	{{Quicklinks}}	+	{{Quicklinks\|PCampBot}}

	= Verwendung von pCampbot ab OpenSimulator 0.7.6 =		= Verwendung von pCampbot ab OpenSimulator 0.7.6 =

@@ Line 98: / Line 98: @@
   quit
-oder verbinden Sie die Bots erneut, wenn Sie möchten. Sie können den aktuellen Verbindungsstatus von Bots auch mit dem Befehl einsehen
+oder verbinden Sie die Bots erneut.
   show bots
-jederzeit.
+jederzeit einsehen.
 [[Category:Testing]]
 [[Category:German Translations]]

@@ Line 65: / Line 65: @@
 === Schritt 2: pCampbot starten ===
-Der nächste Schritt besteht darin, pCampbot mit den erforderlichen Verbindungsparametern zu starten. Nehmen wir an, Sie möchten mit einer Region namens "r1" in einem lokalen Grid mit einem Loginuri von http://192.168.1.2:8002 testen. Nehmen wir an, Sie haben den Bots das Passwort "plentyofruth" gegeben. Der auszuführende Befehl lautet dann
+Der nächste Schritt besteht darin, pCampbot mit den erforderlichen Verbindungsparametern zu starten. Nehmen wir an, Sie möchten mit einer Region namens "r1" in einem lokalen Grid mit einem Loginuri von http://192.168.1.2:8002 testen. Nehmen wir an, Sie haben den Bots das Passwort "mein_geheimes_passwort" gegeben. Der auszuführende Befehl lautet dann
-  mono --debug pCampBot.exe -loginuri <nowiki>http://192.168.1.2:8002</nowiki> -s r1 -firstname ima -lastname bot -password plentyofruth
+  mono --debug pCampBot.exe -loginuri <nowiki>http://192.168.1.2:8002</nowiki> -s r1 -firstname ima -lastname bot -password mein_geheimes_passwort
 Dadurch wird pCampbot gestartet und Sie sehen eine vertraute Konsolenbefehlszeile wie auf einem Simulator oder einer Robust-Konsole. Wie bei den anderen Konsolen können Sie "help" eingeben, um eine Liste mit Befehlen zu erhalten.
 Ab OpenSimulator 0.7.6 startet pCampbot standardmäßig ohne die Bots automatisch zu verbinden.
 === Schritt 3: Verbinden der Bots ===

@@ Line 34: / Line 34: @@
 Wenn Sie diese Funktion verwenden, erhalten Sie eine Konsolenbefehlszeile ähnlich der in OpenSimulator und Robust. Geben Sie an dieser Eingabeaufforderung "help" ein, um weitere Befehle anzuzeigen.
-== Optional pCampbot.ini configuration  ==
+== Optional pCampbot.ini Konfiguration  ==
 pCampbot bietet einige weitere optionale Konfigurationsoptionen bezüglich des detaillierten Bot-Verhaltens in pCampbot.ini.example. Um diese von den Standardeinstellungen zu ändern

← Older revision		Revision as of 09:32, 11 November 2021
Line 105:		Line 105:

	[[Category:Testing]]		[[Category:Testing]]
		+	[[Category:German Translations]]

@@ Line 73: / Line 73: @@
 Ab OpenSimulator 0.7.6 startet pCampbot standardmäßig ohne die Bots automatisch zu verbinden.
-=== Step 3: Connect the bots ===
+=== Schritt 3: Verbinden der Bots ===
-Once you're ready, type the command
+Wenn Sie fertig sind, geben Sie den Befehl ein
   conn
-to start connecting the bots.  You will see the connection messages on the console and if all goes well you'll see the bots appear on the region.  The default bot behaviour is "physics", so the bots will start walking and jumping around to test and load up region physics.
+um die Verbindung der Bots zu starten. Sie sehen die Verbindungsnachrichten auf der Konsole und wenn alles gut geht, werden die Bots in der Region angezeigt. Das Standardverhalten des Bots ist "Physik", also beginnen die Bots zu laufen und zu springen, um die Regionsphysik zu testen und zu laden.
-A client connection is a complicated affair so you'll probably see many warnings and debug messages of different severity on the console.  But as long as the bot it present in the region you can assume that the connection has succeeded.
+Eine Client-Verbindung ist eine komplizierte Angelegenheit, daher werden Sie wahrscheinlich viele Warnungen und Debug-Meldungen unterschiedlichen Schweregrades auf der Konsole sehen. Aber solange der Bot in der Region präsent ist, kann man davon ausgehen, dass die Verbindung gelungen ist.
-=== Step 4: Assess performance ===
+=== Schritt 4: Leistung bewerten ===
-Now this is quite tricky, since there's currently no automated way of assessing simulator or connection performance.  Manual ways to assess this include logging in a viewer to the same region to get a feel for avatar movement (e.g. is it jerky, is there rubberbanding, is chat delayed, etc.) and to see [[Client_side_monitoring|viewer statistics]] such as Ping Sim, Packet Loss, Physics Time (frame) and Spare Time (frame).
+Dies ist jedoch ziemlich knifflig, da es derzeit keine automatisierte Möglichkeit gibt, die Simulator- oder Verbindungsleistung zu bewerten. Manuelle Möglichkeiten zu bewerten diese umfassen in einem Viewer auf derselben Region Protokollierung ein Gefühl für Avatarbewegung zu erhalten (zB ist es ruckelt, ist es Rubberbanding, ist Chat verzögert, etc.) und sehen [[Client_side_monitoring|viewer statistics]] wie Ping Sim, Packet Loss , Physikzeit (Frame) und Freizeit (Frame).
-However, one needs to be extremely careful if logging in using a viewer on the same machine from which the bots are running.  The bots should really be running from a different machine or ideally even from a different network in order to get a more accurate picture of current simulator performance.
+Bei der Anmeldung mit einem Viewer auf demselben Computer, auf dem die Bots ausgeführt werden, ist jedoch äußerste Vorsicht geboten. Die Bots sollten wirklich von einem anderen Rechner oder idealerweise sogar von einem anderen Netzwerk laufen, um ein genaueres Bild von der aktuellen Simulatorleistung zu bekommen.
-One can also look at [[Monitoring|server side monitoring]], particularly "show stats clientstack" which will show various client stack related statistics (this is the part of the OpenSimulator code that handles receiving and sending of UDP messages from viewers).  In particular, the InboxPacketsCount should be constantly 0 or near 0 - a build up here means that your simulator is receiving UDP packets quicker than it can process them.
+Man kann sich auch die ansehen [[Monitoring|server side monitoring]], insbesondere "show stats clientstack", das verschiedene Statistiken zum Client-Stack anzeigt (dies ist der Teil des OpenSimulator-Codes, der das Empfangen und Senden von UDP-Nachrichten von Zuschauern verarbeitet). Insbesondere sollte der InboxPacketsCount konstant 0 oder nahe 0 sein - ein Aufbau hier bedeutet, dass Ihr Simulator UDP-Pakete schneller empfängt, als er sie verarbeiten kann.
-=== Step 5: Disconnect bots ===
+=== Schritt 5: Bots trennen ===
-Once you've finished, you can disconnect the bots in an orderly fashion with the command
+Sobald Sie fertig sind, können Sie die Bots mit dem Befehl geordnet trennen
   disconn
-Once all the bots are disconnected you can exit pCampbot with the command
+Sobald alle Bots getrennt sind, können Sie pCampbot mit dem Befehl beenden
   quit
-or reconnect the bots if you want.  You can also see the current connection status of bots with the command
+oder verbinden Sie die Bots erneut, wenn Sie möchten. Sie können den aktuellen Verbindungsstatus von Bots auch mit dem Befehl einsehen
   show bots
-at any time.
+jederzeit.
 [[Category:Testing]]

@@ Line 26: / Line 26: @@
 </pre>
-You must have already created all the necessary bot accounts in the simulator before using pCampbot. It does not create these accounts on the fly.
+Sie müssen bereits alle erforderlichen Bot-Konten im Simulator erstellt haben, bevor Sie pCampbot verwenden können. Es erstellt diese Konten nicht im Handumdrehen.
-Because pCampbot connects bots using the [http://lib.openmetaverse.org libopenmetaverse] library in the same manner that an ordinary viewer program would connect, you can use the pCampbot in 0.7.6 or later to test earlier versions of OpenSimulator.
+Da pCampbot Bots mit der [http://lib.openmetaverse.org libopenmetaverse] Bibliothek auf die gleiche Weise verbindet wie ein gewöhnliches Viewer-Programm, können Sie den pCampbot in 0.7.6 oder höher verwenden, um frühere Versionen von OpenSimulator zu testen.
-The -wear option almost certainly doesn't work. The others are operational.
+Die Option -wear funktioniert mit ziemlicher Sicherheit nicht. Die anderen sind betriebsbereit.
-On using this facility you'll get a console command line similar to the one in OpenSimulator and Robust. Type "help" at this prompt to see further commands.
+Wenn Sie diese Funktion verwenden, erhalten Sie eine Konsolenbefehlszeile ähnlich der in OpenSimulator und Robust. Geben Sie an dieser Eingabeaufforderung "help" ein, um weitere Befehle anzuzeigen.
-== Optional pCampbot.ini configuration ==
+== Optional pCampbot.ini configuration  ==
-pCampbot has some further optional configuration options relating to detailed bot behaviour in pCampbot.ini.example.  To change these from the defaults
+pCampbot bietet einige weitere optionale Konfigurationsoptionen bezüglich des detaillierten Bot-Verhaltens in pCampbot.ini.example. Um diese von den Standardeinstellungen zu ändern
   cp pCampbot.ini.example pCampbot.ini
-and change pCampbot.ini accordingly.
+und ändern Sie die pCampbot.ini entsprechend.
-== Caveats ==
+== Vorbehalte ==
-* There are some things you can do to improve this in pCampbot.  For instance, if you have RequestObjectTextures set in pCampbot.ini then pCampbot will request textures for all objects it sees.  This is both much less stressful than a real scenario (since for a particular sets of bots textures are only requested once) and more stressful (since there is never any caching).
+* Eine synthetische Bot-Last von pCampBot ist immer noch ein extrem schlechter Proxy für eine "echte" Verbindung (dh ein echter Mensch, der sich mit einem Viewer einloggt und all die Dinge tut, die er in einer virtuellen Welt erwartet). Echte Verbindungen belasten den Simulator sehr wahrscheinlich unterschiedlich, sodass die reale Leistung erheblich anders und schlechter sein kann, als synthetische Lasttests vermuten lassen.
-* pCampbot does currently not work well if there are any surrounding regions.  Avatars will currently just walk off into oblivion.  You must either build fences or remove such regions.  In testing so far, the presence of neighbouring regions does not have any great impact on performance in the region occupied by bots.  However, these tests were performed with blank surrounding regions - surrounding regions containing objects will place more initial stress on the bot connections as object data is downloaded (and textures if this option is active).
+* Es gibt einige Dinge, die Sie tun können, um dies in pCampbot zu verbessern. Wenn Sie beispielsweise RequestObjectTextures in pCampbot.ini eingestellt haben, fordert pCampbot Texturen für alle Objekte an, die es sieht. Dies ist sowohl viel stressfreier als ein reales Szenario (da für einen bestimmten Satz von Bots Texturen nur einmal angefordert werden) als auch stressiger (da es nie zu Zwischenspeichern kommt).
-== Example ==
+* pCampbot funktioniert derzeit nicht gut, wenn es umliegende Regionen gibt. Avatare werden derzeit einfach in Vergessenheit geraten. Sie müssen entweder Zäune bauen oder solche Gebiete entfernen. In bisherigen Tests hat die Präsenz benachbarter Regionen keinen großen Einfluss auf die Leistung in der von Bots besetzten Region. Diese Tests wurden jedoch mit leeren umgebenden Regionen durchgeführt - umgebende Regionen mit Objekten belasten die Bot-Verbindungen beim Herunterladen von Objektdaten (und Texturen, wenn diese Option aktiviert ist) stärker.
-Okay, let's suppose that we're on Linux and want to create a 5 bot synthetic load test on a region called myregion1.  Depending on your bandwidth and the bot settings you can connect quite a large number of bots but for this example we will stick with 5.  Here are the steps to take.
-=== Step 1: Create bot accounts ===
+== Beispiel  ==
-The first step is to create 5 bot accounts, all with the same password.  Each bot account must have the same first name and the same last name prefix.  But each bot must also have its last name prefix appended with an underscore (_) and its bot number, starting from 0.  In this case, we want five bots, and lets suppose we will call them "ima bot".  Then the five accounts that we want are
+Okay, nehmen wir an, wir verwenden Linux und möchten einen synthetischen 5-Bot-Lasttest für eine Region namens myregion1 erstellen. Abhängig von Ihrer Bandbreite und den Bot-Einstellungen können Sie eine ziemlich große Anzahl von Bots verbinden, aber für dieses Beispiel bleiben wir bei 5. Hier sind die Schritte, die Sie ausführen müssen.
   ima bot_0
@@ Line 61: / Line 62: @@
   ima bot_4
-The classic way to create a user account is to do it by using the "create user" command on the OpenSimulator standalone or Robust service console, depending on whether one is running in standalone or grid mode.  However, this can be laborious, particularly if one needs hundreds of bot accounts.  There's a very basic python script at https://github.com/justincc/opensimulator-tools/blob/master/create-user-line-generator/src/culg.py ( dead link ) which will generate the user lines needed, giving each account a non-random UUID for later debugging purposes.  The lines that this script generated can be pasted directly into the OpenSimulator console.
+Der klassische Weg zum Erstellen eines Benutzerkontos besteht darin, den Befehl "Benutzer erstellen" in der OpenSimulator-Standalone- oder Robust-Service-Konsole zu verwenden, je nachdem, ob sie im Standalone- oder Grid-Modus ausgeführt wird. Dies kann jedoch mühsam sein, insbesondere wenn man Hunderte von Bot-Accounts benötigt. Es gibt ein sehr einfaches Python-Skript unter https://github.com/justincc/opensimulator-tools/blob/master/create-user-line-generator/src/culg.py ( dead link ) das die benötigten Benutzerzeilen generiert. Geben Sie jedem Konto eine nicht zufällige UUID für spätere Debugging-Zwecke. Die von diesem Skript generierten Zeilen können direkt in die OpenSimulator-Konsole eingefügt werden.
-=== Step 2: Start pCampbot ===
+=== Schritt 2: pCampbot starten ===
-The next step is to start up pCampbot with the required connection parameters.  Let us suppose that you want to test against a region called "r1" on a local grid with a loginuri of <nowiki>http://192.168.1.2:8002</nowiki>.  Let us assume that you've given the bots the password "plentyofruth". The command to run is then
+Der nächste Schritt besteht darin, pCampbot mit den erforderlichen Verbindungsparametern zu starten. Nehmen wir an, Sie möchten mit einer Region namens "r1" in einem lokalen Grid mit einem Loginuri von http://192.168.1.2:8002 testen. Nehmen wir an, Sie haben den Bots das Passwort "plentyofruth" gegeben. Der auszuführende Befehl lautet dann
   mono --debug pCampBot.exe -loginuri <nowiki>http://192.168.1.2:8002</nowiki> -s r1 -firstname ima -lastname bot -password plentyofruth
-This will start up pCampbot and you'll see a familiar console command line as you would on a simulator or Robust console.  As with the other consoles, you can type "help" to get a list of commands.
+Dadurch wird pCampbot gestartet und Sie sehen eine vertraute Konsolenbefehlszeile wie auf einem Simulator oder einer Robust-Konsole. Wie bei den anderen Konsolen können Sie "help" eingeben, um eine Liste mit Befehlen zu erhalten.
-As of OpenSimulator 0.7.6, pCampbot by default starts without automatically connecting the bots.
+Ab OpenSimulator 0.7.6 startet pCampbot standardmäßig ohne die Bots automatisch zu verbinden.
 === Step 3: Connect the bots ===