Soracom

soratun 設定ファイル (/path/to/arc.json) を作成したら、WireGuard インターフェースを作成します。WireGuard インターフェースが作成されると、SORACOM プラットフォームにアクセス できます。

soratun up コマンドを実行して WireGuard インターフェースを作成する

SORACOM プラットフォームにアクセスするときに以下のコマンドを実行して、WireGuard インターフェースを作成する方法です。soratun 設定ファイルのパス (/path/to/arc.json) については、soratun 設定ファイルのパスについて を参照してください。

$ sudo soratun up --config /path/to/arc.json

$ soratun bootstrap sim --dump-config | sudo soratun up --read-stdin

WireGuard インターフェースを削除する

soratun のプロセスへ kill コマンドで SIGTERM を送信してください。

WireGuard インターフェースを更新する

バーチャル SIM/Subscriber のセッションを再確立したときや、バーチャル SIM/Subscriber の認証情報を更新したときなど、soratun 設定ファイルを更新したときは、一度、WireGuard インターフェースを削除してから、再度作成してください。

1. WireGuard インターフェースを削除します。
2. WireGuard インターフェースを作成します。

systemd を利用してデバイス起動時に WireGuard インターフェースを作成する

soratun は単体のプログラムとして実行できますが、systemd と併用してデーモンとして動作させることができます。

1. soratun をインストール したときにダウンロードしたファイル (例: soratun_x.x.x_linux_armv7.tar.gz) に含まれる conf/soratun.service.sample を参考に、必要な設定を行います。

   特に、ExecStart に記載する soratun のパス (/usr/local/bin/soratun) は、soratun をコピーしたパスを入力してください。また、soratun 設定ファイルのパス (/etc/arc.json) については、soratun 設定ファイルのパスについて を参照してください。

       :
   
   [Service]
   Type=simple
   # ExecStartPre=/usr/local/bin/soratun bootstrap cellular --config /etc/arc.json
   ExecStart=/usr/local/bin/soratun up --config /etc/arc.json
   Restart=always
   StandardOutput=journal
   StandardError=journal
   SyslogIdentifier=soratun
   SyslogFacility=local7
   WatchdogSec=120
   
       :
   

2. 設定したファイルを systemd の設定ディレクトリへコピーします。

   $ sudo cp conf/soratun.service.sample /etc/systemd/system/soratun.service
   

3. soratun デーモンを有効化して、起動します。

   $ sudo systemctl enable soratun
   $ sudo systemctl start soratun
   

systemd watchdog との連携

soratun は systemd の watchdog をサポートします。以下のタイマーに基づいておよそ 110 秒ごとに systemd へ稼働状況を報告します。

Protocol & Cryptography - WireGuard:

After receiving a packet, if the receiver was the original initiator of the handshake and if the current session key is REKEY_AFTER_TIME - KEEPALIVE_TIMEOUT - REKEY_TIMEOUT ms old, we initiate a new handshake.

soratun が何らかの原因で停止したり、SORACOM Arc のセッションが切断された場合、一定時間経過後 (上記 systemd の設定ファイルの場合は、最大 120 + 110 秒後) に systemd が soratun を再起動します。

WireGuard インターフェースを削除する

systemd を利用してデバイス起動時に WireGuard インターフェースを作成した場合は、以下のコマンドを実行して soratun デーモンを停止します。

$ sudo systemctl stop soratun

soratun デーモンを無効化して、再起動したときに WireGuard インターフェースが作成されないようにするには、以下のコマンドを実行します。

$ sudo systemctl disable soratun

WireGuard インターフェースを更新する

バーチャル SIM/Subscriber のセッションを再確立したときや、バーチャル SIM/Subscriber の認証情報を更新したときなど、soratun 設定ファイルを更新したときは、一度、WireGuard インターフェースを再起動してください。具体的には、以下のコマンドを実行します。

$ sudo systemctl restart soratun