Cosminexus アプリケーションサーバ V8 リファレンス コマンド編
![[目次]](FIGURE/CONTENT.GIF)
![[索引]](FIGURE/INDEX.GIF)
![[前へ]](FIGURE/FRONT.GIF)
mngsvrctl(Management Serverの起動/停止/セットアップ)
形式
- Management Serverを起動する場合
- Windowsの場合
mngsvrctl start
- UNIXの場合
/opt/Cosminexus/manager/bin/mngsvrctl start
- Management Serverを停止する場合
- Windowsの場合
mngsvrctl stop
- UNIXの場合
/opt/Cosminexus/manager/bin/mngsvrctl stop
- Management Serverをセットアップする場合
- Windowsの場合
mngsvrctl setup [<サーバ名>] [-u <管理ユーザID>] [-p <管理ユーザパスワード>] [-np <変更後の管理ユーザパスワード>] [-nu <変更後のユーザID>]
- UNIXの場合
/opt/Cosminexus/manager/bin/mngsvrctl setup [<サーバ名>] [-u <管理ユーザID>] [-p <管理ユーザパスワード>] [-np <変更後のユーザパスワード>] [-nu <変更後のユーザID>]
機能
Management Serverを起動または停止します。または,アプリケーションサーバを初めてインストールしたマシンで,Management Serverを実行するために必要なセットアップをします。
管理ユーザアカウントの省略機能を無効にしている場合,セットアップと同時に,Management Serverへログインするための管理ユーザアカウント(管理ユーザIDおよび管理ユーザパスワード)を設定できます。セットアップ時に管理ユーザアカウントを設定しないと,Management Serverの起動時および停止時に管理ユーザアカウントの設定が必要になります。また,管理ユーザアカウントがすでに設定されている場合は,別のユーザアカウントを指定することで管理ユーザアカウントを変更することもできます。
管理ユーザアカウントの省略機能を有効にしている場合,および仮想化したサーバ上でJP1ユーザ認証連携機能を有効にしている場合,このコマンドの実行時およびManagement Serverの起動後に管理ユーザアカウントを設定する必要はありません。
管理ユーザアカウントの省略機能については,マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.6.5 管理ユーザアカウントを設定しない場合の設定」を参照してください。
このコマンドは,Administrator権限(Windowsの場合),またはroot権限(UNIXの場合)のあるユーザが実行してください。ただし,UNIXの場合,root権限がない特定のユーザにコマンドの実行権限を設定することもできます。設定については,「mngenvsetup(管理グループの設定)」を参照してください。
UNIXの場合に,Management Serverをデーモンプロセスとして起動する方法については,「daemon(デーモンプロセスの起動)」を参照してください。
引数
引数の指定がない場合,コマンドの使用方法が表示されます。
- start
- Management Serverを起動します。
- stop
- Management Serverを停止します。
- setup
- Management Serverをセットアップします。
- <サーバ名>
- Management Serverの名称(Webコンテナのサーバ名称)を指定します。省略した場合は,「cosmi_m」が仮定されます。
- -u <管理ユーザID>
- Management Serverの管理ユーザIDを指定します。
- -p <管理ユーザパスワード>
- Management Serverの管理ユーザパスワードを指定します。
- -np <変更後の管理ユーザパスワード>
- 新しいManagement Serverの管理ユーザパスワードを指定します。
- -nu <変更後の管理ユーザID>
- 新しいManagement Serverの管理ユーザIDを指定します。
- 設定済みの管理ユーザパスワードを解除する場合は,空文字("")を指定します。
戻り値
- 0:
- 正常終了しました。
- 1:
- 実行時エラーが発生しました。
- 2:
- シンタックスエラーが発生しました。
入力例
- Management Serverをセットアップする場合
mngsvrctl setup [<サーバ名>]
- セットアップ時に管理ユーザアカウントの設定もする場合
mngsvrctl setup [<サーバ名>] -u admin01 -p p1574809
- 設定済みの管理ユーザアカウントを変更する場合
mngsvrctl setup -u admin01 -p p1574809 -np passwd123 -nu admin02
- 管理ユーザパスワードを解除する場合
mngsvrctl setup localhost -u admin01 -p p1574809 -np ""
注意事項
UNIXの場合のmngsvrctlの注意事項を次に示します。
- Management Serverを起動する前に,umask 022を設定してください。
コマンドからManagement Serverを起動した場合,umaskに影響されるファイルは,それぞれ次のownerおよびgroupで作成します。
- AIXの場合
root/system
- HP-UXの場合
root/sys
- Linuxの場合
root/root
- Solarisの場合
root/other
umaskに影響されるファイルを次に示します。
- 構成情報の退避/回復画面で退避した構成情報ファイル(ユーザ任意)
- J2EEアプリケーションまたはリソースのインポート時に作成されるJ2EEアプリケーションファイル(EARファイル),またはリソース情報ファイル(mapps_<論理サーバ名>_<内部ID>)
- 登録されたJ2EEアプリケーション(<アプリケーション表示名>_<登録時刻>)
- ssogenkeyコマンド実行時またはリポジトリ管理で暗号鍵ファイルの設定時に作成される暗号化/復号化用の鍵ファイル(ユーザ任意)
- J2EEサーバ,またはバッチサーバへの設定情報の配布時に作成される運用監視エージェントの設定ファイル(mngagent.<論理サーバ名>.properties)
- snapshotログ収集の直前に作成されるsnapshotログ機能で設定されている環境変数の格納ファイル(envinfo.txt)
- J2EEサーバ,またはバッチサーバへの設定情報の配布時に作成されるJ2EEサーバ,またはバッチサーバのユーザ定義ファイルのバックアップファイル(usrconf.cfg.bak)
- J2EEサーバ,またはバッチサーバへの設定情報の配布時に作成されるJ2EEサーバ,またはバッチサーバのユーザ定義ファイルのバックアップファイル(usrconf.properties.bak)
- Management Serverを起動する場合,ロケールを日本語に設定してから実行してください。
kshを使用している環境でロケールを日本語に設定する場合の例を次に示します。
- AIXの場合の設定例
export LANG=Ja_JPまたはexport LANG=ja_JP
- HP-UXの場合の設定例
export LANG=ja_JP.SJISまたはexport LANG=ja_JP.eucJP
- Linuxの場合の設定例
export LANG=ja_JP.utf8
- Solarisの場合の設定例
export LANG=Ja_JP.PCKまたはexport LANG=ja_JP.eucJP
Management Serverをセットアップする場合の注意事項を次に示します。
- 管理ユーザアカウントの省略機能を有効にしてこのコマンドを実行した場合,共通引数の-uオプション,-pオプション,-npオプション,および-nuオプションの設定は無効になります。このときメッセージが出力され,セットアップ処理は続行されます。
- 管理ユーザアカウントの省略機能を無効にして管理ユーザIDが設定されていない状態で-nuオプションを指定したコマンドを実行すると,-uオプションの指定は無視されて,-nuオプションで指定した管理ユーザIDが設定されます。また,管理ユーザアカウントの省略機能を無効にして管理ユーザパスワードが設定されていない状態で-npオプションを指定したコマンドを実行すると,-pオプションの指定は無視されて,-npオプションで指定した管理ユーザパスワードが設定されます。
All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.