/* * 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.Generic; using System.IO; using System.Reflection; using System.Text; using System.Threading; using System.Timers; using log4net; using OpenSim.Framework.Console; using OpenSim.Framework.Statistics; namespace OpenSim.Framework.Servers { /// /// Common base for the main OpenSimServers (user, grid, inventory, region, etc) /// public abstract class BaseOpenSimServer { private static readonly ILog m_log = LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType); /// /// This will control a periodic log printout of the current 'show stats' (if they are active) for this /// server. /// private System.Timers.Timer m_periodicDiagnosticsTimer = new System.Timers.Timer(60 * 60 * 1000); protected ConsoleBase m_console; /// /// Time at which this server was started /// protected DateTime m_startuptime; /// /// Record the initial startup directory for info purposes /// protected string m_startupDirectory = Environment.CurrentDirectory; /// /// Server version information. Usually VersionInfo + information about svn revision, operating system, etc. /// protected string m_version; protected BaseHttpServer m_httpServer; public BaseHttpServer HttpServer { get { return m_httpServer; } } /// /// Holds the non-viewer statistics collection object for this service/server /// protected IStatsCollector m_stats; public BaseOpenSimServer() { m_startuptime = DateTime.Now; m_version = VersionInfo.Version; m_periodicDiagnosticsTimer.Elapsed += new ElapsedEventHandler(LogDiagnostics); m_periodicDiagnosticsTimer.Enabled = true; } /// /// Print statistics to the logfile, if they are active /// protected void LogDiagnostics(object source, ElapsedEventArgs e) { StringBuilder sb = new StringBuilder("DIAGNOSTICS\n\n"); sb.Append(GetUptimeReport()); if (m_stats != null) { sb.Append(m_stats.Report()); } m_log.Debug(sb); } /// /// Return a report about the uptime of this server /// /// protected string GetUptimeReport() { StringBuilder sb = new StringBuilder(String.Format("Time now is {0}\n", DateTime.Now)); sb.Append(String.Format("Server has been running since {0}, {1}\n", m_startuptime.DayOfWeek, m_startuptime)); sb.Append(String.Format("That is an elapsed time of {0}\n", DateTime.Now - m_startuptime)); return sb.ToString(); } /// /// Performs initialisation of the scene, such as loading configuration from disk. /// public virtual void Startup() { m_log.Info("[STARTUP]: Beginning startup processing"); EnhanceVersionInformation(); m_log.Info("[STARTUP]: Version " + m_version + "\n"); } /// /// Should be overriden and referenced by descendents if they need to perform extra shutdown processing /// public virtual void Shutdown() { m_log.Info("[SHUTDOWN]: Shutdown processing on main thread complete. Exiting..."); Environment.Exit(0); } /// /// Runs commands issued by the server console from the operator /// /// The first argument of the parameter (the command) /// Additional arguments passed to the command public virtual void RunCmd(string command, string[] cmdparams) { switch (command) { case "help": Notice(""); Notice("quit - equivalent to shutdown."); Notice("show info - show server information (e.g. startup path)."); if (m_stats != null) Notice("show stats - show statistical information for this server"); Notice("show threads - list tracked threads"); Notice("show uptime - show server startup time and uptime."); Notice("show version - show server version."); Notice("shutdown - shutdown the server.\n"); break; case "show": if (cmdparams.Length > 0) { Show(cmdparams[0]); } break; case "quit": case "shutdown": Shutdown(); break; } } /// /// Outputs to the console information about the region /// /// What information to display (valid arguments are "uptime", "users") public virtual void Show(string ShowWhat) { switch (ShowWhat) { case "info": Notice("Version: " + m_version); Notice("Startup directory: " + m_startupDirectory); break; case "stats": if (m_stats != null) { Notice(m_stats.Report()); } break; case "threads": List threads = ThreadTracker.GetThreads(); if (threads == null) { Notice("Thread tracking is only enabled in DEBUG mode."); } else { Notice(threads.Count + " threads are being tracked:"); foreach (Thread t in threads) { Notice("ID: " + t.ManagedThreadId.ToString() + ", Name: " + t.Name + ", Alive: " + t.IsAlive.ToString() + ", Pri: " + t.Priority.ToString() + ", State: " + t.ThreadState.ToString()); } } break; case "uptime": Notice(GetUptimeReport()); break; case "version": Notice("Version: " + m_version); break; } } /// /// Console output is only possible if a console has been established. /// That is something that cannot be determined within this class. So /// all attempts to use the console MUST be verified. /// private void Notice(string msg) { if (m_console != null) { m_console.Notice(msg); } } /// /// Enhance the version string with extra information if it's available. /// protected void EnhanceVersionInformation() { string buildVersion = string.Empty; // Add subversion revision information if available // Try file "svn_revision" in the current directory first, then the .svn info. // This allows to make the revision available in simulators not running from the source tree. // FIXME: Making an assumption about the directory we're currently in - we do this all over the place // elsewhere as well string svnRevisionFileName = "svn_revision"; string svnFileName = "../.svn/entries"; string inputLine; int strcmp; if (File.Exists(svnRevisionFileName)) { StreamReader RevisionFile = File.OpenText(svnRevisionFileName); buildVersion = RevisionFile.ReadLine(); buildVersion.Trim(); RevisionFile.Close(); } if (string.IsNullOrEmpty(buildVersion) && File.Exists(svnFileName)) { StreamReader EntriesFile = File.OpenText(svnFileName); inputLine = EntriesFile.ReadLine(); while (inputLine != null) { // using the dir svn revision at the top of entries file strcmp = String.Compare(inputLine, "dir"); if (strcmp == 0) { buildVersion = EntriesFile.ReadLine(); break; } else { inputLine = EntriesFile.ReadLine(); } } EntriesFile.Close(); } if (!string.IsNullOrEmpty(buildVersion)) { m_version += ", SVN build r" + buildVersion; } else { m_version += ", SVN build revision not available"; } // Add operating system information if available string OSString = ""; if (System.Environment.OSVersion.Platform != PlatformID.Unix) { OSString = System.Environment.OSVersion.ToString(); } else { OSString = Util.ReadEtcIssue(); } if (OSString.Length > 45) { OSString = OSString.Substring(0, 45); } m_version += ", OS " + OSString; } } }