Server Commands/ru

= Что такое консольные команды сервера? =

Командами сервера являются те, которые можно ввести с консоли симулятора, чтобы заставить сервер сделать различные вещи.

Команды можно разделить на те, которые применимы к симулятору (команды симулятора) и те, которые направлены на взаимодействие со службами грида(служебные команды).

На автономных(standalone) системах, команды симулятора и служб доступны с одной автономной консоли системы.

В архитектуре грид-режима, команды симулятора доступны непосредственно на симуляторах, в то время как служебные команды, доступны только с рабочей консоли ROBUST сервера.

Предупреждение: некоторые команды могут не работать, как ожидалось, некоторые могут не работать вообще, и есть шанс, что вы можете даже потерять все свои настройки / содержимое. Это справка быстро устаревает - лучшее место для поиска команд, набрать "help" в консоли региона.

Если не указано иное, этот список должен быть точным для OpenSimulator 0.7.1 и выше.

= Команды =

Общие команды сервера
Эти команды доступны как с консоли симулятора, так и на сервере ROBUST

Основные

 * command-script [файл_сценария] - Считывает файл сценария, содержащий команды сервера и последовательно их исполняет.
 * quit - выключить сервер.
 * shutdown - синоним команды quit.

Отладки

 * debug http [ ] - Включить/выключить экстра-лог для отладки HTTP запросов. Доступна только на ROBUST консоли начиная с правки 94517c8 (dev code post 0.7.3.1).

Основные

 * change region   - subsequent commands apply only to the specified region. If region name is "root" then all regions are selected
 * create region [name] [filename] - создать новый регион
 * debug packet   - Turn on packet debugging, where OpenSimulator prints out summaries of incoming and outgoing packets for viewers, depending on the level set
 * debug scene - Turn on scene debugging
 * delete-region   - удалить регион с диска
 * emergency-monitoring - turn emergency debugging monitoring mode on or off.
 * export-map [ ] - Save an image of the world map (default name is exportmap.jpg)
 * help [ ] - Get general command list or more detailed help on a specific command or set of commands
 * 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 - список модулей
 * modules load   - загрузить модуль
 * modules unload   - выгрузить модуль
 * monitor report - Returns a variety of statistics about the current region and/or simulator
 * region restart abort [ ] - Abort a scheduled region restart, with an optional message
 * region restart bluebox  + - 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  + - Schedule a region restart. Same as above except showing a transient notice instead of a dismissable bluebox.
 * reload estate - перезагрузить данные парселей
 * remove-region - удалить регион из симулятора
 * restart - перезагрузка всех регионов данного симулятора
 * set log level [level] - change the console logging level only. For example, off or debug. See Logging for more information.
 * set region flags   - Set database flags for region
 * set terrain heights   [] [] - Sets the terrain texture heights on corner # to /, if  or  are specified, it will only set it on regions with a matching coordinate. Specify -1 in  or  to wildcard that coordinate. Corner # SW = 0, NW = 1, SE = 2, NE = 3.
 * set terrain texture  [] [] - Sets the terrain to, if  or  are specified, it will only set it on regions with a matching coordinate. Specify -1 in  or  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 info - показать информацио о сервере (версия и рабочий каталог)
 * show modules - показать все модули
 * show neighbours - Shows the local regions' neighbours
 * 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 ratings - показать рейтинг(безопасности) региона
 * show region [region name] - Show region data (Region Name, Region UUID, Location, URI, Owner ID, Flags)
 * show regions - Show regions data (Region Names, XLocation YLocation coordinates, Region Ports, Estate Names)
 * show stats - показать полезную статистику по этому симулятору. См Элементы кадра статистики для деталей.
 * 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.
 * show uptime - show server startup time and uptime.
 * show version - показать версию сервера.
 * unlink-region   - unlink a hypergrid region

Внешний вид аватара

 * 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.

Архивации

 * load iar   [ ] - Load user inventory archive. See Inventory Archives.
 * load oar [filename] - load an OpenSimulator archive. This entirely replaces the current region. Default filename is region.oar. See OpenSim Archives.
 * load xml [-newIDs [  ]] - Load a region's data from XML format (0.7.*: DEPRECATED and may be REMOVED soon. Use "load xml2" instead)
 * those xml are the result of the export save or *export save-all


 * load xml2 [filename] - optional parameters not supported for XML2 format as at 1-Jul-2008
 * save iar   [ ] - Save user inventory archive. See Inventory Archives
 * save oar [filename] - save the current region to an OpenSimulator archive. Default filename is region.oar. See OpenSim Archives.
 * save prims xml2 [ ] - Save named prim to XML2
 * save xml [filename] - save prims to XML
 * save xml2 [filename] - save prims to XML (Format 2 - rearrangement of some nodes, to make loading/saving easier)

Ассеты
The fcache commands only currently appearance if you are using the fcache asset cache. This is the default on OpenSimulator.


 * fcache assets - Attempt a deep scan and cache of all assets in all scenes
 * fcache clear [file] [memory] - Remove all assets in the cache. If file or memory is specified then only this cache is cleared.
 * fcache expire - Purge cached assets older then the specified date/time
 * fcache status - Display cache status
 * j2k decode <ID> - Do JPEG2000 decoding of an asset.

Конфигурация

 * config get [ ] [ ] - получить текущую рабочую конфигурацию, всю - нет параметров; параметры секции - если она существует; конкретный параметр, указанной секции, если параметр существует и секция присутствует.
 * config save   - сохранить текущую рабочую конфигурацию в указанный файл.
 * config set   - установить указанный конфигурационный параметр. В целом это бесполезно, поскольку OpenSimulator, ни его модули, не могут динамически обновлять значения конфигурации.
 * config show [ ] [ ] - синоним для команды 'config get'

Региона

 * land show - показать все парсели в текущем регионе.

Объектов

 * 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] - Delete a scene object by name.
 * delete object outside - Delete all scene objects outside region boundaries. This is currently if 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
 * edit scale <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] - Show details of scene objects with the given name.
 * show object uuid <UUID> - Show details of a scene object with the given UUID
 * show part name [--regex] - 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

Скрипты
Эти команды в настоящее время существуют только в git мастере OpenSimulator после релиза 0.7.2.


 * scripts resume [<script-item-uuid>] - продолжить работу приостановленных скрипт(ов)
 * scripts show [<script-item-uuid>] - Показать информацию о скрипте(ах). параметр <script-item-uuid> присутствует только в гит мастере 82f0e19 (2012-01-14) начиная с релизов (после OpenSimulator 0.7.2).
 * scripts start [<script-item-uuid>] - запустить все работающие скрипт(ы)
 * scripts stop [<script-item-uuid>] - остановить все работающие скрипт(ы)
 * scripts suspend [<script-item-uuid>] - приостановить все работающие скрипт(ы)

Ландшафта
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

Растительности

 * 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

Пользовательские

 * alert   - отправить сообщение для всех пользователей региона
 * alert-user    - отправить сообщение для указанного пользователя находящегося в регионе
 * bypass permissions &lt;true / false&gt; - вкл/выкл обход проверки разрешений в регионе
 * debug permissions - включить отладочные разрешения
 * force permissions - форсировать разрешения на включение или выключить их совсем.
 * kick user  [message]: - выкидывание пользователя из региона, можно указать необязательный параметр - текст причины "пенка"
 * login disable - выключить вход в регион симулятора
 * login enable - включить вход в регион симулятора
 * login status - показать статус активности региона для входа в него пользователями
 * show users [full]- Показать информацию о пользователях подключенных в настоящее время к этому региону. Без параметра 'full' отображаются только пользователи позиционно присутствующих в этом регионе. С параметром 'full' также показываются присутствующие агенты, пользователей, которые находятся в данный момент в соседних регионах.
 * teleport user   - телепорт пользователя в указанную позицию региона. Начиная с версии 0.7.3.1 (commit bf0b817).

Атмосферные/LightShare

 * windlight load - Загрузить профиль windlight из базы и задействовать
 * windlight enable - включить плагин windlight
 * windlight disable - выключить плагин windlight

Служебные команды сервера ROBUST
Их можно набирать в консоли симулятора когда вы работаете в автономном (standalone) режиме

Службы Ассетов

 * 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"

Службы Грида

 * set region flags <Region name>  - 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.

Службы пользователей
Note for use of create user in standalone mode: use the user default coordinates
 * create user [first] [last] [passw] [RegionX] [RegionY] [Email] - creates a new user and password
 * or just: create user - and server prompts for all data
 * 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.
 * login-level   - 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>
 * show account   - show account details for the given user name (0.7.2-dev)
 * set user level    - Set UserLevel for the user, which determines whether a user has a god account (0.7.2-dev)

terrain load
Загрузить ландшафт из указанного файла.

Параметры 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)
 * filename (String)

terrain load-tile
Loads a terrain from a section of a larger file.

Параметры 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) The width of the file in tiles The height of the file in tiles The X region coordinate of the first section on the file The Y region coordinate of the first section on the file
 * filename (String)
 * file width (Integer)
 * file height (Integer)
 * minimum X tile (Integer)
 * minimum Y tile (Integer)

terrain save
Сохраняем текущую карту высот в указанный файл.

Параметры 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)
 * filename (String)

terrain fill
Заливаем карту высот указанным значением - ровняем землю на этот уровень.

Параметры The numeric value of the height you wish to set your region to.
 * value (Double)

terrain elevate
Raises the current heightmap by the specified amount.

Параметры
 * amount (Double)

terrain lower
Lowers the current heightmap by the specified amount.

Параметры The amount of height to remove from the terrain in meters.
 * amount (Double)

terrain multiply
Multiplies the heightmap by the value specified.

Параметры The value to multiply the heightmap by.
 * value (Double)

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.

Параметры true / false - Enable new brushes
 * Enabled? (Boolean)

terrain stats
Shows some information about the regions heightmap for debugging purposes.

terrain effect
Runs a specified plugin effect

Параметры The plugin effect you wish to run, or 'list' to see all plugins
 * name (String)

Details of Hypergrid Commands
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> <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 

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

Important Note

Due to a viewer bug, you can only TP between regions that are no more than 4096 cells apart in any dimension. What this means in practice is that if you want to link to OSGrid, you must have your own regions reachable from the (10,000; 10,000) point on the map, which is where OSGrid is centered. Place your regions somewhere in the 8,000s or the 12,000s.

link-mapping

Элементы кадра статистики
Заголовки колонок кадра статистики, печатаемые в консоли, как результат команды "show stats" могут быть неясны. Ниже расшифровка этих значений:


 * Dilatn - коэфф. разделения времени симулятора
 * SimFPS - рабочих кадров на симулятора
 * PhyFPS - физических кадров в секунду
 * AgntUp - # кол-во обновлений агентов
 * RootAg - # кол-во реальных пользователей
 * ChldAg - # кол-во пользовательских агентов
 * Prims - # кол-во примов
 * AtvPrm - # кол-во активных примов
 * AtvScr - # кол-во активных скриптов
 * ScrLPS - # кол-во выполненых скриптовых строк в секунду
 * PktsIn - # кол-во принятых пакетов в секунду
 * PktOut - # кол-во отправленных пакетов в секунду
 * PendDl - # кол-во ожидающих загрузку
 * PendUl - # кол-во ожидающий выгрузку
 * UnackB - # кол-во неподтвержденных байт
 * TotlFt - общее время на кадр
 * NetFt - время кадра на сеть
 * PhysFt - время кадра на физику
 * OthrFt - время кадра на остальное
 * AgntFt - время кадра на агенты
 * ImgsFt - время кадра на растры