RemoteAdmin
From OpenSimulator
(Difference between revisions)
m (correcting a --> at) |
(→How to Setup the Remote Admin) |
||
| Line 29: | Line 29: | ||
# invoke admin_alert: requires password and message | # invoke admin_alert: requires password and message | ||
gridServer.admin_broadcast({’password’: ’secret’, ‘message’: ‘the answer is 42′}) | gridServer.admin_broadcast({’password’: ’secret’, ‘message’: ‘the answer is 42′}) | ||
| + | |||
| + | === Example in PHP === | ||
| + | |||
| + | This example needs the RemoteAdmin PHP Class file available [http://code.google.com/p/opensimtools/wiki/RemoteAdminPHPClass here]. | ||
| + | |||
| + | <pre> | ||
| + | <?php | ||
| + | |||
| + | // Author : Olish Newman | ||
| + | // Source : http://code.google.com/p/opensimtools/wiki/RemoteAdminPHPClass | ||
| + | // Licence : BSD License | ||
| + | |||
| + | // Including the RemoteAdmin PHP class. It can be downloaded from the link above. | ||
| + | include('RemoteAdmin.php'); | ||
| + | |||
| + | // Instantiate the class with parameters identical to the Python example above | ||
| + | $myRemoteAdmin = new RemoteAdmin('127.0.0.1', 9000, 'secret'); | ||
| + | |||
| + | // Invoke admin_broadcast | ||
| + | $parameters = array('message' => 'the answer is 42'); | ||
| + | $myRemoteAdmin->SendCommand('admin_broadcast', $parameters); | ||
| + | |||
| + | // Invoke admin_shutdown (example for use without parameters) | ||
| + | $myRemoteAdmin->SendCommand('admin_shutdown'); | ||
| + | |||
| + | ?></pre> | ||
== RemoteAdmin Commands == | == RemoteAdmin Commands == | ||
Revision as of 05:09, 9 June 2008
Caution ! The RemoteAdmin feature is unsecured at this time. For testing uses only.
Contents |
How to Setup the Remote Admin
Setup OpenSim
First you should enable the remote admin interface to do so just add the following lines to your OpenSim.ini file:
[RemoteAdmin] enabled = true access_password = secret
Example in Python
# Author : DrScofield # Source : http://xyzzyxyzzy.net/2008/01/23/using-pythons-xmlrpclib-with-opensim/ # License : BSD License #!/usr/bin/python import xmlrpclib # XML-RPC URL (http_listener_port) gridServerURL = ‘http://127.0.0.1:9000′ # instantiate server object gridServer = xmlrpclib.Server(gridServerURL) # invoke admin_alert: requires password and message gridServer.admin_broadcast({’password’: ’secret’, ‘message’: ‘the answer is 42′})
Example in PHP
This example needs the RemoteAdmin PHP Class file available here.
<?php
// Author : Olish Newman
// Source : http://code.google.com/p/opensimtools/wiki/RemoteAdminPHPClass
// Licence : BSD License
// Including the RemoteAdmin PHP class. It can be downloaded from the link above.
include('RemoteAdmin.php');
// Instantiate the class with parameters identical to the Python example above
$myRemoteAdmin = new RemoteAdmin('127.0.0.1', 9000, 'secret');
// Invoke admin_broadcast
$parameters = array('message' => 'the answer is 42');
$myRemoteAdmin->SendCommand('admin_broadcast', $parameters);
// Invoke admin_shutdown (example for use without parameters)
$myRemoteAdmin->SendCommand('admin_shutdown');
?>
RemoteAdmin Commands
| Name | Status | Description |
|---|---|---|
| admin_create_region | Create a new region | |
| admin_shutdown | Shut down the region | |
| admin_broadcast | Send a general alert | |
| admin_restart | Restart OpenSim | |
| admin_load_heightmap | Load Height Map... | |
| admin_create_user | Create a new user | |
| admin_load_xml | Execute the Load XML command |
Credits
Thanks to DrScofield for the Python Script Sources : http://xyzzyxyzzy.net/2008/01/23/using-pythons-xmlrpclib-with-opensim/
