リモートコマンドを実行してデバイスログを確認する

Armadillo Twinに登録されているデバイス上でリモートコマンドを実行します。 Armadillo Twinでリモートコマンドを入力すると、リモートコマンドはデバイスにリクエストとして送信されます。デバイスがリモートコマンドを受理すると、デバイス上でリモートコマンドが実行され、その実行結果はArmadillo Twinに返信されます。リモートコマンドの実行状態はArmadillo Twinによって監視され、ユーザーはArmadillo Twin上で実行状態と結果を確認できます。

セキュリティ上の懸念からリモートコマンド実行はデフォルト無効です。リモートコマンドを有効にするためには、デバイス側とサービス側の双方で相応の権限と作業が必要になります。

関連情報:

• リモートコマンドを実行する
• リモートコマンド実行の操作方法
• リモートコマンド実行のセキュリティ

前提条件

• 対象デバイスがArmadillo Twinに未登録の場合は「Armadillo Twin にデバイスを登録する」を参照して登録してください。
• 準備作業を行うためには、操作するユーザーに「アカウント管理」権限が必要です。また、実際のリモートコマンドを実行するためには、「リモートコマンド実行状況閲覧」権限と「リモートコマンド実行と管理」権限が必要です。「ユーザーの権限を変更する」を参考に権限を設定してください。ユーザー権限を変更するメニューが表示されない場合は、管理ユーザー に確認して権限についてご相談ください。

準備をする (Armadillo Twin 側)

注意

リモートコマンドを有効にするためには「アカウント管理」の権限が必要です。 「ユーザーの権限を変更する」を参考に権限を設定してください。ユーザー権限を変更するメニューが表示されない場合は、管理ユーザー に確認して権限についてご相談ください

1. 右上のユーザー名をクリックします。
2. 「アカウント管理」を選択します。
3. 「有効化する」をクリックします。
4. 利用規約が表示されるので内容を確認の上、有効化してください。

準備をする (デバイス側)

ノート

この手順ではArmadilloの開発環境であるATDE (Atmark Techno Development Environment) を使用します。また、ATDEに含まれるmkswuというコマンドも使用します。 ATDEのセットアップ方法については製品マニュアルの「開発環境のセットアップ」を参照してください。

リモートコマンド実行を有効化するSWUイメージを生成し、それを対象のデバイスに対してインストールすることでデバイス側のリモートコマンド実行を有効化します。 ATDE上で以下のコマンドを実行し、mkswuのバージョンを最新にしてください。

[ATDE]$ sudo apt update && sudo apt install --upgrade mkswu

以下のようにmkswuコマンドを実行し、 enable_exec_command.swu を生成してください。

[ATDE]$ mkswu /usr/share/mkswu/examples/armadillo-twin/enable_exec_command.desc -o enable_exec_command.swu

ノート

上記コマンド実行時に以下のエラーが出力されたら、mkswu --initを先に実行してください。

ERROR: 設定ファイルが見つかりませんでした。 mkswu —init で作成してください。

設定事項の入力後、生成された~/mkswu/initial_setup.swuをArmadilloにインストールしてください。 下記の手順内のenable_exec_command.swuをinitial_setup.swuに読み替えることでインストール可能です。

生成したenable_exec_command.swuを対象のデバイスに対してインストールします。

1. Armadillo Twin上で「デバイス一覧」に移動します。

2. 対象のデバイスのシリアル番号を選択します。

3. 下にスクロールすると「ソフトウェアアップデート実行」というブロックが表示されます。

4. enable_exec_command.swuをアップロードします。

   ノート

   今月の通信量について

   アップデートにかかるファイルデータ転送量は、アカウントで利用中のデバイスの総数によって制限され、1か月ごとにリセットされます。また、通信量の更新は24時間ごとに行われます。 ここで表示されている値は今月の残りのデータ転送可能量になります。詳しくは以下を参照してください。

   ソフトウェアアップデートに必要なデータ通信量

5. アップロードが完了するとファイル名、イメージサイズ、バージョンが表示されます。確認してください。

6. アップデート完了後のデバイスの挙動を設定します。ここでは「ダウンロード後、再起動する」を選択してください。

7. アップデートを開始します。

8. リクエスト送信が成功するとメッセージが表示されます。

9. 更新するとステータスと実行結果を確認できます。

10. ステータスが成功になると、インストール完了です。実行結果にアップデート後のバージョンが表示されますので、「extra_os.twin_exec_command」が「enable」になっていることを確認してください。

単体デバイス上でリモートコマンドを実行する

1. 「デバイス一覧」に移動します。
2. リモートコマンドを実行するデバイスを選択してシリアル番号をクリックします。
3. デバイスの画面を下にスクロールすると「リモートコマンド実行」というブロックが表示されます。
4. リモートコマンドを入力します。
5. タイムアウト時間は通常デフォルト設定で十分です。ただし、コマンドによっては実行時にタイムアウトとなる場合があります。その際はタイムアウト時間を調整します。
6. 実行タイミングを設定します。
7. リモートコマンドを実行します。
8. リクエスト送信が成功するとメッセージが表示されます。
9. 更新するとステータスと実行結果を確認できます。

   ノート

   実行結果は最大1,024文字までしか表示されません。

   注意

   armadillo-twin-agentバージョン1.0-r0ではリモートコマンドの実行を中止できません。 バージョン1.1-r0以降のarmadillo-twin-agentをご使用ください。 armadillo-twin-agentはpersist_file -a upgradeコマンドを実行するか、Armadillo Base OS自体のバージョンを上げることでアップデートできます。

次のステップ

複数のデバイスに対して操作する:

• 選択した複数デバイス上でリモートコマンドを実行する

デバイスグループを作って管理する:

• デバイスグループを作成する
• デバイスグループ上でリモートコマンドを実行する