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

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

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

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

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

   "状態" が [失敗] となった場合は復旧作業ができません。何らかの原因で 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. x1-debian-builderの準備

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

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

   [PC ~]$ ls
   x1-debian-builder-[version].tar.gz
   [PC ~]$ tar zxf x1-debian-builder-[version].tar.gz
   [PC ~]$ cd x1-debian-builder-[version]
   [PC ~]/x1-debian-builder-[version]$ ls
   aiotg3_resources   ax1_resources   aiotg3l_resources   build.sh

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

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

   [PC ~]/x1-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.
   
   #Utils
   sudo
   locales
   sed
   less
   expect
   minicom
   cu
   vim-tiny
   dosfstools
   util-linux
   rsyslog
   bash-completion
   man
   dialog
   cpufrequtils
   pds6j-utils
   atmark-x1-base
   
   #Device
   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
   ruby2.1
   rubygems
   bundler
   lua5.2
   node-eye
   

3. line.confの作成

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

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

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

4. line.confの配置

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

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

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

   [PC ~]/x1-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-key adv --keyserver pgp.nic.ad.jp --recv-keys 3874DA771B351757
   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
   echo "Asia/Tokyo" > /etc/timezone
   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 fstab
   mkdir /opt/license
   if [ $(grep -c proc /etc/fstab) -eq 0 ]; then
       echo "proc                    /proc           proc     defaults                0 0" >> /etc/fstab
       echo "/dev/mtdblock1          /opt/license    squashfs defaults,nofail         0 0" >> /etc/fstab
   fi
   
   #fix rc.local
   cp /resources/rc.local /etc/rc.local
   cp /resources/hosts /etc/hosts
   cp /resources/line.conf /etc/armsd/line.conf
   

5. x1-debian-builderのビルド

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

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

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

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

   [PC ~]/x1-debian-builder-[version]$ ls
   aiotg3_resources   ax1_resources   aiotg3l_resources   build.sh   debian-jessie-armhf_ax1_YYYYMMDD.tar.gz