UNIX 版 Reprise 設定解説書 C/C++言語ソースコード・アナライザ / 第 1.04 版日 2014 年 6 月 23 日最終更新日 2014 年 12 月 9 日作成 Programming Research Ltd. ソフトウェア・ソリューション ©2014 Programming Research Ltd / (株)東陽テクニカ 1 目次 UNIX 版 Reprise 設定解説書 ......................................................................................................................... 1 はじめに .......................................................................................................................................................... 3 1. Reprise がサポートするプラットフォーム ..................................................................................................... 4 2. Reprise のインストール............................................................................................................................. 5 3. ファイルの抽出 ....................................................................................................................................... 5 4. prqa.opt の作成...................................................................................................................................... 6 5. ライセンスファイルの配置......................................................................................................................... 7 6. ライセンスサーバの起動 .......................................................................................................................... 7 7. ライセンスサーバの終了 .......................................................................................................................... 7 8. ライセンスサーバのデーモン化 ................................................................................................................ 8 9. 接続先サーバの設定 .............................................................................................................................. 9 10. ライセンスファイルの入れ替え .................................................................................................................. 9 11. Web 管理画面........................................................................................................................................ 9 12. Web 管理画面の操作 ........................................................................................................................... 10 13. オプションファイルの使い方 ................................................................................................................... 13 レポートログの出力 ........................................................................................................................................ 13 ライセンスサーバへアクセスできるクライアントを限定 ......................................................................................... 14 ライセンスのタイムアウト時間を設定 ................................................................................................................ 14 14. RLM Log Reader .................................................................................................................................. 15 ©2014 Programming Research Ltd / (株)東陽テクニカ 2 はじめに本書では、UNIX 系 OS 上に Reprise ライセンス・マネージャを構築して、開始する手順を解説します。 ©2014 Programming Research Ltd / (株)東陽テクニカ 3 1. Reprise がサポートするプラットフォーム Reprise は下記プラットフォームにインストールしてお使い頂く必要がございます。 (Reprise のバージョン 9.0 の場合になります。) ＜Windows＞ Windows 7 (64-bit, 32-bit) Windows Vista (64-bit, 32-bit) Windows XP (64-bit, 32-bit) Windows 2000 (32-bit) Windows server editions 2000 (32-bit) Windows 2003 Server (32-bit) Windows 2008 Server (64-bit, 32-bit) ＜Linux＞ Red Hat Enterprise Linux 3, 4, 5 (64bit, 32bit) Linux PPC (64-bit) ＜Solaris＞ Solaris 8, 9, 10 ©2014 Programming Research Ltd / (株)東陽テクニカ 4 2. Reprise のインストールライセンスサーバにするコンピュータの任意のディレクトリに Reprise をインストールして下さい Reprise はインストール CD の中に含まれますが、以下の URL からダウンロードすることもできます。ダウンロード先にいくつかのバージョンのインストーラがある場合は、最新のものをお使いください。インストール・ウィザードでは、特に必要が無い場合、デフォルト設定を選択してください。 Windows 版: http://www.programmingresearch.com/downloads/Windows/Reprise/ Solaris 版: http://www.programmingresearch.com/downloads/Unix/Solaris/Reprise/ Linux 版: http://www.programmingresearch.com/downloads/Unix/Linux/Reprise/ 3. ファイルの抽出最初に、インストールを行うライセンスサーバに新しいディレクトリを作成します。Programming Research ツールの推奨インストールディレクトリは/usr/prqa です。 /usr/prqa ディレクトリから以下のコマンドを使用して、供給された tar ファイルからライセンスサーバを構成するファイルを抽出します。 gunzip –c <reprise-version-platform>.tgz | tar –xvf すべてのファイルが/usr/prqa ディレクトリの下の新しいディレクトリに展開されます。 ©2014 Programming Research Ltd / (株)東陽テクニカ 5 4. prqa.opt の作成ライセンス使用許諾書に従って製品をご利用頂くためには、ライセンスの使用ログを継続して蓄積して頂く必要があります。そして、使用ログを蓄積していくためには、オプションファイルを作成して、その中に所定の設定を含めて頂く必要があります。CreatePrqaOptionFile.shは、ログを累積するための最低限の設定を含めたオプションファイルのデフォルトファイル(prqa.opt)を作成するためのスクリプトになります。CreatePrqaOptionFile.shは以下のURLからダウンロードできるzipファイルを展開すると取得することができます。 http://www.toyo.co.jp/ss/qac/sheet/CreatePrqaOptionFile.zip Repriseライセンス・マネージャのインストールディレクトリ配下にCreatePrqaOptionFile.shをコピーして、 sh CreatePrqaOptionFile.sh を実行すると、CreatePrqaOptionFile.shと同じディレクトリにprqa.optが生成されますので、このprqa.optを利用してライセンスサーバをお使いください。prqa.optは、ライセンスサーバ起動時に自動的に読み込まれます。すでにprqa.optが存在する場合は、prqa.optを上書きするのか否かを問い合わせるメッセージが表示されます。もし、アクセス可能なクライアント等の指定など、デフォルトから追記された設定がprqa.optに含まれるようでしたら、上書きを中止するため、nを入力してください。 ©2014 Programming Research Ltd / (株)東陽テクニカ 6 5. ライセンスファイルの配置第 3 章で解凍されたフォルダの直下にライセンスファイルを配置します。なお、ライセンスファイルを入手するため、事前に“QA・C/QA・C++/QA・Verify（Ｒｅｐｒｉｓｅ）ライセンス申請書”で hostid 等をご申請頂く必要があります。申請に必要な hostid の取得に関しましては、製品パッケージに同梱されている“QA・ C/QA・C++/ QA・Verify（Ｒｅｐｒｉｓｅ）のライセンスについて”をご参照ください。 6. ライセンスサーバの起動カレント・ディレクトリを Reprise ライセンス・マネージャ・インストールディレクトリに移動して、以下のコマンドを実行します。 ./rlm -ws <port> -c <lic file path> -ws <port>は用法とステータスの情報を供給するウェブ・サーバのポート番号を示します(デフォルトはポート 5054 になります。5055 はウェブ・サーバのポート番号としてお使いにならないで下さい。) -c <lic file path>はライセンスファイルの配置ディレクトリを示します。 7. ライセンスサーバの終了カレント・ディレクトリを Reprise ライセンス・マネージャ・インストールディレクトリに移動して、以下のコマンドを実行します。 ./rlmutil rlmdown RLM -q ©2014 Programming Research Ltd / (株)東陽テクニカ 7 8. ライセンスサーバのデーモン化以下はライセンスサーバの起動を自動化するスクリプトの一例です。 #!/sbin/sh # set the user account to run the qavservice QAVUSER=root # set the QAV bin directory QAVBIN=/usr/local/prqa/reprise case "$1" in 'start') su "$QAVUSER" -c "$QAVBIN/rlm -c licence.lic -dlog licence.log" & exit 0 ;; 'stop') su "$QAVUSER" -c "$QAVBIN/rlmutil rlmdown RLM -q " exit 0 ;; *) echo "Usage: $0 { start | stop }" exit 1 ;; esac exit 0 ©2014 Programming Research Ltd / (株)東陽テクニカ 8 9. 接続先サーバの設定クライアントは、環境変数 PRLDHOST の値を参照して、ライセンスサーバに接続します。 PRLDHOST の値は以下のフォーマットで指定します。接続先ポート番号は通常 5055 になります。接続先ポート番号@ホスト名例：[email protected] QAC/QAC++を.cshrc 等のシェルスクリプトの設定を読み込んでから、実行している場合は、シェルスクリプトに記載された環境変数の PRLDHOST の値を環境に応じて書き換える必要があります。 10.ライセンスファイルの入れ替えライセンスファイルの入れ替えは以下の手順で実施してください。 (1) (2) (3) (4) ライセンスサーバを停止します。旧ライセンスファイルを別ディレクトリに移します。新ライセンスファイルを Reprise インストールディレクトリに配置します。ライセンスサーバを開始します。 11.Web 管理画面ライセンスサーバで http://localhost:5054/にアクセスすると Web 管理画面が表示されます。クライアントからは http://<ライセンスサーバマシン名または IP アドレス>:5054/ にアクセスします。この画面では Reprise ライセンスサーバの状態の表示、設定変更等を行うことができます。Web 管理画面の詳細な操作説明は http://www.reprisesoftware.com/RLM_Enduser.html を参照してください。 ©2014 Programming Research Ltd / (株)東陽テクニカ 9 12.Web 管理画面の操作 Web 管理画面では主に以下の操作を実施することができます。 1. 2. 3. 現在使用されているライセンスの一覧を表示するユーザが使用しているライセンスを強制的に解放するライセンスサーバが所有しているライセンスの一覧を表示するこれらの操作手順を下記に記載します。  （現在使用されているライセンスの一覧を表示する） 1.1 左メニューの Status ボタンをクリックします。左ペインにライセンスサーバの状態が表示されることを確認します。 1.2 ISV Servers リストの License Usage ボタンをクリックします ©2014 Programming Research Ltd / (株)東陽テクニカ 10 1.3 左ペインに Get License Usage が表示されます。GET License Usage ボタンをクリックします 1.4 左ペインに現在使用されているライセンスの一覧が表示されます。  （ユーザが使用しているライセンスを強制的に解放する） 2.1 現在使用されているライセンスの一覧を表示します。(1.1～1.4 の手順を参照してください) Remove ボタンをクリックして使用されているライセンスを強制開放します。 ©2014 Programming Research Ltd / (株)東陽テクニカ 11  (ライセンスサーバが所有しているライセンスの一覧を表示する) 3.1 左メニューの Status ボタンをクリックします。左ペインにライセンスサーバの状態が表示されることを確認します。 3.2 ISV Servers リストの Server Status の prqa ボタンをクリックします 3.3 左ペインにライセンスサーバが所有するライセンスの一覧が表示されることを確認してください。 ©2014 Programming Research Ltd / (株)東陽テクニカ 12 13.オプションファイルの使い方オプションファイルを利用すると、ライセンスサーバの挙動を細かく設定することが可能です。例えば、クライアントからライセンスサーバへアクセスできるマシンを限定、レポートログの出力を実施すること等ができます。Reprise のプログラムと同じディレクトリ内のオプションファイルが読み込まれます。オプションファイルのデフォルト名は prqa.opt です。オプションファイルの記述を変更したときは、ライセンスサーバを再起動して、変更を反映される必要があります。レポートログの出力オプションファイルに REPORTLOG オプションを使って、ライセンスサーバの利用状況を記録したレポートログを出力することができます。REPORTLOG オプションの利用方法の一例を下記に示します。 REPORTLOG オプションの詳細に関しましては、http://www.reprisesoftware.com/RLM_Enduser.html をご参照ください。記述方法) REPORTLOG [+]file_path [std | small | detailed] auth ※ファイルパスの先頭に＋が付与された場合は、ライセンスサーバの再起動時もレポートログは、上書きされず追記されるようになります。例）std のフォーマットで C:\PRQA\Reprise\PRL_usage.log を出力。レポートログを上書きしない。 REPORTLOG +C:\PRQA\Reprise\PRL_usage.log std auth また、ROTATE オプションを使って、1 ファイルのレポートログにどのぐらいの期間のログを蓄積するのかを設定することができます。蓄積期間が完了したファイルは、report_log_file_name.yyyy.mm.dd というファイル名に自動的にリネームされます。記述方法) ROTATE [daily | weekly | monthly | #days ] 例）ログを 30 日蓄積する ROTATE 30 ©2014 Programming Research Ltd / (株)東陽テクニカ 13 ライセンスサーバへアクセスできるクライアントを限定オプションファイルに INCLUDEALL オプションを使って、ライセンスサーバへアクセスできるクライアントを限定することができます。INCLUDEALL オプションの利用方法の一例を下記に示します。INCLUDEALL オプションの詳細に関しましては、http://www.reprisesoftware.com/RLM_Enduser.html をご参照ください。記述方法) INCLUDEALL [user|host|group|host_group|internet|internet_group|project] who 例）john, pc1, IP アドレスが 172.16.7.x の PC のみが使用できる INCLUDEALL user john INCLUDEALL host pc1 INCLUDEALL internet 172.16.7.* ライセンスのタイムアウト時間を設定 TIMEOUT オプションでは、ライセンスサーバとクライアント間の通信が不能になってから、クライアントのライセンスが自動的に解放されるまでの時間を設定することができます。TIMEOUT オプションは、デフォルトのオプションファイルでは 180 秒に設定されておりますが、必要であればこの値を変更することができます。このオプションを設定することで、クライアントマシンとライセンスサーバとの接続ができなくなり、クライアントマシンがライセンスを保持したままになる状態を防ぐことができます。例）QAC の GUI のライセンスが自動的に解放されるまでの時間を 300 秒に設定する。 TIMEOUT 300 qac-gui 例）QAC++のメッセージブラウザのライセンスが自動的に解放されるまでの時間を 300 秒に設定する。 TIMEOUT 300 qacpp-mbrw ※1 この設定が有効になるためには、ライセンスファイルにタイムアウト情報が記載されている必要があります。タイムアウト情報が記載されているのか否かはライセンスファイルに min_timeout=180 が記載されているか否かで判断してください。この記述が無い場合は、以下のページからライセンス申請書を入手し、必要事項を記入の上、ライセンスの再発行をご申請ください。タイムアウト情報を記述したライセンスファイルを発行させて頂きます。なお、ライセンスファイルを再発行するためには、保守契約が有効である必要がございます。 http://www.toyo.co.jp/ss/qac/licence.html ※2 設定値は 180 秒以上にしてください。(180 秒より短い値を設定しても TIMEOUT は強制的に 180 秒に設定されます。) ©2014 Programming Research Ltd / (株)東陽テクニカ 14 14. RLM Log Reader RLM Log Reader を使用すると、prqa.opt(4 章参照)で指定されるログファイル prqa_usage.log の情報から csv 形式の利用状況レポートを作成することができます。RLM Log Reader は以下から入手することができます。 http://sourceforge.jp/projects/sfnet_rlmlogreader/ 【ご注意】 RLM Log Reader は Reprise ライセンス管理ツールの製造元である Reprise Software 社、QA･C/QA・C++の製造元である Programming Research 社、弊社東陽テクニカが作成したツールではありません。そのため RLM Log Reader の使用方法や動作についてのお問い合わせにはお答えできない場合がありますことをご了承ください。また、以下に簡単な使用方法や主なレポートの見方について述べますが、より詳しくは RLM Log Reader のパッケージ内の README.html を参照ください。 [使用方法] 1. ライセンスサーバの OS に合った RLM Log Reader のパッケージを入手し、適当な場所に展開します。 2. RLMLogReader を実行します。以下の画面が表示されます。 3. “RLM Log File” に prqa_usage.log のパス、”Report Output Directory” にレポートの出力先を指定し、Generate ボタンを押下します。 [レポートの見方] 主なレポートについてのみ以下に記載します。・prqa_usage_TotalDuration prqa_usage.log の記録期間全体について、1 ユーザごとに 1 行で製品使用時間の合計が出力されます。（出力例） User Cecil Terra 使用実績のあるユーザ名の一覧 qac Duration (HH:MM:SS) qac-gui Duration (HH:MM:SS) 0:00:00 0:00:00 13:57:19 20:11:50 ユーザごとの QA･C GUI の合計使用時間 ©2014 Programming Research Ltd / (株)東陽テクニカ qac-mbrw Duration (HH:MM:SS) 4:23:33 0:41:03 ユーザごとの QA･C メッセージブラウザの合計使用時間 qac-psr Duration (HH:MM:SS) 0:20:25 0:03:05 qac-baseline Duration (HH:MM:SS) 0:00:00 0:00:00 ユーザごとの QA･C 解析機能の合計使用時間 15 ・prqa_usage_UsageDuration 製品の 1 回の使用ごとに 1 行で、使用開始時刻、使用終了時刻、製品名、バージョン番号、ユーザ名、使用時間が出力されます。（出力例） Checkout Date/Time 12/01/2014 11:47:58 12/01/2014 11:49:14 12/01/2014 15:33:21 12/01/2014 15:34:49 12/01/2014 15:34:51 12/02/2014 11:31:20 12/02/2014 11:31:38 12/02/2014 11:34:55 12/02/2014 11:34:55 使用開始時刻 Checkin Date/Time 12/01/2014 11:48:35 12/01/2014 12:03:34 12/01/2014 15:34:46 12/01/2014 15:34:49 12/01/2014 15:35:15 12/02/2014 11:31:25 12/02/2014 11:34:55 12/02/2014 11:51:29 12/02/2014 11:35:02 使用終了時刻 Product Version Duration (HH:MM:SS) User qac-gui 8.1 Terra 0:00:37 qac-gui 8.1 Terra 0:14:20 qac-mbrw 8.1 Cecil 0:01:25 qac-psr 7.2 Cecil 0:00:00 qac-mbrw 7.2 Cecil 0:00:24 qac-mbrw 8.1 Terra 0:00:05 qac-gui 8.1 Terra 0:03:17 qac-mbrw 8.1 Cecil 0:16:34 qac-psr 8.1 Cecil 0:00:07 使用した製品名 ©2014 Programming Research Ltd / (株)東陽テクニカ使用したバージョン使用したユーザ名 16 使用時間以上の操作においてご質問等がございましたら、(株)東陽テクニカソフトウェア・ソリューションのサポート担当までお問い合わせ下さい。 (株)東陽テクニカソフトウェア・ソリューション〒103-8284 東京都中央区八重洲 1-1-6 TEL. 03-3245-1248 FAX. 03-3246-0645 E-mail (営業窓口)： [email protected] E-mail (サポート窓口)： [email protected] E-mail(ライセンス窓 [email protected] 口)： URL： http://www.toyo.co.jp/ss Windows, Microsoft は、Microsoft Corporation の登録商標です。 ©2014 Programming Research Ltd / (株)東陽テクニカ 17