Qtブログ(日本語)

CocoをQt License Server (QLS) へ移行

作成者: Qt Group 日本オフィス|Oct 23, 2025 12:17:40 AM
このブログは「Migrating Coco to the Qt License Server (QLS)」を翻訳・一部加筆したものです。

Coco 7.4.0より、Cocoは主要なライセンス管理機構としてQt License Server (QLS)を採用いたします。

この変更により、Cocoは他のQt製品と整合性を保ち、エコシステム全体で統一されたライセンス管理機構を提供します。QLSの導入により、以下の利点が得られます。

  • ライセンス管理の一元化
  • 実行時の使用状況追跡
  • 詳細な使用状況レポート

概要については、Qt License Serverのドキュメントをご参照ください。

Cocoユーザーに影響する変更点

Coco 7.4.0以降では、Qt License Server(QLS)が従来のライセンスサーバーに代わり、必須のライセンス管理機構となります。cocolicserverおよびcocoserver.cfgファイルを使用した既存の従来型設定は、設定ファイル内のライセンスが有効期限切れになるまで有効です。

ライセンスキーの有効期限が切れた後は、QLSへの移行が必須となります。以下のセクションでは、ご利用環境に適したQLS導入オプションを説明します。各シナリオには、移行作業のガイドとなる設定手順へのリンクが含まれています。

QLSの使用シナリオ

ご利用の環境に応じて、QLSは様々な方法でお使いいただけます。

1. デフォルト: クラウド QLS

デフォルトの設定では、https://qls.qt.io にホストされているクラウド Qt License Serverを利用します。このサーバーでは、ライセンスをインターネット経由で Qt がホストするインフラストラクチャから直接取得します。ライセンス管理および使用状況レポートは、Qt カスタマーポータル でご利用いただけます。

2. オンプレミス QLS

組織内でライセンスをホストすることを希望される場合、オンプレミス QLS インスタンスを展開することが可能です。

ライセンスの取得および管理は引き続きクラウド QLS から行われますが、これによりオンプレミスサーバーがクラウドからライセンスをキャッシュすることが可能となります。Coco を使用してアプリケーションをコンパイルする際の同時利用率が高い場合に最適です。また、ライセンス要求時のネットワーク遅延を軽減します。

3. オフラインQLS

完全に接続されていない環境において、オンプレミスQLSはオフラインモードでも動作可能です:

クラウドQLSからライセンスを取得する代わりに、オフラインライセンスファイル(entitlement.json)を使用し、ライセンス管理とレポート作成はコマンドライン経由で手動で行います。

この設定は、エアギャップ環境や高度なセキュリティが要求される設置に有用です。

注記:オンプレミス版およびオフライン版QLSのインストールには、ライセンス管理ツールをダウンロードするための特別な許可が必要となります。Qtカスタマーポータルにてカスタマーリクエストを作成の上、弊社営業部門およびカスタマーサクセスチームまでお問い合わせください。手順については、Qt License Serverインストールのドキュメントをご参照ください。

Qtライセンスサービスの設定

Qt License Serverの配置方法を決定し設定が完了しましたら、CocoがインストールされているデバイスにQtライセンスサービスをインストールする必要があります。

Qt商用ユーザーの皆様へ

  • 既にQt商用版を導入済み、またはQtオンラインインストーラー経由で他のQt製品をインストール済みの場合、QtオンラインインストーラーもしくはQtメンテナンスツールを使用し、Qtライセンスサービスをバージョン3.5.0以上にアップグレードしてください。
  • Cocoプログラムが実行されると、自動的にQtアカウントからライセンスを取得します。
  • 詳細はCocoマニュアルをご参照ください

Qt商用版をご利用でないユーザー様へ

  • Cocoインストール先のlicense-serviceサブディレクトリに同梱されているQtライセンスサービスをご利用ください。
  • Cocoインストール後、以下のコマンドを実行してください。
    cocolic --setup-qls
  • その後、表示される手順に従って設定を進めてください。
  • 詳細はCocoマニュアルをご参照ください

レガシーシステムと互換性

Coco 7.3.0 以前のバージョンをご利用になる必要がある場合、またはレガシーな Coco パッケージ(例:CentOS 7 や Debian 9)を使用する必要がある場合、特別な cocolicserver パッケージ をご用意しております。これは プロキシ として機能し、QLS ライセンス(クラウドまたはオンプレミスサーバーからのもの)をレガシーライセンスに変換します。これにより、ライセンスソースを変更することなく、古い Coco バージョンとの互換性が確保されます。

まとめ

  • Coco 7.4.0以降、既存のライセンス設定は段階的に廃止され、QLSが主要なライセンス管理方式となります。デフォルトの選択肢:Qtがホストするインフラストラクチャを利用したクラウドQLS。
  • 代替案:高同時接続数と低ネットワーク遅延を求める場合はオンプレミスQLS、より厳格な環境ではオフラインQLSをご利用いただけます。
  • 既存のライセンスは有効期限まで引き続きご利用いただけますが、その後はQLSへの移行が必要となります。
  • 古いバージョンのCoco向けに、プロキシのドロップイン置換となるcocolicserverが用意されております。

詳細につきましては、Qt License ServerのドキュメントおよびCocoマニュアルをご参照ください。