TotalView インストールガイド Version 8.x

(1)

TotalView

®

インストールガイド

(2)

No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise without the prior written permission of Rogue Wave Software, Inc. ("Rogue Wave").

Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013.

Rogue Wave has prepared this manual for the exclusive use of its customers, personnel, and licensees. The information in this manual is subject to change without notice, and should not be construed as a commitment by Rogue Wave. Rogue Wave assumes no responsibility for any errors that appear in this document. TotalView and

TotalView Technologies are registered trademarks of Rogue Wave Software, Inc. TVD is a trademark of Rogue Wave.

Rogue Wave uses a modified version of the Microline widget library. Under the terms of its license, you are entitled to use these modifications. The source code is available at:

http://www.roguewave.com/support/knowledge-base.aspx

(3)

TotalView インストールガイド

2014/7 版

はじめに ... 1 全体の流れ ... 1 1. TotalViewダウンロード ... 2 2. TotalViewインストール... 3 3. トライアルライセンスの設定と動作確認 ... 4 4. 正式ライセンスの申請 ... 8 5. 正式ライセンスの設定 ... 9 6. TotalViewのアンインストール（削除）方法 ... 11 7. 参考資料（１） ... 13

はじめに

製品をご購入されたお客様、トライアルで初めてご使用されるお客様も次項の「全体の流れ」を必ずお読みいただき、TotalView のインストールを行って下さい。

全体の流れ

ローグウェーブソフトウェアジャパンお客様 ① TotalViewをダウンロードするための FTPサイト、トライアルキー、およびインストールガイドを電子メールにて送付します。 ② WebブラウザよりFTPサイトにアクセスし、TotalViewをダウンロードして下さい。 ③ TotalViewのインストールを行って下さい。 ④ トライアルキーの設定を行います。（有効期間は約2週間） ⑤ 動作確認を行って下さい。 ※ 評価版ご利用のお客様は、ここまでで終了です。正規製品をご購入のお客様は続けて以下の設定を行って下さい。 ⑦ ホスト名、ホストIDから正式なライセンスキーを作成しお客様に送付します。ライセンスキーは申請があってから、3営業日以内に送付します。 ⑥ ライセンスデーモンを実行するコンピュータのホスト名、ホストIDを取得し、カスタマーサポート（[email protected]）宛に送付して下さい。 ⑧ トライアルキーから正式なライセンスキーに変更して下さい。 ⑨ 動作確認を行い、インストールは終了となります。

(4)

1. TotalView のダウンロード

弊社から送られたFTP サイトから、同じく通知されるログインユーザ名、パスワードを入力してダウンロードページに移動します。

始めのダウンロードページには、TotalView と ThreadSpotter のディレクトリがありますので、 TotalView を選択します。

(5)

ここでは、TotalView インストールファイル（totalview.< VER >-Linux-x86-64.tar）とドキュメントファイル（totalview. <ver>--doc.tar）をダウンロードします。

※< VER >はTotalview のバージョン

2. TotalView のインストール

TotalViewをインストールする場合は、su又はsudoコマンドでrootユーザとして以下を実行して下さい。

2.1 tarファイルの展開

まず始めに、弊社サイトよりダウンロードした tar ファイルを展開します。下記コマンドを実行すると、“totalview-<VER>”ディレクトリが作成され、全てのファイルが展開されます。

tar xvf totalview-<VER>-<ENV>.tar tar xvf totalview-<VER>-doc.tar

※<VER>=バージョン

<ENV>=マシン環境の略称。linux-x86-64、sun5 など。

(6)

新しく作成された“totalview-<VER>”ディレクトリに移動の後、“Install”コマンドで TotalView をインストールしてください。 cd ./totalview-<VER> ./Install Install コマンドを実行すると、メッセージの確認（<CR>：リターンキー）やインストールディレクトリ入力（注２：参照）、インストールモジュールの確認（y 又は n 入力）、シンボリックリンクの作成の可否（注３：参照）の入力を求められます。表示されるメッセージを読んで、該当するキーやディレクトリ名を入力してください。最後に“Installation complete.”が表示されればインストール終了です。 ※ Install コマンドの実行例は 12 ページ「7.参考資料（１）」をご参照下さい。注1.) インストールは“Ctrl+C”で中断できます。注2.) TotalView インストールディレクトリのデフォルトは /usr/toolworks または /opt/toolworks です。インストールディレクトリを変更する場合は、 Enter installation directory name [default /usr]:

という問いに対して、インストールディレクトリ名を入力してください。注3.) インストールを root ユーザ以外で実施した場合、シンボリックリンクが設定できない場合があります。注4.) “./Install -help”でインストールコマンドオプションが確認できます。

3. トライアルライセンスの設定と動作確認

弊社よりお送りしたトライアルライセンスを使い、TotalViewの動作確認をお願いします。ここでは、 TotalViewのインストールディレクトリを“/usr/toolworks”として説明します。 3.1

トライアルライセンスの設定

root ユーザで、弊社よりお送りしたトライアルライセンスファイル（license.demo）を TotalView のインストールディレクトリ直下にある Flexlm ディレクトリ（/usr/toolworks/flexlm-＜VER>）に保存してください。

(7)

TotalView の起動コマンド（/usr/toolworks/totaiview-<VER>/bin/totalview）を実行すると、 TotalView の root ウインドウ（図 3.2.1）と New Program ウインドウ（図 3.2.2）が立ち上がります。

/usr/toolworks/totaiview-<VER>/bin/totalview

図3.2.1

図3.2.2

次に、New Program ウインドウ（図 3.2.2 ）の右上部にある “ Browse ” ボタンを押すと Open:Program パネル（図 3.2.3）が表示されます。ここで各システムに対応したコンパイル済のサンプルプログラム（cppview_example_1～4）を選んでください。

お使いのシステムが linux-x86-64 の場合、サンプルプログラムは下記ディレクトリに格納されています。

(8)

図3.2.3

ここで、Open:Program パネル（図 3.2.3）の“OK”ボタンを押すと、New Program ウインドウの上部（Program:）に選択したサンプルプログラム名が表示されます。

図3.2.4

更に、New Program ウインドウ（図 3.2.4）の“OK”ボタンを押し Process ウインドウ（図 3.2.5）が立ち上がれば TotalView の起動確認は終了です。もし、Process ウインドウが立ち上がらず、 Warning（図 3.2.6）が表示される場合は、ライセンスの設定が正常に行われていません。前節 “3.1 トライアルライセンスの設定”を再度確認してください。

※ 環境によっては、”While loading shared libraries:libstdc++.so.5:Can not open shared object file”のエラーでサンプルプログラムが実行できない場合があります。その場合は、同ディレクト

(9)

リのREADME.ｔｘｔの内容に従ってサンプルプログラムのリビルドを行って下さい。図3.2.5 図3.2.6 3.3

TotalViewの動作テストトライアルライセンスの有効期間

トライアルライセンスは約二週間有効です。正式ライセンスを申請して頂いている間、TotalView をご自由にお使いいだたけます。尚、TotalView のマニュアルは下記ディレクトリにインストールされています。ご参照ください。

/usr/toolworks/totaiview.<VER>/doc/pdf/

(10)

TotalView_User_Guide.pdf の PartⅠ：Introduction にございます。ご参照ください。

4. 正式ライセンスの申請

4.1

サーバ情報の取得

root ユーザとして、ホスト ID 取得コマンド（toolworks_hostid）を実行してください。正式ライセンス申請に必要な情報が標準出力に表示されます。

/usr/toolworks/flexlm-<VER>/bin/toolworks_hostid 出力例：

The host name for this machine is : ****** The host ID for this machine is : ************

注）ホストID を取得するコマンドとして OS の hostid コマンドは使用しないでください。 4.2

正式ライセンスの申請

Toolworks_hostid コマンドを実行して表示された情報を弊社カスタマーサポート（[email protected] ）までメールにてお送りください。後日、正式なライセンスキーをお送りいたします。

(11)

5. 正式ライセンスの設定

正式ライセンスの設定を行う場合は、su 又は sudo コマンドで root ユーザとして以下を実行してください。 5.1

ライセンスマネージャ起動のためのユーザ名

ライセンスマネージャを起動する為に、root 権限を持たないユーザ名が必要です。ライセンス設定コマンド（5.3 参照）では、デフォルトとして“flexlm”というユーザ名を使用していますが勿論他のユーザ名でも構いません。予めご用意ください。 5.2

正式ライセンスの設定

弊社よりお送りした正式ライセンス情報（注１）を、“license.src”というファイル名で TotalView のインストールディレクトリ直下にあるFlexlm ディレクトリ（/usr/toolworks/flexlm-<VER>）に保存してください。

注1.) license.src に保存する情報は、弊社からお送りしたメールの以下の部分です。

## BEGIN ETNUS TOTALVIEW KEY -- ******* ## HOSTID=******

: :

## END ETNUS TOTALVIEW KEY -- ********

5.3 ライセンス制御コマンドとライセンスファイルの生成

Configure_License コマンドは、上記 5.2 で保存したライセンス情報（license.src）を元にライセンス制御コマンド（toolworks_init）と正式ライセンスファイル（license.dat）を生成します。 TotalView のインストールディレクトリ直下にある Flexlm ディレクトリに移動した後、bin ディレクトリ下のConfigure_License コマンドを実行してください。 cd /usr/toolworks/flexlm-<VER> bin/Configure_License Configure_License コマンドを実行すると、メッセージの確認（<CR>：リターンキー）やライセンスマネージャ起動用ユーザ名（注１）、ライセンスマネージャが使用するポート番号、ライセンスファイル（license.dat）、クライアント用ライセンスの生成等について入力や確認を求められます。表示されるメッセージを読んで、該当するキーやユーザ名等を入力してください。エラー情報が表示されず、最後に“Done.”が表示されれば設定終了です。

(12)

Configure_License コマンドが正常に終了すると、次の２ファイルが生成されます。ご確認ください。

/usr/toolworks/flexlm-<VER>/license.dat

/usr/toolworks/flexlm-<VER>/bin/toolworks_init

注1.) 上記 5.1 で設定した root 権限を持たないユーザ名です。デフォルト以外のユーザ名を使用する場合は、

License manager user name [default: flexlm]? という問いに対して、ユーザ名を入力してください。

5.4 ライセンスマネージャの起動と停止

上記5.3 で生成した toolworks_init を使って、ライセンスマネージャの起動（start）と停止（stop）を手動で行う事ができます。ライセンスマネージャを起動した後、前述（3.2 TotalView の動作テスト）に従いTotalView の動作確認を行ってください。ライセンスマネージャの起動：

/usr/toolworks/flexlm-<VER>/bin/toolworks_init start ライセンスマネージャの停止：

/usr/toolworks/flexlm-<VER>/bin/toolworks_init stop

尚、正式ライセンスの設定及びライセンスマネージャの詳細に付きましては下記資料をご参照ください。

・/usr/toolworks/totaiview-<VER>/doc/pdf/TotalView_Instllation_Guide.pdf Chapter2 及び Chapter3

・/usr/toolworks/flexlm-<VER>/README.TXT

5.5 ライセンスマネージャの自動起動

同じくbin ディレクトリ下にある Configure_Autostart を使って、マシンの起動時にライセンスマネージャを自動起動させる設定を行う事ができます。下記コマンドを一度実行しておくと、ライセンスマネージャを実行するマシンの起動（ブート）時に、TotalView のライセンスマネージャを自動起動しますので、前述（5.3）の“toolworks_init start”をマシン再立ち上げ毎に実行する必要がありません。ライセンスマネージャの自動起動コマンド：

(13)

Configure_Autostart コマンドを実行すると、このコマンドで実施される設定の概要が表示され、その後下記メッセージが表示されます。

Rely on native install_initd (y or n)?

ここで、“n”を入力し、さらに”Execute these commands now (y or n)”にｙを入力すると、ライセンスマネージャ自動起動が設定されます。最後に下記メッセージが表示されれば、設定終了です。 /etc/init.d/twlmgrd created! /etc/rc3.d/S95twlmgrd created! /etc/rc5.d/S95twlmgrd created! /etc/rc2.d/S95twlmgrd created! ライセンスマネージャの自動起動設定を解除する場合は次のコマンドを実行してください。ライセンスマネージャ自動起動の解除コマンド：

/usr/toolworks/flexlm-<VER>/bin/Deconfigure_Autostart

5.6 クライアントでのライセンス設定

正式ライセンスを作成すると、/usr/toolworks/flexlm-<VER>にlicense.client というファイルが作成されます。このファイルは、クライアントとしてTotalView を使用するマシンのためのライセンスファイルです。

クライアントマシンに TotalView をインストールしたのち、クライアントマシンの /usr/toolworks/flexlm-<VER>にこのファイルをlicense.dat の名前で登録して下さい。

6. TotalView のアンインストール（削除）方法

TotalView をシステムからアンインストールする場合は、su 又は sudo コマンドで root ユーザとして以下を実行してください。ここでは、TotalView のインストールディレクトリを“/usr/toolworks”として説明します。

6.1 ライセンスサーバの停止

TotalViewインストールディレクトリ下にあるFlexlmディレクトリに移動しtoolworks_initコマンドでライセンスサーバを停止します。

cd /usr/toolworks/flexlm-<VER>/bin ./toolworks_init stop

(14)

6.2 ライセンスマネージャ自動起動設定の解除

前述5.4で、ライセンスマネージャの自動起動設定を行っている場合はDeconfigure_Autostart コマンドで設定を解除してください。

/usr/toolworks/flexlm-<VER>/bin/Deconfigure_Autostart

6.3 TotalViewを削除

TotalViewのインストールディレクトリ以下を全て削除してください。これでTotalViewのアンインストールは終了です。

(15)

参考資料

Install コマンドの実行例: スタンドアロンの Linux 機にインストール先ディレクトリを明示的に指定してインストールする場合

[root@localhost totalview.8.9.1-1]# ./Install

********************************************************************** Install

Install is an interactive shell script to help you install

the TotalView(TM) debugger. You may also perform a non-interactive install using this shell script.

Type './Install -help' for details.

You may ^C out of this script at any time, and start again. When you are asked to type <CR>, press the 'Return' key. Type <CR> to continue ... ←リターンキー

********************************************************************** Please enter the name of the directory to hold the TotalView

installation. The directory you specify must already exist, and you must be able to write into that directory.

This installation script will create a directory named 'toolworks' under the installation directory you specify.

Enter installation directory name [default /usr]: /usr/test/toolworks Using directory '/usr/test/toolworks'

Type <CR> to continue ... ←リターンキー

********************************************************************** Checking for components to install ...

***

Found 'totalview-common.tar.Z' containing:

TotalView common files (required for TotalView on all platforms). Installed size is about 112 MB.

Install totalview-common.tar.Z (y or n)? y ←y リターンキー ... done

***

Found 'totalview-linux-x86-64.tar.Z' containing: TotalView Linux X86_64 platform files.

Installed size is about 74 MB.

Install totalview-linux-x86-64.tar.Z (y or n)? y ←y リターンキー Installing totalview-linux-x86-64.tar.Z to '/usr/test/toolworks' ... done

(16)

続き

***

Found 'license-common.tar.Z' containing:

License (FLEXlm) common files (required for license manager daemon). Installed size is about 2 MB.

Install license-common.tar.Z (y or n)? y ←y リターンキー y

Installing license-common.tar.Z to '/usr/test/toolworks' ... done

***

Found 'license-linux-x86-64.tar.Z' containing: License (FLEXlm) Linux X86_64 platform files. Installed size is about 3 MB.

Install license-linux-x86-64.tar.Z (y or n)? y ←y リターンキー Installing license-linux-x86-64.tar.Z to '/usr/test/toolworks' ... done

********************************************************************** Some users find it useful to create a symbolic link that points to the version-specific installation directory:

'/usr/test/toolworks/totalview.8.9.1-1'

which allows them to add a version-independent directory to their PATH. When new versions are installed and the symbolic link is updated, users will get the new version without needing to update their PATH.

Create the symbolic link (y or n)? y ←y リターンキー Type <CR> to continue ... ←リターンキー

********************************************************************** Installation complete. ←インストール終了