くいんとライセンスシステム ユーザーズマニュアル 第 7 版 /7

Transcription

1 くいんとライセンスシステム ユーザーズマニュアル 第 7 版 /7

2 版権 2006 株式会社くいんと 本マニュアルを株式会社くいんとの書面による許可なく複製 送信 複写 情報検索のために保存すること および他の言語に翻訳することを禁じます 本マニュアルに誤りや不正確な記述があった場合も 株式会社くいんとはいかなる責任 債務を負わないものとします 本マニュアルの記載内容は予告なしに変更されることがあります 本マニュアル内の画像 表記などは実際と異なる場合があります ソフトウェアライセンスについて 製品の合法的な使用方法については ライセンス契約に明記しています 許可なしにソフトウェ アの全部または一部を印刷 保存 検索などの目的に使用および複製することを禁じます ライセンス 商標について弊社のライセンスサーバは米国 Acresso Software の FLEXNET Publisher( 旧商品名 FLEXlm) を使用しています その他の製品および会社名は一般に各会社の商標または登録商標であり 本書の説明および所有者の権利のためにのみ使用されます この使用によって所有者の法律上の権利を侵害するものではありません 株式会社くいんと

3 目次 目次 1 はじめに バージョンアップ (Windows 版 ) 新規インストール インストールの流れ ドングルドライバーのインストール Windows 版のインストール WinXX フォルダの setup.exe を実行 Windows サービスを開始 UNIX/Linux 版のインストール ライセンスサーバーモジュールの展開 ライセンスサーバーの実行 プロダクトをインストールしたマシンの設定 ライセンスサーバーモジュールの削除 ライセンスを更新するには 問題が発生したときは... 13

4

5 1. はじめに 1 はじめに このマニュアルは 弊社ソフトウェア製品 ( 以下プロダクトといいます ) を利用するために最低限必要な FlexNet Publisher の設定方法を簡単にまとめたマニュアルです FlexNet Publisher の詳細 高度な使い方は 同梱の License Administration Guide (fnp_licadmin.pdf) をご覧下さい 弊社では ライセンス管理システムを 2006 年から順次 Qlock から FlexNet Publisher に移行してきました Qlock をお使いのお客様は 契約上現在のものと同時利用することができませんので アンインストールしてください ただし 過去のプロダクトを継続してご利用になる場合はこの限りではありません このパッケージには FlexNet Publisher が含まれています OPTISHAPE-TS 2013 VOXELCON 2013 AMDESS 2013 より 利用する FlexNet Publisher を から へバージョンアップします そのため 各製品のバージョン 2013 以降を実行するには ライセンスサーバーも 以降を利用してください 1

6

7 2. バージョンアップ (Windows 版 ) 2 バージョンアップ (Windows 版 ) ここでは Windows 版の 以前の FlexNet Publisher から にバージョンアップする方法を説明します 新規に FlexNet Publisher をインストールする場合や UNIX/Linux 版は次のセクションへ進んでください にバージョンアップするには (1) 以前の FlexNet Publisher をアンインストールし (2) を新規にインストール必要があります (1) 以前の FlexNet Publisher をアンインストール 以前の FlexNet Publisher をアンインストールしただけでは サービスは削除されません まずサービスを削除してからアンインストールしてください まず LMTOOLS を起動しライセンスサーバーを停止させ くいんとのライセンスサービスを削除します 次に コントロールパネルから Quint License Manager を削除します 詳しくは インストールしている FlexNet Publisher のマニュアルをご覧ください (2) を新規にインストール を新規にインストールします 次のセクション 3 新規インストール に進んでくださ い 1

8 3. 新規インストール 3 新規インストール ここでは 新規にライセンスサーバーをインストールする方法を説明します 3-1 インストールの流れ ライセンスの形態 ライセンスサーバーの OS によってインストール手順は異なります ライセンスの形態には ID としてドングルの FLEX-ID を利用するかマシン ID を利用するかに分かれます さらに ライセンスサーバーの OS によってインストールするモジュールが異なります お使いのライセンス形態と OS に合った手順でインストールしてください ライセンス形態 ドングル マシン ID ドングルドライバーの インストール OS Windows UNIX/Linux Windows 版のインストール UNIX/Linux 版のインストール 2

9 3. 新規インストール 3-2 ドングルドライバーのインストール この作業は ドングルを利用する場合のみ必要です ドングルを利用しない場合は次のセクションへ進んでください ドングルを利用するには FLEXid 9 のドングルを認識するためのドングルドライバーが必要です CD に同梱されている FLEXId_Dongle_Driver_Installer.exe を実行してインストールしてください (1) インストーラーを実行します >> FLEXId_Dongle_Driver_Installer.exe をダブルクリックします (2) FLEXid9 のドライバーをインストールします >> FLEXid 9 Drivers のみチェックを付けて Next をクリックします (3) 次へ進みます >> FLEXid 9 Drivers がインストールされることを確認して Next をクリックします 3

10 3. 新規インストール (4) インストールが完了したら再起動します >> Yes, I want to restart my computer now をクリックして Finish をクリックしま す 3-3 Windows 版のインストール ここでは Windows 版のライセンスサーバープログラムのインストール方法を説明します Windows 版は 32 ビット版と 64 ビット (x64) 版に分かれています 以下の説明で WinXX はお使いの環境に合わせて適宜 Win32 Win64 に読み替えてください このパッケージのインストーラーを使うことで Windows サービスの設定と Windows ファイアウォールの設定が自動でされます Windows サービス名は QuintLicensingServiceXX で スタートアップ時に自動で開始されます また Windows ファイアウォールの例外に lmgrd.exe と quint.exe がそれぞれ QuintLmgrd QuintDaemon という名前で登録されます Windows 版のインストールをするには 次の (1) WinXX フォルダの setup.exe を実行 (2) Windows サービスの開始 の手順を実行します WinXX フォルダの setup.exe を実行 4

11 3. 新規インストール WinXX フォルダの setup.exe を実行します セットアップが開始されたら インストーラーの 画面の指示に従ってインストールしてください setup.exe の実行は 管理者権限で行ってください Windows サービスを開始 Lmtools を使って Windows サービスを開始します (1) ライセンスファイをコピーします ライセンスファイル quint.lic をインストール先 ( デフォルトでは C: Program Files Quint FLEXNET Publisher) にコピーします (2) サービスを開始します >>[ Start/Stop/Reread] タブをクリックします >>[ Start Services] ボタンをクリックします [Server Start Successful.] と表示されれば成功です サービスが開始できなかった場合は 設定を再度確認し 6 問題が発生したときは を参 考に問題を解決してください 3-4 UNIX/Linux 版のインストール ここでは UNIX/Linux 版ライセンスサーバーモジュールのインストール方法を説明します ライセンスサーバーモジュールの展開 (1) CD-ROM もしくはダウンロードしたパッケージを開き [FLEXNET Publisher] フォルダ内 5

12 3. 新規インストール の [Licensing_Module] にある ご利用になるプラットフォームのフォルダ内の tar ファイル をライセンスサーバとして使用するマシンの任意のディレクトリにバイナリ転送します (2) tar ファイルを展開し 適宜実行権限を変更します ライセンスサーバーの実行 ライセンスサーバーはデーモンとして実行されます 実行には root 権限は必要ありません セキュリティ上の観点から root 以外のユーザーでサーバを起動してください (1) 弊社からメールで送付されたライセンスファイル (quint.lic) をインストール先に保存します PC から転送する場合は アスキーモードで転送します (2) 以下のコマンドを実行し ライセンスサーバーを起動します./lmgrd c quint.lic l quint.log 3-5 プロダクトをインストールしたマシンの設定 ここでは プロダクトをインストールしたマシンの設定方法を説明します プロダクトをインストールしたマシンでは 環境変数 QUINT_LICENSE_FILE に次の書式でポート番号とサーバーマシン名を設定する必要があります 詳しくは License Administration Guide の Locating Licenses をご覧下さい QUINT_LICENSE_FILE の書式 port@host ポート番号 (port) にはライセンスサーバーと通信するポート番号を記述します port は必ず記述してください port が省略された場合 から まで自動で検索します host にはネットワーク上のライセンスサーバー名を記述します ライセンスサーバーとプロダクトを実行するマシンが同じ場合は host に を記述します 通常 Windows 版プロダクトのインストーラーでインストールした場合は インストール時にこの環境変数の設定を行いますが プロダクトのインストール時にライセンスサーバのマシンを設定しなかった場合や UNIX/Linux 版プロダクト ライセンスサーバのマシンを変更した場合 以下の手順で環境変数を設定してください Windows (1) システムのプロパティを開きます >>[Windows] キー ( ) を押しながら [Pause/Break] キーを押下します 6

13 3. 新規インストール (2) 環境変数ウィンドウを表示します >>[ 詳細設定 ] タブをクリック >>[ 環境変数 ] ボタンをクリック (3) 変数入力ウィンドウを表示します >> ユーザー環境変数側の [ 新規 ] ボタンをクリックそのマシンすべてのユーザーに対して有効にするにはシステム環境変数の [ 新規 ] ボタンをクリックします (4) 環境変数を入力します >> 変数名に QUINT_LICENSE_FILE を入力 >> 変数値に port@host を入力 7

14 3. 新規インストール UNIX/Linux ターミナル上で以下のコマンドを実行します B シェル系の場合 export QUINT_LICENSE_FILE=port@hostname C シェル系の場合 setenv QUINT_LICENSE_FILE=port@hostname 8

15 4. ライセンスサーバーモジュールの削除 4 ライセンスサーバーモジュールの削除 ここでは ライセンスサーバーモジュールの削除方法を説明します Windows 版は 以下の手順でサービスを削除してから プログラムの追加と削除 で削除してください ライセンスサーバーモジュールの削除は 次の手順で行います (1) プロダクトの終了 (2) ライセンスサーバーの停止 (3) ライセンスサーバーモジュールの削除 (Windows 版はサービスの削除も ) Windows (1) プロダクトを終了します (2) ライセンスサーバーを停止します >>Lmtools を実行 >>[Start/Stop/Reread] タブの [Stop Server] ボタンをクリック (3) 登録したサービスを削除します >>[Config Services] タブの [Remove Services] ボタンをクリック (4) ライセンスサーバーモジュールを削除します >> コントロールパネルから プログラムの追加と削除 を開きます >> Quint License Manager を選択して 削除 ボタンをクリックします 9

16 4. ライセンスサーバーモジュールの削除 UNIX/Linux (1) プロダクトを終了します (2) ライセンスサーバーを停止します./lmutil lmdown -c quint.lic このコマンドを実行する lmutil - Copyright (c) Acresso Software Inc. All Rights Reserved. Port@Host Vendors 1) 27000@localhost.localdomain quint Are you sure (y/n)? y 1 FLEXnet License Server shut down 上記のホストで正しければ y を入力する 詳しくは License Administration Guide の Using License Administration Tools をご覧下さ い (3) ライセンスサーバーモジュールを削除します 10

17 5. ライセンスを更新するには 5 ライセンスを更新するには ここでは ライセンスサーバーモジュールはインストール済みで 新しいラインセンスファイルに更新する方法を説明します 保守契約を更新したり 契約内容を変更した場合 新しいライセンスファイルが送付されます 新しいライセンスファイルが送付されたら 以下の手順でライセンスファイルを差し替えて 新しいライセンス内容をライセンスサーバーに反映させてください (1) 既存のライセンスファイルを新しいライセンスファイルに差し替える (2) ライセンスサーバーを再起動する (Windows) / lmreread を実行する (UNIX) Windows (1) 既存のライセンスファイルを新しいライセンスファイルに差し替えます >> 念のため既存のライセンスファイルをバックアップしてから 新しいライセンスファイルで上書きコピーします (2) ライセンスサーバーを再起動します >>Lmtools を実行します >> LMTOOLS ignores license file path environment values にチェックを付けます >> くいんとのサービスを選択し Start/Stop/Reread タブの Stop Server ボタンをクリ ック後 Start Server ボタンをクリック UNIX/Linux (1) 既存のライセンスファイルを新しいライセンスファイルに差し替えます >> 念のため既存のライセンスファイルをバックアップしてから 新しいライセンスファイル 11

18 5. ライセンスを更新するには で上書きコピーします (2) lmreread を実行します./lmutil lmreread -c quint.lic このコマンドを実行する lmutil - Copyright (c) Acresso Software Inc. All Rights Reserved. lmreread successful このメッセージが出力されれば成功詳しくは License Administration Guide の Using License Administration Tools をご覧下さい 12

19 6. 問題が発生したときは 6 問題が発生したときは ここでは ライセンスサーバーが起動しない ライセンスが取得できないなど 問題が発生したときの対処方法を説明します 通常 問題が発生た場合は プロダクトがエラーメッセージを出力したり ライセンスサーバー (lmgrd ベンダーデーモン) がデバッグログに原因 ( エラーコード ) を出力します このデバッグログから原因を把握し 以下のプロセスのどこに問題があるか追跡してください デバッグログは Windows では lmtools で指定したファイル UNIX/Linux では-l オプションで指定したファイルです エラーコードは 例えば次のような書式でデバッグログに出力されます この例では エラーコードは-15 です Can't connect to license server system (-15,12:61) Connection refused このエラーコードの意味を License Administration Guide の Error Codes を参照して探し 対処してください この例では プロダクトがライセンスサーバーと通信できないことを意味しています 従って ネットワークケーブルが抜けていないか プロダクトを実行するマシンで QUINT_LICENSE_FILE の設定がされているか ファイアウォールで通信がブロックされていないかなど原因を探ります 13

20 6. 問題が発生したときは 以下に ライセンスサーバー起動プロセスとライセンス要求プロセスを示します まず ライセンスサーバー開始コマンドが実行されると このライセンスサーバー起動プロセスが実行されます ライセンスサーバーが起動できないときは このプロセスの中に問題があると考えられます ライセンスサーバー起動プロセス lmgrd ベンダーデーモン ライセンスファイル読み込み A ベンダーデーモン起動 B ライセンスファイルの SERVER 行から 正しいファ イルか判断する ライセンス要求があるまで 待機する ライセンスサーバーが正常に起動した状態で ユーザーがプロダクトを実行しようとすると このライセンス要求プロセスが実行されます ライセンスサーバーが起動しているのに プロダ クトが実行できないときは このプロセスの中に問題があると考えられます 14

21 6. 問題が発生したときは プロダクト ライセンス要求プロセス ライセンスサーバー C ライセンスサーバー検索 ベンダーデーモンのポート番 号問い合せ D ライセンス要求送信 ファイアウォール ベンダーデーモンの ポート番号返却 許可 / 拒否を返答 必要に応じて機能の使用の 許可 / 拒否を決定 以下に お問い合わせの多い問題と解決方法を挙げます (1) ベンダーデーモンが起動できない現象 : ライセンスサーバー起動プロセスのステップ A で 次のようなデバッグログを出力してベンダーデーモンが起動できない 17:50:09 (lmgrd) quint exited with status 0 signal = 17 17:50:09 (lmgrd) Since this is an unknown status, license server 原因 : カーネルや glibc のバージョンがベンダーデーモンのビルド環境と合わないことが考えられます 対処 : RedHat5_EM64T をご利用の場合は RedHat3_EM64T フォルダのライセンスサーバーモジュールを試してみてください その他の場合は 弊社サポートまでご連絡ください (2) COMPOSITE が一致しない現象 : ライセンスサーバー起動プロセスのステップ B で ライセンスファイルの COMPOSITE と実際にベンダーデーモンが取得した COMPOSITE が異なるためライセンスサーバーが開始できない 11:54:35 (quint) Wrong hostid on SERVER line for license file: 11:54:35 (quint) C: Program Files Quint FLEXNET Publisher quint.lic 11:54:35 (quint) SERVER line says COMPOSITE=XXXX, hostid is COMPOSITE=YYYY 15

22 6. 問題が発生したときは 11:54:35 (quint) Invalid hostid on SERVER line 原因 :FLEXNET Publisher のバグです 対処 : 以外の FLEXNET Publisher を使ってください (3) ライセンスサーバーは起動しているのにプロダクトが利用できない現象 : ライセンスサーバーは正常に起動しているのに プロダクトがライセンスを取得できない 原因 1: 環境変数 QUINT_LICENSE_FILE に正しい値がセットされていない可能性があります そのため ライセンス要求プロセスのステップ C で どのマシンに問い合せればいいかわからずエラーになります 対処 1: 環境変数 QUINT_LICENSE_FILE に正しい値をセットしてください 原因 2: ネットワークケーブルが抜けている可能性があります 対処 2: ネットワークケーブルを接続してください 原因 3: ライセンス要求プロセスのステップ D でファイアウォールで通信がブロックされている可能性があります この場合 プロダクトは次のようなメッセージを出力します FLEXnet Licensing error:-15,570. System Error: "WinSock: Invalid argument" 対処 3:FLEXNET Publisher の通信ができるように ファイアウォールの設定を変更してください 原因 4: プロダクトを実行するマシンの時刻とライセンスサーバーの時刻が大きくずれている可能性があります この場合 プロダクトは次のようなメッセージを出力します Clock difference too large between client and license server system. FLEXnet Licensing error:-34,147. System Error: "" 対処 4: プロダクトを実行するマシンの時計とライセンスサーバーの時計を正しい時刻に合わせてください 原因 5: ライセンスがロックされ 利用可能なライセンスがない 対処 5: ロックされたライセンスを解放したい を参照して ライセンスを解放してください 原因 6: ライセンスサーバーに非常に大きな負荷がかかっている可能性があります ライセンスサーバーで高負荷の処理をさせていると 正常にライセンス管理処理ができない場合があります 対処 6: ライセンスサーバーに負荷がかからないようにするか ライセンスサーバーの移設を検討してください (4) ロックされたライセンスを解放したい現象 : プロダクトを使用しているユーザーがいないにもかかわらず ライセンスサーバーのデバッグログに Licensed number of users already reached と出力される 原因 : プロダクトが異常終了したり ネットワークに障害が発生し ライセンスがロックされた可能性があります 対処 : ロック後 2 時間で自動的に解放されるのを待つか lmremove で強制的にライセンスを解放してください 16

23 6. 問題が発生したときは./lmutil lmremove h feature server_host port handle ここで feature server_host port handle は lmstat a を実行して調べてください./lmutil lmstat a このコマンドを実行する lmstat - Copyright (c) Acresso Software Inc. All Rights Reserved. Flexible License Manager status on Thu 7/16/ :18 License server status: 27000@server_host License file(s) on server_host: quint.lic: server_host: license server UP (MASTER) v10.8 Vendor daemon status (on server_host): quint: UP v10.8 Feature usage info: Users of feature: (Total of 1 license issued; Total of 1 license in use) "feature" v , vendor: quint floating license user user_host display (v ) (server_host/port handle), start Thu 7/16 11:54 詳しくは License Administration Guide の Using License Administration Tools をご覧下さい (5) 問題が解決しないとき 上記の確認をしても解決しない場合は プロダクトのエラーメッセージ ライセンスサーバーの デバッグログを添付の上 弊社サポートまでご連絡ください 17