アップデート手順

概要

本手順書では、enebular-agentアップデート(ユーティリティ)を使用したアップデート手順を説明します。

本手順書では、両方のアップデート手順を記載していますが、enebular-agentアップデートはすでにデバイスにインストールされている接続方法に合わせてアップデートを行います。
なお、Pelion Device Managementでインストールしているenebular-agentはアップデートできません。

アップデートは、対象デバイスのLinux OS上でシェルスクリプト(以降、アップデートスクリプト)を実行することにより行われます。

説明

前提条件

アップデートスクリプトでは、現在から2年以内にリリースされたenebular-agentのバージョンからのアップデートをサポートします。

アップデートスクリプトを実行するための前提条件は以下です。

  • 2年以内にリリースされたenebular-agentのインストールが完了していること
  • enebularへの接続方法:AWS IoT / エージェント実行環境
  • サポートしているOS(参照)にアップデートしてからenebular-agentのアップデートを行ってください

以下に対象毎の確認事項を記載します。

Linux

  • enebular-agentがサポートするDebian GNU/Linuxであること
  • enebular-agentを実行するユーザーが作成されていること(以降ではenebularユーザーが作成されているという前提で記載)
  • インストールに使用するユーザーがsudo権限(sudoコマンドを使用)を持っていること
  • インターネット接続環境があること

AWS IoT

  • AWSのアカウントが作成されていること
    • このアカウントにはAWSIoTConfigAccessの権限が与えられていること

enebular

  • enebularのアカウント
  • enebularのプロジェクト

インストール時のオプション

  • インストール時のオプションに--no-startup-registerを指定していないこと
    --no-startup-registerを指定していた場合、アップデートスクリプトを使用したアップデートは行えません。
    アップデートスクリプトを使用しないアップデートについては、 [email protected] までお問い合わせください。
    --no-startup-registerオプションの詳細は、インストール手順 - オプションを参照してください。

アップデートスクリプトの実行

アップデートスクリプトは、対象デバイスのLinuxにログインして、shellより以下のコマンドを入力することで実行できます。

wget -qO- https://enebular.com/agent-update | sudo -E bash -s -- オプション1 オプション2 ・・・

上記のコマンドを実行するフォルダーは、どこでも構いません。
アップデートスクリプトは、enebular.comサーバーよりインターネット経由で取得します。
アップデートに必要な情報(enebularへの接続方法:AWS IoT、インストール先フォルダー等)はアップデートスクリプトが環境変数等を参照して自動取得します。
そのため、任意のフォルダーでアップデートスクリプトを実行できます。
また、アップデートスクリプトはenebular-agentのサービスの起動状況によらず、アップデートを行うことができます。

オプション

アップデートスクリプトに設定できるオプションとオプション引数と省略可/不可は次の表のとおりです。

オプション オプション引数 省略可/不可 説明
--user =enebular-agentをインストールした名 省略不可 enebular-agentを実行するユーザー
-h,--help 無し 省略可 利用情報を出力する

オプション設定時の注意事項

オプション設定時の注意事項を列挙します。

  • オプションは複数指定可能です(オプションとオプションの間は半角ブランク)
  • オプション引数には不要な半角ブランクを入れないでください

事例

アップデートスクリプトの実行例

アップデートスクリプトの実行例を示します。

コマンド実行例(AWS IoTの場合)

wget -qO- https://enebular.com/agent-Update | sudo -E bash -s -- --user=enebular

上記事例のオプションの意味は以下のとおりです。

  • Linuxユーザーはenebular
  • その他のオプションは省略

結果

アップデートスクリプトは、アップデート前のenebular-agentを停止してからアップデート処理を行います。
その後アップデートしたenebular-agentを起動し、アップデートスクリプトは終了します。

enebular-agentの実行状況の確認方法

systemctl status enebular-agent-enebular.service

上記のコマンドを実行することでenebular-agentのサービスの起動状況(起動/停止)を確認できます。

sudo journalctl -ex -u enebular-agent-enebular.service

enebular-agentのサービスが起動している場合は、上記のコマンドを実行することでenebular-agentの実行状況を確認できます。

Node.jsのインストール

必要としているNode.jsのバージョンを利用可能にするため、Node.jsをダウンロードしインストールする場合があります。
Node.jsの詳細については、Node-RED - 備考を参照してください。

results matching ""

    No results matching ""