summaryrefslogtreecommitdiff
path: root/tools/README.restart
diff options
context:
space:
mode:
authorBen Longbons <b.r.longbons@gmail.com>2013-12-14 10:32:08 -0800
committerBen Longbons <b.r.longbons@gmail.com>2013-12-14 10:32:08 -0800
commite34e49d3064640e01305549413c862ee0a7a79aa (patch)
tree863efe11d5aa9a079188df2c9f0c112c93e13074 /tools/README.restart
parent45185408935a56197c308da7ae5d27d72fe06917 (diff)
downloadserverdata-e34e49d3064640e01305549413c862ee0a7a79aa.tar.gz
serverdata-e34e49d3064640e01305549413c862ee0a7a79aa.tar.bz2
serverdata-e34e49d3064640e01305549413c862ee0a7a79aa.tar.xz
serverdata-e34e49d3064640e01305549413c862ee0a7a79aa.zip
Change tools/ to a submodule
Diffstat (limited to 'tools/README.restart')
-rw-r--r--tools/README.restart55
1 files changed, 0 insertions, 55 deletions
diff --git a/tools/README.restart b/tools/README.restart
deleted file mode 100644
index 0bd147e2..00000000
--- a/tools/README.restart
+++ /dev/null
@@ -1,55 +0,0 @@
-There are 3 front-facing scripts for this new pidfile-based restart system.
-
-All of them belong in ~/bin/, although one of them is not actually a script.
-(it is source'd, which follows $PATH)
-
-restart-all Call this on first boot
- if REBUILD is not empty, it will first pull, build, and install
- from the tmw-eathena repository.
- In bash you can do this like: REBUILD=sure restart-all
-restart-world Call this if you only want to restart one server.
- The first argument is the directory, e.g. ~/tmwa-server-data/
- After that, you may pass --manual or --auto to not-pull or pull
- script updates. If neither is specified, the value of PULL is
- used.
- This does NOT use AUTO_WORLDS or MANUAL_WORLDS.
-restart-config Contains configuration settings.
- SERVER_SOURCE is the location of the tmw-eathena clone.
- LOGIN_WORLD is the location of the clone that contains the
- account data. It does not necessarily have to correspond to
- a world that actually starts, although it does in the
- current configuration
- AUTO_WORLDS is an array (space separated, surrounded by
- parentheses) of world directories that will have updates
- pulled when calling restart-all.
- MANUAL_WORLDS is an array of world directories that will not
- have updates pulled when calling restart-all
- VERBOSE controls whether the servers will print their output
- to the tty or have it redirected to /dev/null. Use if if
- you have any problems. It is inspected by the low-level
- command restart-pid.
- REBUILD controls whether the server sources will be rebuilt
- during restart-all.
- PULL controls whether updates should be pulled by
- restart-world. It is ignored if --auto or --manual
- is specified, which is the case during restart-all.
- All of these variables (except probably the arrays) can be
- specified in the environment, but the values in restart-config
- override them. However, since restart-config is a bash script,
- you could conditionally set the variables by using if test ...
-
-There are also two commands you'll probably never have to call yourself:
-restart-login is self-explanatory and is usually called only by restart-all
-restart-pid is the low-level command that maintains the PID file and kills
- the old servers. In order for the server to be killed, three
- things must match: the PID, and name, and the user.
- This will keep errors to a minimum in case PID files continue
- to exist after the processes have died and new processes have
- taken their IDs.
-
- There's a theoretical case in which the replacing process will
- be a new instance of the same process by the same user in a
- different world directory. The odds of this happening are
- theoretically 1 in 32767-ish, but in practice might be a bit
- more common than that. If you find your newly-spawned children
- did not survive, try running restart-all again.