Skip to content

AwaniOS インストール&コンソールダッシュボードガイド

AwaniOS は、ハイパーコンバージドインフラストラクチャ(HCI)、仮想マシン管理、ソフトウェア定義ネットワーク(SDN)向けに設計された商用エンタープライズクラウドオペレーティングシステムです。インタラクティブな TUI インストールウィザードと、リアルタイムのノードモニタリング、ネットワーク設定、Open vSwitch (OVS) バーチャルスイッチ管理、システム管理を提供する包括的なコンソールダッシュボード(os-tui)を備えています。


1. システムインストール

1.1 初期化と起動

  • 起動: AwaniOS の ISO インストールメディアをベアメタルサーバーまたは仮想マシンに挿入してシステムを起動します。カーネルの起動シーケンスとインストーラーサービスの初期化が表示されます [00:10]。
  • ウェルカム画面: 初期化完了後、インタラクティブな AwaniOS Installation Wizard が起動します。
  • 警告: インストールを実行すると、選択したターゲットディスクの すべてのデータが消去・フォーマット されます。確認の上 ENTER を押して続行します [00:27]。

1.2 ディスクとネットワークの設定

  • ターゲットディスクの選択: AwaniOS をインストールするターゲットストレージデバイス(例: /dev/sda または /dev/vda)を選択します。矢印キーで移動し、ENTER で決定します [00:34]。
    • ストレージレイアウト: インストーラーは、BIOS Boot / EFI システムパーティション、ブートパーティション(/boot)、および rootswaphome 論理ボリュームを含む LVM ボリュームグループ(awan-vg)で構成されるアライメント済み GPT テーブルを作成します(32MB の GPT テール予備領域を含む)。
  • プライマリネットワークインターフェースの選択: ノード管理用のアクティブな物理 NIC(例: enp1s0 または eth0)を選択します [00:41]。
  • ネットワークモードの選択:
    • DHCP (自動): ネットワーク上の DHCP サーバーから IP アドレス、ゲートウェイ、DNS サーバーを自動取得します [00:47]。
    • Static (手動): CIDR 表記の静的 IP アドレス(例: 192.168.1.100/24)、デフォルトゲートウェイ(例: 192.168.1.1)、および DNS ネームサーバー(例: 1.1.1.1, 8.8.8.8)を入力します。

1.3 システム識別と認証情報

  • ホスト名: ノード固有のホスト名(例: awanios-node-01)を入力します。
  • システムパスワード: 管理者アカウント(awanio)の安全なパスワードを設定します。
  • パスワードの確認: 確認のためパスワードを再入力します。Tab キーで項目間を移動し、ENTER で送信します [00:54]。

1.4 インストールの実行と再起動

  • 設定概要の確認: パーティション構成、LVM 設定、ネットワークパラメータを確認します [01:21]。
  • 実行: ENTER を押して自動 Curtin インストール処理を開始します。システムはパーティションをフォーマットし、OS イメージを展開して GRUB ブートローダーをインストールします [01:32]。
  • 再起動: 完了後、ENTER を押してノードを再起動し、インストールメディアを取り外します [01:52]。

2. コンソールダッシュボード (os-tui)

インストール完了後の再起動時、システムは tty1 上に AwaniOS Console Dashboard を表示します。

2.1 認証とセキュリティ

インストール時に設定した awanio ユーザー名とパスワードを使用してログインします。認証は PAM(unix_chkpwd)を介して Linux システムの shadow 認証情報に対して検証されます。

2.2 ダッシュボードレイアウトとナビゲーション

ダッシュボードは主に 3 つの領域で構成されています:

  1. ヘッダーバー (上部): ノードホスト名、ログインユーザー(awanio)、接続状態を表示。
  2. サイドバー (左側): ショートカット番号(16)が付いた管理タブ一覧。
  3. メインコンテンツパネル (中央/右側): 統計情報の表示や設定作業を行うインタラクティブエリア。

グローバルキーボードショートカット

キーアクション
16指定タブへ直接ジャンプ (1: 概要, 2: ネットワーク, 3: ストレージ, 4: サービス, 5: ターミナル, 6: 電源)
Tab / Shift+Tabタブを順方向 / 逆方向に切り替え
h / l または / タブを左右に移動
j / k または / リストおよびメニュー項目の移動
n物理 NIC 管理ウィザードを開く (ネットワークタブから)
mバーチャルスイッチ (VS) 管理ウィザードを開く (ネットワークタブから)
uコンソール TUI アップデーターモーダルを開く
qコンソール TUI を終了してログインプロンプトに戻る

3. 各モジュールの詳細説明

3.1 システム概要タブ ([1])

システム概要 タブでは、物理ホストのリアルタイムヘルス状態を確認できます:

  • システム情報: ホスト名、OS ディストリビューションバージョン、Linux カーネルリリースバージョン、稼働時間(Uptime)。
  • ハードウェアリソース: CPU アーキテクチャ、CPU コア数、ロードアベレージ (1分, 5分, 15分)、全メモリ/使用メモリ量。
  • リソース使用量バー: CPU 使用率およびメモリ消費率をリアルタイム表示する動的プログレスバー。
  • クイックアクションボタン [u]: TUI アップデーターモーダルを起動するショートカット。

3.2 ネットワーク&インターフェース管理 ([2])

2 を押すと ネットワーク タブが開きます。物理ネットワークインターフェース、Open vSwitch (OVS) ブリッジ、仮想ポート(vPort)が表示されます。

3.2.1 物理 NIC 管理 ([n])

ネットワークタブで n を押すと、物理ネットワークカードの設定が行えます:

  1. 物理インターフェースの選択: アクティブなインターフェース(例: enp1s0, eth0)を選択。
  2. 設定モードの選択:
    • DHCP モード: Netplan を再設定し、自動 IPv4/IPv6 リーを取得 (dhcp4: true)。
    • Static IP モード: カスタムの静的ネットワークパラメータで Netplan を再設定:
      • CIDR 付き IP アドレス: ネットマスクを含む IP アドレスを入力(例: 192.168.1.10/24)。※ CIDR プレフィックスは必須です。
      • ゲートウェイ: デフォルト IPv4 ゲートウェイ(例: 192.168.1.1)。
      • DNS ネームサーバー: カンマ区切りの DNS リゾルバーアドレス(例: 1.1.1.1, 8.8.8.8)。
  3. ステータス切り替えとクリーンアップ:
    • インターフェースの UP / DOWN 切り替え。
    • 既存の割り当て済み IP アドレスの消去。
  4. 自動 DNS&名前解決同期:
    • Netplan が新しい静的 DNS 設定を適用すると、AwaniOS は自動的に systemd-resolved を有効化し、ネームサーバーを /etc/resolv.conf に同期して、すべてのシステムアプリケーションでドメイン名解決が正しく機能するように保障します。

3.2.2 バーチャルスイッチ (VS) & vPort 管理 ([m])

AwaniOS は、高性能なソフトウェア定義ネットワーク(SDN)のために Open vSwitch (OVS) を統合しています。ネットワークタブで m を押すと、バーチャルスイッチウィザードが開きます。

A. VS ブリッジの管理

  • VS ブリッジの作成:
    • ブリッジ名: カスタムブリッジ名を入力(例: br-ex, br-int)。
    • フェイルモード: standalone(標準 L2 スイッチング)または secure(SDN コントローラーが必要)を選択。
    • STP / RSTP: スパニングツリープロトコル(STP)またはラピッドスパニングツリープロトコル(RSTP)を有効化し、ループを防止。
  • VS ブリッジの削除: OVS ブリッジを削除し、関連付けられたインターフェースを安全に切断します。

B. 仮想ポート (vPort) の管理

  • システムポートの追加 (トランク/物理 NIC):
    • 物理 NIC(例: eth1)をアップリンクシステムポートとして OVS ブリッジに接続。
    • 物理 NIC の IP アドレスは Netplan 上で解除され、OVS パイプラインに引き渡されます。
  • 内部 vPort の追加:
    • ホストネットワークやハイパーバイザーサービス用に内部 OVS vPort(例: mgmt0, storage0)を作成。
    • ネットワークセグメンテーション用に 802.1Q VLAN タグ(1〜4094)を割り当て。
    • 内部 vPort に静的 IP アドレスを直接割り当て。
  • サービス通信タグ (Service Tags): クラスター通信トラフィックの自動ルーティング用に、特定ロールの AwaniOS サービス molten タグを vPort に割り当て可能:
    • management — 主ノード管理および API コントロールプレーン通信。
    • storage — Ceph / SAN ストレージネットワークトラフィック。
    • migration — VM ライブマイグレーション通信。
    • backup — データバックアップおよびスナップショット複製。
    • replication — ストレージブロック複製。
    • shared-heartbeat — クラスタークォーラムおよび HA ハートビート。
  • 永続起動復旧機能 (awanios-ovs-ports.service):os-tui で設定された OVS 内部ポートおよびサービス通信タグは自動的に /etc/awanios/ovs-internal-ports.conf に保存され、ネットワーク初期化前のブート時に自動再適用されます。

3.3 ストレージ管理タブ ([3])

3 を押すと ストレージ タブが開きます:

  • 物理ディスク: 検出されたブロックデバイス、ディスクモデル、シリアル番号、全容量、パーティションテーブル(/dev/sda, /dev/nvme0n1)を表示。
  • LVM ボリュームグループ: awan-vg ストレージプールの指標、割り当て済みエクステント、空き容量を確認。
  • 論理ボリューム: /, /home, swap のマウントポイント、ファイルシステムタイプ(ext4, xfs)、合計サイズ、使用率をモニタリング。

3.4 Systemd サービス管理タブ ([4])

4 を押すと、アクティブおよびバックグラウンドのシステムサービス(vapor, libvirtd, openvswitch-switch, systemd-networkd, systemd-resolved, ceph)を一覧表示します:

  • フィルタと検索: / キーを押してリアルタイム検索ボックスを開き、サービス名を入力して検索。
  • サービスステータス: ロード状態、アクティブ状態(active/inactive)、サブステータス(running/exited)を確認。
  • サービス制御アクション:
    • サービスを選択して ENTER を押すと、詳細なユニットログを確認可能。
    • クイックアクション操作: 起動 (Start)停止 (Stop)再起動 (Restart)有効化 (Enable)無効化 (Disable)
  • リストの更新: R キーを押してサービス状態を再読み込み。

3.5 組み込み擬似ターミナル ([5])

5 を押すと、組み込みの擬似ターミナルシェルが開きます:

  • コンソール UI 内で直接 awanio ユーザー権限のインタラクティブな Bash シェルを起動。
  • 標準的なターミナルコマンド、sudo 権限、テキストエディタ(vim, nano)、CLI ユーティリティ(awctl, kubectl, virsh, ovs-vsctl, ceph)をフルサポート。
  • ctrl+d を押すか exit と入力すると、シェルセッションを終了して TUI メニューに戻ります。

3.6 ノード電源管理 ([6])

6 を押すと、ノードの 電源 管理タブが開きます:

  • ノードの再起動 (Reboot): オペレーティングシステムを安全に再起動 (systemctl reboot)。
  • ノードのシャットダウン (Shutdown): すべての仮想マシンを安全に停止し、ファイルシステムをアンマウントしてハードウェアの電源を切断 (systemctl poweroff)。
  • 誤操作による電源切断を防ぐため、確認ステップが用意されています。

4. コンソール TUI のアップデート

AwaniOS には、コンソールダッシュボードのセルフアップデート機能が組み込まれています。

4.1 アプリ内 TUI アップデーター (u キー)

  1. コンソールダッシュボードの任意のタブから u キーを押します(または概要タブの [u] Update TUI をクリック)。
  2. TUI は https://storage.awan.io/assets/tui-version.json をバックグラウンドで照会し、オンラインリリース情報とローカルの BuildID を比較します。
  3. アップデートが利用可能な場合は、[Enter] を押して更新を開始します:
    • 最新コンパイル済みの os-tui バイナリをダウンロード。
    • バックアップを作成(/usr/local/bin/os-tui.bak)。
    • /usr/local/bin/os-tui をアトミックに置換。
    • ホスト OS を再起動することなく、1秒以内に TUI セッション(getty@tty1.service)を自動再起動。

4.2 手動コマンドラインアップデート

あるいは、システム管理者はリモート SSH ターミナルやシェルセッションから直接コンソールダッシュボードを更新することも可能です:

bash
curl -sSL https://storage.awan.io/assets/awanios-tui-update.sh | sudo bash