2.4. ICE Core 運用ガイド

2.4.1. サービスの起動・停止

ICE Coreのサービスを起動・停止するにはOSが提供するサービス操作用のコマンドを使用します。

2.4.1.1. Linuxの場合

  • ice-edge-core の起動

    $ sudo systemctl start ice-edge-core
    
  • ice-edge-core の停止

    $ sudo systemctl stop ice-edge-core
    
  • ice-edge-core の状態確認

    $ sudo systemctl status ice-edge-core
    

2.4.1.2. Windowsの場合

コマンドプロンプトを管理者として実行し次のコマンドを実行します。

  • ice-core の起動

    > sc start ice-core
    
  • ice-core の停止

    > sc stop ice-core
    
  • ice-core の状態確認

    > sc query ice-core
    

Windowsのサービス用管理コンソール(GUI)からも同様の操作が可能です。

2.4.2. ICE Core の監視

2.4.2.1. 起動プロセス

下記コマンドラインのプロセスが起動します。

  • Linuxの場合

    bin/node --optimize_for_size bin/../main.js ice-core
    

    --optimize_for_size の部分は{ICE_HOME}/conf/core.propsの設定により変化します。

  • Windowsの場合

    node.exe --optimize_for_size bin\..\main.js ice-core
    

2.4.3. ICE Core のバックアップ

稼働中のICE Coreを復元するためには、下記ファイルのバックアップとリストア、または、別の復元方法をご検討ください。

ファイルのバックアップを行う際は、次のコマンドを実行し、ICE Coreのプロセスを停止してからファイルを退避します。

$ sudo systemctl stop ice-edge-core

注釈

Node-REDの設定ファイルを確実に退避させるため、プロセスを停止してからバックアップを行います

  • {ICE_HOME}/conf/core_config.json

    edge_idやバックエンドへの接続情報などの設定が含まれるためバックアップ/リストアが必須です。

  • {ICE_HOME}/conf/cloud_config.json

    cloud_config.jsonにカスタムのDestinationを設定している場合にバックアップ/リストアが必要です。

  • {ICE_HOME}/conf/nodered_settings.js

    Node-REDの設定を変更している場合にバックアップ/リストアが必要です。

  • {ICE_HOME}/conf/core_logger.json

    ICE Coreのログ出力設定を変更している場合にバックアップ/リストアが必要です。

  • {ICE_HOME}/conf/core.props

    ICE CoreのNode.jsプロセスの設定を変更している場合にバックアップ/リストアが必要です。 Node.jsの起動時に指定するオプションを含むため、ICE Coreのバージョンアップ時は指定するオプションの互換性をチェックしたうえでリストアします。

  • SSL/TLS通信向けの証明書

    MQTTSやHTTPSでの通信用に利用しているCA証明書やクライアント証明書がある場合はバックアップ/リストアが必要です。

  • {ICE_HOME}/core/etc/node-red/flows.json
    {ICE_HOME}/core/etc/node-red/flows_cred.json
    {ICE_HOME}/core/etc/node-red/.config.json

    Node-REDのフローを利用している場合にバックアップ/リストアが必要です。 flows_cred.jsonと.config.jsonはバックエンドにアクセスする際の認証情報を含みます。バックアップ/リストア時の扱いには注意してください。

  • 3rd party製のnode_modules

    Node-RED用のノードなど、3rd party製のモジュールを利用している場合には適宜復元方法を検討してください。

  • {ICE_HOME}/core/native/user

    Device AdapterやEdge Applicationを利用している場合にバックアップ/リストが必要です。

  • {ICE_HOME}/core/user_modules

    ICE Coreに独自のカスタムモジュールを追加した場合にバックアップ/リストアが必要です。