サーバーの新しいバージョンへの移行#

新しいバージョンのサーバーでは、異なるサーバーデータベースやサーバー設定が必要になる場合があります。例えば、バージョン 1.6 からバージョン 1.9 を実行したい場合、サーバーには異なる設定が必要になります。

移行プロセスでは、サーバー設定ファイル の serverVersion プロパティの確認が行われます。Unity Licensing Server の現在のバージョンに新しいバージョンとの互換性がないことを検出すると、移行プロセスは以下のメッセージを表示して停止します。

Cannot 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...Done
Scripts to run: 1.9.0
Executing 1.9.0...Done
Stamping version 1.9.0...Done
Successfully migrated from 1.6.0 to 1.9.0

確認が必要な移行例 (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] y

Proceeding with migration...
Backup installed version 1.10.0...Done
Scripts to run: 1.11.0
Executing 1.11.0...Done
Stamping version 1.11.0...Done
Successfully migrated from 1.10.0 to 1.11.0
Enter the server name (e.g. LicenseServer):

移行の仕組み#

setup コマンドは、現在のサーバーのバージョンを検出し、移行の開始前にサーバーのデータを LicensingServerBackups ディレクトリにコピーします。このディレクトリの場所は、サーバーの OS とライセンスサーバーのバージョンによって異なります。

• Linux:

  • バージョン 2.0 以降: /usr/share/unity3d/LicensingServerBackups
  • バージョン 1.x： ~/.config/unity3d/Unity/LicensingServerBackups

• Windows:

  • バージョン 2.0 以降: %PROGRAMDATA%\Unity\LicensingServerBackups
  • バージョン 1.x： %LOCALAPPDATA%\Unity\LicensingServerBackups

データを新しいサーバーのバージョンと互換性を持つように変換することにより、移行が続行されます。移行が完了すると、サーバーの以前の設定時の情報を使って、設定プロセスが開始されます。

許可リストを使用した管理者アクセス#

バージョン 1.x から移行する場合、IP アドレスを使用して管理者アクセスを制御する許可リストを設定している可能性があります。バージョン 2.0 以降に移行する場合、管理者アクセス権を維持するための明示的な手順はありません。許可リストに含まれる IP アドレスは、API の admin エンドポイントと ダッシュボード の管理者モードに引き続きアクセスできます。許可リストに記載された IP アドレスを持つユーザーがダッシュボードにアクセスすると、ログイン画面をスキップして自動的に管理者モードにログインします。

データベースの復元#

サーバーを上位バージョンに移行する際に、setup コマンドによってデータベースファイルのバックアップコピーが自動的に作成されます。復元に失敗すると、以下の重大なエラーメッセージが表示されます。

An 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

サーバーを以前のバージョンに復元するには、以下のステップに従います。

1. 既存のデータベースをターゲットフォルダーに入れます。ターゲットフォルダーは、サーバーの OS とライセンスサーバーのバージョンによって異なります。

   • Linux:

     • バージョン 2.0 以降: /usr/share/unity3d/LicensingServer/data/
     • バージョン 1.x： ~/.config/unity3d/Unity/LicensingServer/data/

   • Windows:

     • バージョン 2.0 以降: %PROGRAMDATA%\Unity\LicensingServer\data\
     • バージョン 1.x： %LOCALAPPDATA%\Unity\LicensingServer\data\

2. ファイルの名前を LicensingServerDb.sqlite に変更します。

その他のリソース#

• setup コマンドの実行 (バージョン 2.0 以降)
• setup コマンドの実行 (バージョン 1.x)