Application Server에는 asadmin으로 알려진 명령줄 관리 유틸리티가 포함되어 있습니다. asadmin 유틸리티는 사용자, 자원 및 응용 프로그램 관리와 Application Server 시작 및 중지에 사용됩니다.
이 장은 다음 내용으로 구성되어 있습니다.
asadmin 유틸리티를 사용하면 Application Server의 모든 관리 작업을 수행할 수 있습니다. 관리 인터페이스를 사용하는 대신 이 asadmin 유틸리티를 사용할 수 있습니다.
asadmin 유틸리티는 수행할 작업을 식별하는 하위 명령을 호출합니다. 대소문자를 구분합니다. 짧은 옵션 인수에는 한 개의 대시(-)를 붙이고 긴 옵션 인수에는 두 개의 대시(--)를 붙입니다. 옵션은 유틸리티가 하위 명령을 수행하는 방법을 제어합니다. 또한 대소문자를 구분합니다. 기능의 ON, OFF를 전환하는 부울 옵션을 제외한 대부분의 옵션에는 인수 값이 필요합니다. 피연산자는 인수 값 뒤에 붙이며 공백, 탭 또는 이중 대시(--)로 구분됩니다. asadmin 유틸리티는 옵션 및 해당 값 뒤에 나오는 모든 부분을 피연산자로 간주합니다.
asadmin은 명령 쉘 호출이나 다중 명령 모드( multimode)에서 사용할 수 있습니다. 명령 쉘 호출의 경우 명령 쉘에서 asadmin 유틸리티를 호출합니다. asadmin은 명령을 실행한 다음 종료됩니다. 다중 명령 모드의 경우 asadmin이 한 번 호출되면 asadmin을 종료하여 정상 명령 쉘 호출로 돌아가기 전까지 여러 번의 명령 실행이 허용됩니다. 다중 명령 모드에서 설정된 환경 변수는 multimode를 종료하기 전까지 모든 후속 명령에 사용됩니다. 파일 또는 표준 입력(파이프)에서 이전에 준비된 명령 목록을 전달하여 명령을 입력할 수 있습니다. 다중 모드 세션 중에 multimode를 호출할 수 있으며 이 때 두 번째 다중 모드 환경을 종료하면 원래 다중 모드 환경으로 돌아갑니다.
asadmin 유틸리티를 대화식 또는 비대화식 옵션으로 실행할 수도 있습니다. 기본적으로 대화식 옵션이 활성화됩니다. 대화식 옵션을 활성화할 때에는 필수 인수를 입력하라는 메시지가 표시됩니다. 모든 환경에서 명령 쉘 호출에 대화식 옵션을 사용할 수 있습니다. 명령 프롬프트에서 한 번에 하나의 하위 명령을 실행하고 파일에서 명령을 multimode로 실행하는 경우 multimode로 대화식 옵션을 사용할 수 있습니다. 입력 스트림에서 파이프된 경우 multimode의 하위 명령 및 다른 프로그램에서 호출된 하위 명령은 대화식 옵션으로 실행되지 않습니다.
로컬 하위 명령은 관리 서버가 없는 상태에서 실행할 수 있습니다. 그러나 사용자는 하위 명령을 실행하고 설치 및 도메인 디렉토리에 대한 액세스 권한을 갖기 위해 도메인을 호스팅하는 시스템에 로그인해야 합니다. 원격 하위 명령은 항상 관리 서버에 연결하여 해당 서버에서 명령을 실행함으로써 실행됩니다. 관리 서버가 실행 중이어야 합니다. 모든 원격 하위 명령에는 다음 옵션이 필요합니다.
-u -‐user 인증된 도메인 응용 프로그램 서버 관리 사용자 이름입니다.
-‐passwordfile 다음 형식으로 된 도메인 응용 프로그램 서버 비밀번호를 포함하는 파일: AS_ADMIN_PASSWORD=password. 여기서 password는 실제 관리자 비밀번호입니다.
-H -‐host 도메인 응용 프로그램 서버가 실행되는 시스템 이름입니다.
-p -‐port 관리 요청을 수신하는 도메인 응용 프로그램 서버의 포트 번호입니다. Platform Edition의 기본 포트 번호는 4848입니다.
-s -‐secure true인 경우 SSL/TLS를 사용하여 도메인 응용 프로그램 서버와 통신합니다.
-t -‐terse 일반적으로 서술형 문장을 배제하고 스크립트 사용에 적합한 형식이 되도록 출력 데이터를 간소화합니다. 기본값은 false입니다.
-e -‐echo true로 설정하면 명령줄 명령이 표준 출력에 표시됩니다. 기본값은 false입니다.
-I -‐interactive true(기본값)로 설정하면 필수 비밀번호 옵션에 대한 프롬프트만 표시됩니다.
-h -‐help 명령에 대한 도움말 텍스트를 표시합니다.
로컬 또는 원격으로 실행할 수 있는 하위 명령에 대해 해당 환경이나 명령줄에서 --host, --port, --user 및 --passwordfile 옵션 중 하나를 설정하면 하위 명령이 원격 모드로 실행됩니다. 또한, 로컬 또는 원격으로 실행할 수 있는 하위 명령에 대해 --local 옵션을 true로 설정하면 하위 명령이 로컬로 실행됩니다. 명령줄 또는 해당 환경에서 로컬 옵션을 설정하지 않으면 기본적으로 하위 명령은 로컬로 실행됩니다. --local 옵션을 true로 설정하면 이미 지정된 로컬 --host, --port, --user 및 --passwordfile 설정이 대체됩니다. 하위 명령이 로컬 모드로 실행됩니다.
로컬로 실행할 수 있는 하위 명령에는 --domain 옵션을 사용하여 도메인이 하나뿐인 경우 기본 도메인으로 간주되도록 도메인을 지정할 수 있습니다. 둘 이상의 도메인이 있는 경우에는 --domain 옵션이 필수 옵션입니다. 로컬 또는 원격으로 실행할 수 있는 하위 명령에 --host, --port, --user 및 --passwordfile 옵션을 지정하여 원격으로 실행하면 --domain 옵션이 무시됩니다. 하위 명령이 원격 모드로 실행되는 경우 --domain 옵션이 무시됩니다. 도메인당 한 개의 관리 인스턴스가 있으므로 단일 시스템에 여러 도메인이 있는 경우 로컬 실행 시 도메인을 지정해야 하며, 원격 실행에서는 해당 도메인의 관리 인스턴스에 대해 --host, --port, --user 및 --passwordfile 옵션을 지정해야 합니다.
보안상의 목적으로 명령줄에서 비밀번호를 입력하는 대신 하위 명령에 대한 비밀번호를 파일에서 설정할 수 있습니다. --passwordfile 옵션을 사용하면 비밀번호가 포함된 파일이 사용됩니다. 파일의 유효한 내용은 다음과 같습니다.
AS_ADMIN_PASSWORD=value AS_ADMIN_ADMINPASSWORD=value AS_ADMIN_USERPASSWORD=value AS_ADMIN_MASTERPASSWORD=value |
AS_ADMIN_PASSWORD를 전역 환경으로 내보낸 경우 --passwordfile 옵션을 지정하면 --password 옵션 사용에 대한 경고가 표시됩니다. AS_ADMIN_PASSWORD를 설정 해제하면 이러한 경고 표시를 방지할 수 있습니다. 마스터 비밀번호는 명령줄이나 환경 변수에서 전파되지 않으며 passwordfile에서 지정할 수 있습니다.
--secure 옵션을 사용하려면 set 명령을 사용하여 domain.xml의 admin http-listener에서 보안 --enabled 플래그를 활성화해야 합니다. asadmin 하위 명령을 사용하여 명령을 만들거나 삭제할 경우 서버를 다시 시작해야 새로 만든 명령이 적용됩니다. start-domain 명령을 사용하여 서버를 다시 시작합니다.
Solaris 플랫폼에서 Application Server 명령줄 인터페이스 하위 명령에 대한 설명서 페이지에 액세스하려면 MANPATH 환경 변수에 $AS_INSTALL/man을 추가합니다.
--help 옵션을 호출하면 asadmin 유틸리티의 모든 하위 명령에 대한 전체 사용법 정보를 얻을 수 있습니다. 하위 명령을 지정하면 해당 하위 명령에 대한 사용법 정보가 표시됩니다. 하위 명령 없이 --help 옵션을 사용하면 사용 가능한 모든 하위 명령의 목록이 표시됩니다.
모든 원격 명령에는 다음 명령 옵션이 필요합니다.
표 C–1 원격 명령의 필수 옵션
옵션 |
정의 |
---|---|
--host |
도메인 관리 서버가 실행 중인 시스템 이름입니다. 기본값은 localhost입니다. |
--port |
관리용 HTTP/S 포트입니다. 이 포트는 도메인을 관리할 수 있도록 사용자의 브라우저를 가리켜야합니다. 예를 들면 다음과 같습니다. http://localhost:4848. Platform Edition의 기본 포트 번호는 4848입니다. |
--user |
인증된 도메인 관리 서버 관리 사용자 이름입니다. asadmin login 명령을 사용하여 도메인에 인증한 경우 이 특정 도메인에 대해서는 후속 작업 시 --user 옵션을 지정할 필요가 없습니다. |
--passwordfile |
-‐passwordfile 옵션은 특정 형식의 비밀번호 항목이 포함된 파일의 이름을 지정합니다. 비밀번호 항목에는 AS_ADMIN_ 접두어가 있어야 하며 뒤에 대문자로 된 비밀번호 이름이 나와야 합니다. 예를 들어, 도메인 관리 서버 비밀번호를 지정하려면 다음 형식의 항목을 사용합니다. AS_ADMIN_PASSWORD=password. 여기서, password는 실제 관리자 비밀번호입니다. 지정 가능한 다른 비밀번호로는 AS_ADMIN_MAPPEDPASSWORD, AS_ADMIN_USERPASSWORD 및 AS_ADMIN_ALIASPASSWORD가 있습니다. 모든 원격 명령 실행 시에는 -‐passwordfile이나 asadmin login을 사용하거나 명령 프롬프트에서 대화식 방법을 사용하여 관리 비밀번호를 지정함으로써 도메인 관리 서버에 인증해야 합니다. asadmin login 명령은 관리 비밀번호를 지정하는 경우에만 사용할 수 있습니다. 원격 명령에 다른 비밀번호를 지정해야 하는 경우에는 -‐passwordfile을 사용하거나 명령 프롬프트에서 해당 비밀번호를 입력합니다. asadmin login 명령을 사용하여 도메인에 인증한 경우 이 특정 도메인에 대해서는 후속 작업 시 -‐passwordfile 옵션을 통해 관리 비밀번호를 지정할 필요가 없습니다. 그러나 이 절차는 AS_ADMIN_PASSWORD 옵션에만 적용됩니다. 하지만 update-file-user와 같은 개별 명령에서 요구하는 경우 AS_ADMIN_USERPASSWORD와 같은 다른 비밀번호를 입력해야 합니다. 보안상 환경 변수로 지정된 비밀번호는 asadmin으로 읽을 수 없습니다. |
--secure |
true로 설정되면 SSL/TLS를 사용하여 도메인 관리 서버와 통신합니다. |
--interactive |
true로 설정되면(기본값) 필수 비밀번호 옵션에 대한 프롬프트만 표시됩니다. |
--terse |
일반적으로 서술형 문장을 배제하고 스크립트 사용에 적합한 형식이 되도록 출력 데이터를 간결화합니다. 기본값은 false입니다. |
--echo |
true로 설정되면 명령줄 명령이 표준 출력에 표시됩니다. 기본값은 false입니다. |
--help |
명령에 대한 도움말 텍스트를 표시합니다. |
multimode 명령을 사용하여 asadmin 명령을 처리할 수 있습니다. 명령줄 인터페이스에서 명령을 입력하라는 메시지를 표시하고, 입력된 명령을 실행하며, 명령에 대한 결과를 표시합니다. 그런 다음 다시 다음 명령을 입력하라는 메시지를 표시합니다. 또한, 이 모드에서 설정된 모든 asadmin 옵션 이름은 이에 대한 모든 후속 명령에 사용됩니다. 사용자 환경을 설정할 수 있으며 “exit” 또는 “quit”를 입력하여 multimode를 종료하기 전까지 명령을 실행할 수 있습니다.파일 또는 표준 입력(파이프)에서 이전에 준비한 명령 목록을 전달하여 명령을 제공할 수도 있습니다. 다중 모드 세션 내에서 multimode를 호출할 수 있으며, 두 번째 다중 모드 환경을 종료하면 원래 다중 모드 환경으로 돌아갑니다.
asadmin get, set 및 list 명령을 차례대로 실행하면 Application Server의 추상 계층에 대한 탐색 메커니즘이 제공됩니다. 다음과 같은 두 가지 계층이 있으며 이러한 명령은 두 계층 모두에서 작동합니다. configuration과 monitoring. list 명령은 읽기 전용의 또는 수정 가능한 속성을 갖는 관리 구성 요소의 점으로 구분된 정규화된 이름을 제공합니다.
configuration 계층은 수정 가능한 속성을 제공하지만, monitoring 계층은 읽기 전용의 관리 구성 요소 속성만을 제공합니다. configuration 계층은 어느 정도 도메인의 스키마 문서를 기반으로 하지만, monitoring 계층은 조금 다릅니다.
list 명령을 사용하면 원하는 계층의 특정 관리 구성 요소에 연결할 수 있습니다. 그런 다음 get 및 set 명령을 호출하면 이름 및 값을 얻거나 관리 구성 요소의 속성 값을 직접 설정할 수 있습니다. 와일드카드(*) 옵션을 사용하면 점으로 구분된 정규화된 해당 이름과 일치하는 모든 항목을 불러올 수 있습니다. 계층 및 관리 구성 요소 탐색을 위해 사용 가능한 다음 세부 분류 예를 참조하십시오.
Application Server의 점으로 구분된 이름은 "."(마침표)를 구분자로 사용하여 전체 이름을 구성하는 부분을 구분합니다. 이는 UNIX 파일 시스템에서 파일에 대한 절대 경로 이름의 수준을 구분하는 데 “/” 문자를 사용하는 것과 비슷합니다. get, set 및 list 명령에서 허용되는 점으로 구분된 이름을 구성할 때 다음 규칙이 적용됩니다. 특정 명령에는 일부 추가 어휘가 적용됩니다.
.(마침표)는 항상 이름의 순차적인 두 부분을 구분합니다.
이름을 구성하는 부분은 대개 응용 프로그램 서버 하위 시스템 및/또는 특정 인스턴스를 식별합니다. 예를 들면 다음과 같습니다. web-container, log-service, thread-pool-1 등.
이름을 구성하는 부분 자체에 .(마침표)가 포함되어 있는 경우에는 “.”가 구분자로 사용되지 않도록 앞에 \(백슬래시)를 붙여 이스케이프 처리해야 합니다.
*(별표)는 위치와 상관없이 점으로 구분된 이름의 일부로 사용할 수 있으며 정규 표현식에서 와일드카드 문자의 역할을 합니다. 또한 *는 점으로 구분된 이름의 모든 부분을 축약할 수 있습니다. 예를 들어, "<classname>this.is.really.long.hierarchy </classname>"과 같이 길이가 긴 점으로 구분된 이름을 "<classname>th*.hierarchy</classname>"으로 축약할 수 있습니다.하지만 .는 항상 이름을 구성하는 부분을 구분하는 역할을 합니다.
점으로 구분된 이름에 대한 최상위 수준의 스위치는 -‐monitor 또는 -m이며 해당 명령줄에 별도로 지정됩니다. 이 스위치 존재의 유무는 응용 프로그램 서버 관리를 위해 모니터링 및 구성 계층 중 하나를 선택했다는 것을 의미합니다.
점으로 구분된 전체 이름을 정확히 알고 있어 와일드카드 문자를 사용하지 않는 경우에는 list 및 get/set에 어휘상 약간의 차이점이 있습니다.
list 명령의 경우 이 점으로 구분된 전체 이름은 추상 계층에 있는 부모 노드의 전체 이름으로 간주됩니다. 이 이름을 list 명령에 사용하면 해당 수준에서 직계 자식의 이름이 반환됩니다. 예를 들어, list server.applications.web-module을 사용하면 도메인 또는 기본 서버에 배포된 모든 웹 모듈이 나열됩니다.
get 및 set 명령의 경우 이 점으로 구분된 전체 이름은 노드(이에 대한 점으로 구분된 이름은 이 점으로 구분된 이름의 마지막 부분을 제거하여 얻어진 이름임) 속성의 정규화된 이름으로 간주되며, 이 명령을 실행하면 해당 속성 값을 가져오고 설정할 수 있습니다. 이러한 속성이 있는 경우 이 설정은 true입니다. 계층에 있는 특정 노드의 속성 이름을 찾기 위해서는 와일드카드 문자 *를 사용해야 하기 때문에 이 경우에는 시작할 수 없습니다. 예를 들어, server.applications.web-module.JSPWiki.context-root는 도메인 또는 기본 서버에 배포된 웹 응용 프로그램의 컨텍스트 루트를 반환합니다.
list 명령은 이 세 명령의 탐색 기능의 기반입니다. 특정 응용 프로그램 서버 하위 시스템의 속성을 set 또는 get하려면 점으로 구분된 해당 이름을 알고 있어야 합니다. list는 해당 하위 시스템의 점으로 구분된 이름을 찾을 수 있도록 해주는 명령입니다. 예를 들어, 대용량 파일 시스템의 특정 파일에서 /로 시작하는 수정된 날짜(속성)를 찾으려는 경우 이 명령을 사용할 수 있습니다. 먼저 파일 시스템에서 해당 파일의 위치를 찾은 다음 해당 속성을 확인할 수 있으므로 appserver의 계층을 인식하는 첫 번째 두 명령은 * list "*" 및 <command>* list * -‐monitor가 됩니다. 이 명령에 대한 정렬된 출력을 식별하려면 get, set 또는 list 명령 설명서 페이지를 참조하십시오.
서버 라이프사이클 명령은 도메인 또는 인스턴스를 만들고 삭제하거나 시작하고 중지하는 명령입니다.
표 C–2 서버 라이프사이클 명령
명령 |
정의 |
---|---|
create-domain |
도메인 구성을 만듭니다. 도메인은 관리 이름 공간입니다. 모든 도메인에는 구성이 있으며 이 구성은 파일 집합에 저장되어 있습니다. Application Server의 해당 설치에 각 고유 관리 아이디가 있는 도메인을 얼마든지 만들 수 있습니다. 도메인은 다른 도메인과 독립적으로 존재할 수 있습니다. 해당 시스템의 asadmin 스크립트에 액세스할 수 있는 사용자는 도메인을 만들 수 있으며 해당 구성을 선택한 폴더에 저장할 수 있습니다. 기본적으로 도메인 구성은 install_dir/domains 디렉토리에 만들어집니다. 이 위치를 대체하여 구성을 다른 곳에 저장할 수 있습니다. |
delete-domain |
명명된 도메인을 삭제합니다. 도메인이 이미 있어야 하며 중지해야 합니다. |
start-domain |
도메인을 시작합니다. 도메인 디렉토리가 지정되지 않은 경우에는 기본 install_dir/domains 디렉토리의 도메인이 시작됩니다. 도메인이 두 개 이상 있으면 domain_name 피연산자를 지정해야 합니다. |
stop-domain |
지정된 도메인의 Domain Administration Server를 중지합니다. |
restore-domain |
백업 디렉토리에서 도메인의 파일을 복원합니다. |
list-domains |
도메인을 나열합니다. 도메인 디렉토리가 지정되지 않은 경우에는 기본 install_dir/domains 디렉토리의 도메인이 나열됩니다. 도메인이 두 개 이상 있으면 domain_name 피연산자를 지정해야 합니다. |
backup-domain |
명명된 도메인의 파일을 백업합니다. |
login |
도메인에 로그인합니다. 여러 시스템에 다양한 응용 프로그램 서버 도메인이 로컬로 만들어진 경우 한 시스템에서 asadmin을 호출하여 다른 곳에 있는 도메인을 원격으로 관리할 수 있습니다. 특히, 특정 시스템이 관리 클라이언트로 선택되어 여러 도메인 및 서버를 관리할 때 편리합니다. 다른 곳에 있는 도메인을 관리하는 데 사용되는 asadmin 명령을 원격 명령이라고 합니다. asadmin login 명령을 사용하면 이러한 원격 도메인을 쉽게 관리할 수 있습니다. login 명령은 대화식 모드에서만 실행됩니다. 이 명령을 실행하면 관리 사용자 이름과 비밀번호를 입력하라는 메시지가 표시됩니다. 로그인에 성공하면 .asadminpass 파일이 사용자의 홈 디렉토리에 만들어집니다. 이 파일은 -‐savelogin 옵션을 사용한 create-domain 명령 실행 과정에서 수정된 파일과 동일합니다. 이 명령을 실행하려면 도메인이 실행 중이어야 합니다. |
create-instance |
로컬 또는 원격 시스템에 상주하는 새 서버 인스턴스를 만듭니다. |
delete-instance |
서버 인스턴스를 삭제합니다. 이 명령은 원격 또는 로컬로 실행할 수 있습니다. 사용자는 관리 서버에 대해 식별되는 비밀번호를 사용하여 인증됩니다. 또한, 관리 서버에서 서비스를 제공하는 도메인에 인스턴스가 이미 존재해야 합니다. 이 명령은 심각한 손상을 가져올 수 있으며 실행을 취소할 수 없으므로 주의하여 사용해야 합니다. |
List 및 Status 명령은 배포된 구성 요소의 상태를 표시합니다.
표 C–3 List 및 Status 명령
명령 |
정의 |
show-component-status |
배포된 구성 요소의 상태를 가져옵니다. 상태는 서버에서 반환된 문자열 표현입니다. 상태 문자열에는 "app-name의 상태: enabled" 또는 "app-name의 상태: disabled"를 사용할 수 있습니다. |
list-components |
배포된 모든 Java EE 5 구성 요소를 나열합니다. -‐type 옵션이 지정되지 않은 경우 모든 구성 요소가 나열됩니다. |
list-sub-components |
배포된 모듈 또는 배포된 응용 프로그램의 모듈에 있는 EJB 또는 서블릿을 나열합니다. 모듈이 식별되지 않으면 모든 모듈이 나열됩니다. |
enable |
지정된 구성 요소를 활성화합니다. 구성 요소가 이미 활성화되어 있는 경우 구성 요소가 다시 활성화됩니다. 구성 요소를 활성화하려면 배치되어 있어야 합니다. 구성 요소가 배포되어 있지 않은 경우에는 오류 메시지가 반환됩니다. |
disable |
명명된 구성 요소를 즉시 비활성화합니다. 구성 요소가 배포되어 있어야 합니다. 구성 요소가 배포되어 있지 않은 경우에는 오류 메시지가 반환됩니다. |
export |
후속 명령 환경을 위한 자동 내보내기 변수 이름을 표시합니다. 모든 후속 명령은 명령의 설정을 해제하거나 다중 모드를 종료하지 않는 한 지정된 변수 이름 값을 사용합니다. |
get |
속성 이름 및 값을 가져옵니다. |
set |
구성 가능한 속성 값을 한 개 이상 설정합니다. |
list |
구성 가능한 요소를 나열합니다. Solaris의 경우 *가 포함된 명령을 옵션 값 또는 피연산자로 실행할 때 따옴표가 필요합니다. |
unset |
다중 모드 환경에서 설정한 변수를 한 개 이상 제거합니다. 변수 및 연관된 값이 환경에서 제거됩니다. |
배포 명령은 응용 프로그램을 배포하거나 클라이언트 스텁을 가져옵니다.
표 C–4 배포 명령
명령 |
정의 |
---|---|
deploy |
엔터프라이즈 응용 프로그램, 웹 응용 프로그램, EJB 모듈, 커넥터 모듈 또는 응용 프로그램 클라이언트 모듈을 배포합니다. 구성 요소가 이미 배포되었거나 존재하는 경우 -‐force 옵션을 true로 설정하면 구성 요소가 강제로 재배포됩니다. |
deploydir |
응용 프로그램을 개발 디렉토리에서 직접 배포합니다. Java EE 사양을 준수하는 적합한 디렉토리 계층 및 배포 설명자가 배포 디렉토리에 있어야 합니다. |
get-client-stubs |
AppClient 독립 실행형 모듈 또는 AppClient 모듈이 포함된 응용 프로그램의 클라이언트 스텁 JAR 파일을 서버 시스템에서 로컬 디렉토리로 가져옵니다. 이 명령을 실행하기 전에 응용 프로그램 또는 모듈을 배포해야 합니다. |
버전 명령은 버전 문자열을 반환하고, 모든 asadmin 명령의 목록을 표시하며, 라이센스 파일을 설치하는 데 사용할 수 있습니다.
표 C–5 버전 명령
명령 |
정의 |
---|---|
version |
버전 정보를 표시합니다. 지정된 사용자/비밀번호 및 호스트/포트를 사용하여 명령이 응용 프로그램 서버와 통신할 수 없는 경우 해당 명령은 로컬에서 버전을 검색하고 경고 메시지를 표시합니다. |
help |
모든 asadmin 유틸리티 명령에 대한 목록을 표시합니다. 명령을 지정하면 해당 명령에 대한 사용법 정보가 표시됩니다. |
install-license |
Application Server의 인증되지 않은 사용을 방지합니다. 라이센스 파일을 설치합니다. |
shutdown |
관리 서버 및 실행 중인 모든 인스턴스를 적절하게 중지합니다. 관리 서버를 다시 시작하려면 수동으로 시작해야 합니다. |
Message Queue 관리 명령을 사용하면 JMS 대상을 관리할 수 있습니다.
표 C–6 Message Queue 명령
명령 |
정의 |
---|---|
create-jmsdest |
JMS 물리적 대상을 만듭니다. 물리적 대상과 함께 create-jms-resource 명령을 사용하여 물리적 대상을 지정하는 Name 등록 정보가 있는 JMS 대상 자원을 만들 수 있습니다. |
delete-jmsdest |
지정된 JMS 대상을 제거합니다. |
flush-jmsdest |
지정된 대상의 JMS 서비스 구성에서 물리적 대상의 메시지를 제거합니다. |
list-jmsdest |
JMS 물리적 대상을 나열합니다. |
jms-ping |
JMS 서비스(JMS 공급자로도 알려져 있음)가 실행 중인지 확인합니다. Application Server를 시작할 때 기본적으로 JMS 서비스가 시작됩니다. 이 명령은 JMS 서비스 내의 기본 JMS 호스트만 ping합니다. 기본 제공 JMS 서비스를 ping할 수 없는 경우 오류 메시지가 표시됩니다. |
자원 명령을 사용하면 응용 프로그램에 사용되는 다양한 자원을 관리할 수 있습니다.
표 C–7 자원 관리 명령
명령 |
정의 |
---|---|
create-jdbc-connection-pool |
지정된 JDBC 연결 풀 이름을 사용하여 새 JDBC 연결 풀을 등록합니다. |
delete-jdbc-connection-pool |
JDBC 연결 풀을 삭제합니다. 피연산자가 삭제할 JDBC 연결 풀을 식별합니다. |
list-jdbc-connection-pools |
만들어진 JDBC 연결 풀을 가져옵니다. |
create-jdbc-resource |
새 JDBC 자원을 만듭니다. |
delete-jdbc-resource |
지정된 JNDI 이름을 가진 JDBC 자원을 제거합니다. |
list-jdbc-resources |
만들어진 JDBC 자원 목록을 표시합니다. |
create-jms-resource |
JMS(Java Message Service) 연결 팩토리 자원 또는 JMS 대상 자원을 만듭니다. |
delete-jms-resource |
지정된 JMS 자원을 제거합니다. |
list-jms-resources |
기존 JMS 자원(대상 및 연결 팩토리 자원)을 나열합니다. |
create-jndi-resource |
JNDI 자원을 등록합니다. |
delete-jndi-resource |
지정된 JNDI 이름을 가진 JNDI 자원을 제거합니다. |
list-jndi-resources |
기존의 모든 JNDI 자원을 확인합니다. |
list-jndi-entries |
JNDI 트리를 찾아 쿼리합니다. |
create-javamail-resource |
JavaMail 세션 자원을 만듭니다. |
delete-javamail-resource |
지정된 JavaMail 세션 자원을 제거합니다. |
list-javamail-resources |
기존 JavaMail 세션 자원을 나열합니다. |
create-persistence-resource |
지속성 자원을 등록합니다. |
delete-persistence-resource |
지속성 자원을 제거합니다. 지속성 자원을 삭제할 때 이 명령은 create-persistence-resource 명령을 사용하여 만든 JDBC 자원도 제거합니다. |
list-persistence-resources |
모든 지속성 자원을 표시합니다. |
create-custom-resource |
사용자 정의 자원을 만듭니다. 사용자 정의 자원은 javax.naming.spi.ObjectFactory 인터페이스를 구현하는 사용자 정의 서버측 자원 객체 팩토리를 지정합니다. |
delete-custom-resource |
사용자 정의 자원을 제거합니다. |
list-custom-resources |
사용자 정의 자원을 나열합니다. |
create-connector-connection-pool |
지정된 연결 풀 이름을 사용하여 새 커넥터 연결 풀을 추가합니다. |
delete-connector-connection-pool |
피연산자 connector_connection_pool_name을 사용하여 지정한 커넥터 연결 풀을 제거합니다. |
list-connector-connection-pools |
만들어진 커넥터 연결 풀을 나열합니다. |
create-connector-resource |
지정된 JNDI 이름을 가진 커넥터 자원을 등록합니다. |
delete-connector-resource |
지정된 JNDI 이름을 가진 커넥터 자원을 제거합니다. |
list-connector-resources |
모든 커넥터 자원을 가져옵니다. |
create-admin-object |
지정한 JNDI 이름을 가진 관리 대상 객체를 만듭니다. |
delete-admin-object |
지정된 JNDI 이름을 가진 관리 대상 객체를 제거합니다. |
list-admin-objects |
모든 관리 대상 객체를 나열합니다. |
create-resource-adapter-config |
커넥터 모듈에 대한 구성 정보를 만듭니다. |
delete-resource-adapter-config |
domain.xml에 만들어진 커넥터 모듈에 대한 구성 정보를 삭제합니다. |
list-resource-adapter-configs |
domain.xml의 커넥터 모듈에 대한 구성 정보를 나열합니다. |
add-resources |
지정된 XML 파일에 명명된 자원을 만듭니다. xml_file_path는 생성할 자원이 포함될 XML 파일 경로입니다. resources.xml 파일에서 DOCTYPE은 install_dir/lib/dtds/sun-resources_1_2.dtd로 지정되어야 합니다. |
ping-connection-pool |
연결 풀을 JDBC 연결 풀 및 커넥터 연결 풀 모두에 사용할 수 있는지 테스트합니다. 예를 들어, 나중에 배포될 것으로 예상되는 응용 프로그램에 새 JDBC 연결 풀을 만든 경우 응용 프로그램을 배포하기 전에 JDBC 풀이 이 명령으로 테스트됩니다. 연결 풀을 ping하기 전에 인증이 있는 연결 풀을 만들어야 하며 엔터프라이즈 서버 또는 데이터베이스가 시작되었는지 확인해야 합니다. |
구성 명령을 사용하여 IIOP Listener, 라이프사이클 모듈, HTTP 및 IIOP Listener, 프로필러 및 기타 하위 시스템을 구성할 수 있습니다.
이 절은 다음 내용으로 구성되어 있습니다.
HTTP 및 IIOP Listener 명령은 Listener 관리 작업을 도와줍니다. 이 명령은 원격 모드에서만 지원됩니다.
표 C–8 IIOP Listener 명령
명령 |
정의 |
---|---|
create-http-listener |
새 HTTP Listener 소켓을 추가합니다. |
delete-http-listener |
지정된 HTTP Listener를 제거합니다. |
list-http-listeners |
기존 HTTP Listener를 나열합니다. |
create-iiop-listener |
IIOP Listener를 만듭니다. |
delete-iiop-listener |
지정된 IIOP Listener를 제거합니다. |
list-iiop-listeners |
기존 IIOP Listener를 나열합니다. |
라이프사이클 및 감사 모듈 명령은 라이프사이클 모듈 및 감사 기능을 구현하는 선택 사항의 플러그 인 모듈을 제어하는 데 도움을 줍니다. 이 명령은 원격 모드에서만 지원됩니다.
표 C–9 라이프사이클 모듈 명령
명령 |
정의 |
---|---|
create-lifecycle-module |
라이프사이클 모듈을 만듭니다. 라이프사이클 모듈은 Application Server 환경 내에서 기간이 짧거나 긴 Java 기반의 작업을 실행하는 수단을 제공합니다. |
delete-lifecycle-module |
지정된 라이프사이클 모듈을 제거합니다. |
list-lifecycle-modules |
기존 라이프사이클 모듈을 나열합니다. |
create-audit-module |
감사 기능을 구현하는 플러그인 모듈에 명명된 감사 모듈을 추가합니다. |
delete-audit-module |
명명된 감사 모듈을 제거합니다. |
list-audit-modules |
모든 감사 모듈을 나열합니다. |
프로필러 및 SSL 명령을 사용하여 프로필러 및 SSL 클라이언트 구성을 관리할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.
표 C–10 프로필러 및 SSL 명령
명령 |
정의 |
---|---|
create-profiler |
프로필러 요소를 만듭니다. Java 구성의 프로필러 요소는 서버 인스턴스를 특정 프로필러와 연결합니다. 프로필러를 변경하려면 서버를 다시 시작해야 합니다. |
delete-profiler |
지정된 프로필러 요소를 삭제합니다. Java 구성의 프로필러 요소는 서버 인스턴스를 특정 프로필러로 묶습니다. 프로필러를 변경하려면 서버를 다시 시작해야 합니다. |
create-ssl |
선택한 HTTP Listener, IIOP Listener 또는 IIOP 서비스에 SSL 요소를 만들고 구성하여 해당 Listener/서비스의 보안 통신을 활성화합니다. |
delete-ssl |
선택한 HTTP Listener, IIOP Listener 또는 IIOP 서비스의 SSL 요소를 삭제합니다. |
JVM 옵션 및 가상 서버 명령을 사용하여 해당 요소를 제어할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.
표 C–11 JVM 옵션 및 가상 서버 명령
명령 |
정의 |
---|---|
create-jvm-option |
Java 구성의 JVM 옵션 또는 domain.xml 파일의 프로필러 요소를 만듭니다. 프로필러에 만든 JVM 옵션은 특정 프로필러를 실행하는 데 필요한 설정을 기록할 때 사용합니다. 새로 만든 JVM 옵션을 적용하려면 서버를 다시 시작해야 합니다. |
delete-jvm-option |
Java 구성의 JVM 옵션 또는 domain.xml 파일의 프로필러 요소를 제거합니다. |
create-virtual-server |
명명된 가상 서버를 만듭니다. Application Server를 가상화하면 여러 호스트 주소를 수신하는 단일 HTTP 서버 프로세스를 통해 여러 URL 도메인을 서비스할 수 있습니다. 응용 프로그램이 두 개의 가상 서버에서 사용 가능한 경우 이 가상 서버는 계속해서 동일한 물리적 자원 풀을 공유합니다. |
delete-virtual-server |
지정된 가상 서버 아이디를 가진 가상 서버를 제거합니다. |
스레드 풀 및 Auth 영역 명령을 사용하여 해당 요소를 제어할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.
표 C–12 스레드 풀 및 Auth 영역 명령
명령 |
정의 |
---|---|
create-threadpool |
지정된 이름을 사용하여 스레드 풀을 만듭니다. 풀 내 스레드의 최대 및 최소 개수, 작업 대기열 수 및 스레드의 유휴 시간 초과를 지정할 수 있습니다. 만들어진 스레드 풀은 IIOP 요청을 서비스할 때 및 자원 어댑터가 작업 관리 요청을 서비스할 때 사용할 수 있습니다. 만들어진 스레드 풀은 여러 자원 어댑터에 사용할 수 있습니다. |
delete-threadpool |
명명된 아이디를 가진 스레드 풀을 제거합니다. |
list-threadpools |
모든 스레드 풀을 나열합니다. |
create-auth-realm |
명명된 인증 영역을 추가합니다. |
delete-auth-realm |
명명된 인증 영역을 제거합니다. |
트랜잭션 및 타이머 명령을 사용하면 트랜잭션 및 타이머 하위 시스템을 제어할 수 있으며 실행 중인 트랜잭션을 일시 중지할 수도 있습니다. 이 명령은 원격 모드에서만 지원됩니다.
표 C–13 트랜잭션 명령
명령 |
정의 |
---|---|
freeze-transaction |
실행 중인 모든 트랜잭션이 일시 중지되도록 트랜잭션 하위 시스템을 중단합니다. 실행 중인 트랜잭션을 롤백하기 전에 이 명령을 호출합니다. 이미 중단된 트랜잭션 하위 시스템에서 이 명령을 호출하는 경우 아무런 영향을 주지 않습니다. |
unfreeze-transaction |
일시 중지된 모든 실행 트랜잭션을 다시 시작합니다. 이미 중단된 트랜잭션에서 이 명령을 호출합니다. |
recover-transactions |
보류 중인 트랜잭션을 수동으로 복구합니다. |
rollback-transaction |
명명된 트랜잭션을 롤백합니다. |
unpublish-from-registry | |
list-timers |
특정 서버 인스턴스가 소유한 타이머를 나열합니다. |
레지스트리 명령을 사용하여 웹 서비스 아티팩트를 게시하거나 게시 취소할 수 있습니다.
표 C–14 트랜잭션 명령
명령 |
정의 |
---|---|
publish-to-registry |
웹 서비스 아티팩트를 레지스트리에 게시합니다. |
unpublish-from-registry |
레지스트리에서 웹 서비스 아티팩트 게시를 취소합니다. |
list-registry-locations |
이 사용자 명령을 사용하면 파일 영역 인증에서 지원되는 사용자를 관리할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.
표 C–15 사용자 관리 명령
명령 |
정의 |
---|---|
create-file-user |
지정된 사용자 이름, 비밀번호 및 그룹을 사용하여 키 파일에 항목을 만듭니다. 콜론(:)으로 그룹을 구분하여 여러 그룹을 만들 수 있습니다. |
delete-file-user |
키 파일에서 지정된 사용자 이름을 가진 항목을 삭제합니다. |
update-file-user |
지정된 user_name, user_password 및 그룹을 사용하여 키 파일의 기존 항목을 업데이트합니다. 콜론(:)으로 그룹을 구분하여 여러 그룹을 입력할 수 있습니다. |
list-file-users |
파일 영역 인증에서 지원되는 파일 사용자 목록을 만듭니다. |
list-file-groups |
파일 영역 인증에서 지원되는 파일 사용자 및 그룹을 관리합니다. 이 명령은 파일 사용자가 사용할 수 있는 그룹을 나열합니다. |
규칙 및 모니터링 명령을 사용하여 규칙을 관리하고 서버를 모니터할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.
표 C–16 규칙 및 모니터링 명령
명령 |
정의 |
---|---|
create-management-rule |
새 관리 규칙을 만들어 Application Server 설치 및 배포된 응용 프로그램을 지능적으로 자체 관리합니다. |
delete-management-rule |
지정된 관리 규칙을 제거합니다. |
create-transformation-rule |
웹 서비스 작업에 적용할 수 있는 XSLT 변환 규칙을 만듭니다. 요청 또는 응답에 규칙을 적용할 수 있습니다. |
delete-transformation-rule |
지정된 웹 서비스의 XSLT 변환 규칙을 삭제합니다. |
start-callflow-monitoring |
웹 컨테이너, EJB 컨테이너 및 JDBC에서 데이터를 수집하고 상관 관계를 지정하여 요청의 전체 호출 흐름/경로를 제공합니다. callflow-monitoring이 ON으로 지정된 경우에만 데이터를 수집할 수 있습니다. |
stop-callflow-monitoring |
요청의 호출 흐름 정보 수집을 비활성화합니다. |
데이터베이스 명령을 사용하여 Java DB 데이터베이스(Apache Derby를 기반으로 함)를 시작하고 중지할 수 있습니다. 이 명령은 로컬 모드에서만 지원됩니다.
표 C–17 데이터베이스 명령
명령 |
정의 |
---|---|
start-database |
Application Server와 함께 사용할 수 있는 Java DB 서버를 시작합니다. Application Server에 배포된 응용 프로그램 작업을 수행하는 경우에만 이 명령을 사용합니다. |
stop-database |
Java DB 서버 프로세스를 중지합니다. Java DB 서버는 Application Server와 함께 사용할 수 있습니다. |
진단 및 로깅 명령은 Application Server의 문제를 해결하는 데 도움을 줍니다. 이 명령은 원격 모드에서만 지원됩니다.
표 C–18 진단 및 로깅 명령
명령 |
정의 |
---|---|
generate-diagnostic-report |
응용 프로그램 서버 인스턴스의 구성 세부 정보, 로깅 세부 정보 또는 프로세스별 정보와 같은 응용 프로그램 서버 설치 세부 정보에 대한 탐색 링크나 포인터가 포함된 HTML 보고서를 생성합니다. |
display-error-statistics |
마지막으로 서버가 다시 시작된 후 server.log에 기록된 심각도 및 경고에 대한 요약 목록을 표시합니다. |
display-error-distribution |
모듈 수준에서 인스턴스 오류 server.log의 배포를 표시합니다. |
display-log-records |
지정된 모듈에 대한 모든 오류 메시지를 지정된 타임스탬프에 표시합니다. |
웹 서비스 명령을 사용하면 배포된 웹 서비스를 모니터하고 변환 규칙을 관리할 수 있습니다.
표 C–19 웹 서비스 명령
명령 |
정의 |
---|---|
configure-webservice-management |
배포된 웹 서비스의 maxhistory 속성 또는 모니터링을 구성합니다. |
create-transformation-rule |
웹 서비스 작업에 적용할 수 있는 XSLT 변환 규칙을 만듭니다. 요청 또는 응답에 규칙을 적용할 수 있습니다. |
delete-transformation-rule |
지정된 웹 서비스의 XSLT 변환 규칙을 삭제합니다. |
list-transformation-rules |
지정된 웹 서비스의 모든 변환 규칙을 적용된 순서대로 나열합니다. |
publish-to-registry |
웹 서비스 아티팩트를 레지스트리에 게시합니다. |
unpublish-from-registry |
레지스트리에서 웹 서비스 아티팩트 게시를 취소합니다. |
list-registry-locations |
구성된 웹 서비스 레지스트리 액세스 지점에 대한 목록을 표시합니다. |
이 보안 명령을 사용하면 커넥터 연결 풀에 대한 보안 매핑을 제어할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.
표 C–20 보안 명령
명령 |
정의 |
---|---|
create-connector-security-map |
지정된 커넥터 연결 풀에 대한 보안 맵을 만듭니다. 보안 맵이 없는 경우 새 맵이 만들어집니다. 또한, 이 명령을 사용하여 응용 프로그램(principal 또는 사용자 그룹)의 호출자 아이디를 컨테이너 관리 트랜잭션 기반 시나리오의 적절한 EIS(Enterprise Information System) principal로 매핑합니다. 한 개 이상의 명명된 보안 맵을 커넥터 연결 풀에 연관시킬 수 있습니다. 커넥터 보안 맵 구성은 모든 사용자 또는 사용자 그룹을 나타낼 수 있도록 와일드카드 문자(*) 사용을 지원합니다. 이 명령을 성공적으로 실행하려면 먼저 커넥터 연결 풀을 만들어야 합니다. EIS는 조직 데이터를 보관하는 시스템입니다. 이는 메인프레임, 메시징 시스템, 데이터베이스 시스템 또는 응용 프로그램일 수 있습니다. |
delete-connector-security-map |
지정된 커넥터 연결 풀에 대한 보안 맵을 삭제합니다. |
update-connector-security-map |
지정된 커넥터 연결 풀에 대한 보안 맵을 수정합니다. |
list-connector-security-map |
지정된 커넥터 연결 풀에 속한 보안 맵을 나열합니다. |
create-message-security-provider |
관리자가 지정된 메시지 계층에 대한 provider-config 하위 요소를 만들 수 있도록 활성화합니다(Application Server에 대한 매개 변수 및 등록 정보를 지정하는 domain.xml 파일의 message-security-config 요소). |
delete-message-security-provide |
관리자가 지정된 메시지 계층에 대한 provider-config 하위 요소를 삭제할 수 있도록 활성화합니다(Application Server에 대한 매개 변수 및 등록 정보를 지정하는 domain.xml 파일의 message-security-config 요소). |
list-message-security-providers |
관리자가 지정된 메시지 계층에 대한 모든 보안 메시지 공급자(provider-config 하위 요소)를 나열할 수 있도록 활성화합니다(domain.xml의 message-security-config 요소). |
비밀번호 명령을 사용하면 비밀번호를 관리할 수 있으며 Application Server의 보안을 확보할 수 있습니다.
표 C–21 비밀번호 명령
명령 |
정의 |
---|---|
create-password-alias |
비밀번호의 별칭을 만들고 domain.xml에 저장합니다. 별칭은 ${ALIAS=password-alias-password} 형식의 토큰입니다. 별칭 이름에 해당하는 비밀번호는 암호화된 형식으로 저장됩니다. 이 명령에는 대화식 보안 형식(모든 정보에 대해 입력 요청 메시지가 표시됨) 및 스크립트 형식(비밀번호가 명령줄에서 전파됨)이 모두 사용됩니다. |
delete-password-alias |
비밀번호 별칭을 삭제합니다. |
update-password-alias |
명명된 대상의 비밀번호 별칭 아이디를 업데이트합니다. |
list-password-aliases |
모든 비밀번호 별칭을 나열합니다. |
change-admin-password |
이 원격 명령은 관리 비밀번호를 수정합니다. 이 명령은 대화식으로 실행되며 이전 관리 비밀번호 및 새 관리 비밀번호(비밀번호 확인 포함)를 입력하라는 메시지를 표시합니다. |
change-master-password |
이 로컬 명령은 마스터 비밀번호를 수정합니다. 이 명령은 대화식으로 실행되며 이전 마스터 비밀번호 및 새 마스터 비밀번호를 입력하라는 메시지를 표시합니다. 서버가 중지되지 않으면 이 명령이 작동하지 않습니다. |
XML 검증자 명령은 domain.xml 파일의 내용을 검증합니다.
표 C–22 검증 명령
명령 |
정의 |
---|---|
verify-domain-xml |
domain.xml 파일의 내용을 검증합니다. |
MBean 명령을 사용하면 사용자 정의 MBean을 관리하고 등록할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.
표 C–23 사용자 정의 MBean 명령
명령 |
정의 |
---|---|
create-mbean |
사용자 정의 MBean을 만들고 등록합니다. 대상 MBeanServer가 실행 중이 아니면 MBean이 등록되지 않습니다. |
delete-mbean |
사용자 정의 MBean을 삭제합니다. 대상 MBeanServer가 실행 중인지 확인합니다. |
list-mbeans |
지정된 대상의 사용자 정의 MBean을 나열합니다. |
서비스 명령을 사용하여 DAS(Domain Administration Server)의 시작을 구성할 수 있습니다.
표 C–24 서비스 명령
명령 |
정의 |
---|---|
create-service |
자동 부트 시 DAS 시작을 구성합니다. Solaris 10의 경우 이 명령은 SMF(Service Management Facility)를 사용합니다. 이 명령은 로컬 명령으로 수퍼유저 권한을 가진 OS 수준의 사용자로 실행해야 합니다. 이 명령은 Solaris 10에서만 사용할 수 있습니다. 서비스가 만들어지면 사용자는 이 서비스를 시작, 활성화, 비활성화, 삭제 또는 중지해야 합니다. DAS는 수퍼유저가 액세스할 수 있는 폴더에 저장되어야 합니다. 구성은 네트워크 파일 시스템에 저장할 수 없습니다. DAS의 구성이 있는 폴더를 소유한 OS 수준의 사용자가 제어할 수 있도록 서비스가 만들어집니다. 이 명령을 실행하려면 solaris.smf.* 권한이 있어야 합니다. |
참조되는 구성에 정의된 속성을 대체하기 위해 공유 서버 인스턴스가 필요한 경우가 있습니다. 서버 인스턴스의 모든 구성 속성은 해당 이름의 시스템 등록 정보를 통해 대체될 수 있습니다. 시스템 등록 정보 명령을 사용하여 이러한 공유 서버 인스턴스를 관리할 수 있습니다.
표 C–25 등록 정보 명령
명령 |
정의 |
---|---|
create-system-property |
도메인, 구성 또는 서버 인스턴스에 대해 한 번에 하나의 시스템 등록 정보를 만듭니다. |
delete-system-property |
도메인, 구성 또는 서버 인스턴스에 대해 하나의 시스템 등록 정보를 제거합니다. |
list-system-properties |
도메인, 구성 또는 서버 인스턴스의 시스템 등록 정보를 표시합니다. |