ドキュメント

サポート

Unity License Server

スタートガイド

サーバー設定 (クイックスタート)

サーバー設定 (上級者向け)

サーバーの管理

トラブルシューティング (サーバー)

Unity License Server

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

Learn how to migrate your Unity Licensing Server to a new version.
読み終わるまでの所要時間 2 分最終更新 1ヶ月前
新しいバージョンのサーバーでは、異なるサーバーデータベースやサーバー設定が必要になる場合があります。例えば、バージョン 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...DoneScripts to run: 1.9.0Executing 1.9.0...DoneStamping version 1.9.0...DoneSuccessfully 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] 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):

移行の仕組み

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
    に変更します。

その他のリソース