Debianモデル(ストレージ版)
Debianモデル(ストレージ版)のソフトウェアとは、初代OpenBlocksから引き継ぐソフトウェアの供給版です。
このため最新仕様のOpenBlocksのフレームワークを持っていません。
全ては素のDebian Linuxになるため、基本的にはお客様がこの上にシステムを構築するためのベースとなります。
ハードウェア特性を活かすための若干のカスタマイズ(「Debian GNU/Linuxへの変更」を参照してください。)していますが、本カスタマイズ以外は、Debianやその他Linuxの一般的な操作方法でご利用いただけます。
Debian GNU/Linuxへの変更
AirManage未使用時における追加
- /usr/sbin/runled
ステータス・インジケーターの表示制御を行うため、デーモンとして起動 - /usr/sbin/pshd
パワーボタンが押下されたときの制御を行うため、デーモンとして起動 - /usr/sbin/wd-keepalive
watchdogへのキープアライブ信号を発するデーモンとして起動
AirManage未使用時における削除
- /usr/share/locale以下のja以外のロケールデータ
容量削減のため、削除しています。
AirManage使用時における追加
- AirManage未使用時における追加項目と同一
- AirManage Agent用データ一式
AirManageを使用する上で必用データを一式インストールしています。
インストールデータの一部として、以下となります。- /usr/lib/systemd/system/airagent.service AirManage用サービスを自動起動するための設定ファイルです。
- /usr/local/sbin/airagent.sh AirManage使用向けにサービス起動用のツールです。
- /usr/local/sbin/amregist AirManageを使用するにあたり、アカウント作成やOpenBlocksをAirManageに登録するツールです。
- /usr/local/sbin/proxysetup HTTPプロキシ環境向けのネットワーク設定ツールです。
- /etc/airmanage/bin/airmanage-node-setup.sh AirManageを有効化するためのツールです。
AirManage使用時における削除
- AirManage未使用時における削除項目と同一
基本的な使い方
シリアルコンソール
OpenBlocksとPCを付属のコンソールケーブルで接続し、シリアルコンソールソフトウェア(Windowsの場合はTera Term等)を用いて操作します。
出荷時のパスワード情報は、「出荷時設定情報」を参照してください。
| 項目 | 値 |
|---|---|
| ボーレート | 115200bps |
| データ | 8bit |
| パリティ | なし |
| ストップビット | 1bit |
| HWモデル | 出荷時設定情報 |
|---|---|
| OBSA16 | リンク |
SSHでの接続
本装置のIPアドレスに対して、SSHクライアントソフトウェア(Tera Termやputty等)を用いて操作します。出荷時のIPアドレス・パスワード情報は、「出荷時設定情報」を参照してください。
なおSSHサーバーのホスト鍵は、OpenBlocksを起動した際にホスト鍵ファイルが存在しない場合に作成します。
| HWモデル | 出荷時設定情報 |
|---|---|
| OBSA16 | リンク |
各種設定
AirManage設定ツール以外については、通常のDebianの操作と違いはありません。
aptコマンドによるパッケージの追加/削除/更新なども保存領域の許す限り自由に行うことが可能です。
初期化
設定変更や追加パッケージを消去する場合、以下の手順で出荷時設定に初期化します。
使用モデルにより作業内容が異なります。
初期化(OBSA16)
ファームウェアのバージョンの確認
以下のコマンドを実行して、ファームウェアのバージョンを確認してください。
この結果では、ファームウェアのバージョンが「5.4.47-5」であることを示しています。
BOOT用USBメモリの作成
USB BOOTするために、BOOT用USBメモリを作成します。
info
BOOT用USBメモリは、初期化の他に、バックアップ・リストアに使用します。
USBメモリ(USB2.0、4GB以上)を用意してください。
以下のファイルをPCにダウンロードしてください。
- Rufus 3.5
- USB BOOT用イメージ は最新版の物をダウンロードしてください。
- ファームウェアのバージョン に対応したrootfsファイルを以下からダウンロードしてください。なお、rootfsファイルはファームウェアのバージョンパス配下に配置してあります。
- Debian12(Debianコードネーム : bookworm)用rootfsファイル
- Debian11(Debianコードネーム : bullseye)用rootfsファイル
- AirManageエージェント入りのrootfsファイル : obsa16_<AirManage用管理バージョン>-<Debianコードネーム>_amrootfs.tgz
info
BOOT用USBメモリをバックアップ(OBSA16)及びリストア(OBSA16)に使用する場合、rootfsファイルのダウンロードは不要です。
- PCにUSBメモリを挿入し、Rufusを起動します。
デバイスでPCに挿入したUSBメモリを選択、ブートの種類で「USB BOOT用イメージ」のファイルを選択して、スタートボタンをクリックします。状態が「準備完了」になったら閉じるボタンをクリックします。
コンピューターの管理⇒ディスクの管理で、USBメモリの残りのバーティションを、ファイル システム: FAT32、ボリューム ラベル: 空でフォーマットしてください。
- そのパーティションに、rootfsファイルをコピーします。
info
BOOT用USBメモリをバックアップ(OBSA16)及びリストア(OBSA16)に使用する場合、rootfsファイルのダウンロードは不要です。
USB BOOT
OpenBlocks A16を停止します。シリアルコンソールに接続、BOOT用USBメモリをUSBポートの上段に挿入してください。
シリアルコンソールの画面でキーを入力する準備をし、電源を入れます。U-BOOTのプロンプト
u-boot=>が表示されるまで、任意のキー(例えばスペースキー)を押下します。以下のコマンドを実行してください。
rootfsの展開
起動したらログインします。パスワード情報は、出荷時設定情報を参照してください。
ストレージをフォーマットするために、以下のコマンドを実行してください。
info
SSDをrootfsとしている場合には、"/dev/mmcblk2p2"を"/dev/nvme0n1p1"として読み替えてください。
- ストレージをマウントするために、以下のコマンドを実行してください。
info
SSDをrootfsとしている場合には、"/dev/mmcblk2p2"を"/dev/nvme0n1p1"として読み替えてください。
- USBメモリをマウントするために、以下のコマンドを実行してください。
- rootfsを展開するために、以下のコマンドを実行してください。
info
ここでは、rootfsファイルに obsa16_0.1.2-bullseye_amrootfs.tgz を使用しています。
- ストレージとUSBメモリをアンマウントするために、以下のコマンドを実行してください。
- OpenBlocks A16を停止して、USBメモリを抜いてください。
rootユーザのパスワード変更
次のコマンドを実行します。
セキュリティ上、rootユーザのパスワードを変更することをお勧めします
ネットワークの基本設定
ネットワーク関連の設定ファイルは、次のものがあります。それぞれ適切な内容に変更する必要があります。
- /etc/hosts
- /etc/hostname
- /etc/network/interfaces
- /etc/resolv.conf
ネットワーク設定情報の確認(例)
| 項目 | 値 |
|---|---|
| ホスト名 | obs16 |
| ドメイン名 | example.jp |
| IPアドレス(ETHER-0) | 192.168.0.10/255.255.255.0 |
| IPアドレス(ETHER-1) | 192.168.1.10/255.255.255.0 |
| デフォルトゲートウェイ | 192.168.0.1 |
| DNSサーバー | 192.168.0.2, 192.168.0.3 |
- /etc/hosts
- /etc/hostname
- /etc/network/interfaces
- /etc/resolv.conf
HTTP Proxyの設定(必要な場合のみ)
HTTP Proxyがある環境では、次のファイルに設定を行います。
なお、systemdのサービス等でHTTP通信を行うサービス向けには別途設定が必用になることがあります。
- /etc/profile.d/80-proxyenv.sh
- /etc/apt/apt.conf.d/80-proxy.conf
info
AirManageを使用する場合には、proxysetupコマンドにてHTTP Proxy設定を実施してください。
これによりAirManageツール考慮のプロキシ設定が行われます。
HTTP Proxy設定ツール
前述のファイルは以下のコマンドを実行することで作成が行えます。
対話式のツールとなるため、パラメータを入力します。
インストール可能パッケージの情報更新
次のコマンドを実行します。
必要に応じて、/etc/apt/sources.listを編集してダウンロード先を変更して下さい。
info
ダウンロード先を追加する場合にはPublicキーを追加する必要になることがあります。
Publicキーの追加方法は追加先にて公開されていますので、公開先の情報をご確認ください。
インストール済みパッケージの更新
次のコマンドを実行します。
タイムゾーンの設定
次のコマンドを実行します。
ロケールデータの作成
次のコマンドを実行します。
一般ユーザの追加
次のコマンドを実行します。
一般ユーザsudo権限
次のコマンドを実行します。
例のuser01は、「sudo -s」でrootに権限昇格できるほか、「sudo fdisk -l」のようにすることで各コマンドをroot権限で実行できます。
バックアップ・リストア
使用モデルにより作業内容が異なります。
バックアップ先にUSBメモリを使用していますので、ご用意ください。
OpenBlocks A16(OBSA16)の場合、BOOT用USBメモリをBOOT用USBメモリの作成を参照して用意してください。
バックアップ(OBSA16)
USB BOOT
OpenBlocks A16をUSB BOOTを参照してUSB BOOTしてください。
ユーザーランドのアーカイブ及びKERNELのコピー
起動したらログインします。パスワード情報は、出荷時設定情報を参照してください。
ストレージをマウントするために、以下のコマンドを実行してください。
info
SSDをrootfsとしている場合には、"/dev/mmcblk2p2"を"/dev/nvme0n1p1"として読み替えてください。
- USBメモリをマウントするために、以下のコマンドを実行してください。
- KERNELファイルをコピーするために、以下のコマンドを実行してください。
- ユーザーランドをアーカイブするために、以下のコマンドを実行してください。
- ストレージとUSBメモリをアンマウントするために、以下のコマンドを実行してください。
- OpenBlocks A16を停止して、USBメモリを抜いてください。
リストア(OBSA16)
USB BOOT
OpenBlocks A16をUSB BOOTを参照してUSB BOOTしてください。
ユーザーランドの展開及びKERNELファイルのコピー
起動したらログインします。パスワード情報は、出荷時設定情報を参照してください。
ストレージをフォーマットにするために、以下のコマンドを実行してください。
info
SSDをrootfsとしている場合には、"/dev/mmcblk2p2"を"/dev/nvme0n1p1"として読み替えてください。
- ストレージをマウントするために、以下のコマンドを実行してください。
info
SSDをrootfsとしている場合には、"/dev/mmcblk2p2"を"/dev/nvme0n1p1"として読み替えてください。
- USBメモリをマウントするために、以下のコマンドを実行してください。
- ユーザーランドに合わせたKERNELを用いるため、以下のコマンドを実行します。
- ユーザーランドを展開するために、以下のコマンドを実行してください。
- ストレージとUSBメモリをアンマウントするために、以下のコマンドを実行してください。
- OpenBlocks A16を停止して、USBメモリを抜いてください。
更新
オンラインアップデート
OpenBlocksは、本体基板上のストレージに書き込まれたファームウェア(カーネルとユーザーランド)を電源ON時に、読み出し・実行し稼働を行っています。
カーネルに関しては、ファームウェアそのものを更新することで、最新の状態にすることが可能です。
アップデート方法は特別なことではなく、ユーザーランドの各種パッケージ類と同様に、「apt update」でリポジトリ情報を更新し、「apt upgrade」または「apt install」で最新のバージョンへ更新することが可能です。
- 全てのパッケージを更新する場合
- OpenBlocks A16においてカーネルのみ更新する場合
オフラインアップデート
オンラインアップデートが実施できない環境の場合、別途ダウンロードしたファームウェアファイルを用いて以下のコマンドを実施することで更新が可能です。
- OpenBlocks A16においてカーネルのみ更新する場合
AirManage
AirManageは遠隔地に設置したOpenBlocksシリーズを統合管理するシステムです。
また、AirManageはインターネットでサービスしているAirManageサーバーとそれぞれのOpenBlocks間で通信を行い、システム異常の検出やソフトウェアのバージョン統合管理を行います。
Debianモデル(ストレージ版)ではWEB-UIは搭載されていないため、ブラウザでのコンソール機能をサポートします。
info
AirManageを使用する場合にはインターネット通信が必須となります。
そのため、インターネット通信ができるようにネットワーク設定を行ってください。
AirManageへの登録
AirManageの使用にはサブスクリプションに加入する必要があります。
AirManageサブスクリプションが期限切れの場合は1年毎に追加購入できるので当社セールスへご連絡ください。
AirManage利用規約はこちらからご確認ください。
初めてのAirManage登録には4つのステップがあります。
① AirManageアカウントの作成
② テナントの確認/作成/登録
③ 本体登録及びテナントへの所属
④ AirManageの有効化
info
本登録を行う上でインターネット接続が必須となります。前述のネットワークの設定にてインターネットへ接続できるネットワーク環境を設定した上で実施してください。
① AirManageアカウントの作成
AirManageシステムでは、e-mailアドレスをユーザーIDとして使用しますので、このOpenBlocksを管理するためのe-mailアドレスを1つ用意してください。
※2つ以上のe-mailで管理したい場合は、当社サポートへご連絡ください。
アカウントの確認
AirManageのアカウント作成及び登録するツールを実行します。
メニューが表示されますので、1を入力した後に登録済みまたは登録したいメールアドレスを入力しアカウントの確認を行います。
既にアカウントをお持ちの場合には、Account found.と表示されます。
その場合、こちらを押してください。
新規アカウントの場合
AirManageに初めて登録するアカウントの場合では、 Account not found. Do ceate AirManage account...と表示されます。
アカウント作成が追加されたメニューが表示されますので、2を入力した後にアカウント名とパスワードを入力します。
※パスワードは確認用のものを含めて2回入力する必要があります。
Please check the email you received. And , check your account again.というメッセージが表示された後、アカウント確認時に入力したメールアドレス宛に以下の様な確認メールが到着します。
caution
Please check the email you received. And , check your account again.というメッセージが表示されてから15分以内にメール内のURLからWEBアクセスを行ってください。
WEBアクセスを行わず一定時間を経過した場合、登録作業中の情報は破棄される為、再度上部のアカウント作成処理を行う必要があります。
AirManageに正規登録するには赤枠内にあるURLをクリックします。
本登録に成功するとブラウザに以下の画面が表示されます。
本登録完了後、再度アカウントの確認を行ってください。
② テナントの確認/作成/登録
テナントとはショッピングセンターの中にある一つのお店の様なもので、これを独立した一つの会社の様に扱う単位としています。
要するにAirManageはショッピングセンターであり、テナントはそのサーバーを共有利用する個々のお店(会社)にあたります。
初めてOpenBlocksをAirManageに登録する時、そのユーザーはAirManageからテナントID(テナント記号)を確保する事から始まります。
テナントを所持しているかの確認は一定バージョンによって以下の2種類となります。
- アクセストークンを用いて、テナント確認を行うケース(新Ver.)
新Ver.ではテナント確認以降の作業にてAirManageのアクセストークンが必用となります。
テナント確認にして使用したアクセストークンを入力は保持されていますので、更新等がない場合には変更は不要です。 - アカウント確認にて、自動でテナント確認がされるケース(旧Ver.)
新Ver.でのテナント確認方法
新Ver.の場合、テナント確認方法としてメニューに6.) Tenant Checkが表示されます。
6を入力し、自身が使用するAirManageのWEB画面のユーザ設定部からアクセストークンを確認し入力します。
テナント未所持の場合、Tenant not found. Do ceate tenant ...が表示されます。
テナントを所持している場合、テナント一覧が表示されます。
テナント確認(新Ver.)またはアカウント確認(旧Ver.)にて、Tenant not found. Do ceate tenant ... というメッセージが表示された方が対象となります。
テナント作成が追加されたメニューが表示されますので、3を入力した後にテナントID(テナント記号)を入力します。
テナントID(テナント記号)で入力可能文字は英数字及び記号の"_"です。
テナント作成後、新Ver.の場合はテナント確認、旧Ver.の場合はアカウントの確認を行ってください。
テナントが作成されていると以下のように表示されます。
info
Use AirManage URL :部に表示されているURLがブラウザにてアクセスするURLとなります。
そのため、このURLはブックマークすることをお奨めします。
③ 本体登録及びテナントへの所属
テナントを所持しているアカウントの場合、本体登録確認メニューが表示されます。
本体登録確認のため、4を入力します。
Already registered in AirManage. Therefore, change the connection settings of AirManage.が表示された場合、本体は既に登録が完了しています。
Enter the menu code : にて"x"を入力し、設定・登録ツールを終了します。
※もし登録した事がないのに登録されていた場合は当社サポートへご連絡ください。
The device has not been registered in AirManage. Please continue the registration process.と表示された場合、本体が未登録となります。
その場合、本体登録メニューが表示されますので、5を入力した後にノード名及び登録対象テナントを入力します。
Registration success.が表示された場合、本体の登録が完了となります。
Enter the menu code : にて"x"を入力し、設定・登録ツールを終了します。
④ AirManageの有効化
AirManageの有効化の前には予め①～③の項を終わらせておかなければなりません。
またインターネットへの接続が終わっていなければなりません。
最初の1台目の登録はアカウント認証などの手間がかかります。
しかし、2台目以降は設定選択だけなので容易に作業を進めることができるので、なるべくAirManage登録を行うことをお奨めします。
前述の③ 本体登録及びテナントへの所属にて、AirManageの使用設定は完了しています。
以下のコマンドを実行することにより、自動で再起動されAirManageの有効化が完了します。
caution
コマンドを実行し再起動しない場合には、通信エラーや設定ミスの恐れがあります。
ネットワーク設定や本体が登録されているかご確認ください。
AirManageにログイン
ログイン画面
AirManageのアカウント確認にてUse AirManage URL : 部に表示されているURLを、パソコンのWEBブラウザのURLに入力しEnterキーを入力します。
ここでユーザーIDとパスワードを入力しログインします。
ログインするとノード状況画面が表示されます。
これがAirManageのフロントページです。
ここで全ての登録されたOpenBlocksの状態が確認できます。
2段階認証登録をする
OpenBlocksのセキュリティをいくら強化してもAirManageへのログインがBASIC認証だけでは不十分です。
このためAirManegeでばワンタイムパスワードによる2段階認証の登録が可能です。
ワンタイムパスワードのトークン発行にはスマートフォン(またはタブレットなど)が必要ですのでご用意ください。
スマートフォンには予めAuthenticatorアプリを登録します。
iPhone版Authenticator : Microsoft版またはGoogle版
Android版Authenticator : Microsoft版またはGoogle版
※Authenticator互換であれば特にアプリメーカーを限定しません。
二段階認証の設定はAirManageフロントページの左上にあるユーザー設定をクリックしてください。
すると下図の通りユーザーの編集画面が表示されます。
このページではユーザーのパスワードなどの変更が可能です。
ここの中段にある2段階認証項目の設定を有効に変更してください。
有効にすると以下の画面にQRコードが表示されます。
このQRコードが表示されたら、先ほどスマートフォンに登録したAuthenticatorアプリを起動してください。
起動したら、そのアプリでQRコードをカメラでスキャンします。
スキャンと同時に数字6桁のワンタイムパスワードがスマホの画面に表示されるので、この6桁数字をQRコード下の入力枠にタイプインしてください。
正常な認識コードを入力すると前画面に戻るのでアカウント詳細を更新ボタンを押してください。
これで次回からのログインにはBASIC認証の後に、ワンタイムパスワードの入力画面が表示されるようになります。
スマホのAuthenticatorアプリを起動して表示されたワンタイムパスワードを入力しログインしてください。
警告
2段階認証はシステム運用ではセキュリティ上たいへん重要なので必ず設定してください。
ノード一覧を表示する
AirManageのWEBサイトの上段にある横並びメニューのノードをクリックしてください。
下図の様に登録されたOpenBlocksが一覧されます。(ここでは1台だけですが)
ここでは一覧にあるアクションボタンのWEBアクセスボタン▶についてのみ解説します。
アクションボタン以外の操作に関してはAirManage遠隔監視を参照ください。
このWEBアクセスボタン▶ボタンはOpenBlocksと接続可能な状態にある時は黒色に表示され、接続不可能な状態では灰色になります。
したがって黒色の時のみOpenBlocksの画面の転送が始まります。
転送が始まると下図の様に新しいタブにログイン画面が表示されます。
OpenBlocksへのブラウザ上でのSSHアクセスとなるため、ユーザー名及びパスワードを入力しログインします。
SSHのポート番号や鍵設定をしている場合には適宜パラメータの変更・設定をしてログインしてください。
ログインが成功すると、以下のようにコンソールが表示されます。
なお、Tera Term等で行うドラッグ＆ドロップでのファイル転送は行えません。
ファイルを転送したい場合には、AirManageのファイル配信機能をご検討ください。
info
AirManageからのOpenBlocksへのWEBアクセスはブラウザでのSSHアクセスが標準機能となります。
ブラウザでのSSHアクセスではなく、ユーザーが追加したWEBシステムへのアクセス変更についても可能です。
実施方法についてはAirManageからのWEBアクセス変更をご確認ください。
AirManageへのアテンション喚起
以下のファイルが存在する場合、AirManageサーバーへアテンションを上げることができます。
アテンション内容を記載したファイルを配置することでAirManageサーバー側ではアテンションありとなります。
アテンション状態はAirManageサーバー側のノード情報取得間隔ごとに確認されます。
このとき、ファイル有無によりアテンション状態が変更となります。
※エントリープランのノード情報取得間隔は弊社設定に依存します。
info
緊急でアテンション喚起状態とする場合にはファイル配置後に以下のコマンドを実行してください。
アテンションの解除はAirManageサーバー側から実施可能です。
カスタマイズ
OpenBlocksでは、FUNCスイッチの機能やステータスインジケーターの表示色等をカスタマイズすることができます。
FUNCスイッチの機能変更
/usr/sbin/pshdはFUNCスイッチの状態を監視しています。
FUNCスイッチが押された場合、定義ファイル( /tmp/.pshd ファイル)に記載された内容に基づきコマンドを実行します。
そのため、定義ファイルの内容を別のコマンドに変更することでFUNCスイッチの機能を変更できます。
info
- 定義ファイルの内容は1行のコマンドを定義してください。
複雑な処理を行う場合には、指定したコマンド内にて処理を行うようにしてください。 - 起動時に定義ファイルが存在しない場合にデフォルトで上記内容のファイルを作成します。
ステータスインジケーター表示の変更
/usr/sbin/runledはステータスインジケーターを行っています。
LEDの表示色・点灯状態を変更する場合は、定義ファイル( /tmp/.runled ファイル)の内容を編集します。
表示色及び点灯時間を変更することにより、ステータスインジケーターの表示を変更できます。
| 行 | 設定内容 | 備考 | 設定値サンプル |
|---|---|---|---|
| 1行目 | 点灯1 時間(msec) | 1以上 | 300 |
| 2行目 | 点灯2 時間(msec) | 1以上 | 3000 |
| 3行目 | 点灯1 色番号 | 下表参照 | 2 |
| 4行目 | 点灯2 色番号 | 下表参照(省略した場合、0) | 0 |
| 色番号 | 色 |
|---|---|
| 0 | 非点灯 |
| 1 | 赤 |
| 2 | 緑 |
| 3 | 黄 |
| 4 | 青 |
| 5 | 紫 |
| 6 | 水色 |
| 7 | 白 |
| 範囲外 | 非点灯 |
AirManageからのWEBアクセス変更
AirManageからのOpenBlocksへのWEBアクセスするサービスを変更できます。
通常ではOpenBlocks内にて稼働しているブラウザ上でのSSH機能ですが、ユーザーが追加したWEBシステムへのアクセスが可能となります。
設定ファイル(/etc/default/airmanage-extusr-node)にNODE_WEB_PORT変数に切り替え先のWEBサービスのポート番号を定義することすることで、AirManageからアクセスするWEBサービスが切り替わります。
以下は、OpenBlocksへインストールしたWEBサービス(nginxやapache)への切り替えサンプルとなります。
info
本カスタマイズをおこなった場合、ファイル作成後は設定反映の為に再起動を行ってください。