diff --git a/README.rst b/README.rst
index 091b5fc9..e4df8b6c 100644
--- a/README.rst
+++ b/README.rst
@@ -69,12 +69,17 @@ To run tests use:
py.test -v
-Run as daemon
-***************
+Run as daemon (Unix only)
+**************************
You will found init sample script for various systems
inside the init directory.
+Usefull options:
+* --daemon: start process as a daemon
+* --log logfile: store output in a logfile
+* --pid pidfile: store the pid of the running process in a file and prevent double execution
+
upstart
~~~~~~~
diff --git a/gns3server/main.py b/gns3server/main.py
index ee32440f..34670e10 100644
--- a/gns3server/main.py
+++ b/gns3server/main.py
@@ -16,121 +16,40 @@
# You should have received a copy of the GNU General Public License
# along with this program. If not, see .
+"""
+Entry point of the server. It's support daemonize the process
+"""
+
import os
-import datetime
import sys
-import locale
-import argparse
-
-from gns3server.server import Server
-from gns3server.web.logger import init_logger
-from gns3server.version import __version__
-from gns3server.config import Config
-from gns3server.modules.project import Project
-from gns3server.crash_report import CrashReport
-
-import logging
-log = logging.getLogger(__name__)
-def locale_check():
+def daemonize():
"""
- Checks if this application runs with a correct locale (i.e. supports UTF-8 encoding) and attempt to fix
- if this is not the case.
-
- This is to prevent UnicodeEncodeError with unicode paths when using standard library I/O operation
- methods (e.g. os.stat() or os.path.*) which rely on the system or user locale.
-
- More information can be found there: http://seasonofcode.com/posts/unicode-i-o-and-locales-in-python.html
- or there: http://robjwells.com/post/61198832297/get-your-us-ascii-out-of-my-face
+ Do the UNIX double-fork magic for properly detaching process
"""
-
- # no need to check on Windows or when this application is frozen
- if sys.platform.startswith("win") or hasattr(sys, "frozen"):
- return
-
- language = encoding = None
try:
- language, encoding = locale.getlocale()
- except ValueError as e:
- log.error("Could not determine the current locale: {}".format(e))
- if not language and not encoding:
- try:
- log.warn("Could not find a default locale, switching to C.UTF-8...")
- locale.setlocale(locale.LC_ALL, ("C", "UTF-8"))
- except locale.Error as e:
- log.error("Could not switch to the C.UTF-8 locale: {}".format(e))
- raise SystemExit
- elif encoding != "UTF-8":
- log.warn("Your locale {}.{} encoding is not UTF-8, switching to the UTF-8 version...".format(language, encoding))
- try:
- locale.setlocale(locale.LC_ALL, (language, "UTF-8"))
- except locale.Error as e:
- log.error("Could not set an UTF-8 encoding for the {} locale: {}".format(language, e))
- raise SystemExit
- else:
- log.info("Current locale is {}.{}".format(language, encoding))
+ pid = os.fork()
+ if pid > 0:
+ # Exit first parent
+ sys.exit(0)
+ except OSError as e:
+ print("First fork failed: %d (%s)\n" % (e.errno, e.strerror), file=sys.stderr)
+ sys.exit(1)
+ # Decouple from parent environment
+ os.setsid()
+ os.umask(700)
-def parse_arguments(argv, config):
- """
- Parse command line arguments and override local configuration
-
- :params args: Array of command line arguments
- :params config: ConfigParser with default variable from configuration
- """
-
- defaults = {
- "host": config.get("host", "0.0.0.0"),
- "port": config.get("port", 8000),
- "ssl": config.getboolean("ssl", False),
- "certfile": config.get("certfile", ""),
- "certkey": config.get("certkey", ""),
- "record": config.get("record", ""),
- "local": config.getboolean("local", False),
- "allow": config.getboolean("allow_remote_console", False),
- "quiet": config.getboolean("quiet", False),
- "debug": config.getboolean("debug", False),
- "live": config.getboolean("live", False),
- "logfile": config.getboolean("logfile", ""),
- }
-
- parser = argparse.ArgumentParser(description="GNS3 server version {}".format(__version__))
- parser.set_defaults(**defaults)
- parser.add_argument("-v", "--version", help="show the version", action="version", version=__version__)
- parser.add_argument("--host", help="run on the given host/IP address")
- parser.add_argument("--port", help="run on the given port", type=int)
- parser.add_argument("--ssl", action="store_true", help="run in SSL mode")
- parser.add_argument("--certfile", help="SSL cert file")
- parser.add_argument("--certkey", help="SSL key file")
- parser.add_argument("--record", help="save curl requests into a file")
- parser.add_argument("-L", "--local", action="store_true", help="local mode (allows some insecure operations)")
- parser.add_argument("-A", "--allow", action="store_true", help="allow remote connections to local console ports")
- parser.add_argument("-q", "--quiet", action="store_true", help="do not show logs on stdout")
- parser.add_argument("-d", "--debug", action="store_true", help="show debug logs")
- parser.add_argument("--live", action="store_true", help="enable code live reload")
- parser.add_argument("--shell", action="store_true", help="start a shell inside the server (debugging purpose only you need to install ptpython before)")
- parser.add_argument("--log", help="send output to logfile instead of console")
-
- return parser.parse_args(argv)
-
-
-def set_config(args):
-
- config = Config.instance()
- server_config = config.get_section_config("Server")
- server_config["local"] = str(args.local)
- server_config["allow_remote_console"] = str(args.allow)
- server_config["host"] = args.host
- server_config["port"] = str(args.port)
- server_config["ssl"] = str(args.ssl)
- server_config["certfile"] = args.certfile
- server_config["certkey"] = args.certkey
- server_config["record"] = args.record
- server_config["debug"] = str(args.debug)
- server_config["live"] = str(args.live)
- server_config["shell"] = str(args.shell)
- config.set_section_config("Server", server_config)
+ # Do second fork
+ try:
+ pid = os.fork()
+ if pid > 0:
+ # Exit from second parent
+ sys.exit(0)
+ except OSError as e:
+ print("Second fork failed: %d (%s)\n" % (e.errno, e.strerror), file=sys.stderr)
+ sys.exit(1)
def main():
@@ -138,53 +57,11 @@ def main():
Entry point for GNS3 server
"""
- level = logging.INFO
- args = parse_arguments(sys.argv[1:], Config.instance().get_section_config("Server"))
- if args.debug:
- level = logging.DEBUG
-
- user_log = init_logger(level, logfile=args.log, quiet=args.quiet)
- user_log.info("GNS3 server version {}".format(__version__))
- current_year = datetime.date.today().year
- user_log.info("Copyright (c) 2007-{} GNS3 Technologies Inc.".format(current_year))
-
- for config_file in Config.instance().get_config_files():
- user_log.info("Config file {} loaded".format(config_file))
-
- set_config(args)
- server_config = Config.instance().get_section_config("Server")
- if server_config.getboolean("local"):
- log.warning("Local mode is enabled. Beware, clients will have full control on your filesystem")
-
- # we only support Python 3 version >= 3.3
- if sys.version_info < (3, 3):
- raise RuntimeError("Python 3.3 or higher is required")
-
- user_log.info("Running with Python {major}.{minor}.{micro} and has PID {pid}".format(
- major=sys.version_info[0], minor=sys.version_info[1],
- micro=sys.version_info[2], pid=os.getpid()))
-
- # check for the correct locale (UNIX/Linux only)
- locale_check()
-
- try:
- os.getcwd()
- except FileNotFoundError:
- log.critical("The current working directory doesn't exist")
- return
-
- Project.clean_project_directory()
-
- CrashReport.instance()
- host = server_config["host"]
- port = int(server_config["port"])
- server = Server.instance(host, port)
- try:
- server.run()
- except Exception as e:
- log.critical("Critical error while running the server: {}".format(e), exc_info=1)
- CrashReport.instance().capture_exception()
- return
+ if not sys.platform.startswith("win"):
+ if "--daemon" in sys.argv:
+ daemonize()
+ from gns3server.run import run
+ run()
if __name__ == '__main__':
main()
diff --git a/gns3server/run.py b/gns3server/run.py
new file mode 100644
index 00000000..54953e29
--- /dev/null
+++ b/gns3server/run.py
@@ -0,0 +1,238 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2015 GNS3 Technologies Inc.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see .
+
+
+"""
+Start the program. Use main.py to load it.
+"""
+
+import os
+import datetime
+import sys
+import locale
+import argparse
+import asyncio
+
+from gns3server.server import Server
+from gns3server.web.logger import init_logger
+from gns3server.version import __version__
+from gns3server.config import Config
+from gns3server.modules.project import Project
+from gns3server.crash_report import CrashReport
+
+import logging
+log = logging.getLogger(__name__)
+
+
+def locale_check():
+ """
+ Checks if this application runs with a correct locale (i.e. supports UTF-8 encoding) and attempt to fix
+ if this is not the case.
+
+ This is to prevent UnicodeEncodeError with unicode paths when using standard library I/O operation
+ methods (e.g. os.stat() or os.path.*) which rely on the system or user locale.
+
+ More information can be found there: http://seasonofcode.com/posts/unicode-i-o-and-locales-in-python.html
+ or there: http://robjwells.com/post/61198832297/get-your-us-ascii-out-of-my-face
+ """
+
+ # no need to check on Windows or when this application is frozen
+ if sys.platform.startswith("win") or hasattr(sys, "frozen"):
+ return
+
+ language = encoding = None
+ try:
+ language, encoding = locale.getlocale()
+ except ValueError as e:
+ log.error("Could not determine the current locale: {}".format(e))
+ if not language and not encoding:
+ try:
+ log.warn("Could not find a default locale, switching to C.UTF-8...")
+ locale.setlocale(locale.LC_ALL, ("C", "UTF-8"))
+ except locale.Error as e:
+ log.error("Could not switch to the C.UTF-8 locale: {}".format(e))
+ raise SystemExit
+ elif encoding != "UTF-8":
+ log.warn("Your locale {}.{} encoding is not UTF-8, switching to the UTF-8 version...".format(language, encoding))
+ try:
+ locale.setlocale(locale.LC_ALL, (language, "UTF-8"))
+ except locale.Error as e:
+ log.error("Could not set an UTF-8 encoding for the {} locale: {}".format(language, e))
+ raise SystemExit
+ else:
+ log.info("Current locale is {}.{}".format(language, encoding))
+
+
+def parse_arguments(argv, config):
+ """
+ Parse command line arguments and override local configuration
+
+ :params args: Array of command line arguments
+ :params config: ConfigParser with default variable from configuration
+ """
+
+ defaults = {
+ "host": config.get("host", "0.0.0.0"),
+ "port": config.get("port", 8000),
+ "ssl": config.getboolean("ssl", False),
+ "certfile": config.get("certfile", ""),
+ "certkey": config.get("certkey", ""),
+ "record": config.get("record", ""),
+ "local": config.getboolean("local", False),
+ "allow": config.getboolean("allow_remote_console", False),
+ "quiet": config.getboolean("quiet", False),
+ "debug": config.getboolean("debug", False),
+ "live": config.getboolean("live", False),
+ "logfile": config.getboolean("logfile", ""),
+ }
+
+ parser = argparse.ArgumentParser(description="GNS3 server version {}".format(__version__))
+ parser.set_defaults(**defaults)
+ parser.add_argument("-v", "--version", help="show the version", action="version", version=__version__)
+ parser.add_argument("--host", help="run on the given host/IP address")
+ parser.add_argument("--port", help="run on the given port", type=int)
+ parser.add_argument("--ssl", action="store_true", help="run in SSL mode")
+ parser.add_argument("--certfile", help="SSL cert file")
+ parser.add_argument("--certkey", help="SSL key file")
+ parser.add_argument("--record", help="save curl requests into a file")
+ parser.add_argument("-L", "--local", action="store_true", help="local mode (allows some insecure operations)")
+ parser.add_argument("-A", "--allow", action="store_true", help="allow remote connections to local console ports")
+ parser.add_argument("-q", "--quiet", action="store_true", help="do not show logs on stdout")
+ parser.add_argument("-d", "--debug", action="store_true", help="show debug logs")
+ parser.add_argument("--live", action="store_true", help="enable code live reload")
+ parser.add_argument("--shell", action="store_true", help="start a shell inside the server (debugging purpose only you need to install ptpython before)")
+ parser.add_argument("--log", help="send output to logfile instead of console")
+ parser.add_argument("--daemon", action="store_true", help="start as a daemon")
+ parser.add_argument("--pid", help="store process pid")
+
+ return parser.parse_args(argv)
+
+
+def set_config(args):
+
+ config = Config.instance()
+ server_config = config.get_section_config("Server")
+ server_config["local"] = str(args.local)
+ server_config["allow_remote_console"] = str(args.allow)
+ server_config["host"] = args.host
+ server_config["port"] = str(args.port)
+ server_config["ssl"] = str(args.ssl)
+ server_config["certfile"] = args.certfile
+ server_config["certkey"] = args.certkey
+ server_config["record"] = args.record
+ server_config["debug"] = str(args.debug)
+ server_config["live"] = str(args.live)
+ server_config["shell"] = str(args.shell)
+ config.set_section_config("Server", server_config)
+
+
+def pid_lock(path):
+ """
+ Write the file in a file on the system.
+ Check if the process is not already running.
+ """
+
+ if os.path.exists(path):
+ pid = None
+ try:
+ with open(path) as f:
+ pid = int(f.read())
+ try:
+ os.kill(pid, 0) # If the proces is not running kill return an error
+ except OSError:
+ pid = None
+ except OSError as e:
+ log.critical("Can't open pid file %s: %s", args.pid, str(e))
+ sys.exit(1)
+
+ if pid:
+ log.critical("GNS3 is already running pid: %d", pid)
+ sys.exit(1)
+
+ try:
+ with open(path, 'w+') as f:
+ f.write(str(os.getpid()))
+ except OSError as e:
+ log.critical("Can't write pid file %s: %s", args.pid, str(e))
+ sys.exit(1)
+
+
+def run():
+ args = parse_arguments(sys.argv[1:], Config.instance().get_section_config("Server"))
+
+ if args.daemon and sys.platform.startswith("win"):
+ log.critical("Daemon is not supported on Windows")
+ sys.exit(1)
+
+ if args.pid:
+ pid_lock(args.pid)
+
+ level = logging.INFO
+ if args.debug:
+ level = logging.DEBUG
+
+ user_log = init_logger(level, logfile=args.log, quiet=args.quiet)
+ user_log.info("GNS3 server version {}".format(__version__))
+ current_year = datetime.date.today().year
+ user_log.info("Copyright (c) 2007-{} GNS3 Technologies Inc.".format(current_year))
+
+ for config_file in Config.instance().get_config_files():
+ user_log.info("Config file {} loaded".format(config_file))
+
+ set_config(args)
+ server_config = Config.instance().get_section_config("Server")
+ if server_config.getboolean("local"):
+ log.warning("Local mode is enabled. Beware, clients will have full control on your filesystem")
+
+ # we only support Python 3 version >= 3.3
+ if sys.version_info < (3, 3):
+ raise RuntimeError("Python 3.3 or higher is required")
+
+ user_log.info("Running with Python {major}.{minor}.{micro} and has PID {pid}".format(
+ major=sys.version_info[0], minor=sys.version_info[1],
+ micro=sys.version_info[2], pid=os.getpid()))
+
+ # check for the correct locale (UNIX/Linux only)
+ locale_check()
+
+ try:
+ os.getcwd()
+ except FileNotFoundError:
+ log.critical("The current working directory doesn't exist")
+ return
+
+ Project.clean_project_directory()
+
+ CrashReport.instance()
+ host = server_config["host"]
+ port = int(server_config["port"])
+
+ server = Server.instance(host, port)
+ try:
+ server.run()
+ except Exception as e:
+ log.critical("Critical error while running the server: {}".format(e), exc_info=1)
+ CrashReport.instance().capture_exception()
+ return
+
+ if args.pid:
+ log.info("Remove PID file %s", args.pid)
+ try:
+ os.remove(args.pid)
+ except OSError as e:
+ log.critical("Can't remove pid file %s: %s", args.pid, str(e))
diff --git a/init/gns3.conf.upstart b/init/gns3.conf.upstart
index aadf4c9b..f81ffcba 100644
--- a/init/gns3.conf.upstart
+++ b/init/gns3.conf.upstart
@@ -5,8 +5,7 @@ start on filesystem or runlevel [2345]
stop on shutdown
script
- echo $$ > /var/run/gns3.pid
- exec start-stop-daemon --start -c gns3 --exec /usr/local/bin/gns3server --log /var/log/gns3.log
+ exec start-stop-daemon --start -c gns3 --exec /usr/local/bin/gns3server --log /var/log/gns3.log --pid /var/run/gns3.pid --daemon
end script
pre-start script
@@ -14,6 +13,5 @@ pre-start script
end script
pre-stop script
- rm /var/run/gns3.pid
echo "[`date`] GNS3 Stopping" >> /var/log/gns3.log
end script