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

リモート管理サーバ [[https://www.centurysys.co.jp/products/router/cms1300_s.html|CMS-1300]] と連携することにより、

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

を行うことができます。

\\

===== 設定 =====

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

<file config cmslink.ini>
[CMS]
ADDRESS=cms1300.example.com
TOKEN=deadbeefcafebabe277b3fcc8526df73ef0eb65d
[DEVICE]
TENANT=maseries
NODE=mas1xx
[MODE]
FIRMUP=true
MODULE_FIRMUP=true
SYSLOG=true
NOTIFY=true
</file>

\\

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

|<50em 6em 8em 20em>|
^  Section  ^  Key  ^  Info  |
|  CMS  |ADDRESS|CMS-1300 のアドレス|
|:::|TOKEN|HTTP アクセストークン((書込可能なもの))|
|  DEVICE  |TENANT|テナントコード|
|:::|NODE|ノード名|
|  MODE  |FIRMUP|自動ファームウェア更新の有効 / 無効|
|:::|MODULE_FIRMUP|LTE Module 自動ファームウェア更新の有効 / 無効|
|:::|SYSLOG|syslog upload の有効 / 無効|
|:::|NOTIFY|状態通知の有効 / 無効|

\\

===== コマンド =====

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

<code>
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
</code>

\\

===== 実行例 =====

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

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

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

\\

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

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

<code>
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
</code>

\\

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

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

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

\\

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

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

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

\\

==== syslog のアップロード ====

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

{{:mas1xx_ope:cms_link:cmslink_syslog_0.png|syslog 一覧}}

{{:mas1xx_ope:cms_link:cmslink_syslog_01.png|syslog 閲覧}}