ライセンスをインストールして Business へ移行する

プランを購入し、ライセンスを受け取りました。このページでは、そのファイルをどこに置くか、稼働中のエンジンへ適用する方法、インストール済みの内容を確認する方法、そしてエンタープライズプランを購入した場合に Community バイナリをエンタープライズバイナリへ何も再インストールせずに切り替える方法を説明します。

実行中のソフトウェアの機能をゲートするものではありません。 ライセンスが期限切れまたは不在でも機能は無効にならず、どのライセンスもユーザーアカウント数を制限しません。セルフホストのユーザー数はどのティアでも無制限です。これは保有する権利を示す署名済みの声明であり、すでにディスク上にあるコードを解錠する鍵ではありません。

実際にゲートするのは、アーティファクトへのアクセスです。この区別こそがモデル全体の要点です。エンタープライズビルドのダウンロードと、ローカルバンドルからのインストール（olivares upgrade --bundle）には有効なライセンスが必要です。そのライセンスは、使用中のバイナリに埋め込まれた鍵に対してオフラインで検証されます。そのため、エンタープライズエディションは既存バイナリ内の feature flag を切り替えるものではなく、トークンを使って取得する別のバイナリです。したがって、「何もゲートしない」と説明するのは誤りです。

受け取ったもの

購入したもの	届くもの	その扱い
Community	インストールするものはありません	すでに稼働中です。このページの手順は該当しません
Business / Business Max、セルフホスト	ライセンスファイルとダウンロードトークン	ライセンスをインストールしてからエンタープライズバイナリへ切り替えます
Cloud	ホストされたテナントの認証情報	自分のホストにインストールするものはありません

ライセンスは単一の署名済み blob です。customer.license など任意の名前でファイルに保存し、同じメールに記載されたダウンロードトークンも保管してください。両者は別々の手順で使用し、インストールするのはライセンスだけです。

1 · ライセンスをインストールする

olivares license install ./customer.license --data-dir /var/lib/olivares

このコマンドは、ビルドに埋め込まれた Ed25519 公開鍵に対して、何かを書き込む前に blob を検証します。そのため、途中で切れたコピー＆ペーストは次回起動時ではなく、ここで失敗します。成功すると、エンジンがデフォルトで読み込む正規の保存ライセンス <data-dir>/license.key をモード 0600 で書き込みます。

パスの代わりに - を渡すと、標準入力から blob を読み取ります。

pbpaste | olivares license install - --data-dir /var/lib/olivares

既存ライセンスの上にインストールすると、それをアトミックに置き換え、置き換えたライセンスを表示します。

稼働中のエンジンへ適用する — 再起動は不要

稼働中のエンジンは新しいライセンスをインプレースで取り込みます。次のいずれでも適用できます。

kill -HUP "$(pidof olivares)"                 # signal the running process
curl -X POST .../v1/console/runtime/reload    # the API half

…または、コンソールの再読み込みコントロールを使用します。再起動でも適用できますが、必要ではありません。

エンジンが検索する場所と優先順位

すでに別の方法でライセンスを注入している場合、データディレクトリのファイルは 4 つのソースのうち最も優先順位が低いことに注意してください。エンジンは次の順で、上から解決します。

--license <path>（または構成ファイル内の LicenseFile）
OLIVARES_LICENSE_PATH=<path>
OLIVARES_LICENSE=<blob> — 環境内に直接指定したライセンス
<data-dir>/license.key — license install が書き込むもの

license install は、これから書き込むファイルより override が優先されていることを検出できる場合に拒否します。その override の下にインストールすると、エンジンが決して読まないファイルが残り、変更がないのに exit 0 と表示されます。検出した override も表示します。--force はそれでもファイルを準備します。これは、これから override を削除する場合に正当です。

このコマンドは OLIVARES_LICENSE_PATH と OLIVARES_LICENSE を自身のプロセス環境から読み取ります。すでに別プロセスとして稼働しているエンジンに渡された --license flag（または構成内の LicenseFile エントリ）を検出できません。 install と uninstall は、そもそも --license flag を受け付けません。したがって、サービスが明示的なパスで起動されたホストでは、どちらのコマンドも成功終了しながら、エンジンが読み取る内容を何も変更しないことがあります。

どちらかを実行した後は、olivares license status を実行してください。エンジンと同じ優先順位で解決し、実際に有効なソースを表示します。これこそが重要な問いです。

2 · インストール済みの内容を確認する

olivares license status --data-dir /var/lib/olivares

status はオフラインで動作し、エンジンと同じ優先順位でライセンスを解決します。そのため「ファイルがあるか」ではなく、重要な問いである実際に有効なライセンスはどれかに答えます。解決したソース、保持者、プラン、有効期限を表示します。

インストールするたび、また override を削除した後に実行してください。

3 · Community → Business、インプレース

ライセンスをインストールすると、エンタープライズバイナリをダウンロードできます。再インストールは不要で、データも移動しません。

olivares upgrade --enterprise --token <TOKEN>

プラットフォーム用の署名済みエンタープライズビルドを取得し、署名をオフラインで検証します。改ざんされたアーティファクトはアップグレードを中止させ、稼働中のバイナリは変更されないままです。その後アトミックに置き換え、以前のバイナリのバックアップを保持します。適用せずに計画を確認するには、先に --check を実行します。

olivares upgrade --enterprise --token <TOKEN> --check

サービスを再起動してから、アドオンを有効にします。

olivares enterprise enable <preset>     # starter | regulated | full

有効化は管理され、監査されます。最初に diff を表示し、シークレットやレビューが必要なアドオンは半端に有効化せず、準備状態に置きます。olivares enterprise status は有効なものを報告します。これらのコマンドはエンタープライズバイナリにのみ存在します。 olivares enterprise がコマンドとして存在しない場合、まだ Community ビルドが稼働しており、上記の切り替えは完了していません。

ライセンスを削除する

olivares license uninstall --data-dir /var/lib/olivares --yes

このコマンドは <data-dir>/license.key を削除し、削除した内容を報告します。install と同様に、 OLIVARES_LICENSE* override を検出できる間は拒否します。そのファイルは実際に有効なものではなく、削除しても何も変わらないためです。また、同じ盲点があります。別プロセスで稼働するエンジンに渡された --license flag は、このコマンドからは見えません。これはコンソール自身の DELETE /v1/console/license のオフライン側です。

ライセンスを削除しても、実行していたものは何も無効になりません。証明を取り下げるだけであり、元に戻すまでエンタープライズバイナリはエンタープライズバイナリとして動作し続けます。

このページに含まれない内容

ライセンスの発行（license keygen / sign）は、同じコマンドのベンダー側の操作です。顧客には必要ありません。
各プランの内容は料金ページにあり、ここでは扱いません。
このモデルの仕組み — サブスクリプションがスイッチではなくアーティファクトへのアクセスである理由 — はオープンコアとライセンスで説明しています。