システム更新

更新体系は、システム、カーネル、エージェント、差分更新の 4 種類を対象とし、クラウドとローカルの 2 経路に対応します。A/B デュアルシステムにより、すべての更新に戻せる経路を用意します。

更新対象

対象	説明
システム（JelinaOS）	機能の進化やセキュリティ修正を含むバージョン更新
カーネル	性能やハードウェア対応の改善
デバイスエージェント	デバイス管理コンポーネントの更新
差分更新	システム差分パッチの迅速な適用

更新方法

クラウド OTA（推奨）

JelinaCloud に接続し、フリートまたはデバイスのページで更新を一元管理します。

システム／カーネル／エージェントの目標バージョンを指定します。
ポリシーに従って配信します。バージョン固定と段階的実行に対応します。
デバイスが自動で取得・適用し、状態をクラウドでリアルタイム確認できます。

オフライン更新パッケージにも対応します。接続できないデバイス向けにダウンロードし、現場で適用できます。USB メモリーなどの可搬媒体で届けることもでき、デバイスが媒体を認識すると自動で更新処理します。

ローカル OTA

クラウドのない環境では、デバイス側の更新ツールを使用します。

# バージョンと更新状態を確認
jelina-local-ota -g
jelina-local-ota -s
jelina-local-ota --json --status      # 構造化された状態出力

# 確認待ちの更新を表示（ローカル確認モード）
jelina-local-ota --confirmation

# 更新パッケージの事前確認（適用せず解析・検証のみ）
jelina-local-ota --check <更新パッケージ>

内容を確認してパッケージの適用を送信します。更新確認が有効な場合は保留状態となり、確認後に実行します。

jelina-local-ota <更新パッケージ>
jelina-local-ota -c -w    # 現在の保留中更新を確認して進捗を追跡

単一コンポーネントパッケージ（.pkg）

エージェントやアプリケーションコンポーネントなどの単体パッケージは、インストーラーで適用できます。

jelina-instpackage --pkg-info <コンポーネントパッケージ.pkg>   # パッケージ情報を表示（インストールしない）
jelina-instpackage <コンポーネントパッケージ.pkg>              # コンポーネントパッケージをインストール

インストール前に出所とチェックサムを確認してください。一部の更新は再起動後に有効になります。

更新パッケージの種類

用途とインストール方法が異なる 2 種類の形式を使用します。

種類	形式	用途	インストールツール
単一コンポーネント	`.pkg`	システム、カーネル、エージェント、アプリケーションなどの個別更新	`jelina-instpackage`
OTA 更新	`.zip`	目標状態と複数コンポーネントを含む完全な更新を、エージェントが一元的に実行	`jelina-local-ota`

インストール方式

単一コンポーネントパッケージは、対象に応じて異なる方式を使用します。

方式	説明
全体書き込み	対象パーティションへ書き込み。通常は予備の A/B パーティション
展開インストール	指定のパーティション、ファイル、ディレクトリへ展開
差分インストール	オーバーレイとして適用。パーティションは切り替えない
実行インストール	インストールして一度実行。リスクが高く、特定の用途のみ

インストール成功と有効化は別

インストーラーが成功を返しても、新しい内容が有効になったとは限りません。システムやカーネルなどは、再起動または再マウント後に有効になります。再起動後、実際のバージョンとパーティションを検証して完了を確認してください。

2 種類のパッケージを混同しない

OTA パッケージ（.zip）を単体インストーラーに渡さないでください。また、単体パッケージ（.pkg）を目標状態の管理を迂回して手動適用しないでください。コンポーネント間の更新順序が崩れます。
クラウドから取得したオフライン OTA は、jelina-local-ota で適用してください。

更新確認機構

重要な現場では、ローカル確認後に実行するよう設定できます。

クラウドから届いた新バージョンを保存し、直ちにはインストールしません。
現場担当者が確認した後に開始します。
デバイス側コマンドまたは画面で確認できます。
確認前は現在のバージョンで稼働し、最終判断は現場が行います。

更新フローと安全性

更新パッケージを取得 → 整合性検証 → 待機パーティションへ書き込み → 再起動して切り替え → 起動時検証
                                                            │
                                                ✅ 合格：稼働を継続
                                                ❌ 失敗：元のシステムへ自動復帰

業務を中断しない更新：ダウンロードと書き込みをバックグラウンドで行い、稼働を継続します。
失敗時の自動ロールバック：切り替え後の検証に失敗すると、元のシステムへ戻します。
バージョンのロールバック：適用後に問題があっても、前のバージョンへ戻せます。

更新状態の確認

jelina-info          # 現在のバージョンと起動パーティションを確認
jelina-local-ota -s  # 更新状態と保留中の更新を確認

クラウドのデバイス画面にも、バージョンと更新状態が表示されます。

更新の推奨事項

場面	推奨事項
定期保守	パッチを適時に適用し、セキュリティ基準を維持
バージョンアップ	テストデバイスで検証してから一括展開
厳しい適合要件のある業界	ローカル確認を有効にし、十分な事前検証を実施
帯域が限られる現場	差分更新またはオフラインパッケージを使用