サーバーの新しいバージョンへの移行
Learn how to migrate your Unity Licensing Server to a new version.
読み終わるまでの所要時間 2 分最終更新 9ヶ月前
新しいバージョンのサーバーでは、異なるサーバーデータベースやサーバー設定が必要になる場合があります。例えば、バージョン 1.6 からバージョン 1.9 を実行したい場合、サーバーには異なる設定が必要になります。
移行プロセスでは、サーバー設定ファイル の プロパティの確認が行われます。Unity Licensing Server の現在のバージョンに新しいバージョンとの互換性がないことを検出すると、移行プロセスは以下のメッセージを表示して停止します。
serverVersionCannot start the licensing server. Incompatible version is already installed. Please, make sure to stop existing Licensing.Server service (if it is running) and run setup command.
この非互換性を解決するには、使用している OS に応じたコマンドを実行します。
- Linux: Linuxのターミナルを使用して、として
sudoを実行します。./Unity.Licensing.Server setup - Windows: Windows PowerShell を管理者として開き、を実行します。
.\Unity.Licensing.Server.exe setup
- - -Welcome to Unity Licensing Server setup command line interface.This setup will help you configure your license server and generate server registration request file.- - -Upgrading from 1.6.0 to 1.9.0...Backup installed version 1.6.0...DoneScripts to run: 1.9.0Executing 1.9.0...DoneStamping version 1.9.0...DoneSuccessfully migrated from 1.6.0 to 1.9.0
重要
setup コマンドを実行する前に、Licensing Server サービス を停止してください。
ライセンスサーバーの移行を開始する前に、必ずダウンタイムの計画を立ててください。現在のバージョンとターゲットバージョンによっては、移行に数分かかることがあります。例えば、Unity のラボでは、1.11.0 より前のバージョンから 1.11.0 より後のバージョンへの移行を 3 GB のデータベースで完了するのに 15 分かかりました。
複雑な移行では、先に進む前に確認のプロンプトが表示されます。
確認が必要な移行例 (Windows):
> .\Unity.Licensing.Server.exe setup- - - -Welcome to Unity Licensing Server setup command line interface.This setup will help you configure your license server and generate server registration request file.- - - -Upgrading from 1.10.0 to 1.11.0...This migration can take more than a few minutes. Are you sure you want to run it now? [y/N] yProceeding with migration...Backup installed version 1.10.0...DoneScripts to run: 1.11.0Executing 1.11.0...DoneStamping version 1.11.0...DoneSuccessfully migrated from 1.10.0 to 1.11.0Enter the server name (e.g. LicenseServer):
注
The 移行プロセスでは、サーバーのログファイルに詳細情報が書き込まれますが、新しい情報が表示されるまでに数分かかる場合があります。
移行の仕組み
setupLicensingServerBackups- Linux:
- バージョン 2.0 以降:
/usr/share/unity3d/LicensingServerBackups - バージョン 1.x：
~/.config/unity3d/Unity/LicensingServerBackups
- バージョン 2.0 以降:
- Windows:
- バージョン 2.0 以降:
%PROGRAMDATA%\Unity\LicensingServerBackups - バージョン 1.x：
%LOCALAPPDATA%\Unity\LicensingServerBackups
- バージョン 2.0 以降:
データを新しいサーバーのバージョンと互換性を持つように変換することにより、移行が続行されます。移行が完了すると、サーバーの以前の設定時の情報を使って、設定プロセスが開始されます。
注
If the 移行中にコマンドで問題が発生した場合は、移行がキャンセルされ、データは移行前の状態に復元されます。
許可リストを使用した管理者アクセス
バージョン 1.x から移行する場合、IP アドレスを使用して管理者アクセスを制御する許可リストを設定している可能性があります。バージョン 2.0 以降に移行する場合、管理者アクセス権を維持するための明示的な手順はありません。許可リストに含まれる IP アドレスは、API の エンドポイントと ダッシュボード の管理者モードに引き続きアクセスできます。許可リストに記載された IP アドレスを持つユーザーがダッシュボードにアクセスすると、ログイン画面をスキップして自動的に管理者モードにログインします。
adminデータベースの復元
サーバーを上位バージョンに移行する際に、 コマンドによってデータベースファイルのバックアップコピーが自動的に作成されます。復元に失敗すると、以下の重大なエラーメッセージが表示されます。
setupAn error occurred while restoring a backup.
これは、サーバーが無効な状態であり、以前のサーバーのバージョンを引き続き使用できなくなる可能性があることを示しています。このエラーを修正するには、 ディレクトリのコンテンツを ディレクトリにコピーして、バックアップデータを手動で復元します。
例:
LicensingServerBackups/<your_old_server_version>/LicensingServer├── LicensingServer│ ├── config│ │ ├── key-b4573620-ca22-423f-8d52-e3a767391234.xml│ │ ├── licensing-server-config.json│ │ └── unity.licensing.delegation.key│ ├── data│ └── wwwroot\v1\package\acl│└── LicensingServerBackups └── 1.6.0 ├── config ├── data └── wwwroot
サーバーを以前のバージョンに復元するには、以下のステップに従います。
-
既存のデータベースをターゲットフォルダーに入れます。ターゲットフォルダーは、サーバーの OS とライセンスサーバーのバージョンによって異なります。
- Linux:
- バージョン 2.0 以降:
/usr/share/unity3d/LicensingServer/data/ - バージョン 1.x：
~/.config/unity3d/Unity/LicensingServer/data/
- バージョン 2.0 以降:
- Windows:
- バージョン 2.0 以降:
%PROGRAMDATA%\Unity\LicensingServer\data\ - バージョン 1.x：
%LOCALAPPDATA%\Unity\LicensingServer\data\
- バージョン 2.0 以降:
- Linux:
-
ファイルの名前をに変更します。
LicensingServerDb.sqlite
その他のリソース
- setup コマンドの実行 (バージョン 2.0 以降)
- setup コマンドの実行 (バージョン 1.x)