症状:
- Unity から Pixyz のフローティングライセンを購入したばかりで、インストールに関するガイダンスを探しています。
- ライセンスを購入したばかりですが、ライセンスが見つからない理由を解明しようとしています。
- サーバーの識別子を伝えようとしていますが、どこで見つければよいかわかりません。
解決策:
目次
- 導入
- 要件
- 自動インストール
- サーバーのアクティベーション
- 手動インストールとアクティベーション
- Pixyz「クライアント」に接続し、製品の使用を開始する
- トラブルシューティング
- アンインストール
導入
この記事は、FlexNet の新しい Pixyz ユーザーや IT チームで、初めて設定する必要がある方を対象としています。FlexNet はフローティングライセンス管理サーバーであり、会社のネットワーク内で多くのPixyz ユーザーがライセンスにアクセスできるようにします。
契約を更新する場合や Flexlm ツールに既に慣れている場合は、Pixyz ライセンスポータルから直接ライセンストークンを更新し、新しいライセンスファイルを取得できます。問題がある場合は、Unity サポートにお問い合わせください。
他のソフトウェアを管理するために FlexLM または Flexnet を既に使用している場合は、既存のサーバーを使用してPixyzライセンスをホストおよび管理できます。
ネットワークがカスタムのファイアウォール設定で保護されている場合は、ポート設定に移動してください。
要件
少数のフローティングライセンス/同時使用者(100未満)の場合、ほとんどのこれらのシステム制限は、任意のワークステーションで適用可能で利用可能です。
CPU
ライセンスサーバーは、ほとんどCPUを使用しません。
多くのクライアントが(各クライアントがライセンスサーバーとハートビートメッセージを交換する場合)、あるいは高いチェックアウトやチェックインのアクティビティレベル(毎秒数百)がある場合、サーバーが消費する CPU 時間の量は重要になるかもしれません。ただし、ここでも通常、CPU 使用率は高くありません。
メモリ
ライセンスサーバーは、ほとんどメモリを使用しません。
ベンダーデーモンは約 2 MB、コマンドラインライセンスサーバーマネージャー lmgrd は約 2 MBを使用します。
ディスクスペース
ライセンスサーバーによって作成される唯一の出力ファイルは、デバッグおよびレポートログファイルです。
ライセンスアクティビティが多い場合、これらのログファイルは非常に大きく成長します。これらのファイルをどこに置くか、どのくらいの頻度でローテーションおよびアーカイブするかを考慮する必要があります。
ネットワーク幅
ライセンスサーバーは、ネットワークを介して比較的小さなデータ量を送信します。各トランザクション、例えばチェックアウトまたはチェックインでは、通常 1 KB未満のデータが転送されます。
マシン
物理マシンと仮想マシンのみがサポートされています。このインストーラーはコンテナで使用されるべきではありません。
ファイヤーウォール
- サーバーには、Flexlm サーバーの初期化と実行のために 27000〜27009 の範囲でポートが開かれる必要があります。
- Pixyz ベンダーデーモンの実行には、通常 26999 の 2 番目のポートが開かれる必要があります。
自動インストール
ターゲットサーバーでターミナルを開き、Pixyz ウェブサイトのソースから Pixyz Flexlm ライセンスサーバーを自動的にダウンロードするために次のコマンドを実行します。
curl -L https://pixyz-software.com/get_pixyz_flexlm -s -k | /bin/bash
サーバーのアクティベーション
- Pixyz ウェブサイトにログインします。
- プロファイルのライセンス管理セクションに移動します。
- 一つ以上のフローティングライセンスを選択します。
- 検出された識別方法(MACアドレスまたはUUID)を選択します。
- 前のステップで取得したアクティベーション情報を入力します。
- アクティベートされたライセンスをダウンロードし、サーバーにアップロードします。
- その後、以下を実行します:
/opt/flexlm/activate.sh /path/to/uploaded_license.lic
手動インストールとアクティベーション
前提情報:
- インストールプロセスには root/sudo 権限が必要です。
- このステップ・バイ・ステッププロセスは次のデフォルト値を使用します:
- /opt/flexlm - インストールパス
- flexlm:flexlm - サービスユーザー
これらの値を変更する必要がある場合は、コマンド、サービス定義、パーミッションを適宜編集してください。
インストーラのダウンロード
インストールパッケージをダウンロードし、ターゲットサーバーにアップロードします。または、ターミナルで次のコマンドを実行します。
curl -s -k -L https://www.pixyz-software.com/wp-content/uploads/2023/05/pixyz_flexlm_server_11.16.4.1.tar.gz --output ./pixyz_license_server.tar.gz
インストールパスへの展開
sudo tar -xzf pixyz_license_server.tar.gz -C /opt/flexlm --no-same-owner
この時点で、sudo /opt/flexlm/install.sh を実行するか、手動で続行することができます。
必要な依存関係をインストール
Ubuntu の場合
sudo apt-get update && sudo apt-get install lsb-core fuse
Debian の場合
sudo apt-get update && sudo apt-get install lsb-base fuse
sudo ln -s /lib/x86_64-linux-gnu/ld-linux-x86-64.so.2 /lib64/ld-lsb-x86-64.so.3 1> /dev/null 2> /dev/null
サービスのインストール
デフォルトのインストールパスを使用していない場合、サービス定義をインストールする前に /opt/flexlm/services で編集する必要があります。
- flexlm ユーザーとして実行
sudo useradd flexlm --no-create-home -s /bin/bash
sudo chown -R flexlm:flexlm /opt/flexlm
sudo cp /opt/flexlm/services/FNP.service /etc/systemd/system/FNP.service
sudo cp /opt/flexlm/services/pixyz-flexlm.service /etc/systemd/system/pixyz-flexlm.service - root ユーザーとして実行
重要: 安全上の理由からサーバーを root として実行することは推奨されません。sudo chown -R root:root /opt/flexlm
sudo cp /opt/flexlm/services/FNP.service /etc/systemd/system/FNP.service
sudo cp /opt/flexlm/services/pixyz-flexlm-root.service /etc/systemd/system/pixyz-flexlm.service
サービスを有効にする
sudo systemctl enable FNP
sudo service start FNP
sudo systemctl enable pixyz-flexlm
sudo service start pixyz-flexlm
注意: サーバーの実行にはアクティベートされたライセンスファイルが必要です。以下のセクションを参照してください。
サーバーアクティベーション情報の取得
ホスト名
/opt/flexlm/bin/lmutil lmhostid -hostname -n
ホスト名が空の場合、サーバーのパブリックIPを使用してください。
AWS EC2インスタンス用のパブリックエラスティック IP は以下を実行して取得できます:
/opt/flexlm/bin/lmutil lmhostid -ptype AMZN -eip
サーバーID
物理マシンとクラウドベースの VM でアクティベーションプロセスが異なります。
- 物理マシン:
/opt/flexlm/bin/lmutil lmhostid -ptype PHY -n
注意: 発行されたMACアドレスのうち、アクティベーションに1つのみを選択してください。 - クラウドベースの VM:
/opt/flexlm/bin/lmutil lmhostid -ptype VM -uuid
AWS EC2 は MAC アドレス識別を使用する必要があります。
署名付きライセンスのインストール
本 KB 内のサーバーアクティベーションセクションに従ってください。
アップロードされたアクティベートされたライセンスを手動でインストールするには、次のようにします:
sudo service stop pixyz-flexlm
sudo cp ./pixyz_licence.lic /opt/flexlm/licenses/pixyz_license.lic
sudo service start pixyz-flexlm
ライセンスが実装されていることを確認します。
/opt/flexlm/pixyz-flexlm.sh status
Pixyz「クライアント」に接続し、製品の使用を開始する
Pixyz Studio:
Pixyz Studio の例を以下に示します:
Pixyz SDK:
Pixyz SDK では次のAPIを利用してください - core.configureLicenseServer。
core.configureLicenseServer("company-server-hostname", 27000, True)
環境の構築方法については次のKBを参照してください - Pixyz SDK の Python API 環境の構築するにはどうすればいいですか?
トラブルシューティング:
-
ライセンスサーバーが実行されていることを確認します
ライセンスサーバーで以下を実行します:/opt/flexlm/services/pixyz-flexlm.sh status
デーモンのステータスとバージョンが出力され、インストールされたライセンスで利用可能なトークンが続けて出力されるはずです。 -
クライアントソフトウェアからライセンスサーバーが見つからない
- ライセンスサーバーが実行されていることを確認してください。
- サーバーがクライアントから到達可能であることを確認してください。
- サーバーのインバウンドポート 26999 から 27010 がマシンおよびファイアウォールで開かれているか確認してください。
- クライアントのアウトバウンドポート 26999 と 27000 が開かれていることを確認してください
- ホスト名ではなくサーバーのパブリックIPを使用します。
-
必要なベンダーデーモンがダウンしている
- ライセンスサーバーが実行されていることを確認してください。
- ライセンスが /opt/flexlm/licenses/pixyz-license.lic に正しくインストールされていることを確認してください。
- /opt/flexlm/logs/lmgrd.log を読み、希望のホスト名とサーバーIDを確認してください。
- このガイドの「サーバーアクティベーション情報の取得」セクションを確認し、ホスト名とサーバーIDがライセンスファイルに正しく登録されていることを確認してください。
-
インストーラー実行中に「ファイルがすでに使用されています」というエラーが出る
FlexLMサーバーが既に実行中です。以下を実行してサービスを停止してください:sudo service stop pixyz-flexlm
そして再度インストーラーを実行します。
sudo service stop FNP
-
既存の flexlm インストールに PIXYZ ベンダーを追加する
インストールパッケージを解凍し、bin/PIXYZ ファイルを既存の flexlm インストールディレクトリにコピーします。
アクティベーションプロセスに従って署名済みライセンスファイルをインストールし、flexlm サービスを再起動します。
アンインストール
sudo service stop pixyz-flexlm
sudo service stop FNP
sudo rm /etc/systemd/system/FNP.service /etc/systemd/system/pixyz-flexlm.service
sudo rm -R /opt/flexlm
参考情報: