02. インストール

はじめに

インストールについて

インストールでは下記の処理が実行されます。

  • デバイスの固有情報を収集し、NEQTO Consoleへデバイス登録を行い、発行されたシリアルIDを格納します。
  • アーキテクチャを識別し、最新バージョンのソフトウェアパッケージをダウンロードして、インストールを行います。
  • systemdへNEQTOサービスを登録します。

デバイス登録に関する注意事項
NEQTO Console上にデバイス登録する際、デバイスの固有情報が用いられます。
アーキテクチャ種別・CPU情報、ネットワークアダプタMACアドレス(1つに限られ、優先的にイーサーネットアダプタが選択されます)、OS情報(ディストリビューション名、バージョンは含まれません)が収集され、自動登録されます。この固有情報は不変であることが前提であり、いずれかが変更となった場合、新規デバイス登録(再インストール)が必要となりますので注意願います。

再インストールについて

インストールは何度でも実行可能です。
既にインストール済みの状態で、再度インストールを実行した場合、設定済みのパラメータは引き継がれ、ソフトウェアのみ最新バージョンに更新されます。
一度アンインストールを行った状態でも、NEQTO Console上にデバイス登録が残っていれば、アンインストール前に発行されたシリアルIDで再構成されます。NEQTO Console上にデバイス登録が残っていない場合は、新規デバイス登録となります。


インストール

事前準備

インストールを開始する前に、下記項目を確認してください。

  • NEQTO Consoleのアカウント登録が完了している必要があります。
  • インストール対象デバイスがシステム要件を満たしている必要があります。
  • インストール対象デバイスでネットワーク通信が疎通している必要があります。
  • インストールには下記ツールが必要となります。必要に応じて事前にインストールしてください。
    • curlまたはwget
    • md5sum
  • インストールを開始すると、デバイスのシステム固有の情報がNEQTOコンソールに送信され、自動的にデバイス登録が行われます。

インストール手順

以下の手順に沿って操作してください。

  1. はじめにNEQTO Consoleへログインし、インストールに必要なLinux用APIキーおよびインストールツールのダウンロードURLを確認します。

    インストールツールはNEQTO Engineソフトウェアリリースと同時に更新される場合があります。常に最新バージョンのツールをダウンロードしてご使用ください。

  2. インストールツールをLinuxデバイス内の任意ディレクトリにダウンロードします。

    • curlを使用する場合
      $ curl -O https://<Download URL>/neqto-daemon-install.latest.sh↵
    • wgetを使用する場合
      $ wget https://<Download URL>/neqto-daemon-install.latest.sh↵

  3. ダウンロードしたインストールツールに実行権限を設定します。

    $ chmod 755 neqto-daemon-install.latest.sh↵

  4. インストールを開始します。インストールツールに-kオプションでLinux用APIキーを指定し、スーパーユーザー(root)で実行してください。その他のコマンドオプションについてはこちらを参照してください。

    # neqto-daemon-install.latest.sh -k <Linux API key>↵

  5. 実行直後、注意事項が表示されます。確認の上、同意する場合はagreeを入力してください。以降、デバイス登録が実行され、継続してソフトウェアのインストールが開始されます。

    ============================================================
    NEQTO Daemon Installation [ver X.X] (c) 2022 JIG-SAW INC
    ============================================================
    *** IMPORTANT ***
    Supported Architectures: armv6l armv7l aarch64 x86_64
    Will begin installation of the NEQTO service.
    Starting the installation will send the system-specific information of this device to the NEQTO Console for automatic registration.
    If you agree and want to continue, please enter "agree" >> agree↵

  6. 最終ステータスのInstallation completed successfully!が表示されるまで、お待ちください。

    ============================================================
    NEQTO Daemon Installation [ver X.X] (c) 2022 JIG-SAW INC
    ============================================================
    *** IMPORTANT ***
    Supported Architectures: armv6l armv7l aarch64 x86_64
    Will begin installation of the NEQTO service.
    Starting the installation will send the system-specific information of this device to the NEQTO Console for automatic registration.
    If you agree and want to continue, please enter "agree" >> agree↵
    ============================================================ Registering device...OK
    Device-specific information to register in NEQTO:
    Platform: armv7l;XXXX;X;XXXX;XXXX;XXXX;XXXX
    NIC: ethX-XX:XX:XX:XX:XX:XX
    OS: Raspbian GNU/Linux
    Assigned Serial ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
    ============================================================
    Downloading package...OK
    neqtod installed - (neqtod-XX.XX.XX)
    ============================================================
    Starting NEQTO service...
    Loaded: loaded (/etc/systemd/system/neqto.service; enabled; vendor preset: enabled)
    Active: active (running)
    ============================================================
    Installation completed successfully!

  7. デバイスではインストール完了と同時にNEQTOサービスが開始されます。

    NEQTO Console上にデバイス登録された固有情報および発行されたシリアルIDは、上記インストールメッセージ上に表示されます。

    継続、NEQTO Console上でノードの登録を進めてください。デバイスはNEQTO Console上でノードが紐づけられるまでリトライ動作を繰り返し、ノードが紐づけられるとneqto.jsを開始します。

コマンドオプション

  • -n <note>
    デバイス登録と同時に、NEQTO Console上で管理されるデバイス情報の備考欄に任意文字列を書き込みます。新規デバイス登録時のみ有効となります。

  • -f
    インストールツール起動直後に表示される注意事項確認を同意とみなし、インストール処理を継続します。

トラブルシューティング

インストールが途中で失敗した場合、下記の事項を確認し、再度インストールを実行してください。それでも解決できない場合は、NEQTOサポートまでお問い合わせください。

  • Please execute as rootと表示されます。
     » インストールツールはスーパーユーザー(root)で実行する必要があります。

  • APIKEY is not specifiedと表示されます。
     » インストールツールを起動する際に-kオプションでLinux用APIキーを指定する必要があります。

  • 'systemctl' is required. Please install and try againと表示されます。
     » NEQTOデーモンはsystemdが必要となります。システム要件を確認してください。

  • 'md5sum' is required. Please install and try againと表示されます。
     » インストールツールはmd5sumコマンドを必要とします。別途インストールしてください。

  • Either 'curl' or 'wget' is required. Please install and try againと表示されます。
     » インストールツールはcurlまたはwgetコマンドのどちらかを必要とします。別途インストールしてください。

  • Unsupported architecture - XXXXと表示されます。
     » このデバイスのアーキテクチャはサポートされていません。システム要件を確認してください。

  • No valid NICと表示されます。
     » デバイス固有情報の内、必要となる有効なデバイスのNICが見当たりません。システム要件を確認してください。

  • Registering device...表示直後にcurl errorもくしはwget errorとなります。
     » 指定したLinux用APIキーが正しいか確認してください。
     » ネットワーク通信が可能かつインターネットへアクセス可能であるか確認してください。

  • Downloading package...表示直後にcurl errorもくしはwget errorとなります。
     » ネットワーク通信が可能かつインターネットへアクセス可能であるか確認してください。

  • systemctl daemon-reload error、systemctl enable error、systemctl start error、NEQTO service could not be startedが表示されます。
     » systemdが正常に動作しているか確認してください。


アンインストール

事前準備

アンインストールを開始する前に、下記項目を確認してください。

  • アンインストールを開始すると、デバイスにインストールされているNEQTO関連データが全て消去されます。データを復元することはできません。
  • NEQTO Console上に登録されている本デバイスに関連するデータ、登録情報およびライセンスは削除されません。アンインストール完了後に、別途、NEQTO Console上で削除してください。

アンインストール手順

以下の手順に沿って操作してください。

  1. アンインストールを開始します。インストールツールに-xオプションを指定し、スーパーユーザー(root)で実行してください。Linux用APIキーの指定、ネットワーク通信は不要です。その他のコマンドオプションについてはこちらを参照してください。

    # neqto-daemon-install.latest.sh -x↵

  2. 実行直後、注意事項が表示されます。確認の上、同意する場合はagreeを入力してください。 以降、アンインストールが開始されます。

    ============================================================
    NEQTO Daemon Installation [ver X.X] (c) 2022 JIG-SAW INC
    ============================================================
    *** IMPORTANT ***
    Will begin uninstallation of the NEQTO service.
    It completely removes all data related to the NEQTO already installed on this system. It will not be possible to restore this data.
    In addition, the registration information and license associated with the device registered in the NEQTO Console will not be deleted. To delete this information, please perform the deletion on the NEQTO Console once the uninstallation is successfully complete.
    If you agree and want to continue, please enter "agree" >> agree↵

  3. 最終ステータスのUninstallation completed successfully!が表示されるまで、お待ちください。

    ============================================================
    NEQTO Daemon Installation [ver X.X] (c) 2022 JIG-SAW INC
    ============================================================
    *** IMPORTANT ***
    Will begin uninstallation of the NEQTO service.
    It completely removes all data related to the NEQTO already installed on this system. It will not be possible to restore this data.
    In addition, the registration information and license associated with the device registered in the NEQTO Console will not be deleted. To delete this information, please perform the deletion on the NEQTO Console once the uninstallation is successfully complete.
    If you agree and want to continue, please enter "agree" >> agree↵
    ============================================================
    Uninstallation completed successfully!

コマンドオプション

  • -f
    インストールツール起動直後に表示される注意事項を同意とみなし、アンインストール処理を継続します。


Updated: 2022-10-26
← 前次 →