Server Commands/de

From OpenSimulator

Revision as of 07:36, 10 September 2016 by Manni (Talk | contribs)

Jump to: navigation, search

Contents

Was sind Serverbefehle

Server-Befehle sind diejenigen, die Sie in der Konsole eingeben können, um den OpenSim Server zu steuern.

Befehle lassen sich in solche unterteilen in Simulator-Befehle und Service-Befehle.

Auf einem Standalone System stehen beide Arten in einer Konsole zur Verfügung.

In einer Grid Architektur stehen die Simulator Befehle in der Simulator Konsole zur verfügung wärend die Service Kommandos in der ROBUST Konsole zur Verfügung stehen.

Stand: OpenSim 0.9.0 Dev - Server Konsolenbefehle 29.04.2016

Haftungsausschluss:Einige Befehle können unerwartet funktionieren, einige nicht funktionieren, und es gibt eine Chance , dass Sie auch alle Ihre Einstellungen und Inhalt verlieren. Diese Zusammenfassung veraltet schnell - das beste ist durch eingabe von "help" in der Konsole.

Befehle

Allgemeine Befehle

Diese Befehle sind sowohl für die Simulator und die Robust Konsole.

General

  • command-script <script> - Startet Scriptbefehle aus einer Datei.
  • quit - Server beenden.
  • show info - Zeigt allgemeine Informationen über den Server.
  • show uptime - Zeigt Server-Uptime an.
  • show version - Zeigt die Server Version an.
  • shutdown - Fährt den Server herunter.
  • get log level - Gibt den aktuellen Log-Level aus.
  • set log level <level> - Log Level Einstellen.

Debug

  • debug http [<level>] - Schaltet das inbound http request debugging für alles, außer dem event queue ein. Für mehr Informationen siehe Debugging.
  • debug threadpool level <level> - Turn on/off logging of activity in the main threadpool. For more information, see General-Purpose Threadpool.

Simulator Befehle

General

  • change region <Regionsname> - Region auswählen.
  • debug packet <level> - Schaltet das packet debugging ein, where OpenSimulator prints out summaries of incoming and outgoing packets for viewers, depending on the level set
  • emergency-monitoring - Notfall Monitoring Modus ein- und ausschalten.
  • help [<Befehl>] - Zeigt die Hilfe zu einem bestimmten Befehl oder einer Liste von Befehlen. Beispiel: "help General", "help change region".
  • link-mapping - Set a local grid co-ordinate to link to a remote hypergrid
  • link-region - Link a HyperGrid region. Not sure how this differs from link-mapping
  • modules list - List modules
  • modules load <name> - Load a module
  • modules unload <name> - Unload a module
  • monitor report - Returns a variety of statistics about the current region and/or simulator
  • set terrain heights <corner> <min> <max> [<x>] [<y>] - Sets the terrain texture heights on corner #<corner> to <min>/<max>, if <x> or <y> are specified, it will only set it on regions with a matching coordinate. Specify -1 in <x> or <y> to wildcard that coordinate. Corner # SW = 0, NW = 1, SE = 2, NE = 3.
  • set terrain texture <number> <uuid> [<x>] [<y>] - Sets the terrain <number> to <uuid>, if <x> or <y> are specified, it will only set it on regions with a matching coordinate. Specify -1 in <x> or <y> to wildcard that coordinate.
  • show caps - show all registered capabilities URLs
NOTE: In OpenSimulator 0.7.1, "show capabilities" is shown as a result for help command, but actually only "show caps" will be accepted. (#5467)
  • show circuits - Show agent circuit data
  • show connections - show connections data
  • show http-handlers - show all registered http handlers
  • show hyperlinks - list hg regions
  • show modules - show module data
  • show pending-objects - show number of objects in the pending queues of all viewers
  • show pqueues [full] - show priority queue data for each client. Without the 'full' option, only root agents are shown. With the 'full' option child agents are also shown.
  • show queues - Show queue data for agent connections.
  • show threads - shows the persistent threads registered with the system. Does not include threadpool threads.
  • show throttles [full] - Show throttle data for each client connection, and the maximum allowed for each connection by the server. Without the 'full' option, only root agents are shown. With the 'full' option child agents are also shown.
  • unlink-region <local name> - unlink a hypergrid region

Appearance Befehle

  • appearance show - Show information about avatar appearance. Currently just checks whether the baked texture is "OK" or "corrupt". Still in development. Only exists in development code at the moment.

Archiv Befehle

  • load iar [-m|--merge] <Vorname> <Nachname> <Inventar Pfad> <Passwort> [<Dateiname.iar>] - Lädt Benutzerarchiv (IAR).
  • load oar [-m|--merge] [-s|--skip-assets] [--default-user "Benutzername"] [--force-terrain] [--force-parcels] [--no-objects] [--rotation degrees] [--bounding-origin "<x,y,z>"] [--bounding-size "<x,y,z>"] [--displacement "<x,y,z>"] [-d|--debug] [<OAR Pfad>] - Lädt Daten einer Region aus einem OAR-Archiv (tar/gz Format).
  • load xml [-newIDs [<x> <y> <z>]] - Lädt Daten einer Region aus einer XML Datei.
  • load xml2 - LädtDaten einer Region aus einer XML2 Datei.
  • save iar [-h|--home=<url>] [--noassets] <Vorname> <Nachname> <Inventar Pfad> <Passwort> [<IAR Pfad>] [-c|--creators] [-e|--exclude=<name/uuid>] [-f|--excludefolder=<foldername/uuid>] [-v|--verbose] - Speichert Benutzerarchiv (IAR).
  • save oar [-h|--home=<url>] [--noassets] [--publish] [--perm=<permissions>] [--all] [<OAR Pfad>] - Speichern einer Region zu einem OAR-Archiv (tar/gz Format).
  • save prims xml2 [<prim name> <file name>] - Speichert Prims im XML2 Format.
  • save xml - Speichert Daten einer Region im XML-Format.
  • save xml2 - Speichert Daten einer Region im XML2 Format.

Asset Befehle

  • dump asset <id> - Dump einen Vermögenswert.
  • fcache assets - Versuche einen tiefen Scan und Cache aller Assets in allen Szenen.
  • fcache clear [file] [memory] - Löscht alle Vermögenswerte im Cache. Wenn die Datei oder Speicher angegeben wird dann wird nur dieser Cache gelöscht.
  • fcache expire <datetime> - Säuberung gecached Vermögenswerte, älter als das angegebene Datum/Uhrzeit.
  • fcache status - Display Cache-Status.
  • j2k decode <ID> - Do JPEG2000 Dekodierung eines Vermögenswertes.
  • show asset <ID> - Zeige Asset-Informationen.

Config Befehle

  • config get [<Sektion>] [<Schlüssel>] - Synonym für config show, Zeigt Konfigurationsinformationen.
  • config save <Pfad> - Speichert die aktuelle Konfiguration in eine Datei.
  • config set <Sektion> <Schlüssel> - Setzt eine Konfigurationsoption. In den meisten Fällen ist dies nicht sinnvoll, weil veränderte Parameter nicht dynamisch geladen und gespeichert werden. Man sollte die Konfiguration in den entsprechenden Dateien ändern und Neustarten.
  • config show [<Sektion>] [<Schlüssel>] - Synonym für 'config get' Zeigt Konfigurationsinformationen.

Land Befehle

  • land show - Shows all parcels on the current region.

Map Befehle

  • export-map [<path>] - Save an image of the world map (default name is exportmap.jpg)
  • generate map - Regenerates and stores map tile. Only in development code post 0.7.6.

Object Befehle

  • backup - Persist currently unsaved object changes immediately instead of waiting for the normal persistence call. This shouldn't normally be required - the simulator persists region objects automatically at regular intervals and on shutdown.
  • delete object creator <UUID> - Delete a scene object by creator
  • delete object name [--regex] <name> - Delete a scene object by name.
  • delete object outside - Delete all scene objects outside region boundaries. This is currently if z < 0 or z > 10000. Object outside these bounds have been known to cause issues with OpenSimulator's use of some physics engines (such as the Open Dynamics Engine).
  • delete object owner <UUID> - Delete a scene object by owner
  • delete object uuid <UUID> - Delete a scene object by uuid. In current dev code (post 0.7.5) this is "show object id" and also allows a local ID.
  • dump object id <UUID-or-localID> - Dump the serialization of the given object to a file for debug purposes.
  • edit scale <name> <x> <y> <z> - Change the scale of a named prim
  • force update - Force the region to send all clients updates about all objects.
  • show object name [--regex] <name> - Show details of scene objects with the given name.
  • show object uuid <UUID> - Show details of a scene object with the given UUID. In current dev code (post 0.7.5) this is "show object id" and also allows a local ID.
  • show part name [--regex] <name> - Show details of scene object parts with the given name.
  • show part uuid <UUID> - Show details of a scene object parts with the given UUID. In current dev code (post 0.7.5) this is "show object id" and also allows a local ID.

Estate Befehle

  • reload estate - reload estate data

Region Befehle

  • change region <Regionsname> - Region auswählen.
  • create region [name] [filename] - Create a new region
  • delete-region <name> - Delete a region from disk.
  • region get - Post OpenSimulator 0.8.0.*. Show region parameters (Region Name, Region UUID, Location, URI, Owner ID, Flags).
  • region restart abort [<message>] - Abort a scheduled region restart, with an optional message
  • region restart bluebox <message> <delta seconds>+ - Schedule a region restart. If one delta is given then the region is restarted in delta seconds time. A time to restart is sent to users in the region as a dismissable bluebox notice. If multiple deltas are given then a notice is sent when we reach each delta.
  • region restart notice <message> <delta seconds>+ - Schedule a region restart. Same as above except showing a transient notice instead of a dismissable bluebox.
  • region set - Post OpenSimulator 0.8.0.*. Set certain region parameters. Currently, can set
    • agent-limit - The current avatar limit for the region. More usually this is set via the region/estate dialog in a typical viewer. This persists over simulator restarts.
    • max-agent-limit - The maximum value that agent-limit can have. Unfortunately, setting it here does not currently persist over server restarts. For that to happen it must be separately set as the MaxAgents parameter in the region config file.
  • remove-region - remove a region from the simulator
  • restart - Restarts all sims in this instance
  • set region flags <Region name> <flags> - Set database flags for region
  • show neighbours - Shows the local regions' neighbours
  • show ratings - Show rating data
  • show region - Show region parameters (Region Name, Region UUID, Location, URI, Owner ID, Flags).
  • show regions - Show regions data (Region Names, XLocation YLocation coordinates, Region Ports, Estate Names)

Scene Befehle

  • debug scene - Turn on scene debugging
  • rotate scene <degrees> - Rotates scene around 128,128 axis by x degrees where x=0-360.
  • scale scene <factor> - Scales all scene objects by a factor where original size =1.0.
  • translate scene <x,y,z> - Translate (move) the entire scene to a new coordinate. Useful for moving a scene to a different location on either a Mega or Variable region.

(please back up your region before using any of these commands and be aware of possible floating point errors the more they are used.)

Script Befehle

These currently only exist in git master OpenSimulator development code post the 0.7.2 release.

  • scripts resume [<script-item-uuid>] - Resumes all suspended scripts
  • scripts show [<script-item-uuid>] - Show script information. <script-item-uuid> option only exists from git master 82f0e19 (2012-01-14) onwards (post OpenSimulator 0.7.2).
  • scripts start [<script-item-uuid>] - Starts all stopped scripts
  • scripts stop [<script-item-uuid>] - Stops all running scripts
  • scripts suspend [<script-item-uuid>] - Suspends all running scripts

Stats Befehle

  • show stats - show useful statistical information for this server. See Frame Statistics Values below for more information.
  • stats show - a synonym for "show stats" (OpenSimulator dev code only post 19th March 2014).
  • stats record - record stats periodically to a separate log file.
  • stats save - save a snapshot of current stats to a file (OpenSimulator dev code only post 19th March 2014).

Terrain Befehle

Note that some of these may require a sim restart to show properly.

  • terrain load - Loads a terrain from a specified file.
  • terrain load-tile - Loads a terrain from a section of a larger file.
  • terrain save - Saves the current heightmap to a specified file.
  • terrain fill - Fills the current heightmap with a specified value.
  • terrain elevate - Raises the current heightmap by the specified amount.
  • terrain lower - Lowers the current heightmap by the specified amount.
  • terrain multiply - Multiplies the heightmap by the value specified.
  • terrain bake - Saves the current terrain into the regions revert map.
  • terrain revert - Loads the revert map terrain into the regions heightmap.
  • terrain newbrushes - Enables experimental brushes which replace the standard terrain brushes. WARNING: This is a debug setting and may be removed at any time.
  • terrain stats - Shows some information about the regions heightmap for debugging purposes.
  • terrain effect - Runs a specified plugin effect.
  • terrain modify - Performs terrain modifications in a bounded area in the heightmap.

Tree Befehle

  • tree active - Change activity state for the trees module
  • tree freeze - Freeze/Unfreeze activity for a defined copse
  • tree load - Load a copse definition from an xml file
  • tree plant - Start the planting on a copse
  • tree rate - Reset the tree update rate (mSec)
  • tree reload - Reload copse definitions from the in-scene trees
  • tree remove - Remove a copse definition and all its in-scene trees
  • tree statistics - Log statistics about the trees

User Befehle

  • alert <message> - send an in-world alert to everyone
  • alert-user <first> <last> <message> - send an an in-world alert to a specific user
  • bypass permissions <true / false> - Bypass in-world permission checks
  • debug permissions - Turn on permissions debugging
  • force permissions - Force permissions on or off.
  • kick user <first> <last> [message]: - Kick a user off the simulator
  • login disable - Disable user entry to this simulator
  • login enable - Enable user entry to this simulator
  • login status - Show whether logins to this simulator are enabled or disabled
  • show users [full]- show info about currently connected users to this region. Without the 'full' option, only users actually on the region are shown. With the 'full' option child agents of users in neighbouring regions are also shown.
  • teleport user <destination> - Teleport a user on this simulator to a specific destination. Currently only in OpenSimulator development code after the 0.7.3.1 release (commit bf0b817).

Windlight/LightShare Befehle

  • windlight load - Load windlight profile from the database and broadcast
  • windlight enable - Enable the windlight plugin
  • windlight disable - Enable the windlight plugin

ROBUST Service Befehle

These can also be accessed on the simulator command console itself in standalone mode.

Asset Service

  • delete asset - Delete an asset from the database. Doesn't appear to be implemented.
  • dump asset <ID> - Dump an asset to the filesystem. OpenSimulator 0.7.3 onwards.
  • show digest <ID> - Show summary information about an asset. From OpenSimulator 0.7.3 onwards this will be renamed to "show asset"

Grid Service

  • set region flags <Region name> <flags> - Set database flags for region
  • show region <Region name> - Show the details of a given region. This command is renamed to "show region name" in development versions of OpenSimulator.

The following commands currently only exist in development versions of OpenSimulator (post 0.7.3.1). These are currently found in the "Regions" help section.

  • deregister region id <Region UUID> - Deregister a region manually. This can be helpful if a region was not properly removed due to bad simulator shutdown and the simulator has not since been restarted or its region configuration has been changed.
  • show region at <x-coord> <y-coord> - Show details on a region at the given co-ordinate.
  • show region name <Region name> - Show details on a region
  • show regions - Show details on all regions. In standalone mode this version of the command is not currently available - the simulator version of "show regions" is used instead, which shows similar information.

User Service

  • create user [first] [last] [passw] [RegionX] [RegionY] [Email] - creates a new user and password
or just: create user - and server prompts for all data
Note for use of create user in standalone mode: use the user default coordinates
of 1000,1000 for Start Region X and Y position otherwise server
gives error of "[LOGIN]: Not found region"
  • reset user password - reset a user's password.
  • show account <firstname> <lastname> - show account details for the given user name (0.7.2-dev)

Login Service

  • login level <value> - Set the miminim userlevel allowed to login.
  • login reset - reset the login level to its default value.
  • login text <text to print during the login>
  • set user level <firstname> <lastname> <level> - Set UserLevel for the user, which determines whether a user has a god account or can login at all (0.7.2-dev)

Details of Terrain Module Befehle

terrain load

Loads a terrain from a specified file.

Parameters

  • filename (String)

The file you wish to load from, the file extension determines the loader to be used. Supported extensions include: .r32 (RAW32) .f32 (RAW32) .ter (Terragen) .raw (LL/SL RAW) .jpg (JPEG) .jpeg (JPEG) .bmp (BMP) .png (PNG) .gif (GIF) .tif (TIFF) .tiff (TIFF)

terrain load-tile

Loads a terrain from a section of a larger file.

Parameters

  • filename (String)

The file you wish to load from, the file extension determines the loader to be used. Supported extensions include: .r32 (RAW32) .f32 (RAW32) .ter (Terragen) .raw (LL/SL RAW) .jpg (JPEG) .jpeg (JPEG) .bmp (BMP) .png (PNG) .gif (GIF) .tif (TIFF) .tiff (TIFF)

  • file width (Integer)

The width of the file in tiles

  • file height (Integer)

The height of the file in tiles

  • minimum X tile (Integer)

The X region coordinate of the first section on the file

  • minimum Y tile (Integer)

The Y region coordinate of the first section on the file

terrain save

Saves the current heightmap to a specified file.

Parameters

  • filename (String)

The destination filename for your heightmap, the file extension determines the format to save in. Supported extensions include: .r32 (RAW32) .f32 (RAW32) .ter (Terragen) .raw (LL/SL RAW) .jpg (JPEG) .jpeg (JPEG) .bmp (BMP) .png (PNG) .gif (GIF) .tif (TIFF) .tiff (TIFF)

terrain fill

Fills the current heightmap with a specified value.

Parameters

  • value (Double)

The numeric value of the height you wish to set your region to.

terrain elevate

Raises the current heightmap by the specified amount.

Parameters

  • amount (Double)

terrain lower

Lowers the current heightmap by the specified amount.

Parameters

  • amount (Double)

The amount of height to remove from the terrain in meters.

terrain multiply

Multiplies the heightmap by the value specified.

Parameters

  • value (Double)

The value to multiply the heightmap by.

terrain bake

Saves the current terrain into the regions revert map.

terrain revert

Loads the revert map terrain into the regions heightmap.

terrain newbrushes

Enables experimental brushes which replace the standard terrain brushes. WARNING: This is a debug setting and may be removed at any time.

Parameters

  • Enabled? (Boolean)

true / false - Enable new brushes

terrain stats

Shows some information about the regions heightmap for debugging purposes.

terrain effect

Runs a specified plugin effect

Parameters

  • name (String)

The plugin effect you wish to run, or 'list' to see all plugins

terrain modify

Allows area-of-effect and tapering with standard heightmap manipulations.

General command usage:

terrain modify <operation> value [<mask>] [-taper=<value2>]
Parameters
  • value: base value to use in applying operation
  • mask:
    • -rec=x1,y1,dx[,dy] creates a rectangular mask based at x1,y1
    • -ell=x0,y0,rx[,ry] creates an elliptical mask centred at x0,y0
  • taper:
    • rectangular masks taper as pyramids
    • elliptical masks taper as cones


Terrain Manipulation (fill, min, max)

  • value represents target height (at centre of range)
  • value2 represents target height (at edges of range)

Terrain Movement (raise, lower, noise)

  • value represents a delta amount (at centre of range)
  • value2 represents a delta amount (at edges of range)

Terrain Smoothing (smooth)

The smoothing operation is somewhat different than the others, as it does not deal with elevation values, but rather with strength values (in the range of 0.01 to 0.99). The algorithm is simplistic in averaging the values around a point, and is implemented as follows:
The "strength" parameter specifies how much of the result is from the original value ("strength" * map[x,y]).
The "taper" parameter specifies how much of the remainder is from the first ring surrounding the point (1.0 - "strength") * "taper". There are 8 elements in the first ring.
The remaining contribution is made from the second ring surrounding the point. There are 16 elements in the second ring.
e.g.
terrain modify smooth 0.5 -taper=0.6
  • the original element will contribute 0.5 * map[x0,y0]
  • each element 1m from the point will contribute ((1-0.5)*0.6)/8 * map[x1,y1]
  • each element 2m from the point will contribute ((1-0.5)*0.4)/16 * map[x2,y2]

Notes:

The "taper" value may need to be exaggerated due to the integer math used in maps.
e.g. To create a 512x512 var island:
terrain modify min 30 -ell=256,256,240 -taper=-29

Example:

https://www.youtube.com/watch?v=pehyqr3H8I0

Details der Hypergrid Befehle

For full details and explanations of Hypergrid Commands, see the Linking Regions sections of the Installing and Running Hypergrid page.

show hyperlinks

This command will show a list of all hypergrid linked regions.

link-region <Xloc> <Yloc> <host> <port> <location-name>

  • Use Xloc and Yloc that make sense to your world, i.e. close to your regions, but not adjacent.
  • replace osl2.nac.uci.edu and 9006 with the domain name / ip address and the port of the region you want to link to

E.g. link-region 8998 8998 osl2.nac.uci.edu 9006 OSGrid Gateway

unlink-region <local region name>

This command will unlink the specified hypergrid linked region - be sure to use the exact local name as reported by the "show hyperlinks" command.

link-mapping

Frame Statistik Werte

Die Werte die über den Konsolenbefehl "show stats" gezeigt werden, sind etwas kryptisch. Hier ist eine Liste der Bedeutungen:

  • Dilatn - time dilation
  • SimFPS - sim FPS
  • PhyFPS - physics FPS
  • AgntUp - # of agent updates
  • RootAg - # of root agents
  • ChldAg - # of child agents
  • Prims - # of total prims
  • AtvPrm - # of active prims
  • AtvScr - # of active scripts
  • ScrLPS - # of script lines per second
  • PktsIn - # of in packets per second
  • PktOut - # of out packets per second
  • PendDl - # of pending downloads
  • PendUl - # of pending uploads
  • UnackB - # of unacknowledged bytes
  • TotlFt - total frame time
  • NetFt - net frame time
  • PhysFt - physics frame time
  • OthrFt - other frame time
  • AgntFt - agent frame time
  • ImgsFt - image frame time
Personal tools
General
About This Wiki