/* * Copyright (c) Contributors, http://opensimulator.org/ * See CONTRIBUTORS.TXT for a full list of copyright holders. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the OpenSim Project nor the * names of its contributors may be used to endorse or promote products * derived from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ using System; using System.Collections; using System.Collections.Generic; using System.IO; using System.Net; using System.Reflection; using System.Timers; using log4net; using Nini.Config; using Nwc.XmlRpc; using OpenMetaverse; using OpenSim.Framework; using OpenSim.Framework.Servers; using OpenSim.Region.CoreModules.World.Terrain; using OpenSim.Region.Framework.Interfaces; using OpenSim.Region.Framework.Scenes; namespace OpenSim.ApplicationPlugins.RemoteController { public class RemoteAdminPlugin : IApplicationPlugin { private static readonly ILog m_log = LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType); private static Object rslock = new Object(); private OpenSimBase m_app; private BaseHttpServer m_httpd; private IConfig m_config; private IConfigSource m_configSource; private string requiredPassword = String.Empty; // TODO: required by IPlugin, but likely not at all right private string m_name = "RemoteAdminPlugin"; private string m_version = "0.0"; public string Version { get { return m_version; } } public string Name { get { return m_name; } } public void Initialise() { m_log.Info("[RADMIN]: " + Name + " cannot be default-initialized!"); throw new PluginNotInitialisedException(Name); } public void Initialise(OpenSimBase openSim) { m_configSource = openSim.ConfigSource.Source; try { if (m_configSource.Configs["RemoteAdmin"] == null || !m_configSource.Configs["RemoteAdmin"].GetBoolean("enabled", false)) { // No config or disabled } else { m_config = m_configSource.Configs["RemoteAdmin"]; m_log.Info("[RADMIN]: Remote Admin Plugin Enabled"); requiredPassword = m_config.GetString("access_password", String.Empty); m_app = openSim; m_httpd = openSim.HttpServer; Dictionary availableMethods = new Dictionary(); availableMethods["admin_create_region"] = XmlRpcCreateRegionMethod; availableMethods["admin_delete_region"] = XmlRpcDeleteRegionMethod; availableMethods["admin_shutdown"] = XmlRpcShutdownMethod; availableMethods["admin_broadcast"] = XmlRpcAlertMethod; availableMethods["admin_restart"] = XmlRpcRestartMethod; availableMethods["admin_load_heightmap"] = XmlRpcLoadHeightmapMethod; availableMethods["admin_create_user"] = XmlRpcCreateUserMethod; availableMethods["admin_create_user_email"] = XmlRpcCreateUserMethod; availableMethods["admin_exists_user"] = XmlRpcUserExistsMethod; availableMethods["admin_update_user"] = XmlRpcUpdateUserAccountMethod; availableMethods["admin_load_xml"] = XmlRpcLoadXMLMethod; availableMethods["admin_save_xml"] = XmlRpcSaveXMLMethod; availableMethods["admin_load_oar"] = XmlRpcLoadOARMethod; availableMethods["admin_save_oar"] = XmlRpcSaveOARMethod; availableMethods["admin_region_query"] = XmlRpcRegionQueryMethod; // Either enable full remote functionality or just selected features string enabledMethods = m_config.GetString("enabled_methods", "all"); // The assumption here is that simply enabling Remote Admin as before will produce the same // behavior - enable all methods unless the whitelist is in place for backward-compatibility. if (enabledMethods.ToLower() == "all" || String.IsNullOrEmpty(enabledMethods)) { foreach (string method in availableMethods.Keys) { m_httpd.AddXmlRPCHandler(method, availableMethods[method], false); } } else { foreach (string enabledMethod in enabledMethods.Split('|')) { m_httpd.AddXmlRPCHandler(enabledMethod, availableMethods[enabledMethod]); } } } } catch (NullReferenceException) { // Ignore. } } public void PostInitialise() { } public XmlRpcResponse XmlRpcRestartMethod(XmlRpcRequest request) { XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); try { Hashtable requestData = (Hashtable) request.Params[0]; m_log.Info("[RADMIN]: Request to restart Region."); checkStringParameters(request, new string[] {"password", "regionID"}); if (requiredPassword != String.Empty && (!requestData.Contains("password") || (string) requestData["password"] != requiredPassword)) { throw new Exception("wrong password"); } UUID regionID = new UUID((string) requestData["regionID"]); responseData["accepted"] = "true"; responseData["success"] = "true"; response.Value = responseData; Scene rebootedScene; if (!m_app.SceneManager.TryGetScene(regionID, out rebootedScene)) throw new Exception("region not found"); responseData["rebooting"] = "true"; response.Value = responseData; rebootedScene.Restart(30); } catch (Exception e) { m_log.ErrorFormat("[RADMIN]: Restart region: failed: {0}", e.Message); m_log.DebugFormat("[RADMIN]: Restart region: failed: {0}", e.ToString()); responseData["accepted"] = "false"; responseData["success"] = "false"; responseData["rebooting"] = "false"; responseData["error"] = e.Message; response.Value = responseData; } m_log.Info("[RADMIN]: Restart Region request complete"); return response; } public XmlRpcResponse XmlRpcAlertMethod(XmlRpcRequest request) { XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); m_log.Info("[RADMIN]: Alert request started"); try { Hashtable requestData = (Hashtable) request.Params[0]; checkStringParameters(request, new string[] {"password", "message"}); if (requiredPassword != String.Empty && (!requestData.Contains("password") || (string) requestData["password"] != requiredPassword)) throw new Exception("wrong password"); string message = (string) requestData["message"]; m_log.InfoFormat("[RADMIN]: Broadcasting: {0}", message); responseData["accepted"] = "true"; responseData["success"] = "true"; response.Value = responseData; m_app.SceneManager.ForEachScene( delegate(Scene scene) { IDialogModule dialogModule = scene.RequestModuleInterface(); if (dialogModule != null) dialogModule.SendGeneralAlert(message); }); } catch (Exception e) { m_log.ErrorFormat("[RADMIN]: Broadcasting: failed: {0}", e.Message); m_log.DebugFormat("[RADMIN]: Broadcasting: failed: {0}", e.ToString()); responseData["accepted"] = "false"; responseData["success"] = "false"; responseData["error"] = e.Message; response.Value = responseData; } m_log.Info("[RADMIN]: Alert request complete"); return response; } public XmlRpcResponse XmlRpcLoadHeightmapMethod(XmlRpcRequest request) { XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); m_log.Info("[RADMIN]: Load height maps request started"); try { Hashtable requestData = (Hashtable) request.Params[0]; m_log.DebugFormat("[RADMIN]: Load Terrain: XmlRpc {0}", request.ToString()); // foreach (string k in requestData.Keys) // { // m_log.DebugFormat("[RADMIN]: Load Terrain: XmlRpc {0}: >{1}< {2}", // k, (string)requestData[k], ((string)requestData[k]).Length); // } checkStringParameters(request, new string[] {"password", "filename", "regionid"}); if (requiredPassword != String.Empty && (!requestData.Contains("password") || (string) requestData["password"] != requiredPassword)) throw new Exception("wrong password"); string file = (string) requestData["filename"]; UUID regionID = (UUID) (string) requestData["regionid"]; m_log.InfoFormat("[RADMIN]: Terrain Loading: {0}", file); responseData["accepted"] = "true"; Scene region = null; if (!m_app.SceneManager.TryGetScene(regionID, out region)) throw new Exception("1: unable to get a scene with that name"); ITerrainModule terrainModule = region.RequestModuleInterface(); if (null == terrainModule) throw new Exception("terrain module not available"); terrainModule.LoadFromFile(file); responseData["success"] = "true"; response.Value = responseData; } catch (Exception e) { m_log.ErrorFormat("[RADMIN] Terrain Loading: failed: {0}", e.Message); m_log.DebugFormat("[RADMIN] Terrain Loading: failed: {0}", e.ToString()); responseData["success"] = "false"; responseData["error"] = e.Message; } m_log.Info("[RADMIN]: Load height maps request complete"); return response; } public XmlRpcResponse XmlRpcShutdownMethod(XmlRpcRequest request) { m_log.Info("[RADMIN]: Received Shutdown Administrator Request"); XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); try { Hashtable requestData = (Hashtable) request.Params[0]; if (requiredPassword != String.Empty && (!requestData.Contains("password") || (string) requestData["password"] != requiredPassword)) throw new Exception("wrong password"); responseData["accepted"] = "true"; response.Value = responseData; int timeout = 2000; string message; if (requestData.ContainsKey("shutdown") && ((string) requestData["shutdown"] == "delayed") && requestData.ContainsKey("milliseconds")) { timeout = (Int32) requestData["milliseconds"]; message = "Region is going down in " + ((int) (timeout/1000)).ToString() + " second(s). Please save what you are doing and log out."; } else { message = "Region is going down now."; } m_app.SceneManager.ForEachScene( delegate(Scene scene) { IDialogModule dialogModule = scene.RequestModuleInterface(); if (dialogModule != null) dialogModule.SendGeneralAlert(message); }); // Perform shutdown Timer shutdownTimer = new Timer(timeout); // Wait before firing shutdownTimer.AutoReset = false; shutdownTimer.Elapsed += new ElapsedEventHandler(shutdownTimer_Elapsed); shutdownTimer.Start(); responseData["success"] = "true"; } catch (Exception e) { m_log.ErrorFormat("[RADMIN] Shutdown: failed: {0}", e.Message); m_log.DebugFormat("[RADMIN] Shutdown: failed: {0}", e.ToString()); responseData["accepted"] = "false"; responseData["error"] = e.Message; response.Value = responseData; } m_log.Info("[RADMIN]: Shutdown Administrator Request complete"); return response; } private void shutdownTimer_Elapsed(object sender, ElapsedEventArgs e) { m_app.Shutdown(); } private static void checkStringParameters(XmlRpcRequest request, string[] param) { Hashtable requestData = (Hashtable) request.Params[0]; foreach (string p in param) { if (!requestData.Contains(p)) throw new Exception(String.Format("missing string parameter {0}", p)); if (String.IsNullOrEmpty((string) requestData[p])) throw new Exception(String.Format("parameter {0} is empty", p)); } } private static void checkIntegerParams(XmlRpcRequest request, string[] param) { Hashtable requestData = (Hashtable) request.Params[0]; foreach (string p in param) { if (!requestData.Contains(p)) throw new Exception(String.Format("missing integer parameter {0}", p)); } } /// /// Create a new region. /// /// incoming XML RPC request /// /// XmlRpcCreateRegionMethod takes the following XMLRPC /// parameters /// /// parameter namedescription /// password /// admin password as set in OpenSim.ini /// region_name /// desired region name /// region_id /// (optional) desired region UUID /// region_x /// desired region X coordinate (integer) /// region_y /// desired region Y coordinate (integer) /// region_master_first /// firstname of region master /// region_master_last /// lastname of region master /// region_master_uuid /// explicit UUID to use for master avatar (optional) /// listen_ip /// internal IP address (dotted quad) /// listen_port /// internal port (integer) /// external_address /// external IP address /// persist /// if true, persist the region info /// ('true' or 'false') /// /// /// XmlRpcCreateRegionMethod returns /// /// namedescription /// success /// true or false /// error /// error message if success is false /// region_uuid /// UUID of the newly created region /// region_name /// name of the newly created region /// /// public XmlRpcResponse XmlRpcCreateRegionMethod(XmlRpcRequest request) { m_log.Info("[RADMIN]: CreateRegion: new request"); XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); lock (rslock) { int m_regionLimit = m_config.GetInt("region_limit", 0); try { Hashtable requestData = (Hashtable) request.Params[0]; checkStringParameters(request, new string[] { "password", "region_name", "region_master_first", "region_master_last", "region_master_password", "listen_ip", "external_address" }); checkIntegerParams(request, new string[] {"region_x", "region_y", "listen_port"}); // check password if (!String.IsNullOrEmpty(requiredPassword) && (string) requestData["password"] != requiredPassword) throw new Exception("wrong password"); // check whether we still have space left (iff we are using limits) if (m_regionLimit != 0 && m_app.SceneManager.Scenes.Count >= m_regionLimit) throw new Exception(String.Format("cannot instantiate new region, server capacity {0} already reached; delete regions first", m_regionLimit)); // extract or generate region ID now Scene scene = null; UUID regionID = UUID.Zero; if (requestData.ContainsKey("region_id") && !String.IsNullOrEmpty((string) requestData["region_id"])) { regionID = (UUID) (string) requestData["region_id"]; if (m_app.SceneManager.TryGetScene(regionID, out scene)) throw new Exception( String.Format("region UUID already in use by region {0}, UUID {1}, <{2},{3}>", scene.RegionInfo.RegionName, scene.RegionInfo.RegionID, scene.RegionInfo.RegionLocX, scene.RegionInfo.RegionLocY)); } else { regionID = UUID.Random(); m_log.DebugFormat("[RADMIN] CreateRegion: new region UUID {0}", regionID); } // create volatile or persistent region info RegionInfo region = new RegionInfo(); region.RegionID = regionID; region.RegionName = (string) requestData["region_name"]; region.RegionLocX = Convert.ToUInt32(requestData["region_x"]); region.RegionLocY = Convert.ToUInt32(requestData["region_y"]); // check for collisions: region name, region UUID, // region location if (m_app.SceneManager.TryGetScene(region.RegionName, out scene)) throw new Exception( String.Format("region name already in use by region {0}, UUID {1}, <{2},{3}>", scene.RegionInfo.RegionName, scene.RegionInfo.RegionID, scene.RegionInfo.RegionLocX, scene.RegionInfo.RegionLocY)); if (m_app.SceneManager.TryGetScene(region.RegionLocX, region.RegionLocY, out scene)) throw new Exception( String.Format("region location <{0},{1}> already in use by region {2}, UUID {3}, <{4},{5}>", region.RegionLocX, region.RegionLocY, scene.RegionInfo.RegionName, scene.RegionInfo.RegionID, scene.RegionInfo.RegionLocX, scene.RegionInfo.RegionLocY)); region.InternalEndPoint = new IPEndPoint(IPAddress.Parse((string) requestData["listen_ip"]), 0); region.InternalEndPoint.Port = Convert.ToInt32(requestData["listen_port"]); if (0 == region.InternalEndPoint.Port) throw new Exception("listen_port is 0"); if (m_app.SceneManager.TryGetScene(region.InternalEndPoint, out scene)) throw new Exception( String.Format( "region internal IP {0} and port {1} already in use by region {2}, UUID {3}, <{4},{5}>", region.InternalEndPoint.Address, region.InternalEndPoint.Port, scene.RegionInfo.RegionName, scene.RegionInfo.RegionID, scene.RegionInfo.RegionLocX, scene.RegionInfo.RegionLocY)); region.ExternalHostName = (string) requestData["external_address"]; string masterFirst = (string) requestData["region_master_first"]; string masterLast = (string) requestData["region_master_last"]; string masterPassword = (string) requestData["region_master_password"]; UUID userID = UUID.Zero; if (requestData.ContainsKey("region_master_uuid")) { // ok, client wants us to use an explicit UUID // regardless of what the avatar name provided userID = new UUID((string) requestData["region_master_uuid"]); } else { // no client supplied UUID: look it up... UserProfileData userProfile = m_app.CommunicationsManager.UserService.GetUserProfile(masterFirst, masterLast); if (null == userProfile) { m_log.InfoFormat("master avatar does not exist, creating it"); // ...or create new user userID = m_app.CommunicationsManager.UserAdminService.AddUser( masterFirst, masterLast, masterPassword, "", region.RegionLocX, region.RegionLocY); if (userID == UUID.Zero) throw new Exception(String.Format("failed to create new user {0} {1}", masterFirst, masterLast)); } else { userID = userProfile.ID; } } region.MasterAvatarFirstName = masterFirst; region.MasterAvatarLastName = masterLast; region.MasterAvatarSandboxPassword = masterPassword; region.MasterAvatarAssignedUUID = userID; bool persist = Convert.ToBoolean((string) requestData["persist"]); if (persist) { // default place for region XML files is in the // Regions directory of the config dir (aka /bin) string regionConfigPath = Path.Combine(Util.configDir(), "Regions"); try { // OpenSim.ini can specify a different regions dir IConfig startupConfig = (IConfig) m_configSource.Configs["Startup"]; regionConfigPath = startupConfig.GetString("regionload_regionsdir", regionConfigPath).Trim(); } catch (Exception) { // No INI setting recorded. } string regionXmlPath = Path.Combine(regionConfigPath, String.Format( m_config.GetString("region_file_template", "{0}x{1}-{2}.xml"), region.RegionLocX.ToString(), region.RegionLocY.ToString(), regionID.ToString(), region.InternalEndPoint.Port.ToString(), region.RegionName.Replace(" ", "_").Replace(":", "_"). Replace("/", "_"))); m_log.DebugFormat("[RADMIN] CreateRegion: persisting region {0} to {1}", region.RegionID, regionXmlPath); region.SaveRegionToFile("dynamic region", regionXmlPath); } IScene newscene; m_app.CreateRegion(region, out newscene); responseData["success"] = "true"; responseData["region_name"] = region.RegionName; responseData["region_uuid"] = region.RegionID.ToString(); response.Value = responseData; } catch (Exception e) { m_log.ErrorFormat("[RADMIN] CreateRegion: failed {0}", e.Message); m_log.DebugFormat("[RADMIN] CreateRegion: failed {0}", e.ToString()); responseData["success"] = "false"; responseData["error"] = e.Message; response.Value = responseData; } m_log.Info("[RADMIN]: CreateRegion: request complete"); return response; } } /// /// Delete a new region. /// /// incoming XML RPC request /// /// XmlRpcCreateRegionMethod takes the following XMLRPC /// parameters /// /// parameter namedescription /// password /// admin password as set in OpenSim.ini /// region_name /// desired region name /// region_id /// (optional) desired region UUID /// /// /// XmlRpcCreateRegionMethod returns /// /// namedescription /// success /// true or false /// error /// error message if success is false /// /// public XmlRpcResponse XmlRpcDeleteRegionMethod(XmlRpcRequest request) { m_log.Info("[RADMIN]: DeleteRegion: new request"); XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); lock (rslock) { try { Hashtable requestData = (Hashtable) request.Params[0]; checkStringParameters(request, new string[] {"password", "region_name"}); Scene scene = null; string regionName = (string) requestData["region_name"]; if (!m_app.SceneManager.TryGetScene(regionName, out scene)) throw new Exception(String.Format("region \"{0}\" does not exist", regionName)); m_app.RemoveRegion(scene, true); responseData["success"] = "true"; responseData["region_name"] = regionName; response.Value = responseData; } catch (Exception e) { m_log.ErrorFormat("[RADMIN] DeleteRegion: failed {0}", e.Message); m_log.DebugFormat("[RADMIN] DeleteRegion: failed {0}", e.ToString()); responseData["success"] = "false"; responseData["error"] = e.Message; response.Value = responseData; } m_log.Info("[RADMIN]: DeleteRegion: request complete"); return response; } } /// /// Create a new user account. /// /// incoming XML RPC request /// /// XmlRpcCreateUserMethod takes the following XMLRPC /// parameters /// /// parameter namedescription /// password /// admin password as set in OpenSim.ini /// user_firstname /// avatar's first name /// user_lastname /// avatar's last name /// user_password /// avatar's password /// user_email /// email of the avatar's owner (optional) /// start_region_x /// avatar's start region coordinates, X value /// start_region_y /// avatar's start region coordinates, Y value /// /// /// XmlRpcCreateUserMethod returns /// /// namedescription /// success /// true or false /// error /// error message if success is false /// avatar_uuid /// UUID of the newly created avatar /// account; UUID.Zero if failed. /// /// /// public XmlRpcResponse XmlRpcCreateUserMethod(XmlRpcRequest request) { m_log.Info("[RADMIN]: CreateUser: new request"); XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); lock (rslock) { try { Hashtable requestData = (Hashtable) request.Params[0]; // check completeness checkStringParameters(request, new string[] { "password", "user_firstname", "user_lastname", "user_password", }); checkIntegerParams(request, new string[] {"start_region_x", "start_region_y"}); // check password if (!String.IsNullOrEmpty(requiredPassword) && (string) requestData["password"] != requiredPassword) throw new Exception("wrong password"); // do the job string firstname = (string) requestData["user_firstname"]; string lastname = (string) requestData["user_lastname"]; string passwd = (string) requestData["user_password"]; uint regX = Convert.ToUInt32((Int32) requestData["start_region_x"]); uint regY = Convert.ToUInt32((Int32) requestData["start_region_y"]); string email = ""; // empty string for email if (requestData.Contains("user_email")) email = (string)requestData["user_email"]; UserProfileData userProfile = m_app.CommunicationsManager.UserService.GetUserProfile(firstname, lastname); if (null != userProfile) throw new Exception(String.Format("avatar {0} {1} already exists", firstname, lastname)); UUID userID = m_app.CommunicationsManager.UserAdminService.AddUser(firstname, lastname, passwd, email, regX, regY); if (userID == UUID.Zero) throw new Exception(String.Format("failed to create new user {0} {1}", firstname, lastname)); responseData["success"] = "true"; responseData["avatar_uuid"] = userID.ToString(); response.Value = responseData; m_log.InfoFormat("[RADMIN]: CreateUser: User {0} {1} created, UUID {2}", firstname, lastname, userID); } catch (Exception e) { m_log.ErrorFormat("[RADMIN] CreateUser: failed: {0}", e.Message); m_log.DebugFormat("[RADMIN] CreateUser: failed: {0}", e.ToString()); responseData["success"] = "false"; responseData["avatar_uuid"] = UUID.Zero.ToString(); responseData["error"] = e.Message; response.Value = responseData; } m_log.Info("[RADMIN]: CreateUser: request complete"); return response; } } /// /// Check whether a certain user account exists. /// /// incoming XML RPC request /// /// XmlRpcUserExistsMethod takes the following XMLRPC /// parameters /// /// parameter namedescription /// password /// admin password as set in OpenSim.ini /// user_firstname /// avatar's first name /// user_lastname /// avatar's last name /// /// /// XmlRpcCreateUserMethod returns /// /// namedescription /// user_firstname /// avatar's first name /// user_lastname /// avatar's last name /// success /// true or false /// error /// error message if success is false /// /// public XmlRpcResponse XmlRpcUserExistsMethod(XmlRpcRequest request) { m_log.Info("[RADMIN]: UserExists: new request"); XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); try { Hashtable requestData = (Hashtable) request.Params[0]; // check completeness checkStringParameters(request, new string[] {"password", "user_firstname", "user_lastname"}); string firstname = (string) requestData["user_firstname"]; string lastname = (string) requestData["user_lastname"]; UserProfileData userProfile = m_app.CommunicationsManager.UserService.GetUserProfile(firstname, lastname); responseData["user_firstname"] = firstname; responseData["user_lastname"] = lastname; if (null == userProfile) responseData["success"] = false; else responseData["success"] = true; response.Value = responseData; } catch (Exception e) { m_log.ErrorFormat("[RADMIN] UserExists: failed: {0}", e.Message); m_log.DebugFormat("[RADMIN] UserExists: failed: {0}", e.ToString()); responseData["success"] = "false"; responseData["error"] = e.Message; response.Value = responseData; } m_log.Info("[RADMIN]: UserExists: request complete"); return response; } /// /// Update a user account. /// /// incoming XML RPC request /// /// XmlRpcUpdateUserAccountMethod takes the following XMLRPC /// parameters (changeable ones are optional) /// /// parameter namedescription /// password /// admin password as set in OpenSim.ini /// user_firstname /// avatar's first name (cannot be changed) /// user_lastname /// avatar's last name (cannot be changed) /// user_password /// avatar's password (changeable) /// start_region_x /// avatar's start region coordinates, X /// value (changeable) /// start_region_y /// avatar's start region coordinates, Y /// value (changeable) /// about_real_world /// "about" text of avatar owner (changeable) /// about_virtual_world /// "about" text of avatar (changeable) /// /// /// XmlRpcCreateUserMethod returns /// /// namedescription /// success /// true or false /// error /// error message if success is false /// /// public XmlRpcResponse XmlRpcUpdateUserAccountMethod(XmlRpcRequest request) { m_log.Info("[RADMIN]: UpdateUserAccount: new request"); XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); lock (rslock) { try { Hashtable requestData = (Hashtable) request.Params[0]; // check completeness checkStringParameters(request, new string[] { "password", "user_firstname", "user_lastname"}); // check password if (!String.IsNullOrEmpty(requiredPassword) && (string) requestData["password"] != requiredPassword) throw new Exception("wrong password"); // do the job string firstname = (string) requestData["user_firstname"]; string lastname = (string) requestData["user_lastname"]; string passwd = String.Empty; uint? regX = null; uint? regY = null; uint? ulaX = null; uint? ulaY = null; uint? ulaZ = null; uint? usaX = null; uint? usaY = null; uint? usaZ = null; string aboutFirstLive = String.Empty; string aboutAvatar = String.Empty; if (requestData.ContainsKey("user_password")) passwd = (string) requestData["user_password"]; if (requestData.ContainsKey("start_region_x")) regX = Convert.ToUInt32((Int32) requestData["start_region_x"]); if (requestData.ContainsKey("start_region_y")) regY = Convert.ToUInt32((Int32) requestData["start_region_y"]); if (requestData.ContainsKey("start_lookat_x")) ulaX = Convert.ToUInt32((Int32) requestData["start_lookat_x"]); if (requestData.ContainsKey("start_lookat_y")) ulaY = Convert.ToUInt32((Int32) requestData["start_lookat_y"]); if (requestData.ContainsKey("start_lookat_z")) ulaZ = Convert.ToUInt32((Int32) requestData["start_lookat_z"]); if (requestData.ContainsKey("start_standat_x")) usaX = Convert.ToUInt32((Int32) requestData["start_standat_x"]); if (requestData.ContainsKey("start_standat_y")) usaY = Convert.ToUInt32((Int32) requestData["start_standat_y"]); if (requestData.ContainsKey("start_standat_z")) usaZ = Convert.ToUInt32((Int32) requestData["start_standat_z"]); if (requestData.ContainsKey("about_real_world")) aboutFirstLive = (string)requestData["about_real_world"]; if (requestData.ContainsKey("about_virtual_world")) aboutAvatar = (string)requestData["about_virtual_world"]; UserProfileData userProfile = m_app.CommunicationsManager.UserService.GetUserProfile(firstname, lastname); if (null == userProfile) throw new Exception(String.Format("avatar {0} {1} does not exist", firstname, lastname)); if (null != passwd) { string md5PasswdHash = Util.Md5Hash(Util.Md5Hash(passwd) + ":" + String.Empty); userProfile.PasswordHash = md5PasswdHash; } if (null != regX) userProfile.HomeRegionX = (uint) regX; if (null != regY) userProfile.HomeRegionY = (uint) regY; if (null != usaX) userProfile.HomeLocationX = (uint) usaX; if (null != usaY) userProfile.HomeLocationY = (uint) usaY; if (null != usaZ) userProfile.HomeLocationZ = (uint) usaZ; if (null != ulaX) userProfile.HomeLookAtX = (uint) ulaX; if (null != ulaY) userProfile.HomeLookAtY = (uint) ulaY; if (null != ulaZ) userProfile.HomeLookAtZ = (uint) ulaZ; if (String.Empty != aboutFirstLive) userProfile.FirstLifeAboutText = aboutFirstLive; if (String.Empty != aboutAvatar) userProfile.AboutText = aboutAvatar; if (!m_app.CommunicationsManager.UserService.UpdateUserProfile(userProfile)) throw new Exception("did not manage to update user profile"); responseData["success"] = "true"; response.Value = responseData; m_log.InfoFormat("[RADMIN]: UpdateUserAccount: account for user {0} {1} updated, UUID {2}", firstname, lastname, userProfile.ID); } catch (Exception e) { m_log.ErrorFormat("[RADMIN] UpdateUserAccount: failed: {0}", e.Message); m_log.DebugFormat("[RADMIN] UpdateUserAccount: failed: {0}", e.ToString()); responseData["success"] = "false"; responseData["error"] = e.Message; response.Value = responseData; } } m_log.Info("[RADMIN]: UpdateUserAccount: request complete"); return response; } /// /// Load an OAR file into a region.. /// /// incoming XML RPC request /// /// XmlRpcLoadOARMethod takes the following XMLRPC /// parameters /// /// parameter namedescription /// password /// admin password as set in OpenSim.ini /// filename /// file name of the OAR file /// region_uuid /// UUID of the region /// region_name /// region name /// /// /// region_uuid takes precedence over /// region_name if both are present; one of both /// must be present. /// /// XmlRpcLoadOARMethod returns /// /// namedescription /// success /// true or false /// error /// error message if success is false /// /// public XmlRpcResponse XmlRpcLoadOARMethod(XmlRpcRequest request) { m_log.Info("[RADMIN]: Received Load OAR Administrator Request"); XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); lock (rslock) { try { Hashtable requestData = (Hashtable) request.Params[0]; // check completeness foreach (string p in new string[] {"password", "filename"}) { if (!requestData.Contains(p)) throw new Exception(String.Format("missing parameter {0}", p)); if (String.IsNullOrEmpty((string) requestData[p])) throw new Exception(String.Format("parameter {0} is empty")); } // check password if (!String.IsNullOrEmpty(requiredPassword) && (string) requestData["password"] != requiredPassword) throw new Exception("wrong password"); string filename = (string) requestData["filename"]; Scene scene = null; if (requestData.Contains("region_uuid")) { UUID region_uuid = (UUID) (string) requestData["region_uuid"]; if (!m_app.SceneManager.TryGetScene(region_uuid, out scene)) throw new Exception(String.Format("failed to switch to region {0}", region_uuid.ToString())); } else if (requestData.Contains("region_name")) { string region_name = (string) requestData["region_name"]; if (!m_app.SceneManager.TryGetScene(region_name, out scene)) throw new Exception(String.Format("failed to switch to region {0}", region_name)); } else throw new Exception("neither region_name nor region_uuid given"); IRegionArchiverModule archiver = scene.RequestModuleInterface(); if (archiver != null) archiver.DearchiveRegion(filename); else throw new Exception("Archiver module not present for scene"); responseData["loaded"] = "true"; response.Value = responseData; } catch (Exception e) { m_log.InfoFormat("[RADMIN] LoadOAR: {0}", e.Message); m_log.DebugFormat("[RADMIN] LoadOAR: {0}", e.ToString()); responseData["loaded"] = "false"; responseData["error"] = e.Message; response.Value = responseData; } m_log.Info("[RADMIN]: Load OAR Administrator Request complete"); return response; } } /// /// Save a region to an OAR file /// /// incoming XML RPC request /// /// XmlRpcSaveOARMethod takes the following XMLRPC /// parameters /// /// parameter namedescription /// password /// admin password as set in OpenSim.ini /// filename /// file name for the OAR file /// region_uuid /// UUID of the region /// region_name /// region name /// /// /// region_uuid takes precedence over /// region_name if both are present; one of both /// must be present. /// /// XmlRpcLoadOARMethod returns /// /// namedescription /// success /// true or false /// error /// error message if success is false /// /// public XmlRpcResponse XmlRpcSaveOARMethod(XmlRpcRequest request) { m_log.Info("[RADMIN]: Received Save OAR Administrator Request"); XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); try { Hashtable requestData = (Hashtable) request.Params[0]; // check completeness foreach (string p in new string[] {"password", "filename"}) { if (!requestData.Contains(p)) throw new Exception(String.Format("missing parameter {0}", p)); if (String.IsNullOrEmpty((string) requestData[p])) throw new Exception(String.Format("parameter {0} is empty")); } // check password if (!String.IsNullOrEmpty(requiredPassword) && (string) requestData["password"] != requiredPassword) throw new Exception("wrong password"); string filename = (string) requestData["filename"]; Scene scene = null; if (requestData.Contains("region_uuid")) { UUID region_uuid = (UUID) (string) requestData["region_uuid"]; if (!m_app.SceneManager.TryGetScene(region_uuid, out scene)) throw new Exception(String.Format("failed to switch to region {0}", region_uuid.ToString())); } else if (requestData.Contains("region_name")) { string region_name = (string) requestData["region_name"]; if (!m_app.SceneManager.TryGetScene(region_name, out scene)) throw new Exception(String.Format("failed to switch to region {0}", region_name)); } else throw new Exception("neither region_name nor region_uuid given"); IRegionArchiverModule archiver = scene.RequestModuleInterface(); if (archiver != null) archiver.ArchiveRegion(filename); else throw new Exception("Archiver module not present for scene"); responseData["saved"] = "true"; response.Value = responseData; } catch (Exception e) { m_log.InfoFormat("[RADMIN] SaveOAR: {0}", e.Message); m_log.DebugFormat("[RADMIN] SaveOAR: {0}", e.ToString()); responseData["saved"] = "false"; responseData["error"] = e.Message; response.Value = responseData; } m_log.Info("[RADMIN]: Save OAR Administrator Request complete"); return response; } public XmlRpcResponse XmlRpcLoadXMLMethod(XmlRpcRequest request) { m_log.Info("[RADMIN]: Received Load XML Administrator Request"); XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); lock (rslock) { try { Hashtable requestData = (Hashtable) request.Params[0]; // check completeness foreach (string p in new string[] {"password", "filename"}) { if (!requestData.Contains(p)) throw new Exception(String.Format("missing parameter {0}", p)); if (String.IsNullOrEmpty((string) requestData[p])) throw new Exception(String.Format("parameter {0} is empty")); } // check password if (!String.IsNullOrEmpty(requiredPassword) && (string) requestData["password"] != requiredPassword) throw new Exception("wrong password"); string filename = (string) requestData["filename"]; if (requestData.Contains("region_uuid")) { UUID region_uuid = (UUID) (string) requestData["region_uuid"]; if (!m_app.SceneManager.TrySetCurrentScene(region_uuid)) throw new Exception(String.Format("failed to switch to region {0}", region_uuid.ToString())); m_log.InfoFormat("[RADMIN] Switched to region {0}", region_uuid.ToString()); } else if (requestData.Contains("region_name")) { string region_name = (string) requestData["region_name"]; if (!m_app.SceneManager.TrySetCurrentScene(region_name)) throw new Exception(String.Format("failed to switch to region {0}", region_name)); m_log.InfoFormat("[RADMIN] Switched to region {0}", region_name); } else throw new Exception("neither region_name nor region_uuid given"); responseData["switched"] = "true"; string xml_version = "1"; if (requestData.Contains("xml_version")) { xml_version = (string) requestData["xml_version"]; } switch (xml_version) { case "1": m_app.SceneManager.LoadCurrentSceneFromXml(filename, true, new Vector3(0, 0, 0)); break; case "2": m_app.SceneManager.LoadCurrentSceneFromXml2(filename); break; default: throw new Exception(String.Format("unknown Xml{0} format", xml_version)); } responseData["loaded"] = "true"; response.Value = responseData; } catch (Exception e) { m_log.InfoFormat("[RADMIN] LoadXml: {0}", e.Message); m_log.DebugFormat("[RADMIN] LoadXml: {0}", e.ToString()); responseData["loaded"] = "false"; responseData["switched"] = "false"; responseData["error"] = e.Message; response.Value = responseData; } m_log.Info("[RADMIN]: Load XML Administrator Request complete"); return response; } } public XmlRpcResponse XmlRpcSaveXMLMethod(XmlRpcRequest request) { m_log.Info("[RADMIN]: Received Save XML Administrator Request"); XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); try { Hashtable requestData = (Hashtable) request.Params[0]; // check completeness foreach (string p in new string[] {"password", "filename"}) { if (!requestData.Contains(p)) throw new Exception(String.Format("missing parameter {0}", p)); if (String.IsNullOrEmpty((string) requestData[p])) throw new Exception(String.Format("parameter {0} is empty")); } // check password if (!String.IsNullOrEmpty(requiredPassword) && (string) requestData["password"] != requiredPassword) throw new Exception("wrong password"); string filename = (string) requestData["filename"]; if (requestData.Contains("region_uuid")) { UUID region_uuid = (UUID) (string) requestData["region_uuid"]; if (!m_app.SceneManager.TrySetCurrentScene(region_uuid)) throw new Exception(String.Format("failed to switch to region {0}", region_uuid.ToString())); m_log.InfoFormat("[RADMIN] Switched to region {0}", region_uuid.ToString()); } else if (requestData.Contains("region_name")) { string region_name = (string) requestData["region_name"]; if (!m_app.SceneManager.TrySetCurrentScene(region_name)) throw new Exception(String.Format("failed to switch to region {0}", region_name)); m_log.InfoFormat("[RADMIN] Switched to region {0}", region_name); } else throw new Exception("neither region_name nor region_uuid given"); responseData["switched"] = "true"; string xml_version = "1"; if (requestData.Contains("xml_version")) { xml_version = (string) requestData["xml_version"]; } switch (xml_version) { case "1": m_app.SceneManager.SaveCurrentSceneToXml(filename); break; case "2": m_app.SceneManager.SaveCurrentSceneToXml2(filename); break; default: throw new Exception(String.Format("unknown Xml{0} format", xml_version)); } responseData["saved"] = "true"; response.Value = responseData; } catch (Exception e) { m_log.InfoFormat("[RADMIN] SaveXml: {0}", e.Message); m_log.DebugFormat("[RADMIN] SaveXml: {0}", e.ToString()); responseData["saved"] = "false"; responseData["switched"] = "false"; responseData["error"] = e.Message; response.Value = responseData; } m_log.Info("[RADMIN]: Save XML Administrator Request complete"); return response; } public XmlRpcResponse XmlRpcRegionQueryMethod(XmlRpcRequest request) { m_log.Info("[RADMIN]: Received Query XML Administrator Request"); XmlRpcResponse response = new XmlRpcResponse(); Hashtable responseData = new Hashtable(); try { responseData["success"] = "true"; Hashtable requestData = (Hashtable) request.Params[0]; // check completeness if (!requestData.Contains("password")) throw new Exception(String.Format("missing required parameter")); if (!String.IsNullOrEmpty(requiredPassword) && (string) requestData["password"] != requiredPassword) throw new Exception("wrong password"); if (requestData.Contains("region_uuid")) { UUID region_uuid = (UUID) (string) requestData["region_uuid"]; if (!m_app.SceneManager.TrySetCurrentScene(region_uuid)) throw new Exception(String.Format("failed to switch to region {0}", region_uuid.ToString())); m_log.InfoFormat("[RADMIN] Switched to region {0}", region_uuid.ToString()); } else if (requestData.Contains("region_name")) { string region_name = (string) requestData["region_name"]; if (!m_app.SceneManager.TrySetCurrentScene(region_name)) throw new Exception(String.Format("failed to switch to region {0}", region_name)); m_log.InfoFormat("[RADMIN] Switched to region {0}", region_name); } else throw new Exception("neither region_name nor region_uuid given"); Scene s = m_app.SceneManager.CurrentScene; int health = s.GetHealth(); responseData["health"] = health; response.Value = responseData; } catch (Exception e) { m_log.InfoFormat("[RADMIN] RegionQuery: {0}", e.Message); responseData["success"] = "false"; responseData["error"] = e.Message; response.Value = responseData; } m_log.Info("[RADMIN]: Query XML Administrator Request complete"); return response; } public void Dispose() { } } }