差分

このページの2つのバージョン間の差分を表示します。

--- mae3xx_tips:iij_sacm:start [2017/01/13 13:42] – [要件ごとのカスタマイズ] admin
+++ mae3xx_tips:iij_sacm:start [2017/01/13 15:55] (現在) – [設定ファイルの編集] admin
@@ 行 1: / 行 1: @@
+====== IIJ SACM の利用 ======
+[[http://www.sacm.jp/|{{:mae3xx_tips:iij_sacm:sacm_logo.png}}]]
+[[http://www.sacm.jp/|SACM (Service Adapter Control Manager)]] は、[[http://www.iij.ad.jp/|IIJ]] が提供する機器の自動接続、一元管理を可能にするマネージメントシステムサービスです。\\
+MA-E3xx シリーズにパッケージの追加などをすることで、MA-E3xx シリーズの機器を SACM から管理することが可能になります。
+\\
+===== 準備 =====
+==== 動作検証用の無料SACMアカウント取得 ====
+libarms を組み込んだ機器との連携動作を確認できる、libarms 動作検証用 SACM が無償で提供されていますので、下記 URL よりアカウントを取得します。
+[[https://dev.smf.jp/sacm/]]
+[[https://dev.smf.jp/sacm/|{{:mae3xx_tips:iij_sacm:get_sacm_free_account.png|}}]]
+\\
+===== セットアップ =====
+==== パッケージの追加 ====
+libarms および armsd のパッケージをインストールします。\\
+ファームウェアに含める場合は [[mae3xx_devel:chroot_qemu:start]] を参考にして、root filesystem にインストールします。\\
+簡単に試すには、実機上でインストールします。
+\\
+^  File  ^  Stat  ^  SHA1SUM  ^  Note  |
+|{{:mae3xx_tips:iij_sacm:libarms_5.41_armhf.deb|}}|2017/01/12 10:12 100.5 KB|6d2a4893cf57d08924afc94af04105995c515ee9| |
+|{{:mae3xx_tips:iij_sacm:libarms-dev_5.41_armhf.deb|}}|2017/01/12 10:12 7.6 KB|2539ca0e61c9c1141f53f22912b23b0d63aefa6f|開発用ヘッダファイル((armsd を利用する場合、インストール不要))|
+|{{:mae3xx_tips:iij_sacm:armsd_1.0.7_armhf.deb|}}|2017/01/12 10:12 22.5 KB|2afcd226879b5a1876ec5d1a9ee7b4424f4e61b6| |
+\\
+<code>
+user1@plum:~$ sudo dpkg -i /tmp/libarms_5.41_armhf.deb /tmp/armsd_1.0.7_armhf.deb
+[sudo] password for user1:
+Selecting previously unselected package libarms.
+(Reading database ... 20950 files and directories currently installed.)
+Preparing to unpack /tmp/libarms_5.41_armhf.deb ...
+Unpacking libarms (5.41) ...
+Selecting previously unselected package armsd.
+Preparing to unpack /tmp/armsd_1.0.7_armhf.deb ...
+Unpacking armsd (1.0.7) ...
+Setting up libarms (5.41) ...
+Setting up armsd (1.0.7) ...
+Processing triggers for libc-bin (2.19-0ubuntu6.9) ...
+user1@plum:~$
+</code>
+\\
+==== init script の作成 ====
+armsd パッケージには init script が含まれていませんので作成しておきます。\\
+Upstart/SysV init どちらでもかまいません。
+=== /etc/init/armsd.conf ===
+<file generic armsd.conf>
+# SACM armsd
+#
+description "SACM armsd"
+start on runlevel [2345]
+stop on runlevel [!2345]
+respawn
+pre-start script
+    [ -f /etc/default/armsd ] || { stop; exit 0; }
+    . /etc/default/armsd
+    [ "x$START" = "xyes" ] || { stop; exit 0; }
+end script
+script
+    . /etc/default/armsd
+    [ "x$START" = "xyes" ] || { stop; exit 0; }
+    exec /usr/sbin/armsd -D -f /etc/armsd/armsd.conf
+end script
+</file>
+\\
+=== /etc/default/armsd ===
+<file generic armsd>
+START=yes
+</file>
+\\
+==== 設定ファイルの編集 ====
+動作検証用の無料SACMアカウント取得 で送られてきたアカウント情報を、設定ファイルに反映します。
+** /etc/armsd/armsd.conf **
+<file generic armsd.conf>
+distribution-id:	0001-0000-0101-0000-0000-0000-DEAD-BEEF  <-----
+ls-sa-key:		deadbeef                                 <-----
+#sa-model-name:		arms client daemon
+#sa-version:		0.00
+#path-iconfig:		/etc/armsd/initial-config
+#path-state-cache:	/var/cache/armsd/state
+#https-proxy-url:	http://192.168.0.1:8080/
+#hb-disk-usage0:	/
+#hb-traffic-if0:	eth0
+### see sample scripts in /usr/share/armsd-X.X/examples
+#script-app-event:	/etc/armsd/scripts/app-event
+#script-clear: 		/etc/armsd/scripts/clear
+#script-command: 	/etc/armsd/scripts/command
+#script-post-pull:	/etc/armsd/scripts/post-pull
+#script-reconfig:	/etc/armsd/scripts/reconfig
+#script-start:		/etc/armsd/scripts/start
+#script-status:		/etc/armsd/scripts/status
+#script-stop:		/etc/armsd/scripts/stop
+#script-reboot:		/etc/armsd/scripts/reboot
+#script-line-ctrl:	/etc/armsd/scripts/line
+#script-state-changed:	/etc/armsd/scripts/state-changed
+</file>
+\\
+==== ダミーコンフィグの設定 ====
+SACM にコンフィグが登録されていないとエラーとなり接続されないため、適当にダミーのコンフィグを入れておきます。
+{{:mae3xx_tips:iij_sacm:config_dummy.png?800|}}
+\\
+===== armsd の起動 =====
+armsd を起動させてみます。
+<code>
+user1@plum:~$ sudo service armsd start
+[sudo] password for user1:
+armsd start/running, process 5176
+user1@plum:~$
+</code>
+<code>
+user1@plum:~$ ps ax|grep armsd
+?        Ss     0:00 /usr/sbin/armsd -D -f /etc/armsd/armsd.conf
+pts/1    S+     0:00 grep --color=auto armsd
+</code>
+\\
+起動しました。
+\\
+SACM の Web 画面で確認すると、状態が『接続中』になることが確認できます。
+{{:mae3xx_tips:iij_sacm:sa_status_00.png|}}
+\\
+CPU使用率などのグラフを見ることもできます。
+{{:mae3xx_tips:iij_sacm:sacm_graph_00.png|}}
+\\
+===== 要件ごとのカスタマイズ =====
+あとは、アプリケーションの要件ごとにコールバックスクリプトを適宜作成し、
+  * コンフィグの更新
+  * 任意コマンドの実行 (ファームウェア更新など)
+などを実装することができます。
+armsd に関するドキュメントは [[https://dev.smf.jp/libarms/armsd/armsd_top.html|こちら]] を参照して下さい。
+\\
+===== ダウンロード =====
+libarms, armsd および init script を組み込んだサンプルファームウェアです。
+^  File  ^  Stat  ^  SHA1SUM  ^  Note  |
+|{{:mae3xx_tips:iij_sacm:mae3xx_trusty_sacm_v2_6_12.img|}}|2017/01/13 14:57 67.2 MB|91492c0cd048c4ecd2e79aca8e58cc830ff4cf2d|v2.6.12 ベース|
+|{{:mae3xx_tips:iij_sacm:mae320_rootfs_trusty_sacm_v2_6_12.tar.xz|}}|2017/01/13 14:57 52.0 MB|5b8b98cf125ae82636b440398a28a1e18a23b9c1| |

MA-X/MA-S/MA-E/IP-K Developers' WiKi

ユーザ用ツール

サイト用ツール

差分

ページ用ツール