第1章 コマンドリファレンス
1.17 swReplaceSQC(業務サーババンドルAgent入れ替え用コマンド)
■機能説明
Systemwalker Centric Manager V13.4.0からV15.0.xの業務サーバに同梱されていたSystemwalker Service Quality
Coordinator Agentがインストールされている環境に、本製品をインストールするときに使用するコマンドです。
Systemwalker Centric Manager V13.4.0からV15.0.xの業務サーバに同梱されていたSystemwalker Service Quality Coordinator Agenをアンインストールして本製品のインストールを行います。
注意
本コマンドは複数同時に実行しないでください。
注意
Agentのライセンスセットアップを行っている場合
Systemwalker Centric Manager V13.4.0からV15.0.xの業務サーバに同梱されていたSystemwalker Service Quality Coordinator Agentについてライセンスセットアップを行っている場合は、必要に応じて以下の作業を行ってください。
・ 本コマンドを実行する前に、ユーザーが作成、修正した以下のファイル等をバックアップしてください。
【Windows版】
－ <Systemwalker Centric Manager 業務サーバのインストールディレクトリ>\SystemwalkerSQC\control - DSAconfiguration.txt
- template.dat - udataconf.ini - alertconfig.txt
－ <Systemwalker Centric Manager 業務サーバのインストールディレクトリ>\bin - threshold.bat
【UNIX版】
－ /etc/opt/FJSVssqc - DSAconfiguration.txt - template.dat
- udataconf.ini - alertconfig.txt
－ /opt/FJSVssqc/bin - threshold.sh
・ インストール後のセットアップ時に、上記バックアップしたファイルを元に、再度、編集作業を行ってください。
■実行に必要な権限
【Windows版】
Administratorsグループに所属するユーザー権限が必要です。
【UNIX版】
システム管理者(スーパーユーザー)権限が必要です。
■記述形式
【Windows版】
DVD-ROMドライブ:\swReplaceSQC.bat -t <インストール種別> [-f <インストール情報ファイルのパス>]
【UNIX版】
<マウントポイント>/swReplaceSQC.sh -t <インストール種別> [-f <インストール情報ファイルのパス>]
■オプション
-t <sqc-em | sqc-m | sqc-pm | sqc-a-sv | sqc-a-biz>
インストールするインストール種別を指定します。
－ sqc-em：Enterprise Managerのインストールを行います。
－ sqc-m：Managerのインストールを行います。
－ sqc-pm：Proxy Managerのインストールを行います。
－ sqc-a-sv：Agent for Serverのインストールを行います。
－ sqc-a-biz：Agent for Businessのインストールを行います。
-f <Install information file path>
サイレントインストールする場合にインストール情報ファイルの絶対パスを指定します。
インストール情報ファイルについての詳細は、導入手引書「インストール情報ファイルの作成」を参照してください。
■復帰値 0 : 正常終了
2 : コマンドのパラメーターの指定エラー 4 : インストール情報ファイルの指定エラー
10 : インストーラを二重起動した場合、またはその他のエラー
34 : インストーラを二重起動した場合のエラー
35 : 不整合なインストールがあるため、インストールができない場合のエラー
36 : インストールパラメーターの値に誤りがある場合や、インストールの前提条件が満たされていない場合のエラー
101 : Systemwalker Centric Managerの業務サーバに同梱されているSystemwalker Service Quality Coordinator Agentが 存在しない場合のエラー
上記以外 : その他のエラー
■使用例1
Agent for Serverをインストールする場合
Agent for Serverをインストールする場合の手順の例は以下のとおりです。
【Windows版】
1. WindowsマシンのDVD-ROM装置に本製品のDVD-ROMをセットします。
2. 本コマンドを実行します。
D:\swReplaceSQC.bat -t sqc-a-sv
3. 入れ替えを継続するかの問い合わせに対して[y]を入力し、[Enter]を押します。
Do you replace Systemwalker Service Quality Coordinator Agent bundled with Systemwalker Centric Manager with Systemwalker Service Quality Coordinator? [y/n]: y
Systemwalker Centric Managerの業務サーバに同梱されているSystemwalker Service Quality Coordinator Agent のアンインストールが開始されます。
Systemwalker Service Quality Coordinator Agent bundled with Systemwalker Centric Manager is being uninstalled.
4. アンインストールの完了後、以下のメッセージが表示され、インストーラが起動します。
The uninstallation of Systemwalker Service Quality Coordinator Agent bundled with Systemwalker Centric Manager has been completed.
The installer of Systemwalker Service Quality Coordinator is started.
導入手引書「インストールとセットアップ」に従って、インストールおよびセットアップを行ってください。
【UNIX版】
1. UNIXマシンのDVD-ROM装置に本製品のDVD-ROMをセットします。
2. DVD-ROMをマウントします。
3. 本コマンドを実行します。
/mnt/cdrom/swReplaceSQC.sh -t sqc-a-sv
4. 入れ替えを継続するかの問い合わせに対して[y]を入力し、[Enter]を押します。
Do you replace Systemwalker Service Quality Coordinator Agent bundled with Systemwalker Centric Manager with Systemwalker Service Quality Coordinator? [y/n]: y
Systemwalker Centric Managerの業務サーバに同梱されているSystemwalker Service Quality Coordinator Agent のアンインストールが開始されます。
Systemwalker Service Quality Coordinator Agent bundled with Systemwalker Centric Manager is being uninstalled.
5. アンインストールの完了後、以下のメッセージが表示され、インストーラが起動します。
The uninstallation of Systemwalker Service Quality Coordinator Agent bundled with Systemwalker Centric Manager has been completed.
The installer of Systemwalker Service Quality Coordinator is started.
導入手引書「インストールとセットアップ」に従って、インストールおよびセットアップを行ってください。
■使用例2
Agent for Serverをサイレントインストールする場合
Agent for Serverをサイレントインストールする場合の手順の例は以下のとおりです。
【Windows版】
1. WindowsマシンのDVD-ROM装置に本製品のDVD-ROMをセットします。
2. 本コマンドを実行します。
D:\swReplaceSQC.bat -t sqc-a-sv -f D:\tools\Sample\SilentInstall\sqc_ag_pm_win.csv コマンド実行中に以下のメッセージが表示されます。
Systemwalker Service Quality Coordinator Agent bundled with Systemwalker Centric Manager is being uninstalled.
The uninstallation of Systemwalker Service Quality Coordinator Agent bundled with Systemwalker Centric Manager has been completed.
Systemwalker Service Qulity Coordinator is being installed.
インストールが完了すると、以下のメッセージが表示されます。
The installation of Systemwalker Service Qulity Coordinator has been completed.
3. 導入手引書「インストールとセットアップ」に従って、セットアップを行ってください。
【UNIX版】
1. UNIXマシンのDVD-ROM装置に本製品のDVD-ROMをセットします。
2. DVD-ROMをマウントします。
3. 本コマンドを実行します。
/mnt/cdrom/swReplaceSQC.sh -t sqc-a-sv -f /mnt/cdrom/tools/Sample/SilentInstall/sqc_ag_pm_ux.csv コマンド実行中に以下のメッセージが表示されます。
Systemwalker Service Quality Coordinator Agent bundled with Systemwalker Centric Manager is being uninstalled.
The uninstallation of Systemwalker Service Quality Coordinator Agent bundled with Systemwalker Centric Manager has been completed.
Systemwalker Service Qulity Coordinator is being installed.
インストールが完了すると、以下のメッセージが表示されます。
The installation of Systemwalker Service Qulity Coordinator has been completed.
4. 導入手引書「インストールとセットアップ」に従って、セットアップを行ってください。
■実行結果/出力形式 正常終了
正常終了は復帰値の値で判断します。
また、標準出力に対し、正常終了メッセージを出力します。
swReplaceSQC succeeded.
異常終了
異常終了は復帰値の値で判断します。
エラー時の対処について
復帰値とその内容、対処方法は以下のとおりです。
復帰値 内容 対処方法
2 コマンドのパラメーターの指定 エラー
コマンドのパラメーターを修正して、再実行してく ださい。
4 インストール情報ファイルの指 定エラー
インストール情報ファイルのフォーマットを修正し て、再実行してください。
10 インストーラを二重起動した場 合、またはその他のエラー
[アンインストールと管理(ミドルウェア)]が起動して いる場合は、終了してから再実行してください。
また、以下のプロセスが動作していないか確認し てください。
【Windows】
run.exe
【UNIX】 run.sh
上記のプロセスが動作している場合は、製品のイ ンストールまたはアンインストールが実行されてい ます。プロセスが終了するまで待ってから再実行 してください。
上記以外の場合は、技術員に連絡してください。
34 インストーラを二重起動した場 合のエラー
[アンインストールと管理(ミドルウェア)]が起動して いる場合は、終了してから再実行してください。
また、以下のプロセスが動作していないか確認し てください。
【Windows】 run.exe
【UNIX】
run.sh
上記のプロセスが動作している場合は、製品のイ ンストールまたはアンインストールが実行されてい ます。プロセスが終了するまで待ってから再実行 してください。
35 不整合なインストールがあるた め、インストールができない場 合のエラー
[アンインストールと管理(ミドルウェア)]を起動して 不整合なインストールを解決し、再実行してくださ い。
36 インストールパラメーターの値 に誤りがある場合や、インス トールの前提条件が満たされ ていない場合のエラー
導入手引書「インストール条件と資源見積り」に記 載されているインストール条件を満たしていること を確認してください。また、インストール情報ファ イルに設定されているインストールパラメーターの 内容に誤りがないことを確認し、再実行してくださ い。
101 Systemwalker Centric Managerの業務サーバに同梱 されているSystemwalker Service Quality Coordinator
Systemwalker Centric Managerの業務サーバに 同梱されているSystemwalker Service Quality Coordinator Agentがインストールされていないた め、本コマンドを使用してインストールする必要が
復帰値 内容 対処方法 Agentがインストールされてい
ない場合のエラー
ありません。導入手引書「インストールとセットアッ プ」に従ってインストールまたはサイレントインス トールを行ってください。
上記 以外
その他のエラー 技術員に連絡してください。