手順5.1 リカバリーイメージを使った Armadillo の復旧

1. リカバリーイメージで起動していることを確認する

   はじめに、node-eye コントロールパネルにログインします。

   リカバリーイメージで起動した Armadillo は、接続状態が [切断中] で表示されるため、 [切断中] の Armadillo に対し ping を実行します。

   "状態" が [成功] となった場合は復旧作業ができます。Armadillo はリカバリーイメージで起動しているので、次の手順に進んでください。

   "状態" が [失敗] となった場合は復旧作業ができません。何らかの原因で Armadillo と SACM が接続できていないため、Armadillo を直接確認する必要があります。

2. リカバリーイメージからプライマリイメージを書き換える

   ping が成功した Armadillo に対しファームウェアアップデートを行います。入力するカーネルとユーザーランドのダウンロードURLは、起動できるものを入力してください。 ファームウェアアップデートには時間がかかる場合があるため、[アップデート完了時に再起動する] にチェックを入れてから、実行することをおすすめします。

3. 書き込みを行ったイメージの確認

   ファームウェアアップデートが成功し、再起動すると、書き込んだイメージが起動します。 また、SACM と通信ができると接続状態が [接続中] になります。 これでファームウェアアップデートは完了です。

   再起動後、接続状態が [切断中] → [接続中] に切り替わるまでに時間がかかる場合があります。 10分以上切り替わらない場合は、リカバリーイメージで起動していることが考えられます。この場合は、再び復旧作業を行ってください。

手順5.2 リカバリーイメージの起動テスト

1. 起動しないプライマリイメージファイルを作る

   正常に起動することができないイメージを書き込んだ状況を再現するため、サイズが1バイトのファイルをgzip圧縮して不正なプライマリイメージファイルとして用意します。次の手順をATDE等のLinuxマシンで行ってください。

   [PC~]$ echo | gzip > dummy.tar.gz
   [PC~]$ md5sum dummy.tar.gz > dummy.tar.gz.md5
   [PC~]$ ls dummy*
   dummy.tar.gz    dummy.tar.gz.md5

2. 起動しないプライマリイメージを Armadillo から接続可能なWebサーバーに配置する

   作成した2つのファイルをArmadilloがアクセスすることのできるWebサーバーに配置してください。

3. node-eyeコントロールパネルから起動しないプライマリイメージを使ってファームウェアアップデートを実行する

   node-eye コントロールパネル で対象となる Armadillo を選択して、 不正なプライマリイメージファイル "dummy.tar.gz" へのURLを [ユーザーランド] に入力し、 [アップデート完了後に再起動する] にチェックを入れた上で、ファームウェアアップデートを実行してください。

   [カーネル] のテキストボックスには何も入力する必要はありません。

   図5.1 ファームウェアアップデート (node-eye コントロールパネル)

   
   

4. リカバリーイメージによってArmadilloが起動した事を確認する

   起動しないプライマリイメージファイルによるファームウェアアップデートに成功してArmadilloは再起動を実行します。 しかし、起動しないプライマリイメージによって起動が失敗するため、自動的にリカバリーイメージで再起動します。

   リカバリーイメージで再起動した Armadillo は node-eyeコントロールパネル または SACMコントロールパネルからは [切断中] として認識されますが、Ping、Traceroute、再起動、ファームウェアアップデートは実行することができます。

   起動しないプライマリイメージのアップデートによる再起動を実行してから15分以上経過した後に、 対象の Armadillo が node-eyeコントロールパネルから [切断中] として表示される事と、 Ping が実行できる事を確認してください。

   確認が終ったら正常なプライマリイメージを使ってファームウェアアップデートを実行してください。

手順5.3 node-eye環境をインストールしたユーザーランドの作成方法

1. at-debian-builderの準備

   カスタマイズしたユーザーランドの作成には、専用のツールが必要です。アットマークテクノのダウンロードサイトからお使いの環境に合わせた機種,バージョンを選択し、「Debian GNU/Linux ルートファイルシステム 構築ツール」であるat-debian-builderをATDE上にダウンロードしてください。

   ダウンロード後は以下のように解凍し、該当するディレクトリ内に入ります。

   [PC ~]$ ls
   at-debian-builder-[version].tar.gz
   [PC ~]$ tar zxf at-debian-builder-[version].tar.gz
   [PC ~]$ cd at-debian-builder-[version]
   [PC ~]/at-debian-builder-[version]$ ls
   LICENSE         aiota6_resources  aiotg3l_resources  build.sh
   a600_resources  aiotg3_resources  ax1_resources      common_resources

2. パッケージインストールリストにnode-eye追加

   at-debian-builderのビルド時にインストールされる、パッケージのリストへnode-eyeを追加します。以下のようにpackagesファイルを開き、最下部に[node-eye]を追記してください。

   [PC ~]/at-debian-builder-[version]$ vi ax1_resources/resources/packages
   # List of packaes will install in the debootstrap chroot environment.
   # A line start with # is comment. Separate packages name with new-line or space.
   
   #Init
   systemd
   systemd-sysv
   
   #Utils
   sudo
   locales
   sed
   less
   expect
   minicom
   cu
   vim-tiny
   dosfstools
   util-linux
   rsyslog
   bash-completion
   man
   dialog
   cpufrequtils
   atmark-x1-base
   xterm
   brcm-patchram-plus
   rng-tools
   
   #Device
   python
   python-pip
   usbutils
   i2c-tools
   evtest
   bluez
   
   #Network
   iptables
   network-manager
   modemmanager
   net-tools
   avahi-daemon
   avahi-autoipd
   ntpdate
   lighttpd
   curl
   wget
   traceroute
   iputils-ping
   iputils-arping
   dnsutils
   mosquitto-clients
   openssh-client
   
   #Dev
   bundler
   lua5.2
   node-eye
   

3. line.confの作成

   line.confをat-debian-builder下に作成します。

   line.confの説明,設定例は「line.conf」に記載しています。そちらを参考に、お客様のネットワーク環境に合わせたline.confを作成してください。

   [PC ~]/at-debian-builder-[version]$ vi line.conf

4. line.confの配置

   作成したline.confをユーザーランドに配置します。

   [PC ~]/at-debian-builder-[version]$ cp line.conf ax1_resources/resources/

   その後ax1_resources/resources/fixupにcpコマンドを追記します。これを行うことで、node-eyeインストール時に任意のline.confへ上書きできます。

   [PC ~]/at-debian-builder-[version]$ vi ax1_resources/resources/fixup
   #!/bin/sh
   
   PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
   
   PKGS=$(cat /resources/packages | grep -v ^# | xargs)
   
   cp /resources/sources.list /etc/apt/sources.list
   cp /resources/atmark-techno-pin-1001 /etc/apt/preferences.d/
   
   apt-get -y update
   apt-get -y install $PKGS
   
   #Setup locales
   locale-gen
   sed -i 's/# ja_JP.UTF-8 UTF-8/ja_JP.UTF-8 UTF-8/' /etc/locale.gen
   locale-gen
   
   #Setup timezone
   ln -sf /usr/share/zoneinfo/Asia/Tokyo /etc/localtime
   dpkg-reconfigure -f noninteractive tzdata
   
   #user/password/hostname
   useradd atmark
   echo "atmark:atmark" | chpasswd
   usermod -s /bin/bash -Gcdrom,floppy,audio,dip,video,plugdev atmark
   mkhomedir_helper atmark
   
   echo "root:root" | chpasswd
   usermod -Guucp,dialout root
   echo "armadillo" > /etc/hostname
   
   #fix udev rules
   cp /resources/61-x1-license.rules /etc/udev/rules.d/
   
   #fix fstab
   mkdir /opt/license
   if [ $(grep -c proc /etc/fstab) -eq 0 ]; then
       echo "proc                    /proc           proc     defaults                0 0" >> /etc/fstab
       echo "/dev/license            /opt/license    squashfs defaults,nofail         0 0" >> /etc/fstab
   fi
   
   #fix NetworkManager.conf
   cp /resources/NetworkManager.conf /etc/NetworkManager/NetworkManager.conf
   
   #fix rc.local
   cp /resources/rc.local /etc/rc.local
   cp /resources/hosts /etc/hosts
   
   #disable the assignment of fixed device names
   ln -s /dev/null /etc/systemd/network/99-default.link
   cp /resources/line.conf /etc/armsd/line.conf
   

5. at-debian-builderのビルド

   設定が完了したら、at-debian-builderをビルドしてnode-eyeインストール済のユーザーランドを生成します。

   [PC ~]/at-debian-builder-[version]$ sudo ./build.sh

6. ユーザーランドの生成確認

   ビルド完了後、/at-debian-builder-[version]下にユーザーランドが生成されます。

   [PC ~]/at-debian-builder-[version]$ ls
   LICENSE           aiotg3l_resources  debian-jessie-armhf_ax1_YYYYMMDD.tar.gz
   a600_resources    ax1_resources      installed_pkgs_20240918.list
   aiota6_resources  build.sh
   aiotg3_resources  common_resources