形式
change-admin-password
機能説明
admin-realmにfileレルムを使用している場合、fileレルムの管理ユーザーの管理者パスワードを変更します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
戻り値
0: 正常終了
1: 異常終了
注意事項
管理ユーザー、管理者パスワードについては「5.2.4 ログイン認証」を参照してください。
パスワードには8文字以上20文字以内の英数字を指定してください。
その他、パスワードに関する注意事項は、「1.3.4 Java EE 6で使用するパスワードに関する注意事項」を参照してください。
生死監視機能によりサーバーインスタンスのプロセス自動再起動を有効にしている場合、管理者パスワード変更後にlogin --pcmiサブコマンドを実行して.asadminpassを更新してください。詳細は、「2.5.1 Java VMプロセスの生死監視」を参照してください。
使用例
以下のように実行します。問い合わせに従って、管理ユーザー名、現在のパスワード、新しいパスワードを2回入力します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin change-admin-password |
/opt/FJSVisje6/glassfish/bin/asadmin change-admin-password |
形式
change-master-password [--savemasterpassword[=true|=false]]
機能説明
マスターパスワードを変更します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
---|---|---|
--savemasterpassword | なし |
|
注) 新規作成または再作成される、マスターパスワードを保存したファイルは以下に格納されます。
[Java EE 6共通ディレクトリ]\domains\domain1\master-password |
[Java EE 6共通ディレクトリ]/domains/domain1/master-password |
戻り値
0: 正常終了
1: 異常終了
注意事項
本コマンドを実行する場合、実行前に以下を停止してください。
Interstage Java EE 6 DASサービス
すべてのIJServerクラスタ
すべてのメッセージブローカ
マスターパスワードの初期値はchangeitです。
パスワードには6文字以上20文字以内の英数字を指定してください。
--passwordfileオプションで指定したファイルに以下のエントリを追加することで、現在のマスターパスワードを指定できます。
AS_ADMIN_MASTERPASSWORD=現在のマスターパスワード |
--passwordfileオプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
master-passwordファイルが存在する状態でasadmin change-master-passwordサブコマンドを--savemasterpasswordオプションに「false」を指定して実行した場合、master-passwordファイルは削除されます。
その他、パスワードに関する注意事項は、「1.3.4 Java EE 6で使用するパスワードに関する注意事項」を参照してください。
本サブコマンドを多重に実行しないでください。また、本サブコマンド実行と同時に他サブコマンドを実行しないでください。
使用例
以下のように実行します。問い合わせに従って、現在のパスワードと、新しいパスワードを2回入力します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin change-master-password --savemasterpassword |
/opt/FJSVisje6/glassfish/bin/asadmin change-master-password --savemasterpassword |
形式
enable-secure-admin
機能説明
asadminコマンドのSSL暗号化通信を有効にします。また、リモートデバッグを有効にします。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
戻り値
0: 正常終了
1: 異常終了
注意事項
本コマンドを実行する場合、実行前に以下を停止してください
すべてのIJServerクラスタ
すべてのメッセージブローカ
PCMIサービスおよびInterstage Java EE 6 DASサービスのみ起動した状態で本コマンドを実行する必要があります。また、本コマンド実行後、すぐにInterstage Java EE 6 DASサービスを再起動する必要があります。
管理者パスワードが設定されていない場合、本コマンドの実行に失敗します。
本コマンドによりasadminコマンドのSSL暗号化通信を有効にした場合、asadmin実行時にホストのサーバ証明書を利用します。.asadmintruststoreファイルがユーザディレクトリに存在しない場合、または.asadmintruststoreファイルに指定されたホストのサーバー証明書がない場合、asadminコマンドを実行した後、以下のようなメッセージを出力します。
Do you trust the above certificate [y|N] --> |
.asadmintruststoreファイルは、ユーザディレクトリ配下のサーバー証明書を保存するためのものです。SSL接続による管理操作は、当該サーバー証明書を利用してセキュリティ認証を行います。.asadmintruststoreファイルに複数サーバー証明書を保存できます。
ユーザがコンソールに「y」を入力すると、指定されたホストのサーバー証明書が作成され、コマンドの実行に成功します。また、.asadmintruststoreファイルが存在しない場合、.asadmintruststoreファイルが作成されます。
例
>asadmin create-cluster cluster002 [
[
Version: V3
Subject: CN=InterstageApplicationServer
Signature Algorithm: SHA256withRSA, OID = 1.2.840.113549.1.1.11
Key: Sun RSA public key, 2048 bits
modulus: 19560145951819794801041776912862855082164721677762889023481381123240503248284977902300888149217244175143196560102873913090355970284297660389516749163362035010576219022879490180591593743399844936816943339509833661124602120346040705486312579895226100810541799744572656818915287937369568257714849817838680838934434249619667244998892433225634104115192730573939659998261755361343176984974226970821689605451234005105054764284271176336519757346374713275861090068120584222787445007103997502376623518573793037555211694020596468379520521680555734802937822040979764804246380191706946226564730034821615198942184770904592776543343
public exponent: 65537
Validity: [From: Thu Mar 28 18:54:15 JST 2013,
To: Sun Mar 26 18:54:15 JST 2023]
Issuer: CN=InterstageApplicationServer
SerialNumber: [ 0c8c92ba]
Certificate Extensions: 1
[1]: ObjectId: 2.5.29.14 Criticality=false
SubjectKeyIdentifier [
KeyIdentifier [
0000: 99 1D 06 B3 E6 4A F6 54 55 BB D6 C3 A4 7F 50 82 .....J.TU.....P.
0010: DC 57 AA 06 .W..
]
]
]
Algorithm: [SHA256withRSA]
Signature:
0000: 6B ED 08 FF 27 EA F3 69 C0 EC 7D B0 74 58 B2 C5 k...'..i....tX..
0010: D6 04 F9 DA ED 31 F4 05 B3 93 58 4C 33 B0 6F BE .....1....XL3.o.
0020: 2A 1D 99 A3 A7 3C 45 B7 E6 84 E6 C8 21 CD 57 34 *....<E.....!.W4
0030: 8F 04 C7 82 8F A9 DF 7F 98 E8 A1 89 4E 98 53 41 ............N.SA
0040: F9 24 EE 19 34 C4 80 B7 DB 50 80 92 A2 D6 4C 75 .$..4....P....Lu
0050: A2 D4 39 69 9C 4D A1 52 74 C2 A8 08 B9 19 43 CC ..9i.M.Rt.....C.
0060: F4 0C 69 F5 0B B3 29 7C 79 B2 E9 12 32 2D 4E 2D ..i...).y...2-N-
0070: 7D 24 41 A4 BF 0D 54 26 0C 2F D2 5F 44 D6 73 7E .$A...T&./._D.s.
0080: F9 95 89 36 BA 77 15 35 F9 5B 6D A3 66 CE C1 64 ...6.w.5.[m.f..d
0090: 14 40 39 03 77 C6 60 16 41 22 86 D1 AD B5 2A 5D .@9.w.`.A"....*]
00A0: C2 7F 88 9A 2B F8 E0 8E DE A8 9C 5B 30 F3 CD C8 ....+......[0...
00B0: 73 C5 80 72 F8 33 A9 8D 71 56 41 B1 D1 3B 3C D7 s..r.3..qVA..;<.
00C0: 57 05 D7 48 E7 6C 56 E5 80 11 42 49 02 06 BB 01 W..H.lV...BI....
00D0: DA 06 54 BB 66 9A 53 EE 08 C2 AF D2 86 5A 10 0E ..T.f.S......Z..
00E0: AB F8 A2 C6 64 8A B5 A8 51 12 A7 34 1B 70 5F D9 ....d...Q..4.p_.
00F0: 8B 2E 5E 24 F7 AD 72 0B 27 FD AD A3 E7 30 02 99 ..^$..r.'....0..
]
Do you trust the above certificate [y|N] -->y
Command create-cluster executed successfully.
ユーザがコンソールに「n」を入力すると、エラーが出力され、コマンドの実行に失敗します。
例
>asadmin create-cluster cluster003 [
[
Version: V3
Subject: CN=InterstageApplicationServer
Signature Algorithm: SHA256withRSA, OID = 1.2.840.113549.1.1.11
Key: Sun RSA public key, 2048 bits
modulus: 19560145951819794801041776912862855082164721677762889023481381123240503248284977902300888149217244175143196560102873913090355970284297660389516749163362035010576219022879490180591593743399844936816943339509833661124602120346040705486312579895226100810541799744572656818915287937369568257714849817838680838934434249619667244998892433225634104115192730573939659998261755361343176984974226970821689605451234005105054764284271176336519757346374713275861090068120584222787445007103997502376623518573793037555211694020596468379520521680555734802937822040979764804246380191706946226564730034821615198942184770904592776543343
public exponent: 65537
Validity: [From: Thu Mar 28 18:54:15 JST 2013,
To: Sun Mar 26 18:54:15 JST 2023]
Issuer: CN=InterstageApplicationServer
SerialNumber: [ 0c8c92ba]
Certificate Extensions: 1
[1]: ObjectId: 2.5.29.14 Criticality=false
SubjectKeyIdentifier [
KeyIdentifier [
0000: 99 1D 06 B3 E6 4A F6 54 55 BB D6 C3 A4 7F 50 82 .....J.TU.....P.
0010: DC 57 AA 06 .W..
]
]
]
Algorithm: [SHA256withRSA]
Signature:
0000: 6B ED 08 FF 27 EA F3 69 C0 EC 7D B0 74 58 B2 C5 k...'..i....tX..
0010: D6 04 F9 DA ED 31 F4 05 B3 93 58 4C 33 B0 6F BE .....1....XL3.o.
0020: 2A 1D 99 A3 A7 3C 45 B7 E6 84 E6 C8 21 CD 57 34 *....<E.....!.W4
0030: 8F 04 C7 82 8F A9 DF 7F 98 E8 A1 89 4E 98 53 41 ............N.SA
0040: F9 24 EE 19 34 C4 80 B7 DB 50 80 92 A2 D6 4C 75 .$..4....P....Lu
0050: A2 D4 39 69 9C 4D A1 52 74 C2 A8 08 B9 19 43 CC ..9i.M.Rt.....C.
0060: F4 0C 69 F5 0B B3 29 7C 79 B2 E9 12 32 2D 4E 2D ..i...).y...2-N-
0070: 7D 24 41 A4 BF 0D 54 26 0C 2F D2 5F 44 D6 73 7E .$A...T&./._D.s.
0080: F9 95 89 36 BA 77 15 35 F9 5B 6D A3 66 CE C1 64 ...6.w.5.[m.f..d
0090: 14 40 39 03 77 C6 60 16 41 22 86 D1 AD B5 2A 5D .@9.w.`.A"....*]
00A0: C2 7F 88 9A 2B F8 E0 8E DE A8 9C 5B 30 F3 CD C8 ....+......[0...
00B0: 73 C5 80 72 F8 33 A9 8D 71 56 41 B1 D1 3B 3C D7 s..r.3..qVA..;<.
00C0: 57 05 D7 48 E7 6C 56 E5 80 11 42 49 02 06 BB 01 W..H.lV...BI....
00D0: DA 06 54 BB 66 9A 53 EE 08 C2 AF D2 86 5A 10 0E ..T.f.S......Z..
00E0: AB F8 A2 C6 64 8A B5 A8 51 12 A7 34 1B 70 5F D9 ....d...Q..4.p_.
00F0: 8B 2E 5E 24 F7 AD 72 0B 27 FD AD A3 E7 30 02 99 ..^$..r.'....0..
]
Do you trust the above certificate [y|N] -->n
javax.net.ssl.SSLHandshakeException: java.security.cert.CertificateException: The certificate chain from the server is not trusted
Command delete-cluster failed.
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin enable-secure-admin You must restart all running servers for the change in secure admin to take effect. |
/opt/FJSVisje6/glassfish/bin/asadmin enable-secure-admin Command enable-secure-admin executed successfully. |
形式
disable-secure-admin
機能説明
asadminコマンドのSSL暗号化通信を無効にします。また、リモートデバッグを無効にします。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
戻り値
0: 正常終了
1: 異常終了
注意事項
本コマンドを実行する場合、実行前に以下を停止してください
すべてのIJServerクラスタ
すべてのメッセージブローカ
PCMIサービスおよびInterstage Java EE 6 DASサービスのみ起動した状態で本コマンドを実行する必要があります。また、本コマンド実行後、すぐにInterstage Java EE 6 DASサービスを再起動する必要があります。
管理者パスワードが設定されていない場合、本コマンドの実行に失敗します。
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin disable-secure-admin Command disable-secure-admin executed successfully. |
/opt/FJSVisje6/glassfish/bin/asadmin disable-secure-admin You must restart all running servers for the change in secure admin to take effect. |
形式
create-connector-security-map --poolname connector_connection_pool_name [--principals principal_name1[,principal_name2]...] [--usergroups usergroup_name1[,usergroup_name2]...] --mappedusername username security_map_name
機能説明
セキュリティーマップを作成します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
---|---|---|
--poolname | なし | コネクタ接続プールのプール名を指定します。 |
--principals | なし | Principalを指定します。複数のPrincipalを指定する場合、各Principalを「,」で区切って指定します。 |
--usergroups | なし | ユーザーグループを指定します。複数のユーザーグループを指定する場合、各ユーザーグループを「,」で区切って指定します。 |
--mappedusername | なし | Backend Principalのユーザー名を指定します。 |
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
security_map_name | 不可 | セキュリティーマップの名前を指定します。 |
戻り値
0: 正常終了
1: 異常終了
注意事項
--passwordfileオプションで指定したファイルに以下のエントリを追加することで作成されるセキュリティーマップのBackend Principalのパスワードを指定できます。
AS_ADMIN_MAPPEDPASSWORD=パスワード |
--passwordfileオプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
--principalsオプションと--usergroupsオプションはいずれか一方の指定が必須です。2つのオプションを同時に指定した場合、またはいずれも指定しない場合、コマンドの実行に失敗します。
本サブコマンドを実行すると、以下の同期化対象に対して、定義項目の更新(同期化)処理が行われます。
Java EE 6環境のすべてのサーバーインスタンス
このため、Java EE 6環境のすべてのサーバーインスタンスに対する実行結果が出力されます。実行結果の詳細は「asadminコマンドの注意事項」を参照してください。
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin --passwordfile C:\temp\password.txt create-connector-security-map --poolname eis/connectionPool --principals principal1,principal2 --mappedusername backendPrincipal securityMap |
/opt/FJSVisje6/glassfish/bin/asadmin --passwordfile /temp/password.txt create-connector-security-map --poolname eis/connectionPool --principals principal1,principal2 --mappedusername backendPrincipal securityMap |
形式
delete-connector-security-map --poolname connector_connection_pool_name security_map_name
機能説明
セキュリティーマップを削除します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
---|---|---|
--poolname | なし | コネクタ接続プールのプール名を指定します。 |
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
security_map_name | 不可 | セキュリティーマップの名前を指定します。 |
戻り値
0: 正常終了
1: 異常終了
注意事項
本サブコマンドを実行すると、以下の同期化対象に対して、定義項目の更新(同期化)処理が行われます。
Java EE 6環境のすべてのサーバーインスタンス
このため、Java EE 6環境のすべてのサーバーインスタンスに対する実行結果が出力されます。実行結果の詳細は「asadminコマンドの注意事項」を参照してください。
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin delete-connector-security-map --poolname eis/connectionPool securityMap |
/opt/FJSVisje6/glassfish/bin/asadmin delete-connector-security-map --poolname eis/connectionPool securityMap |
形式
update-connector-security-map --poolname connector_connection_pool_name [--addprincipals principal_name1[,principal_name2]...] [--addusergroups usergroup_name1[,usergroup_name2]...] [--removeprincipals principal_name1[,principal_name2]...] [--removeusergroups usergroup_name1[,usergroup_name2]...] [--mappedusername username] security_map_name
機能説明
セキュリティーマップを更新します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
---|---|---|
--poolname | なし | コネクタ接続プールのプール名を指定します。 |
--addprincipals | なし | 追加するPrincipalを指定します。複数のPrincipalを指定する場合、各Principalを「,」で区切って指定します。 |
--addusergroups | なし | 追加するユーザーグループを指定します。複数のユーザーグループを指定する場合、各ユーザーグループを「,」で区切って指定します。 |
--removeprincipals | なし | 削除するPrincipalを指定します。複数のPrincipalを指定する場合、各Principalを「,」で区切って指定します。 |
--removeusergroups | なし | 削除するユーザーグループを指定します。複数のユーザーグループを指定する場合、各ユーザーグループを「,」で区切って指定します。 本オプションを省略した場合、ユーザーグループは削除されません。 |
--mappedusername | なし | Backend Principalのユーザー名を指定します。 |
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
security_map_name | 不可 | セキュリティーマップの名前を指定します。 |
戻り値
0: 正常終了
1: 異常終了
注意事項
--passwordfileオプションで指定したファイルに以下のエントリを追加することでセキュリティーマップのBackend Principalのパスワードを更新できます。
AS_ADMIN_MAPPEDPASSWORD=パスワード |
--passwordfileオプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
--addprincipalsオプションと—-addusergroupsを同時に指定することはできません。指定した場合、コマンドの実行に失敗します。
--addprincipalsオプションと--removeprincipalsオプションに同名のPrincipalを指定することはできません。指定した場合、コマンドの実行に失敗します。
--addusergroupsオプションと--removeusergroupsオプションに同名のユーザーグループを指定することはできません。指定した場合、コマンドの実行に失敗します。
セキュリティーマップに登録済みのPrincipalを--addprincipalsオプションで指定することはできません。指定した場合、コマンドの実行に失敗します。
セキュリティーマップに登録済みのユーザーグループを--addusergroupsオプションで指定することはできません。指定した場合、コマンドの実行に失敗します。
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin --passwordfile C:\temp\password.txt update-connector-security-map --poolname eis/connectionPool --addprincipals principal1,principal2 --mappedusername backendPrincipal securityMap |
/opt/FJSVisje6/glassfish/bin/asadmin --passwordfile /temp/password.txt update-connector-security-map --poolname eis/connectionPool --addprincipals principal1,principal2 --mappedusername backendPrincipal securityMap |
形式
list-connector-security-maps connector_connection_pool_name
機能説明
セキュリティーマップの一覧を取得します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
connector_connection_pool_name | 不可 | コネクタ接続プールのプール名を指定します。 |
戻り値
0: 正常終了
1: 異常終了
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin list-connector-security-maps eis/connectionPool |
/opt/FJSVisje6/glassfish/bin/asadmin list-connector-security-maps eis/connectionPool |
形式
create-password-alias aliasname
機能説明
パスワードエイリアスを作成します。管理者パスワードのエイリアスは作成できません。
作成したパスワードエイリアスは、以下においてパスワードの代りに指定できます。
asadminコマンドのsetサブコマンド
上記でパスワード項目を定義する際、パスワードエイリアスを以下のフォーマットで指定します。
${ALIAS=aliasname} |
コマンドを実行すると以下のプロンプトが表示されますのでパスワードを入力してください。
Please enter the alias password |
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
aliasname | 不可 | パスワードエイリアス名を指定します。 |
戻り値
0: 正常終了
1: 異常終了
注意事項
--passwordfileオプションで指定したファイルに以下のエントリを追加することで作成されるパスワードエイリアスのパスワードを指定できます。エントリを追加しない場合、パスワードの入力を求めるプロンプトが表示されます。
AS_ADMIN_ALIASPASSWORD=パスワード |
--passwordfileオプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
プロンプトで入力したパスワードは表示されません。
パスワードエイリアスの大文字と小文字が区別されるかどうかは、Javaの実装によって異なります。問題の発生を防ぐため、小文字のみで設定するようにしてください。
本サブコマンドを多重に実行しないでください。また、本サブコマンド実行と同時に他サブコマンドを実行しないでください。
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin create-password-alias alias1 |
事前に作成されたコネクションプールeis/connectionPoolのセキュリティマップsecurityMapにパスワードエイリアスを設定するには、以下のように実行します。これにより、定義ファイルに書かれているパスワードやasadmin getサブコマンドなどで表示されるパスワードを隠ぺいすることができます。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin set --user admin |
/opt/FJSVisje6/glassfish/bin/asadmin create-password-alias alias1 |
事前に作成されたコネクションプールeis/connectionPoolのセキュリティマップsecurityMapにパスワードエイリアスを設定するには、以下のように実行します。これにより、定義ファイルに書かれているパスワードやasadmin getサブコマンドなどで表示されるパスワードを隠ぺいすることができます。
/opt/FJSVisje6/glassfish/bin/asadmin set --user admin |
形式
delete-password-alias aliasname
機能説明
パスワードエイリアスを削除します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
aliasname | 不可 | パスワードエイリアス名を指定します。 |
戻り値
0: 正常終了
1: 異常終了
注意事項
本サブコマンドを多重に実行しないでください。また、本サブコマンド実行と同時に他サブコマンドを実行しないでください。
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin delete-password-alias alias1 |
/opt/FJSVisje6/glassfish/bin/asadmin delete-password-alias alias1 |
形式
list-password-aliases
機能説明
パスワードエイリアスの一覧を表示します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
戻り値
0: 正常終了
1: 異常終了
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin list-password-aliases |
/opt/FJSVisje6/glassfish/bin/asadmin list-password-aliases |
形式
update-password-alias aliasname
機能説明
パスワードエイリアスを更新します。
コマンドを実行すると以下のプロンプトが表示されますのでパスワードを入力してください。
Please enter the alias password |
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
aliasname | 不可 | パスワードエイリアス名を指定します。 |
戻り値
0: 正常終了
1: 異常終了
注意事項
--passwordfileオプションで指定したファイルに以下のエントリを追加することでパスワードエイリアスのパスワードを更新できます。
AS_ADMIN_ALIASPASSWORD=パスワード |
--passwordfileオプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
プロンプトで入力したパスワードは表示されません。
本サブコマンドを多重に実行しないでください。また、本サブコマンド実行と同時に他サブコマンドを実行しないでください。
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin update-password-alias alias1 |
/opt/FJSVisje6/glassfish/bin/asadmin update-password-alias alias1 |
形式
create-auth-realm --classname realm_class [--property name=value[:name=value]...] [--target target] auth_realm_name
機能説明
指定された認証方法のレルムを追加します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
---|---|---|
--classname | なし | レルムの実装クラスを指定します。以下のクラスを指定してください。
指定を省略すると、入力を求めるプロンプトが表示されます。 |
--property | なし | 「レルムの追加プロパティ」を指定します。 |
--target | なし | 以下のいずれかを指定します。省略値は「server」です。
|
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
auth_realm_name | 不可 | レルム名を指定します。 |
戻り値
0: 正常終了
1: 異常終了
注意事項
fileレルムを使用する場合は、使用例のように、--propertyオプションにjaas-context、fileを必ず指定するようにしてください。指定しない場合、fileレルムの作成ができません。
レルムをInterstage Java EE 6 DASサービスやIJServerクラスタで共通に使用する場合、同じ名前のレルムを共通に使用するInterstage Java EE 6 DASサービス/IJServerクラスタすべてに作成する必要があります。asadmin create-auth-realmサブコマンドをInterstage Java EE 6 DASサービス、IJServerクラスタごとに--targetオプションを指定して実行してください。
本サブコマンドを実行すると、以下の同期化対象に対して、定義項目の更新(同期化)処理が行われます。
「target」(または「オペランド」)に指定したサーバーインスタンスまたは指定したIJServerクラスタに属するすべてのサーバーインスタンス
このため、サーバーインスタンスまたはIJServerクラスタに属するすべてのサーバーインスタンスに対する実行結果が出力されます。実行結果の詳細は「asadminコマンドの注意事項」を参照してください。
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin create-auth-realm --classname com.sun.enterprise.security.auth.realm.file.FileRealm |
/opt/FJSVisje6/glassfish/bin/asadmin create-auth-realm --classname com.sun.enterprise.security.auth.realm.file.FileRealm |
形式
delete-auth-realm [--target target] auth_realm_name
機能説明
指定されたレルムを削除します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
---|---|---|
--target | なし | 以下のいずれかを指定します。省略値は「server」です。
|
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
auth_realm_name | 不可 | レルム名を指定します。 |
戻り値
0: 正常終了
1: 異常終了
注意事項
本サブコマンドを実行すると、以下の同期化対象に対して、定義項目の更新(同期化)処理が行われます。
「target」(または「オペランド」)に指定したサーバーインスタンスまたは指定したIJServerクラスタに属するすべてのサーバーインスタンス
このため、サーバーインスタンスまたはIJServerクラスタに属するすべてのサーバーインスタンスに対する実行結果が出力されます。実行結果の詳細は「asadminコマンドの注意事項」を参照してください。
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin delete-auth-realm --target IJServer001 fileRealm |
/opt/FJSVisje6/glassfish/bin/asadmin delete-auth-realm --target IJServer001 fileRealm |
形式
list-auth-realms [target]
機能説明
オペランドに指定されたtargetのレルムの一覧を表示します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
target | 可 | 以下のいずれかを指定します。省略値は「server」です。
|
戻り値
0: 正常終了
1: 異常終了
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin list-auth-realms IJServer001 |
/opt/FJSVisje6/glassfish/bin/asadmin list-auth-realms IJServer001 |
形式
create-file-user [--groups user_groups[:user_groups]...] [--authrealmname authrealm_name] [--target target] username
機能説明
fileレルムのユーザを作成します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
---|---|---|
--groups | なし | ユーザが属するグループのリストを指定します。(注) |
--authrealmname | なし | fileレルムの名前を指定します。 |
--target | なし | 以下のいずれかを指定します。省略値は「server」です。
|
注) 詳細は、「5.4.5 fileレルムのユーザ・グループ管理」を参照してください。
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
username | 不可 | ユーザ名を指定します。(注) |
注) 詳細は、「5.4.5 fileレルムのユーザ・グループ管理」を参照してください。
戻り値
0: 正常終了
1: 異常終了
注意事項
--passwordfileオプションで指定したファイルに以下のエントリを追加することで、作成するfileレルムユーザのパスワードを指定できます。エントリを追加しない場合、パスワードの入力を求めるプロンプトが表示されます。
AS_ADMIN_USERPASSWORD=パスワード |
--passwordfileオプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
プロンプトに入力したパスワードは表示されません。
設定するパスワードについては、「5.4.5 fileレルムのユーザ・グループ管理」を参照してください。
本サブコマンドを実行すると、以下の同期化対象に対して、定義項目の更新(同期化)処理が行われます。
「target」(または「オペランド」)に指定したサーバーインスタンスまたは指定したIJServerクラスタに属するすべてのサーバーインスタンス
このため、サーバーインスタンスまたはIJServerクラスタに属するすべてのサーバーインスタンスに対する実行結果が出力されます。実行結果の詳細は「asadminコマンドの注意事項」を参照してください。
更新を反映させるため、手動による同期化が必要な場合があります。詳細は「2.1.4 リポジトリの同期化処理」を参照してください。
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin create-file-user --target IJServer001 user1 |
/opt/FJSVisje6/glassfish/bin/asadmin create-file-user --target IJServer001 user1 |
形式
delete-file-user [--authrealmname authrealm_name] [--target target] username
機能説明
fileレルムのユーザを削除します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
---|---|---|
--authrealmname | なし | fileレルムの名前を指定します。 |
--target | なし | 以下のいずれかを指定します。省略値は「server」です。
|
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
username | 不可 | ユーザ名を指定します。 |
戻り値
0: 正常終了
1: 異常終了
注意事項
本サブコマンドを実行すると、以下の同期化対象に対して、定義項目の更新(同期化)処理が行われます。
「target」(または「オペランド」)に指定したサーバーインスタンスまたは指定したIJServerクラスタに属するすべてのサーバーインスタンス
このため、サーバーインスタンスまたはIJServerクラスタに属するすべてのサーバーインスタンスに対する実行結果が出力されます。実行結果の詳細は「asadminコマンドの注意事項」を参照してください。
更新を反映させるため、手動による同期化が必要な場合があります。詳細は「2.1.4 リポジトリの同期化処理」を参照してください。
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin delete-file-user --target IJServer001 user1 |
/opt/FJSVisje6/glassfish/bin/asadmin delete-file-user --target IJServer001 user1 |
形式
update-file-user [--groups user_groups[:user_groups]...] [--authrealmname authrealm_name] [--target target] username
機能説明
fileレルムのユーザを更新します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
---|---|---|
--groups | なし | ユーザが属するグループのリストを指定します。(注) |
--authrealmname | なし | fileレルムの名前を指定します。 |
--target | なし | 以下のいずれかを指定します。省略値は「server」です。
|
注) 詳細は、「5.4.5 fileレルムのユーザ・グループ管理」を参照してください。
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
username | 不可 | ユーザ名を指定します。(注) |
注) 詳細は、「5.4.5 fileレルムのユーザ・グループ管理」を参照してください。
戻り値
0: 正常終了
1: 異常終了
注意事項
fileレルムユーザのパスワードを更新する場合は、--passwordfileオプションで指定したファイルに以下のエントリを追加してください。
AS_ADMIN_USERPASSWORD=パスワード |
--passwordfileオプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
設定するパスワードについては、「5.4.5 fileレルムのユーザ・グループ管理」を参照してください。
本サブコマンドを実行すると、以下の同期化対象に対して、定義項目の更新(同期化)処理が行われます。
「target」(または「オペランド」)に指定したサーバーインスタンスまたは指定したIJServerクラスタに属するすべてのサーバーインスタンス
このため、サーバーインスタンスまたはIJServerクラスタに属するすべてのサーバーインスタンスに対する実行結果が出力されます。実行結果の詳細は「asadminコマンドの注意事項」を参照してください。
更新を反映させるため、手動による同期化が必要な場合があります。詳細は「2.1.4 リポジトリの同期化処理」を参照してください。
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin --passwordfile c:\temp\password.txt update-file-user --groups group1 --target IJServer001 user1 |
/opt/FJSVisje6/glassfish/bin/asadmin --passwordfile /tmp/password.txt update-file-user --groups group1 --target IJServer001 user1 |
形式
list-file-users [--authrealmname authrealm_name] [target]
機能説明
fileレルムのユーザの一覧を表示します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
---|---|---|
--authrealmname | なし | fileレルムの名前を指定します。 |
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
target | 可 | 以下のいずれかを指定します。省略値は「server」です。
|
戻り値
0: 正常終了
1: 異常終了
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin list-file-users IJServer001 |
/opt/FJSVisje6/glassfish/bin/asadmin list-file-users IJServer001 |
形式
list-file-groups [--name username] [--authrealmname authrealm_name] [target]
機能説明
fileレルムのグループの一覧を表示します。
asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。
また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
---|---|---|
--name | なし | fileレルムのユーザを指定します。 本オプションを指定した場合、指定したユーザが属するグループの一覧を表示します。 |
--authrealmname | なし | fileレルムの名前を指定します。 |
オペランド
オペランド名 | 省略 | 説明 |
---|---|---|
target | 可 | 以下のいずれかを指定します。省略値は「server」です。
|
戻り値
0: 正常終了
1: 異常終了
使用例
以下のように実行します。
C:\Interstage\F3FMisje6\glassfish\bin\asadmin list-file-groups IJServer001 |
/opt/FJSVisje6/glassfish/bin/asadmin list-file-groups IJServer001 |