.NETインテグレーション利用手順書

(1)

Windows 版 Reprise 設定解説書

C/C++言語ソースコード・アナライザ

第 1.06 版

作成日 2014 年 6 月 23 日最終更新日 2015 年 4 月 09 日

/

(2)

1. Reprise がサポートするプラットフォーム ... 4 2. Reprise のインストール ... 5 3. ユーザアカウント制御が実装されている OS へのインストール ... 6 4. バッチファイルの配置 ... 7 5. ライセンスファイルの配置 ... 8 6. prqa.opt の作成 ... 9 7. ライセンスサーバが利用するポートの変更 ... 10 8. サービスの登録 ... 11 9. サービス登録の確認と開始 ... 13 10. クライアントマシンの設定(Windows) ... 16 11. クライアントマシンの設定(UNIX) ... 17 12. サービスの削除 ... 18 13. ライセンスファイルの入れ替え ... 19 14. Web 管理画面 ... 20 15. Web 管理画面の操作 ... 21 16. オプションファイルの使い方 ... 24 16.1. レポートログの出力... 24 16.2. ライセンスサーバへアクセスできるクライアントを限定 ... 25 16.3. ライセンスのタイムアウト時間を設定 ... 25 17. RLM Log Reader ... 26

(3)

はじめに

(4)

1. Reprise がサポートするプラットフォーム

最新版の Reprise ライセンスマネージャがサポートするプラットフォームは以下になります。 [最新版の Reprise ライセンスマネージャダウンロード先] http://products.programmingresearch.com/Windows/Reprise ※2015 年 4 月 7 日現在の最新版はバージョン 11.1 になります。 [サポートするプラットフォーム]

Windows XP, Vista, 7, 8 (64-bit, 32-bit)

Windows Server 2003, 2008, 2012 (64-bit, 32-bit) Windows 2000 (32-bit)

(5)

2. Reprise のインストール

ライセンスサーバにするコンピュータの任意のディレクトリに Reprise をインストールして下さい。（インストール先が、ユーザアカウント制御が実装されている OS の場合は、3 章「ユーザアカウント制御が実装されている OS へのインストール」をご参照ください） Reprise はインストール CD の中に含まれますが、以下の URL からダウンロードすることもできます。ダウンロード先にいくつかのバージョンのインストーラがある場合は、最新のものをお使いください。インストール・ウィザードでは、特に必要が無い場合、デフォルト設定を選択してください。 http://www.programmingresearch.com/downloads/Windows/Reprise/

(6)

3. ユーザアカウント制御が実装されている OS へのインストール

Windows Vista 以降のユーザアカウント制御をサポートしている OS をお使いになられる場合は、以下の手順に従って、インストールを実施します。

1. Administrator 権限を持っているユーザでログインします。

2. インストーラを右クリックして表示されるポップアップメニューより「管理者として実行」を選択します。

3. ユーザアカウント制御の影響を避けるため、C:\Program Files もしくは C:\Program Files (x86)ディレクトリ配下へのインストールを避けていただくようにお願いいたします。以下の例ではインストール先フォルダを

C:\PRQA\Reprise にしています。

(7)

4. バッチファイルの配置

Reprise 登録用バッチファイルを Reprise のインストールディレクトリと同じディレクトリに配置します。このバッチファイルは、ここでは C:\PRQA\Reprise に配置したと仮定します。バッチファイルは以下の URL からダウンロードすることができます。 http://www.toyo.co.jp/ss/qac/sheet/RepriseSettingBatch.zip なお、各バッチファイルには以下の機能があります。 RepriseConfig.bat Windowsサービスの起動条件を変更するためのバッチファイルです。 REPRISE_HOME :Repriseがインストールされているディレクトリの絶対パス LICENSE_FILE :Repriseのライセンスファイルの絶対パス LOG_FILE :動作ログファイルの絶対パス SERVICE_NAME :Windowsに登録するRepriseのサービス名 REPRISE_PORT :Web管理画面にアクセスするためのポート番号 RegistRepriseAsService.bat RepriseのサービスをWindowsに登録するためのバッチファイルです。 DeleteRepriseService.bat RepriseのサービスをWindowsから削除するためのバッチファイルです。 CreatePrqaOptionFile.bat ご利用環境に対応したprqa.optを作成するファイルです。

(8)

5. ライセンスファイルの配置

ライセンスファイルを Reprise がインストールされているフォルダに配置します。なお、ライセンスファイルを入手するために事前に“QA・C/QA・C++/QA・Verify（Ｒｅｐｒｉｓｅ）ライセンス申請書”に hostid 等をご申請頂く必要があります。申請に必要な hostid の取得に関しましては、製品パッケージに同梱されている“QA・ C/QA・C++/QA・Verify（Ｒｅｐｒｉｓｅ）のライセンスについて”をご参照ください。ライセンスファイルの配置次に RepriseConfig.bat を編集して、インストールディレクトリの絶対パスとライセンスファイルへの絶対パスをお客様の環境に合わせます。

(9)

6. prqa.opt の作成

ライセンス使用許諾書に従って製品をご利用頂くためには、ライセンスの使用ログを継続して蓄積して頂く必要がございます。そして、使用ログを蓄積していくためには、オプションファイルを作成して、その中に所定の設定を含めて頂く必要がございます。CreatePrqaOptionFile.bat は、ログを累積するための最低限の設定を含めたオプションファイルのデフォルトファイル(prqa.opt)を作成するためのバッチになります。

CreatePrqaOptionFile.bat を実行すると、CreatePrqaOptionFile.bat と同じディレクトリに prqa.opt が生成されますので、この prqa.opt を利用してライセンスサーバをお使いください。prqa.opt は、ライセンスサーバ起動時に自動的に読み込まれます。

すでに prqa.opt が存在する場合は、prqa.opt を上書きするのか否かを問い合わせるメッセージが表示されます。 Reprise ライセンスマネージャのバージョン 10 以降では、デフォルトの prqa.opt がインストールされますが、この prqa.opt は必要ないので、Y を入力して上書きしてください。なお、CreatePrqaOptionFile.bat によって生成された prqa.opt に、ユーザがアクセス可能なクライアント等の指定など、設定を追記されている場合は、上書きを中止するため、N を入力してください。

(10)

7. ライセンスサーバが利用するポートの変更

ライセンスサーバは以下の 3 つのポートを利用します。  rlm.exe(ライセンスサーバ本体)が利用するポート (デフォルト 5055)  prqa.exe(Programming research 社の製品を管理するソフト)が利用するポート (デフォルトでは、ライセンスサーバを起動する度に動的にポートが変更されます)  ライセンス管理画面へアクセスするためのポート (デフォルト 5054) もし、これらのポートを変更する必要があるときは、以下の手順に従って、これらのポート番号を変更してください。各ポートは番号が重複しないように設定する必要があります。 rlm.exe のポートの変更方法ライセンスファイルをテキストエディタで開き、SERVER 行の 4 番目の値を変更します。以下の例はポート番号を 5059 に変更する場合の例です。 [変更後] prqa.exe のポートの変更方法ライセンスファイルをテキストエディタで開き、ISV 行に port=xxxx(xxxx はポート番号)を追加します。以下はポート番号を 1234 番にする例です。 [変更前] [変更後] ライセンス管理画面へアクセスするためのポートの変更方法 RepriseConfig.bat(第 5 章ライセンスファイルの配置を参照ください)の環境変数 REPRISE_PORT を任意のポート番号に変更します。以下はポート番号を 5099 番にする例です。 [変更後]

(11)

8. サービスの登録

Reprise を Windows サービスとして登録します。手順は以下です。 1. Administrator 権限を持っているユーザでログインします。 2. コマンドプロンプトを表示します。  ユーザアカウント制御が実装されている OS の場合は Windows メニューの“プログラムとファイルの検索”に cmd と入力して、cmd.exe を検索します。その後、検索された cmd.exe を右クリックしてポップアップメニューを表示し、「管理者として実行」を選択します。 (ユーザアカウント制御が実装されている OS の場合)

(12)

 ユーザアカウント制御が実装されていない OS の場合はスタートメニューの“ファイル名を指定して実行”を選択します。次に、ファイル名を指定して実行ダイアログに cmd と入力し、コマンドプロンプトを起動します。

(ユーザアカウント制御が実装されていない OS の場合)

3. cd コマンドを使用してカレントディレクトリを Reprise インストールしたフォルダに変更します。 RegistRepriseAsService.batを実行します。

4. コマンドプロンプトに正常に PRQA Reprise License サービスが登録できたことを示すメッセージが表示されることをご確認ください。

(13)

9. サービス登録の確認と開始

1. Windows メニューの[スタート]-[マイコンピュータ]-[管理]よりコンピュータの管理画面を開きます。

(14)

3. 右クリックメニューの[開始]をクリックして PRQA Reprise License サービスを開始します。

4. PRQA Reprise License サービスが実行されているマシンにインストールされているブラウザで以下の URL にアクセスいたします。http://localhost:5054

(15)

6. Status 画面の ISV Servers リストの Server Status 列にある<prqa>ボタンをクリックします

7. License pool status にご申請頂いたライセンスのリストが表示されていれば、正常に Reprise ライセンスサーバが起動していることになります。

(16)

10. クライアントマシンの設定(Windows)

1. PRQALicenceTool.exe を起動します。このアプリケーションは<QA・C / QA・C++のインストール先>\bin もしくは <QA・Verify のインストール先>\Server に配置されています。なお、クライアントマシンの OS に、ユーザアカウント制御が実装されている場合は、管理者権限を持つユーザでログインして、PRQALicenceTool.exe を右クリックし、 [管理者として実行]を選択して実行する必要があります。正常に起動すると、以下のようなライセンス・ウィザードが現れます。 2. 接続先サーバを“ポート番号＠ホスト名(IP アドレス)”の形式で指定します。ライセンスファイルに記載されている SERVER から始まる行の 4 つ目の番号がポート番号になります。通常は 5055 になります。例：SERVER localhost xxxxxxx 5055 ^^^^^^^ 3. <Add>をクリックします。License Files/Server に指定した接続先が追加されます。

(17)

4. <Test>をクリックします。ライセンスサーバと正常に接続できた場合は、”Available Features”にライセンスサーバが所有するライセンス一覧が表示されます。表示されないときは、接続先が正しいのか、ライセンスサーバが起動しているのかを確認してから、再度同じ操作をしてください。 5. ウインドウの右上の＜×＞をクリックして設定を保存します。 6. QA・C もしくは QA・Verify が正常に起動できることを確認します。

11. クライアントマシンの設定(UNIX)

1. クライアントマシンは、環境変数 PRLDHOST の値を参照して、ライセンスサーバに接続します。 2. 環境変数 PRLDHOST の値は以下のフォーマットで指定します。接続先ポート番号は通常 5055 になります。 3. 接続先ポート番号@ホスト名例： [email protected] 4. QAC/QAC++を.cshrc 等のシェルスクリプトの設定を読み込んでから、実行している場合は、シェルスクリプトに記載された環境変数の PRLDHOST の値を環境に応じて書き換える必要があります。

(18)

12. サービスの削除

4 章で Windows に登録した Reprise サービスを削除する場合は、コマンドラインから DeleteRepriseService.bat を実行してください。(ユーザアカウント制御が実装されている OS をお使いの場合は「管理者として実行」を用いてバッチを実行する必要があります。)

(19)

13. ライセンスファイルの入れ替え

ライセンスファイルの入れ替えは以下の手順で実施してください。 (1) DeleteRepriseService.bat を実行します。

(2) Windows サービス一覧から PRQA Reprise License サービスが削除されていることを確認します。 (3) 旧ライセンスファイルを別ディレクトリに移します。 (4) 新ライセンスファイルを Reprise インストールディレクトリに配置します。 (5) RepriseConfig.bat を編集し直して、ライセンスサーバが新ライセンスファイルを参照できるようにします。 (6) RegistRepriseAsService.bat を実行します。

(7) Windows サービス一覧から PRQA Reprise License サービスが登録されていることを確認します。

(20)

14. Web 管理画面

ライセンスサーバでhttp://localhost:5054/にアクセスすると Web 管理画面が表示されます。クライアントからは http://<ライセンスサーバマシン名または IP アドレス>:5054/ にアクセスします。この画面では Reprise ライセンスサーバの状態の表示、設定変更等を行うことができます。Web 管理画面の詳細な操作説明は

http://www.reprisesoftware.com/RLM_Enduser.html を参照してください。

なお、Web 管理画面にアクセスするためのポート番号は RepriseConfig.bat の環境変数 REPRISE_PORT で変更することができます。ファイアウォールの制限でデフォルトの 5054 番のポートを解放することができないときは、

REPRISE_PORT の値を変更してください。

(21)

15. Web 管理画面の操作

Web 管理画面では主に以下の操作を実施することができます。 1. 現在使用されているライセンスの一覧を表示する 2. ユーザが使用しているライセンスを強制的に解放する 3. ライセンスサーバが所有しているライセンスの一覧を表示するこれらの操作手順を下記に記載します。  （現在使用されているライセンスの一覧を表示する） 1.1 左メニューの Status ボタンをクリックします。右ペインにライセンスサーバの状態が表示されることを確認します。

(22)

1.3 Get License Usage が表示されます。GET License Usage ボタンをクリックします

1.4 現在使用されているライセンスの一覧が表示されます。

 （ユーザが使用しているライセンスを強制的に解放する）

2.1 現在使用されているライセンスの一覧を表示します。(1.1～1.4 の手順を参照してください) Remove ボタンをクリックして使用されているライセンスを強制開放します。

(23)

 (ライセンスサーバが所有しているライセンスの一覧を表示する)

3.1 左メニューの Status ボタンをクリックします。右ペインにライセンスサーバの状態が表示されることを確認します。 3.2 ISV Servers リストの Server Status の prqa ボタンをクリックします

(24)

16. オプションファイルの使い方

オプションファイルを利用すると、ライセンスサーバの挙動を細かく設定することが可能です。例えば、クライアントからライセンスサーバへアクセスできるマシンを限定、レポートログの出力を実施すること等ができます。Reprise のプログラムと同じディレクトリ内のオプションファイルが読み込まれます。オプションファイルのデフォルト名は prqa.opt です。オプションファイルの記述を変更したときは、ライセンスサーバを再起動して、変更を反映される必要があります。

16.1. レポートログの出力

オプションファイルに 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 日蓄積する

(25)

16.2. ライセンスサーバへアクセスできるクライアントを限定

オプションファイルに INCLUDEALL オプションを使って、ライセンスサーバへアクセスできるクライアントを限定することができます。INCLUDEALL オプションの利用方法の一例を下記に示します。INCLUDEALL オプションの詳細に関しましては、http://www.reprisesoftware.com/RLM_Enduser.html をご参照ください。

記述方法)

INCLUDEALL user john INCLUDEALL host pc1 INCLUDEALL internet 172.16.7.*

16.3. ライセンスのタイムアウト時間を設定

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 秒に設定されます。)

(26)

17. RLM Log Reader

RLM Log Reader を使用すると、prqa.opt(6 章参照)で指定されるログファイル 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.exe を実行します。以下の画面が表示されます。

3. “RLM Log File” に prqa_usage.log のパス、”Report Output Directory” にレポートの出力先を指定し、Generate ボタンを押下します。 [レポートの見方] 主なレポートについてのみ以下に記載します。・prqa_usage_TotalDuration prqa_usage.log の記録期間全体について、1 ユーザごとに 1 行で製品使用時間の合計が出力されます。（出力例）

User qac Duration (HH:MM:SS) qac-gui Duration (HH:MM:SS) qac-mbrw Duration (HH:MM:SS) qac-psr Duration (HH:MM:SS) qac-baseline Duration (HH:MM:SS) Cecil 0:00:00 13:57:19 4:23:33 0:20:25 0:00:00 Terra 0:00:00 20:11:50 0:41:03 0:03:05 0:00:00

(27)

・prqa_usage_UsageDuration 製品の 1 回の使用ごとに 1 行で、使用開始時刻、使用終了時刻、製品名、バージョン番号、ユーザ名、使用時間が出力されます。（出力例） Checkout Date/Time Checkin

Date/Time Product Version User

Duration (HH:MM:SS) 12/01/2014 11:47:58 12/01/2014 11:48:35 qac-gui 8.1 Terra 0:00:37 12/01/2014 11:49:14 12/01/2014 12:03:34 qac-gui 8.1 Terra 0:14:20 12/01/2014 15:33:21 12/01/2014 15:34:46 qac-mbrw 8.1 Cecil 0:01:25 12/01/2014 15:34:49 12/01/2014 15:34:49 qac-psr 7.2 Cecil 0:00:00 12/01/2014 15:34:51 12/01/2014 15:35:15 qac-mbrw 7.2 Cecil 0:00:24 12/02/2014 11:31:20 12/02/2014 11:31:25 qac-mbrw 8.1 Terra 0:00:05 12/02/2014 11:31:38 12/02/2014 11:34:55 qac-gui 8.1 Terra 0:03:17 12/02/2014 11:34:55 12/02/2014 11:51:29 qac-mbrw 8.1 Cecil 0:16:34 12/02/2014 11:34:55 12/02/2014 11:35:02 qac-psr 8.1 Cecil 0:00:07 使用開始時刻使用終了時刻使用した製品名使用したバージョン使用したユーザ名使用時間

(28)

以上の操作においてご質問等がございましたら、(株)東陽テクニカソフトウェア・ソリューションのサポート担当までお問い合わせ下さい。 (株)東陽テクニカソフトウェア・ソリューション〒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