Graceful shutdown

Author: gotthardp

README.md

@@ -56,21 +56,26 @@ The [Installation Instructions](doc/Installation.md) describe how to build,
 install and configure the server. You can use a Debian package, download the binary
 release and run it manually or build the server from source codes.
 
+After the installation you have to:
+ * Add LoRaWAN gateways you want to use.
+ * Configure each device you want to use, either as a personalized device (ABP) or
+   as an over-the-air activated (OTAA) device.
+
 Run the lorawan-server release by:
 ```bash
 cd lorawan-server
 bin/lorawan-server
 ```
 
+Terminate the lorawan-server by:
+```bash
+bin/lorawanctl stop
+```
+
 You can administrate and manage the server via a set of web-pages or via a REST API
 as described in the [Administration Guide](doc/Administration.md) and in the
 [Adaptive Data Rate (ADR) Guide](doc/ADR.md).
 
-After the installation you have to:
- * Add LoRaWAN gateways you want to use.
- * Configure each device you want to use, either as a personalized device (ABP) or
-   as an over-the-air activated (OTAA) device.
-
 ### Integration
 
 You can integrate lorawan-server with external applications using the WebSocket

rebar.config

@@ -43,6 +43,7 @@
     {generate_start_script, false},
     {overlay, [
         {template, "scripts/lorawan-server", "bin/lorawan-server"},
+        {copy, "scripts/lorawanctl", "bin/lorawanctl"},
         {copy, "scripts/lorawan-daemon", "bin/lorawan-daemon"},
         {template, "scripts/lorawan-server.bat", "bin/lorawan-server.bat"},
         {template, "scripts/lorawan-service.bat", "bin/lorawan-service.bat"},

scripts/lorawanctl

@@ -0,0 +1,12 @@
+#!/bin/sh
+SCRIPT=$(readlink $0 || true)
+if [ -z $SCRIPT ]; then
+    SCRIPT=$0
+fi
+SCRIPT_DIR="$(cd `dirname "$SCRIPT"` && pwd -P)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd -P)"
+if [ -z $LORAWAN_HOME ]; then
+    LORAWAN_HOME=$ROOT_DIR
+fi
+
+cd $LORAWAN_HOME && erl -noinput +Bd -sname loractl -pa $ROOT_DIR/lib/*/ebin -s lorawan_control $@ -s init stop

src/lorawan_app.erl

@@ -52,6 +52,7 @@ start(_Type, _Args) ->
     lorawan_sup:start_link().
 
 stop(_State) ->
+    ok = cowboy:stop_listener(http),
     ok.
 
 % end of file

src/lorawan_control.erl

@@ -0,0 +1,21 @@
+%
+% Copyright (c) 2016-2017 Petr Gotthard <[email protected]>
+% All rights reserved.
+% Distributed under the terms of the MIT License. See the LICENSE file.
+%
+-module(lorawan_control).
+
+-export([stop/0]).
+
+stop() ->
+    invoke(init, stop, []).
+
+invoke(Module, Fun, Params) ->
+    Node = list_to_atom(string:join(["lorawan", net_adm:localhost()], "@")),
+    case rpc:call(Node, Module, Fun, Params) of
+        ok -> ok;
+        {badrpc, Reason} ->
+            io:format("~w wommand failed: ~w~n", [Node, Reason])
+    end.
+
+% end of file

src/lorawan_iface_forwarder.erl

@@ -102,8 +102,9 @@ handle_info({udp, _Socket, _Host, _Port, _Msg}, State) ->
 handle_info({'EXIT', _FromPid, _Reason}, State) ->
     {noreply, State}.
 
-terminate(_Reason, _State) ->
-  ok.
+terminate(Reason, _State) ->
+    lager:debug("packet_forwarder interface terminated: ~w", [Reason]),
+    ok.
 
 code_change(_OldVsn, State, _Extra) ->
   {ok, State}.