Sun Java System Application Server Enterprise Edition 8.2 관리 설명서

19장 asadmin 유틸리티

Application Server에는 asadmin으로 알려진 명령줄 관리 유틸리티가 포함되어 있습니다. asadmin 유틸리티는 사용자, 자원 및 응용 프로그램 관리뿐 아니라 Application Server 시작 및 중지에도 사용됩니다.

이 장은 다음 내용으로 구성되어 있습니다.

asadmin 명령 사용법

asadmin 유틸리티를 사용하면 Application Server의 모든 관리 작업을 수행할 수 있습니다. 관리 콘솔을 사용하는 대신 이 asadmin 유틸리티를 사용할 수 있습니다.

asadmin 유틸리티는 수행할 작업을 식별하는 명령을 호출합니다. 이 명령은 대소문자를 구분합니다. 짧은 옵션 인수에는 한 개의 대시(-)를 붙이고 긴 옵션 인수에는 두 개의 대시(--)를 붙입니다. 옵션은 유틸리티가 명령을 수행하는 방법을 제어합니다. 옵션도 대소문자를 구분합니다. 기능의 ON, OFF를 전환하는 부울 옵션을 제외한 대부분의 옵션에는 인수 값이 필요합니다. 피연산자는 인수 값 뒤에 붙이며 공백, 탭 또는 이중 대시(--)로 구분됩니다. asadmin 유틸리티는 옵션 및 해당 값 뒤에 나오는 모든 부분을 피연산자로 간주합니다.


예 19–1 구문 예

asadmin command [-short_option] [short_option_argument]* [--long_option [long_option_argument]* [operand]*

asadmin create-profiler -u admin --passwordfile password.txt myprofiler


Solaris 플랫폼에서 Application Server asadmin 유틸리티 명령에 대한 설명서 페이지에 액세스하려면 MANPATH 환경 변수에 $AS_INSTALL/man을 추가하십시오.

--help 옵션을 호출하면 모든 asadmin 유틸리티 명령에 대한 전체 사용법 정보를 얻을 수 있습니다. 명령을 지정하면 해당 명령에 대한 사용법 정보가 표시됩니다. 명령을 지정하지 않고 --help 옵션을 사용하면 사용 가능한 모든 명령 목록이 표시됩니다.


예 19–2 help 명령 예

asadmin --help - 일반 도움말을 표시합니다.

asadmin command --help - 지정된 명령에 대한 도움말을 표시합니다.


이 절은 다음 내용으로 구성되어 있습니다.

다중 모드 및 대화식 모드

asadmin 유틸리티는 명령 쉘 호출 또는 다중 명령 모드(multimode 명령으로 알려져 있음)로 사용할 수 있습니다. 명령 쉘 호출의 경우 명령 쉘에서 asadmin 유틸리티를 호출합니다. asadmin은 명령을 실행한 다음 종료됩니다. 다중 명령 모드의 경우 asadmin이 한 번 호출되면 asadmin을 종료하여 정상 명령 쉘 호출로 돌아가기 전까지 여러 번의 명령 실행이 허용됩니다. 다중 명령 모드에서 설정된 환경 변수는 multimode를 종료하기 전까지 모든 후속 명령에 사용됩니다. 파일 또는 표준 입력(파이프)에서 이전에 준비된 명령 목록을 전달하여 명령을 입력할 수 있습니다. 다중 모드 세션 중에 multimode를 호출할 수 있으며 이때 두 번째 다중 모드 환경을 종료하면 원래 다중 모드 환경으로 돌아갑니다.

asadmin 유틸리티를 대화식 또는 비대화식 모드로 실행할 수도 있습니다. 기본적으로 대화식 모드 옵션이 활성화됩니다. 대화식 모드 옵션을 활성화할 때에는 필수 인수를 입력하라는 메시지가 표시됩니다. 모든 환경에서 명령 쉘 호출로 대화식 모드 옵션을 사용할 수 있습니다. 명령 프롬프트에서 한 번에 하나의 명령을 실행하고 파일에서 명령을 multimode로 실행하는 경우 multimode로 대화식 모드 옵션을 사용할 수 있습니다. 입력 스트림에서 파이프된 경우 multimode의 명령 및 다른 프로그램에서 호출된 명령은 대화식 모드로 실행되지 않습니다.

로컬 명령

로컬 명령은 관리 서버가 없는 상태에서 실행할 수 있습니다. 그러나 사용자는 명령을 실행하고 설치 및 도메인 디렉토리에 대한 액세스 권한을 갖기 위해 도메인을 호스팅하는 시스템에 로그인해야 합니다.

해당 환경 또는 명령줄에서 로컬 또는 원격으로 실행할 수 있는 명령에 --host, --port, --user--passwordfile 옵션 중 하나를 설정하면 이 명령은 원격 모드로 실행됩니다. 명령줄 또는 해당 환경에서 로컬 옵션을 설정하지 않으면 기본적으로 이 명령은 로컬로 실행됩니다.

원격 명령

원격 명령은 항상 관리 서버에 연결된 상태로 해당 관리 서버에서 실행됩니다. 관리 서버가 실행 중이어야 합니다. 모든 원격 명령에는 다음 명령 옵션이 필요합니다.

표 19–1 원격 명령의 필수 옵션

짧은 옵션 

옵션 

정의 

-H

--host

도메인 관리 서버가 실행 중인 시스템 이름입니다. 기본값은 localhost입니다. 

-p

--port

관리용 HTTP/S 포트입니다. 이 포트는 도메인을 관리할 수 있도록 사용자의 브라우저를 가리켜야합니다. 예를 들면 다음과 같습니다. http://localhost:4848. Platform Edition의 기본 포트 번호는 4848입니다.

-u

--user

인증된 도메인 관리 서버 관리 사용자 이름입니다. asadmin login 명령을 사용하여 도메인에 인증한 경우 이 특정 도메인에 대해서는 후속 작업 시 --user 옵션을 지정할 필요가 없습니다.

 

--passwordfile

-‐passwordfile 옵션은 특정 형식의 비밀번호 항목이 포함된 파일의 이름을 지정합니다. 비밀번호 항목에는 AS_ADMIN_ 접두어가 있어야 하며 뒤에 대문자로 된 비밀번호 이름이 나와야 합니다.

예를 들어, 도메인 관리 서버 비밀번호를 지정하려면 다음 형식의 항목을 사용합니다. AS_ADMIN_PASSWORD=password. 여기서, password는 실제 관리자 비밀번호입니다. 지정할 수 있는 다른 비밀번호에는 AS_ADMIN_PASSWORD, AS_ADMIN_USERPASSWORDAS_ADMIN_ALIASPASSWORD, AS_ADMIN_MAPPEDPASSWORD가 있습니다.

모든 원격 명령 실행 시에는 -‐passwordfile이나 asadmin login을 사용하거나 명령 프롬프트에서 대화식 방법을 사용하여 관리 비밀번호를 지정함으로써 도메인 관리 서버에 인증해야 합니다. asadmin login 명령은 관리 비밀번호를 지정하는 경우에만 사용할 수 있습니다. 원격 명령에 다른 비밀번호를 지정해야 하는 경우에는 -‐passwordfile을 사용하거나 명령 프롬프트에서 해당 비밀번호를 입력합니다.

asadmin login 명령을 사용하여 도메인에 인증한 경우 이 특정 도메인에 대해서는 후속 작업 시 -‐passwordfile 옵션을 통해 관리 비밀번호를 지정할 필요가 없습니다. 그러나 이 절차는 AS_ADMIN_PASSWORD 옵션에만 적용됩니다. 하지만 update-file-user와 같은 개별 명령에서 요구하는 경우 AS_ADMIN_USERPASSWORD와 같은 다른 비밀번호를 입력해야 합니다.

보안상 환경 변수로 지정된 비밀번호는 asadmin으로 읽을 수 없습니다.

-s

--secure

true로 설정되면 SSL/TLS를 사용하여 도메인 관리 서버와 통신합니다. 

-I

--interactive

true로 설정되면(기본값) 필수 비밀번호와 사용자 옵션을 입력하라는 메시지만 표시됩니다. 

-t

--terse

일반적으로 서술형 문장을 배제하고 스크립트 사용에 적합한 형식이 되도록 출력 데이터를 간결화합니다. 기본값은 false입니다. 

-e

--echo

true로 설정되면 명령줄 명령이 표준 출력에 표시됩니다. 기본값은 false입니다. 

-h

--help

명령에 대한 도움말 텍스트를 표시합니다. 

비밀번호 파일

보안상의 목적으로 명령줄에서 비밀번호를 입력하는 대신 명령에 대한 비밀번호를 파일에서 설정할 수 있습니다. --passwordfile 옵션을 사용하면 비밀번호가 포함된 파일이 사용됩니다. 파일의 유효한 내용은 다음과 같습니다.


예 19–3 passwordfile 내용


AS_ADMIN_PASSWORD=value
AS_ADMIN_ADMINPASSWORD=value
AS_ADMIN_USERPASSWORD=value
AS_ADMIN_MASTERPASSWORD=value

다중 모드 명령

multimode 명령을 사용하여 asadmin 명령을 처리할 수 있습니다. 명령줄 인터페이스에서 명령을 입력하라는 메시지를 표시하고, 입력된 명령을 실행하며, 명령에 대한 결과를 표시합니다. 그런 다음 다시 다음 명령을 입력하라는 메시지를 표시합니다. 또한, 이 모드에서 설정된 모든 asadmin 옵션 이름은 이에 대한 모든 후속 명령에 사용됩니다. 사용자 환경을 설정할 수 있으며 “exit” 또는 “quit”를 입력하여 multimode를 종료하기 전까지 명령을 실행할 수 있습니다.파일 또는 표준 입력(파이프)에서 이전에 준비한 명령 목록을 전달하여 명령을 제공할 수도 있습니다. 다중 모드 세션 내에서 multimode를 호출할 수 있으며, 두 번째 다중 모드 환경을 종료하면 원래 다중 모드 환경으로 돌아갑니다.

다중 모드를 호출하려면 asadmin multimode를 입력합니다.

나열, 가져오기 및 설정 명령

asadmin list, getset 명령을 함께 사용하면 이름이 점으로 구분된 Application Server의 계층에 대한 탐색 메커니즘이 제공됩니다. 다음과 같은 두 가지 계층이 있으며 이러한 명령은 두 계층 모두에서 작동합니다. 구성모니터링. list 명령은 읽기 전용의 또는 수정 가능한 속성을 갖는 관리 구성 요소의 점으로 구분된 정규화된 이름을 제공합니다.

구성 계층은 수정 가능한 속성을 제공하지만, 모니터링 계층은 읽기 전용의 관리 구성 요소 속성만을 제공합니다. 구성 계층은 어느 정도 도메인의 스키마 문서를 기반으로 하지만, 모니터링 계층은 조금 다릅니다.

list 명령을 사용하면 원하는 계층의 특정 관리 구성 요소에 연결할 수 있습니다. 그런 다음 getset 명령을 호출하면 이름 및 값을 얻거나 관리 구성 요소의 속성 값을 직접 설정할 수 있습니다. 와일드카드(*) 옵션을 사용하면 점으로 구분된 정규화된 해당 이름과 일치하는 모든 항목을 불러올 수 있습니다.

Application Server의 점으로 구분된 이름은 “.”(마침표)를 구분자로 사용하여 전체 이름을 구성하는 부분을 구분합니다. 이는 UNIX 파일 시스템에서 파일에 대한 절대 경로 이름의 수준을 구분하는 데 “/” 문자를 사용하는 것과 비슷합니다. get, setlist 명령에서 허용되는 점으로 구분된 이름을 구성할 때 다음 규칙이 적용됩니다. 특정 명령에는 일부 추가 어휘가 적용됩니다.

list 명령은 이 세 명령의 탐색 기능의 기반입니다. 특정 응용 프로그램 서버 하위 시스템의 속성을 set 또는 get하려면 점으로 구분된 해당 이름을 알고 있어야 합니다. list는 해당 하위 시스템의 점으로 구분된 이름을 찾을 수 있도록 해주는 명령입니다. 예를 들어, 대용량 파일 시스템의 특정 파일에서 /로 시작하는 수정된 날짜(속성)를 찾으려는 경우 이 명령을 사용할 수 있습니다. 먼저 파일 시스템에서 해당 파일의 위치를 찾은 다음 해당 속성을 확인할 수 있으므로 Application Server의 계층을 인식하는 첫 번째 두 명령은 * list "*"<command>* list * -‐monitor가 됩니다. 이 명령에 대한 정렬된 출력을 식별하려면 get, set 또는 list 명령 설명서 페이지를 참조하십시오.

서버 라이프사이클 명령

서버 라이프사이클 명령은 도메인, 서비스(DAS) 또는 인스턴스를 만들고 삭제하거나 시작하고 중지하는 명령입니다.

표 19–2 서버 라이프사이클 명령

명령 

정의 

create-service

자동 부트 시 DAS 시작을 구성합니다. Solaris 10의 경우 이 명령은 SMF(Service Management Facility)를 사용합니다. 이 명령은 로컬 명령으로 수퍼유저 권한을 가진 OS 수준의 사용자로 실행해야 합니다. 이 명령은 Solaris 10에서만 사용할 수 있습니다. 서비스가 만들어지면 사용자는 이 서비스를 시작, 활성화, 비활성화, 삭제 또는 중지해야 합니다. DAS는 수퍼유저가 액세스할 수 있는 폴더에 저장되어야 합니다. 구성은 네트워크 파일 시스템에 저장할 수 없습니다. DAS의 구성이 있는 폴더를 소유한 OS 수준의 사용자가 제어할 수 있도록 서비스가 만들어집니다. 이 명령을 실행하려면 solaris.smf.* 권한이 있어야 합니다.

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

명명된 도메인의 파일을 백업합니다. 

list-backups

백업 저장소의 모든 백업에 대한 상태 정보를 표시합니다. 

shutdown

관리 서버 및 실행 중인 모든 인스턴스를 적절하게 중지합니다. 관리 서버를 다시 시작하려면 수동으로 시작해야 합니다. 

List 및 Status 명령

List 및 Status 명령은 배포된 구성 요소의 상태를 표시합니다.

표 19–3 List 및 Status 명령

명령 

정의 

show-component-status

배포된 구성 요소의 상태를 가져옵니다. 상태는 서버에서 반환된 문자열 표현입니다. 상태 문자열에는 "app-name의 상태: enabled" 또는 "app-name의 상태: disabled"를 사용할 수 있습니다.

list-components

배포된 모든 Java EE 5 구성 요소를 나열합니다. --type 옵션이 지정되지 않은 경우 모든 구성 요소가 나열됩니다.

list-sub-components

배포된 모듈 또는 배포된 응용 프로그램의 모듈에 있는 EJB 또는 서블릿을 나열합니다. 모듈이 식별되지 않으면 모든 모듈이 나열됩니다. 

배포 명령

배포 명령은 응용 프로그램을 배포하거나 클라이언트 스텁을 가져옵니다.

표 19–4 배포 명령

명령 

정의 

deploy

엔터프라이즈 응용 프로그램, 웹 응용 프로그램, EJB 모듈, 커넥터 모듈 또는 응용 프로그램 클라이언트 모듈을 배포합니다. 구성 요소가 이미 배포되었거나 존재하는 경우 -‐force 옵션을 true로 설정하면 구성 요소가 강제로 재배포됩니다.

deploydir

응용 프로그램을 개발 디렉토리에서 직접 배포합니다. Java EE 사양을 준수하는 적합한 디렉토리 계층 및 배포 설명자가 배포 디렉토리에 있어야 합니다. 

get-client-stubs

AppClient 독립 실행형 모듈 또는 AppClient 모듈이 포함된 응용 프로그램의 클라이언트 스텁 JAR 파일을 서버 시스템에서 로컬 디렉토리로 가져옵니다. 이 명령을 실행하기 전에 응용 프로그램 또는 모듈을 배포해야 합니다. --retrieve 옵션을 사용하여 deploy 명령의 일부로 클라이언트 스텁을 가져올 수도 있습니다.

undeploy

배포된 지정 구성 요소를 제거합니다. 

Message Queue 관리 명령

Message Queue 관리 명령을 사용하면 JMS 대상을 관리할 수 있습니다.

표 19–5 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할 수 없는 경우 오류 메시지가 표시됩니다. 

자원 관리 명령

자원 명령을 사용하면 응용 프로그램에 사용되는 다양한 자원을 관리할 수 있습니다.

표 19–6 자원 관리 명령

명령 

정의 

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 파일에서 DOCTYPEinstall_dir/lib/dtds/sun-resources_1_2.dtd로 지정되어야 합니다.

ping-connection-pool

연결 풀을 JDBC 연결 풀 및 커넥터 연결 풀 모두에 사용할 수 있는지 테스트합니다. 예를 들어, 나중에 배포될 것으로 예상되는 응용 프로그램에 새 JDBC 연결 풀을 만든 경우 응용 프로그램을 배포하기 전에 JDBC 풀이 이 명령으로 테스트됩니다. 연결 풀을 ping하기 전에 인증이 있는 연결 풀을 만들어야 하며 Application Server 또는 데이터베이스가 시작되었는지 확인해야 합니다. 

Application Server 구성 명령

구성 명령을 사용하면 Application Server 작업을 구성할 수 있습니다. 이 절은 다음 내용으로 구성되어 있습니다.

일반 구성 명령

이 명령을 사용하면 Application Server 구성 요소의 구성을 관리할 수 있습니다.

표 19–7 일반 구성 명령

명령 

정의 

enable

지정된 구성 요소를 활성화합니다. 구성 요소가 이미 활성화되어 있는 경우 구성 요소가 다시 활성화됩니다. 구성 요소를 활성화하려면 배치되어 있어야 합니다. 구성 요소가 배포되어 있지 않은 경우에는 오류 메시지가 반환됩니다. 

disable

명명된 구성 요소를 즉시 비활성화합니다. 구성 요소가 배포되어 있어야 합니다. 구성 요소가 배포되어 있지 않은 경우에는 오류 메시지가 반환됩니다. 

export

후속 명령 환경을 위한 자동 내보내기 변수 이름을 표시합니다. 모든 후속 명령은 명령을 unset하거나 multimode를 종료하지 않는 한 지정된 변수 이름 값을 사용합니다.

get

속성 이름 및 값을 가져옵니다. 

set

구성 가능한 속성 값을 한 개 이상 설정합니다. 

list

구성 가능한 요소를 나열합니다. Solaris의 경우 *가 포함된 명령을 옵션 값 또는 피연산자로 실행할 때 따옴표가 필요합니다.

unset

다중 모드 환경에서 설정한 변수를 한 개 이상 제거합니다. 변수 및 연관된 값이 환경에서 제거됩니다. 

HTTP, IIOP 및 SSL Listener 명령

HTTP 및 IIOP Listener 명령은 Listener 관리 작업을 도와줍니다. 이 명령은 원격 모드에서만 지원됩니다.

표 19–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를 나열합니다. 

create-ssl

선택한 HTTP Listener, IIOP Listener 또는 IIOP 서비스에 SSL 요소를 만들고 구성하여 해당 Listener/서비스의 보안 통신을 활성화합니다. 

delete-ssl

선택한 HTTP Listener, IIOP Listener 또는 IIOP 서비스의 SSL 요소를 삭제합니다. 

라이프사이클 및 감사 모듈 명령

라이프사이클 및 감사 모듈 명령은 라이프사이클 모듈 및 감사 기능을 구현하는 선택 사항의 플러그인 모듈을 제어하는 데 도움을 줍니다. 이 명령은 원격 모드에서만 지원됩니다.

표 19–9 라이프사이클 모듈 명령

명령 

정의 

create-lifecycle-module

라이프사이클 모듈을 만듭니다. 라이프사이클 모듈은 Application Server 환경 내에서 기간이 짧거나 긴 Java 기반의 작업을 실행하는 수단을 제공합니다. 

delete-lifecycle-module

지정된 라이프사이클 모듈을 제거합니다. 

list-lifecycle-modules

기존 라이프사이클 모듈을 나열합니다. 

create-audit-module

감사 기능을 구현하는 플러그인 모듈에 명명된 감사 모듈을 추가합니다. 

delete-audit-module

명명된 감사 모듈을 제거합니다. 

list-audit-modules

모든 감사 모듈을 나열합니다. 

프로필러 및 JVM 옵션 명령

프로필러 및 JVM 옵션 명령을 사용하면 프로필러를 관리하고 해당 요소를 제어할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.

표 19–10 프로필러 및 JVM 옵션 명령

명령 

정의 

create-profiler

프로필러 요소를 만듭니다. Java 구성의 프로필러 요소는 서버 인스턴스를 특정 프로필러와 연결합니다. 프로필러를 변경하려면 서버를 다시 시작해야 합니다. 

delete-profiler

지정된 프로필러 요소를 삭제합니다. Java 구성의 프로필러 요소는 서버 인스턴스를 특정 프로필러로 묶습니다. 프로필러를 변경하려면 서버를 다시 시작해야 합니다. 

create-jvm-option

Java 구성의 JVM 옵션 또는 domain.xml 파일의 프로필러 요소를 만듭니다. 프로필러에 만든 JVM 옵션은 특정 프로필러를 실행하는 데 필요한 설정을 기록할 때 사용합니다. 새로 만든 JVM 옵션을 적용하려면 서버를 다시 시작해야 합니다.

delete-jvm-option

Java 구성의 JVM 옵션 또는 domain.xml 파일의 프로필러 요소를 제거합니다.

가상 서버 명령

가상 서버 명령을 사용하면 해당 요소를 제어할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.

표 19–11 가상 서버 명령

명령 

정의 

create-virtual-server

명명된 가상 서버를 만듭니다. Application Server를 가상화하면 여러 호스트 주소를 수신하는 단일 HTTP 서버 프로세스를 통해 여러 URL 도메인을 서비스할 수 있습니다. 응용 프로그램이 두 개의 가상 서버에서 사용 가능한 경우 이 가상 서버는 계속해서 동일한 물리적 자원 풀을 공유합니다. 

delete-virtual-server

지정된 가상 서버 아이디를 가진 가상 서버를 제거합니다. 

list-virtual-server

기존 가상 서버를 나열합니다. 

스레드 풀 명령

스레드 풀 명령을 사용하면 해당 요소를 제어할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.

표 19–12 스레드 풀 명령

명령 

정의 

create-threadpool

지정된 이름을 사용하여 스레드 풀을 만듭니다. 풀 내 스레드의 최대 및 최소 개수, 작업 대기열 수 및 스레드의 유휴 시간 초과를 지정할 수 있습니다. 만들어진 스레드 풀은 IIOP 요청을 서비스할 때 및 자원 어댑터가 작업 관리 요청을 서비스할 때 사용할 수 있습니다. 만들어진 스레드 풀은 여러 자원 어댑터에 사용할 수 있습니다. 

delete-threadpool

명명된 아이디를 가진 스레드 풀을 제거합니다. 

list-threadpools

모든 스레드 풀을 나열합니다. 

트랜잭션 및 타이머 명령

트랜잭션 및 타이머 명령을 사용하면 트랜잭션 및 타이머 하위 시스템을 제어할 수 있으며 실행 중인 트랜잭션을 일시 중지할 수도 있습니다. 이 명령은 원격 모드에서만 지원됩니다.

표 19–13 트랜잭션 명령

명령 

정의 

freeze-transaction

실행 중인 모든 트랜잭션이 일시 중지되도록 트랜잭션 하위 시스템을 중단합니다. 실행 중인 트랜잭션을 롤백하기 전에 이 명령을 호출합니다. 이미 중단된 트랜잭션 하위 시스템에서 이 명령을 호출하는 경우 아무런 영향을 주지 않습니다. 

unfreeze-transaction

일시 중지된 모든 실행 트랜잭션을 다시 시작합니다. 이미 중단된 트랜잭션에서 이 명령을 호출합니다. 

recover-transactions

보류 중인 트랜잭션을 수동으로 복구합니다. 

rollback-transaction

명명된 트랜잭션을 롤백합니다. 

list-timers

특정 서버 인스턴스가 소유한 타이머를 나열합니다.  

사용자 관리 명령

이 사용자 명령을 사용하면 파일 영역 인증에서 지원되는 사용자를 관리할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.

표 19–14 사용자 관리 명령

명령 

정의 

create-file-user

지정된 사용자 이름, 비밀번호 및 그룹을 사용하여 키 파일에 항목을 만듭니다. 콜론(:)으로 그룹을 구분하여 여러 그룹을 만들 수 있습니다.

delete-file-user

키 파일에서 지정된 사용자 이름을 가진 항목을 삭제합니다. 

update-file-user

지정된 user_name, user_password 및 그룹을 사용하여 키 파일의 기존 항목을 업데이트합니다. 콜론(:)으로 그룹을 구분하여 여러 그룹을 입력할 수 있습니다.

list-file-users

파일 영역 인증에서 지원되는 파일 사용자 목록을 만듭니다. 

list-file-groups

파일 영역 인증에서 지원되는 사용자 및 그룹을 나열합니다. 이 명령은 파일 사용자가 사용할 수 있는 그룹을 나열합니다. 

모니터링 데이터 명령

모니터링 데이터 명령을 사용하면 서버를 모니터할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.

표 19–15 모니터링 데이터 명령

명령 

정의 

start-callflow-monitoring

웹 컨테이너, EJB 컨테이너 및 JDBC에서 데이터를 수집하고 상관 관계를 지정하여 요청의 전체 호출 흐름/경로를 제공합니다. callflow-monitoring이 ON으로 지정된 경우에만 데이터를 수집할 수 있습니다.

stop-callflow-monitoring

요청의 호출 흐름 정보 수집을 비활성화합니다. 

규칙 명령

규칙 명령을 사용하면 서버의 규칙을 관리할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.

표 19–16 규칙 명령

명령 

정의 

create-management-rule

새 관리 규칙을 만들어 Application Server 설치 및 배포된 응용 프로그램을 지능적으로 자체 관리합니다.  

delete-management-rule

지정된 관리 규칙을 제거합니다. 

list-management-rules

사용 가능한 관리 규칙을 나열합니다. 

데이터베이스 명령

데이터베이스 명령을 사용하면 Java DB 데이터베이스(Apache Derby를 기반으로 함)를 시작하고 중지할 수 있습니다. 이 명령은 로컬 모드에서만 지원됩니다.

표 19–17 데이터베이스 명령

명령 

정의 

start-database 

Application Server와 함께 사용할 수 있는 Java DB 서버를 시작합니다. Application Server에 배포된 응용 프로그램 작업을 수행하는 경우에만 이 명령을 사용합니다. 

stop-database 

Java DB 서버 프로세스를 중지합니다. Java DB 서버는 Application Server와 함께 사용할 수 있습니다. 

진단 및 로깅 명령

진단 및 로깅 명령은 Application Server의 문제를 해결하는 데 도움을 줍니다. 이 명령은 원격 모드에서만 지원됩니다.

표 19–18 진단 및 로깅 명령

명령 

정의 

generate-diagnostic-report

응용 프로그램 서버 인스턴스의 구성 세부 정보, 로깅 세부 정보 또는 프로세스별 정보와 같은 응용 프로그램 서버 설치 세부 정보에 대한 탐색 링크나 포인터가 포함된 HTML 보고서를 생성합니다. 

generate-jvm-report

Domain Administration Service를 포함한 해당 대상 인스턴스의 스레드(스택 추적 덤프), 클래스 및 메모리를 표시합니다. 이 명령은 응용 프로그램 서버 인스턴스 프로세스에만 사용됩니다. 이 명령은 응용 프로그램 서버 프로세스에 ctrl+break 또는 kill -3 신호를 보내는 것과 같은 이전 기술을 대체합니다. 대상 서버 인스턴스가 실행 중이 아니면 이 명령은 작동하지 않습니다.

display-error-statistics

마지막으로 서버가 다시 시작된 후 server.log에 기록된 심각도 및 경고에 대한 요약 목록을 표시합니다.

display-error-distribution

모듈 수준에서 인스턴스 오류 server.log의 배포를 표시합니다.™

display-log-records

지정된 모듈에 대한 모든 오류 메시지를 지정된 타임스탬프에 표시합니다. 

웹 서비스 명령

웹 서비스 명령을 사용하면 배포된 웹 서비스를 모니터하고 변환 규칙을 관리할 수 있습니다.

표 19–19 웹 서비스 명령

명령 

정의 

configure-webservice-management

배포된 웹 서비스 종점의 maxhistorysize 속성 또는 모니터링을 구성합니다.

create-transformation-rule

웹 서비스 작업에 적용할 수 있는 XSLT 변환 규칙을 만듭니다. 이 규칙은 요청 및 응답에 적용할 수 있습니다. 

delete-transformation-rule

지정된 웹 서비스의 XSLT 변환 규칙을 삭제합니다. 

list-transformation-rules

지정된 웹 서비스의 모든 변환 규칙을 적용된 순서대로 나열합니다. 

publish-to-registry

웹 서비스 아티팩트를 레지스트리 서버에 게시합니다. 

unpublish-from-registry

레지스트리 서버의 웹 서비스 아티팩트 게시를 취소합니다. 

list-registry-locations

구성된 웹 서비스 항목의 액세스 지점에 대한 목록을 표시합니다. 

보안 서비스 명령

이 보안 명령을 사용하면 커넥터 연결 풀에 대한 보안 매핑을 제어할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.

표 19–20 보안 명령

명령 

정의 

create-connector-security-map

지정된 커넥터 연결 풀에 대한 보안 맵을 만듭니다. 보안 맵이 없는 경우 새 맵이 만들어집니다. 또한, 이 명령을 사용하여 응용 프로그램(principal 또는 사용자 그룹)의 호출자 아이디를 컨테이너 관리 트랜잭션 기반 시나리오의 적절한 EIS(Enterprise Information System) principal로 매핑합니다. 한 개 이상의 명명된 보안 맵을 커넥터 연결 풀에 연관시킬 수 있습니다. 커넥터 보안 맵 구성은 모든 사용자 또는 사용자 그룹을 나타낼 수 있도록 와일드카드 문자(*) 사용을 지원합니다. 이 명령을 성공적으로 실행하려면 먼저 커넥터 연결 풀을 만들어야 합니다. EIS는 조직 데이터를 보관하는 시스템입니다. 이는 메인프레임, 메시징 시스템, 데이터베이스 시스템 또는 응용 프로그램일 수 있습니다.

delete-connector-security-map

지정된 커넥터 연결 풀에 대한 보안 맵을 삭제합니다. 

update-connector-security-map

지정된 커넥터 연결 풀에 대한 보안 맵을 수정합니다. 

list-connector-security-maps

지정된 커넥터 연결 풀에 속한 보안 맵을 나열합니다. 

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.xmlmessage-security-config 요소).

create-auth-realm

명명된 인증 영역을 추가합니다. 

delete-auth-realm

명명된 인증 영역을 제거합니다. 

list-auth-realms

기존 인증 영역을 나열합니다. 

비밀번호 명령

비밀번호 명령을 사용하면 비밀번호를 관리할 수 있으며 Application Server의 보안을 확보할 수 있습니다.

표 19–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

이 로컬 명령은 마스터 비밀번호를 수정합니다. 이 명령은 대화식으로 실행되며 이전 마스터 비밀번호 및 새 마스터 비밀번호를 입력하라는 메시지를 표시합니다. 서버가 중지되지 않으면 이 명령이 작동하지 않습니다. 

domain.xml 검증 명령

XML 검증 명령은 domain.xml 파일의 내용을 검증합니다.

표 19–22 domain.xml 검증 명령

명령 

정의 

verify-domain-xml

domain.xml 파일의 내용을 검증합니다.

사용자 정의 MBean 명령

MBean 명령을 사용하면 사용자 정의 MBean을 관리하고 등록할 수 있습니다. 이 명령은 원격 모드에서만 지원됩니다.

표 19–23 사용자 정의 MBean 명령

명령 

정의 

create-mbean

사용자 정의 MBean을 만들고 등록합니다. 대상 MBeanServer(DAS)가 실행 중이 아니면 MBean이 등록되지 않습니다.

delete-mbean

사용자 정의 MBean을 삭제합니다. 대상 MBeanServer가 실행 중인지 확인합니다.

list-mbeans

지정된 대상의 사용자 정의 MBean을 나열합니다. 

기타 명령

기타 명령을 사용하면 Application Server의 다양한 측면을 관리할 수 있습니다.

표 19–24 기타 명령

명령 

정의 

login

도메인에 로그인합니다. 여러 시스템에 다양한 응용 프로그램 서버 도메인이 로컬로 만들어진 경우 한 시스템에서 asadmin을 호출하여 다른 곳에 있는 도메인을 원격으로 관리할 수 있습니다. 특히, 특정 시스템이 관리 클라이언트로 선택되어 여러 도메인 및 서버를 관리할 때 편리합니다. 다른 곳에 있는 도메인을 관리하는 데 사용되는 asadmin 명령을 원격 명령이라고 합니다. asadmin login 명령을 사용하면 이러한 원격 도메인을 쉽게 관리할 수 있습니다. login 명령은 대화식 모드에서만 실행됩니다. 이 명령을 실행하면 관리 사용자 이름과 비밀번호를 입력하라는 메시지가 표시됩니다. 로그인에 성공하면 .asadminpass 파일이 사용자의 홈 디렉토리에 만들어집니다. 이 파일은 -‐savelogin 옵션을 사용한 create-domain 명령으로 수정된 파일과 동일합니다. 이 명령을 실행하려면 도메인이 실행 중이어야 합니다.

version

버전 정보를 표시합니다. 지정된 사용자/비밀번호 및 호스트/포트를 사용하여 명령이 응용 프로그램 서버와 통신할 수 없는 경우 해당 명령은 로컬에서 버전을 검색하고 경고 메시지를 표시합니다. 

help

모든 asadmin 유틸리티 명령에 대한 목록을 표시합니다. 명령을 지정하면 해당 명령에 대한 사용법 정보가 표시됩니다.

install-license

Application Server의 인증되지 않은 사용을 방지합니다. 라이센스 파일을 설치합니다.