リモート管理サーバ CMS-1300 との連携

リモート管理サーバ CMS-1300 と連携することにより、

ファームウェアの自動更新
LTE Module ファームウェアの自動更新
状態の通知
syslog のアップロード

を行うことができます。

設定

CMS-1300 の設定を行った後で、設定ファイルに CMS-1300 に登録した情報を設定します。設定ファイルのパスは /etc/cmslink/cmslink.ini となっています。

[CMS]
ADDRESS=cms1300.example.com
TOKEN=deadbeefcafebabe277b3fcc8526df73ef0eb65d
[DEVICE]
TENANT=maseries
NODE=mas1xx
[MODE]
FIRMUP=true
MODULE_FIRMUP=true
SYSLOG=true
NOTIFY=true

それぞれの値の内容は下表のとおりとなっています。

Section	Key	Info
CMS	ADDRESS	CMS-1300 のアドレス
CMS	TOKEN	HTTP アクセストークン¹⁾
DEVICE	TENANT	テナントコード
DEVICE	NODE	ノード名
MODE	FIRMUP	自動ファームウェア更新の有効 / 無効
	MODULE_FIRMUP	LTE Module 自動ファームウェア更新の有効 / 無効
	SYSLOG	syslog upload の有効 / 無効
	NOTIFY	状態通知の有効 / 無効

コマンド

CMS-1300 とのやりとりを行うコマンドは /usr/local/sbin/cmslink となります。オプションは下記のとおりです。

root@gemini:~# cmslink -h
cmslink

CMS link application

Usage:
  cmslink [options] command

Arguments:
  command

Options:
  -c, --cfg=CFG              config file path (default: /etc/cmslink/cmslink.ini)
  -o, --out=OUT              firmware download path (default: /tmp/firmware.img)
  -f, --force                force download
  -h, --help                 Show this help

Supported command:
  get_firminfo :        Get Firmware Informations
  get_firmware :        Get Firmware Blob
  get_module_firminfo : Get Module Firmware Informations
  get_module_firmware : Get Module Firmware Blob
  upload_syslog :       Upload rotated syslog
  notify :              Notify Informations

実行例

ファームウェア情報の取得

CMS-1300 にファームウェアが登録されている場合、下記のような情報が取得できます。

root@gemini:~# cmslink get_firminfo
--- Firmware Info ---
 version: 5.1.0
 size:    85665312
 sha1sum: 3325a8430314ed6ae4a26804a4455388ed2593ab

ファームウェアのダウンロード

CMS-1300 に登録されているファームウェアが機器で動作しているファームウェアより新しい場合、ファームウェアをダウンロードします。
機器で動作しているファームウェアと同じもの、もしくは古い場合にはダウンロードしません。

root@gemini:~# cat /etc/version 
MA-S1xx firmware version 5.2.0alpha1 (Fri Oct 30 14:53:16 JST 2020)
root@gemini:~# cmslink get_firmware
Firmware on CMS is old or same, quit

LTE Module ファームウェア情報の取得

CMS-1300 に LTE Module のファームウェアが登録されている場合、下記のような情報が取得できます。

root@gemini:~# cmslink get_module_firminfo
--- Module Firmware Info ---
 label:   aml574
 version: 14-12
 size:    51771118
 sha1sum: 46a5cd53c8c1c039eaef8a0e23da3be9970a1783

LTE Module ファームウェアのダウンロード

CMS-1300 に登録されている LTE Module ファームウェアが機器で動作している LTE Module ファームウェアより新しい場合、LTE Module ファームウェアをダウンロードします。
機器で動作している LTE Module ファームウェアと同じもの、もしくは古い場合にはダウンロードしません。

root@gemini:~# cmslink get_module_firmware
Module Firmware on CMS is same or old (local: '14-12', CMS: '14-12')

syslog のアップロード

upload_syslog を true に設定しておくことで、logrotate 時に rotate された syslog(/var/log/syslog.1) をアップロードします。
CMS-1300 の Web 画面で確認することができます。

¹⁾

書込可能なもの

目次