この章では、Collection Manager（CM）とそのデータベースのインストール手順、および CM の起動方法について説明します。
- ･ システム要件
- ･ Collection Manager のインストール
- ･ Sybase データベースおよびサービス コントロール ソフトウェアのアンインストール
- ･ CM バージョン 3.1 へのアップグレード
システム要件
CM およびそのデータベースは、サーバ プラットフォームで稼働するソフトウェア コンポーネントです。以下の設定のいずれかにインストールすることができます。
- ･ Solaris 9 または Solaris 10 が稼働する Sun SPARC マシン（ Solaris の要件 を参照）。
- ･ Red Hat Enterprise Linux 3.0 または Red Hat Enterprise Linux 4.0 が稼働する IA32 マシン（ Red Hat Linux の要件 を参照）。
- ･ システムの前提条件のチェック
- ･ Solaris の要件
- ･ Red Hat Linux の要件
- ･ ディストリビューションの内容
- ･ デフォルト設定
システムの前提条件のチェック
CM ディストリビューションには、 install_scripts ディレクトリにスクリプト check_prerequisites.sh が含まれていて、システムが CM またはバンドルされている Sybase データベースをインストールするための要件に合致しているかどうかを判別するのに役立ちます。
スクリプトが、CM または Sybase をインストールできるかどうかを全体的にチェックします。チェックされる主な前提条件は次のとおりです。
- ･ CPU の速度
- ･ RAM の容量
- ･ オペレーティング システムのバージョン（Solaris 9 または 10、Red Hat Enterprise Linux 3.0 または 4.0）
- ･ 追加の必須またはオプション パッケージ
- ･ パス内でインストールされ実行可能な Python
- ･ CM および Sybase ホーム用の空き容量
- ･ 全 NIC の名前
- ･ Sybase カーネル パラメータ
- ･ ロケールおよび時間帯フォーマット
check_prerequisites.sh [ --sybhome = SYBHOME ] [ --cmhome = CMHOME ] [ --datadir = DATADIR ]
Solaris の要件
Collection Manager 3.1.0 以降を、以下のセクションで列挙されている要件に適合する Solaris が動作する Sun SPARC マシンにインストールすることができます。
- ･ ハードウェア
- ･ ソフトウェアおよび環境
- ･ ロケールおよび時間帯の設定
ハードウェア
ソフトウェアおよび環境
- ･ Solaris 5.9 64 ビット ビルド 04/01 以上（現時点では Solaris 5.9 および 5.10 だけをサポート）
- ･ Solaris Core Installation
- ･ 次の追加パッケージをインストールする必要があります。
- ･ Python スクリプトを使用するには、Python インタープリタ バージョン 2.2.1 以上がシステムになければなりません。このインタープリタを入手するには、次のパッケージをインストールするという方法があります。
- ･ これらのパッケージは、 http://sunfreeware.com/ からダウンロードできます。
ルート（/）パーティションには、これらのパッケージをインストールするために 104 MB の空き容量が必要です。
- ･ Sun の最新の推奨パッチを適用する必要があります。
- − Solaris 9 については、 http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/xos-9&nav=pub-patches を参照してください。
- − Solaris 10 については、 http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/xos-10&nav=pub-patches を参照してください。
- − Java については、 http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/J2SE を参照してください。
- ･ Sybase を使用する場合は、Sybase が推奨する最新の Solaris パッチをインストールする必要があります。
- − http://my.sybase.com/detail?id=1016173 を参照してください。
- ･ CM をインストールするパーティションに、8 GB以上の空き容量が必要です（CSV の保存および永続的バッファに使用します）。
- ･ （バンドルされている Sybase をインストールする場合）Sybase ホーム ディレクトリ用に 1 パーティションに 3 GB 以上の空き容量が必要です。
- ･ （バンドルされている Sybase をインストールする場合）1 パーティションに、Sybase データおよびログを保持するための適切な空き容量が必要です（これらのサイズはインストール時に設定できます）。
- ･ （任意、およびバンドルされている Sybase をインストールする場合のみ）sudo パッケージを（たとえば http://sunfreeware.com から）インストールして、sudoers ファイルに次の行を設定します。
scmscm ALL= NOPASSWD:XXX/scripts/dbconf.sh
sudo をインストールしない場合：まれに Sybase がクラッシュした場合に、CM が自動回復できなくなります。
- ･ （従来の（3.0 以前の）Service Control Application Suite（SCAS）Reporter を使用する予定で、バンドルされている Sybase をインストールする場合）SCA Reporter が認証できるように、いずれかの FTP サーバをポート 21 で待ち受ける必要があります。
- ･ （バンドルされている Sybase をインストールする場合） /etc/hosts またはその他のアクティブなネーミング サービス内で、マシン NIC に設定されたすべての IP アドレスにホスト名が関連付けられていることを確認してから、インストールする必要があります（これは Sybase Adaptive Server Enterprise の制限です）。
- ･ （Sybase をインストールする使用する場合）カーネルに少なくとも以下を設定する必要があります。
- ･ さらに、起動時に IPC モジュールをロードする必要があります。そのためには、ファイル /etc/system に次の行を挿入します。
forceload:sys/semsys
forceload:sys/shmsys
ロケールおよび時間帯の設定
ロケールを設定する最も簡単な方法は、 /etc/TIMEZONE コンフィギュレーション ファイルに次の行を挿入することです（このファイルの変更を有効にするには、再起動する必要があります）。
また、Solaris にもこのロケールをインストールする必要があります。ディレクトリ /usr/lib/locale/en_US が存在するかを調べることで、このロケールがインストールされていることを確認します。このディレクトリが存在しない場合は、Solaris CD からロケール ファイルをインストールします。
- ･ OS 時間帯 を POSIX 形式で GMT とのオフセットとして設定しないでください。問題が生じることがあります。 /etc/TIMEZONE コンフィギュレーション ファイル内で、次のように（サポートされている）国名で時間帯を設定する方法を推奨します。
ディレクトリ /usr/share/lib/zoneinfo 内にその国名が表示されているかを調べることで、国名が時間帯設定としてサポートされているか確認します。
GMT オフセットを使用しなければいけない場合、次のように :Etc/ 接頭辞を付加することで zoneinfo フォーマットを使用します。
Red Hat Linux の要件
Collection Manager 3.1.0 以降を、以下のセクションで列挙されている要件に適合する Red Hat Linux が動作する i386 にインストールすることができます。
- ･ ハードウェア
- ･ ソフトウェアおよび環境
- ･ ロケールおよび時間帯の設定
ハードウェア
ソフトウェアおよび環境
- ･ Red Hat Linux 3.0 または 4.0
- ･ Red Hat Enterprise「Base」のインストール
- ･ （バンドルされている Sybase を使用する場合）次の追加パッケージをインストールする必要があります。
- ･ このパッケージは、Red Hat インストール CD に収録されています。
- ･ Red Hat の最新の推奨パッチを適用する必要があります。
- ･ （バンドルされている Sybase を使用する場合）Sybase が推奨する最新の Solaris パッチをインストールする必要があります。
- ･ CM をインストールするパーティションに、8 GB 以上の空き容量が必要です（CSV の保存および永続的バッファに使用します）。
- ･ （バンドルされている Sybase をインストールする場合）Sybase ホーム ディレクトリ用にいずれかのパーティションに 1 GB 以上の空き容量が必要です。（任意、およびバンドルされている Sybase をインストールする場合のみ）sudo パッケージをインストールして、sudoers ファイルに次の行を設定します。
scmscm ALL= NOPASSWD:XXX/scripts/dbconf.sh
sudo をインストールしなかった場合、まれに Sybase がクラッシュすると、CM は自動回復できなくなります。
- ･ （従来の（3.0 以前の）SCAS Reporter を使用する予定で、バンドルされている Sybase をインストールする場合）SCA Reporter が認証できるように、いずれかの FTP サーバをポート 21 で待ち受ける必要があります。
- ･ （バンドルされている Sybase をインストールする場合） /etc/hosts またはその他のアクティブなネーミング サービス内で、マシン NIC に設定されたすべての IP アドレスにホスト名が関連付けられていることを確認してから、インストールする必要があります（これは Sybase Adaptive Server Enterprise の制限です）。
- ･ （Sybase をインストールする使用する場合）カーネルに少なくとも以下を設定する必要があります。
- ･ データベースの定期削除を使用する場合、scmscm ユーザは cron ジョブをスケジューリングし、実行できる必要があります。
ロケールおよび時間帯の設定
ディストリビューションの内容
CM インストール キットには、CM および Sybase データベースをインストールするためのインストール スクリプトが収録されています。
デフォルト設定
CM の設定は、インストール時に行われます。これらの設定は、イネーブルにする必要があるアダプタ、アダプタの場所、プライオリティ キューのパラメータ、RDR タイプ（RDR タグ値別）ごとのターゲット アダプタ、およびさまざまなロギング ポリシーなどです。これらの設定は、資格のある担当者だけが行ってください。
Collection Manager のインストール
このセクションでは、CM バージョン 3.1.0 以降および Sybase データベースを Solaris または Red Hat Linux が稼働するコンピュータにインストールする方法について説明します。
Collection Manager ソフトウェアで使用されるポート
次の表では、CM ソフトウェアおよび関連コンポーネント（Sybase データベースなど）が待ち受ける TCP/UDP ポートを説明します。このテーブルは、ネットワーク管理者がソフトウェアの動作、およびソフトウェアとセキュリティ ポリシーとの関係を理解する場合に役立つことがあります。
下記のポートは、デバイスが常に待ち受けているポートです。これらのポート番号に対してアクセスを許可しておきます。許可がない場合、処理内容においては失敗することがあります。
処理（ファイル転送など）によっては、記載されたポート以外のポートをデバイスが 一時的に 開くことがありますが、処理が終了すると自動的にポートが閉じます。
Sybase データベースのインストール
Sybase をインストールしない場合（unbundled モードで作業している場合）は、 Collection Manager ソフトウェアのインストール を参照してください。
- 1. root ユーザとしてログオンします。
- 2. pkill -u sybase を入力して、すべての Sybase プロセスを終了します。
- 3. userdel -r sybase を入力して、Sybase ユーザおよびホーム ディレクトリを削除します。
- 4. Sybase インストール プロセスを最初からやり直します。
installsyb.sh によって実行される動作
installsyb.sh スクリプトは、Sybase データベースをインストールします。このスクリプトは、次の動作を実行します。
- ･ /etc/system で Sybase の shmem 設定を確認します。この設定が存在しない場合は、スクリプトで設定が挿入され（ユーザに確認プロンプトを表示したあと）再起動されます。
- ･ ユーザ sybase およびグループ sybase を追加します。
- ･ 使用しているプラットフォームの Sybase インストーラを起動します。
- ･ Sybase ユーザおよびパスワードを含む Sybase サーバを構築します。
- ･ Sybase を開始します。
- ･ Collection Manager データベース構造を作成する SQL スクリプトを実行します。この作業は Sybase を何度か再起動する必要があり、完了まで長時間かかります。
前提条件
root ユーザとしてログオンして、システムまたはローカル ネットワーク上で利用可能なディストリビューション キット コンテンツを作成します。
サマリー手順
詳細手順
ステップ 2 スクリプト installsyb.sh を実行します。
installsyb.sh --sybhome = SYBHOME { --datadir = DATADIR }
このディレクトリを含むパーティションには、15 GB以上の空き容量が必要です。
- ･ DATADIR を指定した場合、すべての Sybase データは通常のファイルとして該当ディレクトリに格納されます。デフォルト サイズは、データ用に 10 GB、ログ用に 3 GB、Sybase テンポラリ ストレージ用に 3 GB です。ディレクトリの所有権は、インストール中に Sybase ユーザに変更されます。
Collection Manager ソフトウェアのインストール
- 1. root ユーザとしてログオンします。
- 2. pkill -u sybase を入力して、すべての Sybase プロセスを終了します。
- 3. userdel -r sybase を入力して、Sybase ユーザおよびホーム ディレクトリを削除します。
- 4. Sybase インストール プロセスを最初からやり直します。
install-cm.sh スクリプト
install-cm.sh スクリプトは、Collection Manager Server をインストールするのに使用されます。
install-cm.sh スクリプトの使用法に関するメッセージは、次のとおりです。
Usage: install-cm.sh [-h] (-d CMDIR | -o)
Options: -d CMDIR select directory for ~scmscm
(must not exist and must be on 8 GB free partition)
-o upgrade the existing installation
while preserving the current configuration
(can't be used with -d)
-h print this help and exit
-d CMDIR
Used to designate the directory of the newly created
scmscm user's home. Should be the name of a
non-existing directory, whose parent resides on a
partition where at least 8 GB is free.
As an alternate to this option, you can specify -o :
-o
Use this option when you wish to upgrade the existing
installation while preserving the current configuration.
(can't be used with -d)
install-cm.sh スクリプトは、次の手順を実行します
- ･ 必要に応じて、scmscm ユーザおよび scmscm グループを作成します。
- ･ オプションとしてこのユーザのホームを作成します。
- ･ scmscm のホームに CM ファイルおよびスクリプトを読み込みます。
- ･ 次の追加コンポーネントをインストールします。
- ･ /etc/init.d および /etc/rcX.d 内に sybase および scmscm ユーザのブート スクリプト シンボリック リンクを作成します。
サマリー手順
- 1. ディストリビューション キットのルートにある install-scripts ディレクトリに移動します。
- 2. install-cm.sh スクリプトを実行します。
- 3. スクリプトの完了後、scmscm ユーザのためのパスワードを設定します。
- 4. Topper/Aggregating（TA）アダプタに割り当てられるメモリ サイズを拡張します。
- 5. ファイル ~scmscm/cm/config/cm.conf を開きます。
- 6. [adapter_mem] セクション内で、 TAAdapter を含む設定を検索します。
- 7. デフォルト値（512 MB）を、より大きな値に変更します。
- 8. ファイルを保存して、閉じます。
- 9. Real-Time Aggregating（RAG）アダプタに割り当てられるメモリ サイズを拡張します。
- 10. ファイル ~scmscm/cm/config/cm.conf を開きます。
- 11. [adapter_mem] セクション内で、 RAGAdapter を含む設定を検索します。
- 12. デフォルト値（512 MB）を、より大きな値に変更します。
- 13. ファイルを保存して、閉じます。
- 14. アプリケーションが使用する各アダプタに対して、アプリケーションを示すようにアダプタを設定します。
- 15. データベース テーブルの定期削除手順をインストールし、アクティブにします。
- 16. 定期削除手順をインストールします。
- 17. 定期削除手順の自動呼出しをアクティブにします。
- 18. Service Control Engine（SCE）デバイスの時間帯を設定します。
- 19. CM を起動します。
詳細手順
ステップ 2 install-cm.sh スクリプトを実行します。
install-cm.sh スクリプト オプションの詳細については、 install-cm.sh オプション を参照してください。
スクリプトに関する追加情報については、 install-cm.sh によって実行される動作 を参照してください。
ステップ 3 スクリプトの完了後、scmscm ユーザのためのパスワードを設定します。
次のコマンドを実行して、scmscm ユーザのパスワードを設定します。
ステップ 4 TA アダプタに割り当てられるメモリ サイズを拡張します。
TA アダプタを利用するアプリケーションを実行する場合は、このアダプタに割り当てられたメモリ サイズを拡張しなければならない場合があります。拡張が必要かどうかは、CM が処理する加入者数によって決まります。メモリ割り当てを拡張するには、次の手順を実行します。
- a. ファイル ~scmscm/cm/config/cm.conf を開きます。
- b. [adapter_mem] セクション内で、 TAAdapter を含む設定を検索します。
- c. デフォルト値（512 MB）を、より大きな値に変更します。
たとえば、1,024 MB のメモリを割り当てる場合は、値 -Xmx1024M を使用します。
ステップ 5 RAG アダプタに割り当てられるメモリ サイズを拡張します。
RAG アダプタを利用するアプリケーションを実行するときには、このアダプタに割り当てられたメモリ サイズを拡張しなければならない場合があります。拡張が必要かどうかは、CM が処理する加入者数、および RAG アダプタの設定によって決まります。設定を変更するには、次の手順を実行します。
- a. ファイル ~scmscm/cm/config/cm.conf を開きます。
- b. [adapter_mem] セクション内で、 RAGAdapter を含む設定を検索します。
- c. デフォルト値（512 MB）を、より大きな値に変更します。
たとえば、1,024 MB のメモリを割り当てる場合は、値 -Xmx1024M を使用します。
ステップ 6 アプリケーションが使用する各アダプタに対して、アプリケーションを示すようにアダプタを設定します。
- ･ JDBC アダプタ ― ファイル ~scmscm/cm/config/jdbcadapter.conf を編集し、 [app] セクションの値 app_conf_dir を、目的のアプリケーションを示すように変更します。
デフォルトでは、この値は apps/scasbb/3.1.0 に設定されています。
TA アダプタ ― ファイル ~scmscm/cm/config/taadapter.conf を編集し、 [app] セクションの値 app_conf_dir を、目的のアプリケーションを示すように変更します。デフォルトでは、この値は apps/scasbb/3.1.0 に設定されています。
ステップ 7 データベース テーブルの定期削除手順をインストールし、アクティブにします。
（定期削除の動作の設定に関する詳細については、 古いレコードの定期削除の管理 を参照してください。）
scmscm ユーザとしてログオンし、CM を起動して、データベース テーブルが作成されるまで 1 〜 2 分待機して、次のスクリプトを実行します。
~scmscm/db_maint/create_periodic_del_procs.sh.
~scmscm/scripts/dbperiodic.py --load
~scmscm/cm/bin/jselect-sce-tz.sh --offset = offset-in-minutes from GMT
たとえば、SCE デバイスが GMT+2 の場所にある場合は、次のコマンドを使用します。
~scmscm/cm/bin/jselect-sce-tz.sh --offset=120
SCE が GMT-10 の場所にある場合は、次のコマンドを使用します。
~scmscm/cm/bin/jselect-sce-tz.sh --offset=-600
Sybase データベースおよびサービス コントロール ソフトウェアのアンインストール
Sybase のアンインストール
サマリー手順
詳細手順
次のコマンドを実行して、Sybase をアンインストールします。
pkill -u sybase userdel -r sybase rm /etc/rc*.d/[SK]*sybase
ステップ 3 /etc/system を編集して、Sybase の shmem 設定を削除します。
サービス コントロール ソフトウェアのアンインストール
サマリー手順
詳細手順
ステップ 2 サービス コントロール ソフトウェアのアンインストール
次のコマンドを実行して、サービス コントロール ソフトウェアをアンインストールします。
pkill -u scmscm userdel -r scmscm rm /etc/rc*.d/[SK]*scmscm
CM バージョン 3.1 へのアップグレード
サマリー手順
詳細手順
ステップ 2 install-cm.sh スクリプトを使用して新規 CM をインストールします。
アップグレードする場合は、 -o オプションを使用して既存の設定を保存します。
アップグレード後最初に CM を起動する際に、3.1 の新規データベース テーブルが自動的に作成されます。
