명령줄 인터페이스 사용

이 장에서는 시스템 명령 프롬프트에서 한 번에 하나의 명령을 실행하는 단일 모드, 환경 수준 정보를 다시 입력할 필요 없이 여러 개의 명령을 실행할 수 있는 다중 모드, 스크립트 및 프로그램에 명령줄 인터페이스(asadmin 유틸리티)를 사용하는 지침을 제공합니다. 관리 인터페이스 화면 대신 명령줄 인터페이스를 사용할 수 있습니다.

이 장에서는 다음 내용을 설명합니다.

• 명령줄 인터페이스 정보
• asadmin 사용
• 보안 고려 사항
• 동시에 액세스할 때 고려해야 할 사항
• 명령 참조

명령줄 인터페이스 정보

---

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

• asadmin 유틸리티 정보
• Ant 작업 정보
• 기타 명령줄 유틸리티 정보

asadmin 유틸리티 정보

asadmin 유틸리티는 모든 구성 및 관리 작업을 수행합니다. 관리 인터페이스 대신 이 유틸리티를 사용할 수 있습니다.

Ant 작업 정보

많은 개발자들이 J2EE 응용 프로그램의 개발 프로세스를 가속화하기 위해 Ant를 사용합니다. Ant 스크립트는 몇 가지 작업에 asadmin 유틸리티를 사용합니다. 개발자는 응용 프로그램 구축, 모듈 및 응용 프로그램의 배포 및 배포 해제, Sun ONE Application Server 관리에 Ant 작업을 사용합니다.

Ant 작업에 대한 자세한 내용은 Sun ONE Application Server Developer's Guide를 참조하십시오.

Ant에 대한 자세한 내용은 Jakarta Project 사이트 http://jakarta.apache.org/ant/를 참조하십시오.

기타 명령줄 유틸리티 정보

Sun ONE Application Server에는 추가적인 명령줄 유틸리티가 있습니다. 다음 표에는 유틸리티 목록과 그에 대한 간단한 설명이 있습니다.

   기타 명령줄 유틸리티

유틸리티	정의
appclient	응용 프로그램 클라이언트 컨테이너를 시작하고 응용 프로그램 JAR 파일에 패키지화된 클라이언트 응용 프로그램을 호출합니다.
capture-schema	데이터베이스 스키마와 매핑 정보를 가져옵니다.
flexanlg	서버에 대한 통계를 생성합니다.
htpasswd	사용자 인증 파일을 만듭니다.
package-appclient	응용 프로그램 컨테이너 라이브러리와 jar 파일을 압축합니다. 자세한 내용은 Sun ONE Application Server Developer's Guide to Clients를 참조하십시오.
verifier	DTD를 사용하여 J2EE 배포 설명자를 확인합니다. 자세한 내용은 Sun ONE Application Server Developer's Guide를 참조하십시오.
wscompile	서비스 정의 인터페이스를 가져와서 클라이언트 스텁 또는 서버측 기초를 생성하거나 제공된 인터페이스의 WSDL 집합을 생성합니다.
wsdeploy	배포할 수 있는 WAR 파일을 생성합니다.

이러한 유틸리티에 대한 자세한 내용은 온라인 도움말을 참조하십시오.

asadmin 사용

---

asadmin 유틸리티는 관리 작업을 수행하는 명령 집합을 포함합니다. 관리 인터페이스를 사용하여 수행할 수 있는 대부분의 작업에 이 명령들을 사용할 수 있습니다. asadmin 유틸리티는 install_dir/bin에 있으며 이 위치에서 실행할 수 있습니다. Windows에서 asadmin.bat 파일을 두 번 누르면 명령 창에 asadmin 유틸리티가 시작되고 다중 모드로 실행됩니다.

일부 HTTP 서버 관련 등록 정보와 Administration Server 등록 정보는 명령줄을 사용하여 설정할 수 없기 때문에 관리 인터페이스를 사용하여 설정해야 합니다. server.xml 구성 파일에 저장된 모든 등록 정보를 설정할 수 있는 반면 init.conf 또는 obj.conf에 저장된 등록 정보는 설정할 수 없습니다. 구성 파일에 대한 자세한 내용은 Sun ONE Application Server Administrator's Configuration File Reference를 참조하십시오.

각 명령에 대한 자세한 내용은 "명령 참조" 및 온라인 도움말을 참조하십시오.

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

• 명령 구문 이해
• 단일 모드 및 다중 모드 사용
• 대화식 및 비대화식 옵션 사용
• 환경 명령 사용
• 암호 파일 옵션 사용
• asadmin을 로컬 또는 원격으로 실행
• 명령줄 호출 사용
• 이스케이프 문자 사용
• get 및 set 명령 사용
• 도움말 사용
• 출력 및 오류 보기

명령 구문 이해

asadmin 유틸리티 구문은 다음과 같습니다.

asadmin command -short-option argument --long-option argument operand

명령

명령은 수행될 작업 또는 태스크로 대소문자를 구분합니다.

옵션

옵션으로 유틸리티의 명령 수행 방법을 수정합니다. 옵션은 대소문자를 구분합니다. 짧은 옵션 앞에는 한 개의 대시(-), 긴 옵션 앞에는 두 개의 대시(--)를 붙입니다. 많은 옵션에 있어 길거나 짧은 형식 중 한 가지를 사용할 수 있습니다. 예를 들어, user 옵션은 --user 또는 -u 형식으로 사용할 수 있습니다. 옵션에는 필수 옵션과 선택 옵션이 있으며 선택 옵션은 명령 구문에서 대괄호로 표시됩니다. 명령을 실행할 때는 필수 옵션을 모두 포함시켜야 합니다. 그렇지 않으면 오류 메시지가 나타나고 명령이 실행되지 않습니다.

사용할 수 있는 긴 옵션 및 짧은 옵션 이름 목록은 "명령 참조"의 표 "긴 옵션 및 짧은 옵션 형식, 기본값 및 환경 변수"를 참조하십시오.

대부분의 옵션에는 인수 값(예: --port port_number)이 필수이지만 부울 옵션은 그 예외로 기능을 on 또는 off로 전환하며 인수 값을 필요로 하지 않습니다.

또한 옵션을 환경 변수에 저장할 수 있습니다. 자세한 내용은 "환경 명령 사용"을 참조하십시오. 옵션에 해당하는 전체 환경 변수 목록은 "긴 옵션 및 짧은 옵션 형식, 기본값 및 환경 변수 대응"을 참조하십시오.

부울 옵션

부울 옵션은 on 또는 off 사이를 전환합니다(예를 들어, --interactive는 옵션 관련 메시지가 표시되는 대화형 모드를 활성화하고 --no-interactive는 대화형 모드를 비활성화합니다). 긴 옵션 앞에 --no-를 붙이면 옵션이 off로 전환됩니다. 짧은 옵션 이름을 지정하면 항상 기본값의 반대로 설정됩니다.

짧은 부울 옵션을 그룹화하여 사용할 수 있습니다. 예를 들어, -Ie를 사용하여 interactive
(짧은 옵션 -I)와 echo (짧은 옵션 -e)를 지정할 수 있습니다.

피연산자

피연산자는 하나의 공백 또는 탭으로 구분하며 명령 구문에서 순서와 상관없이 사용됩니다. 옵션을 뒤에 붙이지 않고 --를 사용하여 옵션과 피연산자를 구분할 수 있습니다. 다음 인수는 한 개의 대시(-)로 시작하더라도 피연산자로 취급됩니다. 예를 들어 다음 명령에서

asadmin> create-jvm-options --instance server1 -- -Xmx1500m

-XMx1500m은 대시 하나로 시작하지만 피연산자로 취급됩니다.

구문 예

asadmin create-instance [--user admin_user] [--password admin_password] [-H host_name] [--port port_number] [--sysuser sys_user] [--domain domain_name] [--local=true/false] [--passwordfile file_name] [--secure | -s] --instanceport instance_port instance_name

이 구문 예에서 -H는 hostname의 짧은 옵션이고 --user는 인수가 admin_user인 긴 옵션이며 instance_name이 피연산자입니다. 선택 옵션은 대괄호 안에 있습니다.

다음은 실제 값을 사용한 구문의 예입니다. 이 예에는 선택 옵션 중 일부가 사용되지 않았습니다.

asadmin create-instance --user admin --password password -H austen --port 4848 --instanceport 1024 server2

단일 모드 및 다중 모드 사용

asadmin를 단일 모드 또는 다중 모드로 실행할 수 있습니다. 단일 모드에서는 명령 프롬프트에서 한 번에 하나의 명령씩 실행합니다. 다중 모드에서는 환경 수준 정보를 다시 입력하지 않고도 여러 개의 명령을 실행할 수 있습니다.

파일 입력을 사용하는 경우에는 단일 모드에서 명령이 실패하면 프로그램이 종료됩니다. 다중 모드를 사용하는 경우에는 명령이 실패하면 asadmin 프롬프트로 되돌아 옵니다.

단일 모드

명령줄 프롬프트에서 명령줄 인터페이스의 단일 명령을 호출하면 단일 모드로 실행하는 것입니다. 명령줄 인터페이스는 명령을 실행한 후 다시 명령 프롬프트로 나갑니다. 명령 프롬프트에서 명령줄 인터페이스를 실행하려면 install_dir/appserv/bin 디렉토리로 이동한 다음 명령 프롬프트에 명령을 입력합니다.

> asadmin command options arguments

예:

> asadmin create-instance --user admin --password password -H austen --port 4848 --instanceport 1024 server2

다중 모드

다중 모드를 사용하면 환경을 처음에 설정하여 서버 이름, 포트, 암호 등의 환경 수준 정보를 다시 입력하지 않고도 여러 개의 명령을 실행할 수 있습니다. 다중 모드를 사용할 경우 가장 중요한 이점은 asadmin이 메모리에 남아 있기 때문에 명령을 입력하고 실행하는 시간이 크게 단축될 수 있다는 것입니다. 이러한 환경 변수가 운영 체제 수준에 설정된 경우에는 다중 모드에서 이러한 설정을 선택합니다. asadmin 유틸리티는 사용자가 변경할 때까지 이러한 설정을 사용합니다.

Windows에서는 asadmin.bat 파일을 실행하면 자동으로 다중 모드가 됩니다.

UNIX에서는 asadmin 유틸리티를 명령줄에서 다중 모드로 시작하려면 다음과 같이 입력합니다.

> asadmin multimode

다중 모드에서 명령 프롬프트는 asadmin으로 변경되며 사용자는 이 때 asadmin 프롬프트에 명령을 입력할 수 있습니다. 유틸리티 이름을 사용할 필요는 없습니다. 예:

asadmin> create-instance --user admin --password password -H austen --port 4848 --instanceport 1024 server2

exit 또는 quit를 입력하여 다중 모드를 종료하면 명령 프롬프트로 되돌아 옵니다.

여러 다중 모드

다중 모드 세션에서 다음 명령을 사용하여 다중 모드를 호출할 수도 있습니다.

asadmin> multimode

일단 두 번째 다중 모드 환경을 종료하면 원래의 다중 모드 환경으로 되돌아 옵니다.

예를 들어, server1을 다중 모드에서 관리하는 경우 server2를 관리하여 두 가지 서버를 비교하려면 server1에 대한 다중 모드에서 server2에 대한 다중 모드를 호출할 수 있습니다. 사용자는 현재의 다중 모드 세션을 종료하지 않아도 되므로 환경 설정을 그대로 유지할 수 있습니다. server2에 대해 사용하는 다중 모드 세션을 종료하면 server1 다중 모드 환경으로 되돌아 옵니다.

대화식 및 비대화식 옵션 사용

명령줄 인터페이스를 사용할 때 대화형 또는 비대화형 모드로 사용할 수 있습니다. 대화형 모드를 선택한 경우 암호를 지정하지 않으면 암호를 지정하라는 메시지가 나타납니다. 대화형 모드는 기본적으로 활성화되어 있습니다.

export 명령을 사용하여 대화형 환경 변수를 설정함으로써 대화형 모드를 활성화 및 비활성화할 수 있습니다. 자세한 내용은 표 "export 명령과 함께 사용되는 환경 변수"를 참조하십시오.

단일 모드에서는 모든 상황에 대화식 옵션을 사용할 수 있습니다. 다중 모드에서는 명령 프롬프트에서 한 번에 한 개의 명령을 실행할 때와 파일에서 다중 모드로 실행할 때 대화식 옵션을 사용할 수 있습니다. 그러나 입력 스트림에서 파이프된 다중 모드의 명령과 다른 프로그램에서 호출된 명령은 대화형 모드에서 실행할 수 없습니다.

환경 명령 사용

asadmin 유틸리티는 환경 명령을 사용하여 설정할 수 있는 환경 변수 집합을 포함합니다. 다중 모드에서는 이러한 변수를 한 번 설정하면 다중 모드를 종료할 때까지 환경을 다시 설정하지 않아도 됩니다. 이러한 환경 변수를 운영 체제 수준에서 설정할 수도 있습니다. 그런 경우 이러한 환경 변수는 다중 모드에 들어갈 때 자동으로 선택되며 다중 모드를 종료한 후에도 지속됩니다.

환경 변수는 할당으로 언제든지 설정할 수 있는 이름/값 쌍입니다. 환경 변수는 옵션 이름 앞에 붙은 대문자 AS_ADMIN_ 접두어로 구성됩니다. 예를 들어 Administration Server 사용자를 설정하려면 다음과 같이 입력할 수 있습니다.

export AS_ADMIN_USER=administrator

여기서 administrator는 관리자의 사용자 이름입니다.

또한 다음과 같이 입력하면 AS_ADMIN_USER 값을 asadmin 명령에 사용할 수 있습니다.

asadmin multimode
asadmin> export AS_ADMIN_HOST=austen

이 다중 모드 세션에 있는 동안에는 Administration Server 호스트 이름이 austen으로 설정되고 다시 할당하지 않는 한 그대로 유지됩니다.

또한 한 번에 여러 환경 변수의 값을 설정하고 내보낼 수 있습니다. 예:

asadmin> export AS_ADMIN_PORT=4848 AS_ADMIN_USER=admin

현재의 환경 변수 설정을 보려면 다음과 같이 export 명령을 인수 없이 사용합니다.

asadmin> export
AS_ADMIN_HOST=austen
AS_ADMIN_PORT=4848
AS_ADMIN_USER=admin

환경에서 변수와 그 값을 제거하려면 unset 명령을 사용합니다. 예:

asadmin> unset AS_ADMIN_HOST

변수를 다시 설정하거나 asadmin 명령의 일부로 다른 값을 설정함으로써 환경 변수의 설정 값을 대체할 수 있습니다. 예:

asadmin> export AS_ADMIN_HOST=dickens
asadmin> show-instance-status --host austen instance-name

이 예는 Administration Server 호스트 austen에 있는 인스턴스의 인스턴스 상태를 보여주는데 그 값이 이전 호스트 값인 dickens를 대체하기 때문입니다.

내보낸 변수를 사용하지 않는 경우에는 대부분의 명령과 함께 다음 옵션을 사용하거나 기본값을 사용해야 합니다. 다음 기본값 목록은 "긴 옵션 및 짧은 옵션 형식, 기본값 및 환경 변수 대응"을 참조하십시오.

• --host
• --port
• --user
• --password or --passwordfile
• --secure=true (안전한 경우)
• --instance (필요한 경우)

다음 표 "export 명령과 함께 사용되는 환경 변수"에서는 export 명령과 함께 사용하는 환경 변수에 대해 설명합니다. 이 변수들은 특히 환경을 설정하므로 가장 일반적으로 사용됩니다. 첫 번째 열은 환경 변수 이름을 나타내고 두 번째 열은 사용 목적을 설명하며 아무것도 설정되지 않은 경우에는 기본값을 보여줍니다. 전체 환경 변수 목록은 "긴 옵션 및 짧은 옵션 형식, 기본값 및 환경 변수 대응"을 참조하십시오.

   export 명령과 함께 사용되는 환경 변수

환경 변수	사용
AS_ADMIN_HOST	Administration Server의 호스트 이름. 값이 지정되지 않은 경우에는 localhost를 사용합니다.
AS_ADMIN_PORT	Administration Server의 포트 번호. 값이 지정되지 않은 경우에는 4848을 사용합니다.
AS_ADMIN_USER	명령을 실행하는 사용자의 사용자 이름
AS_ADMIN_PASSWORD	명령을 실행하는 사용자 이름의 암호. 사용자 이름과 암호는 사용자를 인증하고 사용자가 서버를 관리하도록 허용되는지를 확인하는 데 사용됩니다. 이는 관리 인터페이스를 통해 Administration Server에 액세스할 때 이루어지는 인증과 동일합니다.
AS_ADMIN_SECURE	안전한 경우 =true
AS_ADMIN_INSTANCE	Sun ONE Application Server의 인스턴스를 설정합니다. 인스턴스 이름을 인수로 사용하는 모든 후속 명령(피연산자로 사용되는 명령은 해당 안 됨)은 이 지정된 인스턴스를 사용합니다.

암호 파일 옵션 사용

명령줄에 암호를 입력하지 않거나 암호에 대한 환경 변수를 설정하려면 암호 파일을 만들어 명령줄 옵션으로 사용할 수 있습니다.

password 옵션을 가진 모든 명령에는 대신 사용할 수 있는 passwordfile 옵션이 있습니다. 암호 파일은 다음 행으로 이루어져 있습니다.

AS_ADMIN_PASSWORD=value

AS_ADMIN_ADMINPASSWORD=value

AS_ADMIN_USERPASSWORD=value

passwordfile 옵션을 사용할 경우 파일의 암호는 다중 모드 환경으로 내보내지며 지정된 password 옵션이 없는 후속 명령은 이 값을 사용합니다.

명령줄에 암호 옵션과 암호 파일 옵션을 모두 지정할 경우에는 암호 파일의 값이 다중 모드 환경으로 내보내지지만 암호 옵션이 암호 파일 옵션에 우선하므로 현재 명령은 암호 옵션에 지정된 암호를 사용합니다.

asadmin을 로컬 또는 원격으로 실행

일반적으로 asadmin 유틸리티는 Administration Server를 통해 명령을 보냅니다. 따라서 Sun ONE Application Server가 설치되어 있는 시스템에서는 asadmin을 실행할 필요가 없습니다. 그러나, 대부분의 asadmin 명령을 수행하기 위해서는 Administration Server가 실행되고 있어야 합니다.

create-instance와 같은 일부 명령은 로컬에서 실행되는 옵션을 가집니다. create-instance와 함께 --local=true 옵션을 사용하는 경우에는 서버가 설치된 시스템에서 명령을 실행해야 합니다. 그러나 인스턴스를 만들기 위해 Administration Server를 실행할 필요는 없습니다.

일부 명령은 로컬로 실행되어야 합니다. 예를 들어, Administration Server와 모든 Administration Server의 인스턴스를 시작하는 start-appserv 명령은 원격으로 실행될 수 없습니다. 이는 이 명령을 사용하여 Administration Server를 시작할 때까지 Administration Server가 실행되지 않기 때문입니다.

Administration Server에 대한 자세한 내용은 "Administration Server 기본 설정"을 참조하십시오.

다음 명령은 로컬 및 원격으로 실행될 수 있습니다.

• create-instance
• delete-instance
• list-instances
• start-instance
• stop-instance
• display-license
• version
• stop-domain
• restart-instance
• list-domains

이러한 명령의 경우에는 로컬 옵션을 지정하지 않고도 명령을 로컬로 실행하도록 선택할 수 있습니다. 기본적으로 명령 구문에서 사용자, 암호, 호스트 및 포트의 값을 지정하는 경우 이러한 옵션에 대해 로컬 값을 지정할 수 있음에도 불구하고 이 명령은 원격 명령으로 취급됩니다. 이러한 옵션의 값을 지정하지 않으면 명령은 기본적으로 로컬로 실행됩니다.

명령이 로컬로 실행될 때 도메인 옵션이 있으면 도메인이 한 개뿐인 경우 외에는 필수 옵션입니다. 지정한 도메인 옵션은 명령이 원격으로 실행되는 경우에는 무시됩니다.

명령줄 호출 사용

명령줄을 다음 항목에 설명된 여러 방법으로 호출할 수 있습니다.

• 명령줄에서 asadmin 사용
• 파일 입력(스크립트)으로 asadmin 사용
• 표준 입력(파이프)으로 asadmin 사용

명령줄에서 asadmin 사용

명령을 사용하는 가장 간단한 방법은 명령줄에서 한 번에 한 개씩 사용하는 것입니다. 유틸리티에 명령, 옵션 및 인수를 입력합니다. 다중 모드에서는 유틸리티 이름과 환경 옵션(환경 변수를 설정한 경우)을 다시 입력할 필요 없이 여러 개의 명령을 입력할 수 있습니다. 단일 모드 또는 다중 모드 명령을 대화형으로 실행하거나 비대화형으로 실행할 수 있습니다. 대화형으로 실행하는 경우에는 암호 등 필요한 추가 입력을 하라는 메시지가 표시됩니다.

단일 모드 및 다중 모드에 대한 자세한 내용은 "단일 모드 및 다중 모드 사용"을 참조하십시오.

대화형으로 명령을 사용하는 자세한 내용은 "대화식 및 비대화식 옵션 사용"을 참조하십시오.

명령줄에서 사용 예

> asadmin create-instance --user admin --password password --host austen --port 4848 --instanceport 1024 server2

명령을 완료한 후 운영 체제 프롬프트로 되돌아 옵니다.

파일 입력(스크립트)으로 asadmin 사용

사용자는 여러 asadmin 명령을 포함하는 스크립트를 작성할 수 있습니다. 사용자는 스크립트를 사용하여 명령을 일괄 처리하고 특정 시간에 작업이 실행되도록 설정할 수 있으며 또한 관리 작업을 단순화 및 자동화할 수 있습니다.

파일에 있는 스크립트를 호출하려면 다음 구문을 사용합니다.

> asadmin multimode --file filename

다음은 이러한 방식으로 호출할 수 있는 파일에 있는 간단한 스크립트의 예입니다.

# Create new instance and start it.
export AS_ADMIN_USER=admin AS_ADMIN_PASSWORD=mypassword AS_ADMIN_HOST=austen AS_ADMIN_PORT=4848
create-instance --instanceport 9000 austen3
start-instance austen3

이 스크립트는 환경을 설정하고 austen3이라는 인스턴스를 만들며 새 인스턴스를 시작합니다. 숫자 기호(#)로 시작하는 행은 주석으로 취급되어 무시됩니다.

표준 입력(파이프)으로 asadmin 사용

다음 구문을 사용하여 asadmin 유틸리티에 파이프 입력할 수 있습니다.

cat filename | asadmin multimode

이 구문은 Windows에서는 작동하지 않을 수 있습니다.

이스케이프 문자 사용

콜론(:), 별표(*) 및 백슬래시(\) 등 일부 문자는 명령 구문에 사용할 때 이스케이프 문자를 함께 써야만 오류가 발생하는 것을 막을 수 있습니다. 이스케이프 문자 사용은 사용 플랫폼 및 단일 모드 또는 다중 모드 사용 여부에 따라 다릅니다.

---

주	get 명령과 set 명령에서는 콜론 이스케이프 문자를 사용할 필요가 없습니다.

---

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

• 단일 모드 UNIX상의 이스케이프 문자
• 단일 모드 Windows상의 이스케이프 문자
• 단일 모드 모든 플랫폼상의 이스케이프 문자
• 다중 모드 모든 플랫폼상의 이스케이프 문자

단일 모드 UNIX상의 이스케이프 문자

Solaris에서는 제한된 문자에 두 개의 백슬래시(\\) 또는 큰 따옴표(" ") 중 하나를 이스케이프 문자로 사용할 수 있습니다.

두 개의 백슬래시(\\)를 이스케이프 문자로 사용

예를 들어, 값에 콜론이 포함된 옵션을 사용하여 JDBC 연결 풀을 만들 때 백슬래시를 사용할 수 있습니다. 다음 예에서는 일부 등록 정보에 환경 변수가 설정된 것으로 가정합니다.

asadmin create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url=jdbc\\:oracle\\:thin\\:@asperfsol8\\:1521\\:V8i:user=staging_lo okup_app:password=staging_lookup_app OraclePoollookup

따옴표를 이스케이프 문자로 사용

위의 예에 따옴표(")를 사용하려면 해당 값을 큰 따옴표로 묶고 백슬래시와 함께 큰 따옴표를 이스케이프 문자로 사용합니다.

asadmin create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url=\"jdbc:oracle:thin:@asperfsol8:1521:V8i\":user=staging_lookup_a pp:password=staging_lookup_app OraclePoollookup

"단일 모드 모든 플랫폼상의 이스케이프 문자"에 설명된 방법을 사용할 수도 있습니다.

단일 모드 Windows상의 이스케이프 문자

Windows에서는 백슬래시 문자를 이스케이프 문자로 사용할 수 있습니다. 예를 들어, 값에 콜론이 포함된 옵션을 사용하여 JDBC 연결 풀을 만들 때 백슬래시를 사용할 수 있습니다. 다음 예에서는 일부 등록 정보에 환경 변수가 설정된 것으로 가정합니다.

asadmin create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url=jdbc\:oracle\:thin\:@asperfsol8\:1521\:V8i:user=staging_lookup_ app:password=staging_lookup_app OraclePoollookup

"단일 모드 모든 플랫폼상의 이스케이프 문자"에 설명된 방법을 사용할 수도 있습니다.

단일 모드 모든 플랫폼상의 이스케이프 문자

사용자는 모든 플랫폼에서 백슬래시를 이스케이프 문자로 사용하고 이스케이프 문자를 포함한 값을 큰 따옴표로 묶을 수 있습니다. 예를 들어, 값에 콜론이 포함된 옵션을 사용하여 JDBC 연결 풀을 만들 때 이스케이프 문자를 다음과 같이 사용할 수 있습니다. 다음 예에서는 일부 등록 정보에 환경 변수가 설정된 것으로 가정합니다

asadmin create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url="jdbc\:oracle\:thin\:@iasperfsol8\:1521\:V8i":user=staging_look up_app:password=staging_lookup_app OraclePoollookup

다중 모드 모든 플랫폼상의 이스케이프 문자

다중 모드에서는 슬래시나 백슬래시 없이 따옴표만을 필요로 하는 다음 구문을 사용할 수 있습니다.

asadmin> create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url="jdbc:oracle:thin:@asperfsol8:1521:V8i":user=staging_lookup_app :password=staging_lookup_app OraclePoollookup

get 및 set 명령 사용

get 명령과 set 명령을 사용하여 Sun ONE Application Server의 구성 설정에 액세스하고 변경할 수 있습니다. 대부분 asadmin 명령은 필수 등록 정보만 설정합니다. 선택적인 등록 정보의 값을 변경하려면 set 명령을 사용하십시오.

   get 및 set 명령

명령	인수	사용
get	(scope) scope는 속성을 나타내며 유효한 이름입니다.	속성 값을 가져옵니다.
set	(scope=value) scope는 속성을 나타내며 유효한 이름입니다. value는 그 속성에 대해 설정한 값입니다.	속성의 값을 설정합니다.
reconfig	instance-name	구성 파일을 수정하는 명령을 실행한 후 reconfig 명령을 실행해야 변경 사항이 서버에 적용됩니다. 변경 사항/재구성 사항을 서버에 적용하는 데 대한 자세한 내용은 "응용 프로그램 서버 인스턴스에 변경 사항 적용"을 참조하십시오.

속성 사이에 공백을 사용하여 단일 명령으로 여러 개의 속성을 가져오거나 설정할 수 있습니다.
예:

set server1.appReloadPollInterval=20 server1.mime.mime1.file=mime.types

AS_ADMIN_PREFIX 환경 변수를 사용하여 후속 get 및 set 명령에 사용될 접두어를 설정할 수 있습니다. get 및 set 명령의 접두어 문자열과 피연산자 사이에는 마침표(".")가 삽입됩니다. 예:

asadmin>export AS_ADMIN_PREFIX=server1
asadmin>get *
server1.locale = en_US
server1.appReloadPollInterval = 2
server1.name = server1
...

get 명령과 set 명령에는 마침표 분리자가 필요하기 때문에 이름에 마침표가 포함된 항목에는 그 앞에 이스케이프 문자 백슬래시(\)를 사용해야 합니다. 다음 예에서는 server2.sun.com라는 마침표가 포함된 서버 인스턴스 이름 앞에 백슬래시가 사용된 것을 보여줍니다.

get server2\.sun\.com.*

백슬래시를 포함하지 않으면 오류 메시지가 표시됩니다.

get 및 set 명령 예

다음 예에서는 get 명령을 사용하여 속성의 값을 가져오는 방법과 set 명령을 사용하여 값을 설정하는 방법을 보여줍니다.

MDB 컨테이너 서비스 예

응용 프로그램 서버 인스턴스가 server1인 경우 다중 모드에서 환경 설정과 함께 다음 명령을 사용하여 모든 mdb-container 속성 값을 가져올 수 있습니다.

asadmin> get server1.mdb-container.*

다음은 해당 속성의 현재 값을 보여주는 이 명령의 출력 예입니다.

server1.mdb-container.logLevel = null
server1.mdb-container.steadyPoolSize = 10
server1.mdb-container.idleInPoolTimeoutInSeconds = 600
server1.mdb-container.maxPoolSize = 60
server1.mdb-container.monitoringEnabled = false
server1.mdb-container.poolResizeQuantity = 2

MDB 컨테이너 속성인 monitoringEnabled의 값만 가져오려면 다음 명령을 사용합니다.

asadmin> get server1.mdb-container.montioringEnabled

monitoringEnabled 속성의 값을 true로 설정하려면 다음 명령을 사용합니다.

asadmin> set server1.mdb-container.montioringEnabled=true

JMS 자원 예

모든 자원 구성에 대한 속성은 다음과 같은 형태여야 합니다.

instancename.resource.primary_key_value.attribute_name

예:

asadmin> get server1.jms-resource.myjms.*

myjms라는 JMS 대상 자원의 모든 속성을 가져옵니다. 예:

server1.jms-resource.myjms.resType = javax.jms.Topic
server1.jms-resource.myjms.enabled = true
server1.jms-resource.myjms.name = myjms
server1.jms-resource.myjms.description = null

단일 속성, 즉 resType과 같은 값을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.jms-resource.myjms.resType

하나의 속성, 예를 들어 description을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.jms-resource.myjms.description=mydescription

이 예에서는 해당 설명을 mydescription으로 설정합니다.

여러 값 가져오기 및 설정하기의 예

하나의 명령을 사용하여 여러 개의 값을 가져오고 설정할 수 있습니다. 동시에 두 개의 속성을 설정하려면 공백을 사용하여 속성을 분리합니다. 예:

set server1.appReloadPollInterval=20 server1.mime.mime1.file=mime.types

또한 환경 변수 AS_ADMIN_PREFIX를 사용하여 여러 get 명령과 set 명령에 사용할 접두어를 설정할 수 있습니다.

get 및 set 명령을 사용한 모니터링

get 및 set 명령을 사용하여 실행 중인 서버를 모니터할 수도 있습니다. list 명령도 모니터링에 사용됩니다. monitor 옵션을 true 또는 false로 설정할 수 있습니다. 이 옵션을 true로 설정하면 지정된 속성을 모니터합니다. 명령줄 인터페이스를 사용한 Sun ONE Application Server 모니터에 대한 자세한 내용은 "CLI를 사용한 모니터링 데이터 추출"을 참조하십시오.

도움말 사용

모든 asadmin 명령에 대한 도움말은 명령 프롬프트에서 -h 또는 --help를 입력하여 볼 수 있습니다. 예를 들어, asadmin에 대한 도움말을 보려면 다음 작업을 수행합니다.

asadmin --help

모든 asadmin 명령의 목록이 표시됩니다.

특정 asadmin 명령에 대한 도움말을 보려면 다음 작업을 수행합니다.

asadmin command -h

또는

asadmin command --help

도움말에는 개요, 명령에 대한 설명, 구문 정보, 예 및 관련 명령의 목록이 포함됩니다.

명령의 어느 부분에서나 -h 또는 --help를 사용하면 그 명령에 대한 도움말을 볼 수 있습니다. 그런 경우 명령은 실행되지 않습니다.

또한 UNIX 환경에서 설명서 페이지의 명령줄 도움말 페이지에 액세스할 수 있습니다. 번들화되지 않은 설치의 경우에는 MANPATH 환경 변수에 install_dir/man을 추가합니다. 일단 이렇게 하면 명령 프롬프트에 man asadmin을 입력하여 Sun ONE Application Server 유틸리티의 설명서 페이지에 액세스할 수 있습니다.

출력 및 오류 보기

명령이 성공적으로 실행되면 수행된 내용을 알리는 메시지가 표시됩니다. 명령이 실패한 경우에는 오류 메시지가 표시됩니다.

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

• 종료 상태 보기
• 사용 보기

종료 상태 보기

오류 메시지가 표시되는 것 외에 asadmin 명령은 종료 시 항상 종료 상태를 표시합니다. 명령이 성공적이면 종료 상태는 0이고 실패하면 1입니다.

UNIX상의 종료 상태

명령 프롬프트에 echo $?를 입력하여 종료 상태를 확인할 수 있습니다.

또한 스크립트에 종료 코드를 사용할 수도 있습니다. 예를 들어, 다음 Korn 셸 스크립트에서는 종료 상태를 사용하여 list-instances 명령이 성공적으로 실행되었는지 여부를 나타냅니다.

#!/bin/ksh
asadmin list-instances
if [[ $? = 0 ]]
then
echo "success"
else
echo "error"
fi

Windows 상의 종료 상태

Windows에서는 .bat 스크립트에서 종료 상태를 확인할 수 있습니다. 예를 들어, 다음 두 스크립트 중 하나는 성공적인 스크립트와 그 출력 결과를 보여주고 다른 하나는 실패한 스크립트와 그 출력 결과를 보여줍니다.

성공 조건

myscript.bat
------------
echo off
echo Processing Command
call asadmin list-instances --domain domain1
if not %errorlevel% EQU 0 goto end
echo Command Succesful
goto program-end
:end
echo Command Failed
:program-end

출력:

Processing Command
admin-server <not running>
server1 <not running>
Command Succesful

오류 상황

myscript.bat
-------------
echo off
echo Processing Command
call asadmin list-instances
if not %errorlevel% EQU 0 goto end
echo Command Succesful
goto program-end
:end
echo Command Failed
:program-end

출력:

Processing Command
No default domain. Need to enter a domain.
Command Failed

사용 보기

명령을 인수 없이 입력하면 명령 구문이 포함된 오류 메시지가 표시됩니다.
예:

asadmin> create-instance

Invalid number of operands received

USAGE: create-instance [--user admin_user] [--password admin_password] [--host localhost] [--port 4848] [--sysuser sys_user] [--domain domain_name] [--local=false] [--passwordfile file_name] [secure | -s] --instanceport instanceport instancename

보안 고려 사항

---

명령줄에서 명령줄 인터페이스 실행 시에는 모든 명령과 함께 사용자 암호를 제공해야 합니다. 다중 모드로 실행 중인 경우에는 처음 환경 설정 시에 암호를 제공해야 합니다. 다중 모드를 종료한 경우에는 다중 모드를 다시 시작할 때 암호를 비롯한 환경을 다시 설정해야 합니다. 환경 명령을 사용하여 암호를 설정합니다. 자세한 내용은 "환경 명령 사용"을 참조하십시오.

암호 파일을 설정하여 명령줄에 암호를 입력하지 않을 수도 없습니다. 자세한 내용은 "암호 파일 옵션 사용"을 참조하십시오.

유효한 사용자 이름과 암호라는 인증 정보가 없으면 명령이 실행되지 않습니다.

명령줄 인터페이스는 Sun ONE Application Server에 설정한 보안 조치를 포함합니다. Sun ONE Application Server 보안에 대한 자세한 내용은 Sun ONE Application Server Administrator's Security Guide를 참조하십시오.

동시에 액세스할 때 고려해야 할 사항

---

두 사람 이상이 명령줄 인터페이스 및/또는 관리 인터페이스를 사용하여 동시에 서버를 구성하려 할 수 있습니다. 그런 경우 두 번째의 구성 요청은 첫번째 요청이 완료될 때까지 대기열 처리됩니다. 요청이 대기열에 너무 오래 있으면 시간 초과 처리됩니다.

일부 명령의 경우에는 reconfig 명령을 사용할 때까지 변경 사항이 적용되지 않습니다. 따라서 변경 사항이 서버에 적용되기 전에 두 사람 이상이 속성을 편집할 수 있습니다. reconfig 명령에 대한 자세한 내용은 "응용 프로그램 서버 인스턴스에 변경 사항 적용"을 참조하십시오.

명령 참조

---

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

• 명령 목록
• 점으로 구분된 이름 및 속성 목록
• 긴 옵션 및 짧은 옵션 형식, 기본값 및 환경 변수 대응

명령 목록

다음 표에서는 모든 asadmin 명령과 그 용도에 대해 설명합니다. 명령 구문 및 그 사용법에 대한 자세한 내용은 온라인 도움말을 참조하십시오.

왼쪽 열은 명령 이름이고 오른쪽 열은 그 사용법입니다.

   asadmin Commands

명령	사용
add-resources	한 개 이상의 jdbc, jms 또는 javamail 유형 자원 추가
create-acl	ACL (액세스 제어 목록) 만들기
create-authdb	인증 데이터베이스 만들기
create-auth-realm	인증 영역 만들기
create-custom-resource	사용자 정의 자원 만들기
create-domain	도메인 만들기
create-file-user	키 파일에 파일 영역 사용자 만들기
create-http-listener	HTTP Listener 만들기
create-http-qos	응용 프로그램 서버 인스턴스 또는 가상 서버를 위한 HTTP QOS(Quality of Service) 설정 만들기
create-iiop-listener	IIOP Listener 만들기
create-instance	응용 프로그램 서버 인스턴스 만들기
create-javamail-resource	JavaMail 자원 만들기
create-jdbc-connection-pool	JDBC 연결 풀 만들기
create-jdbc-resource	JDBC 자원 만들기
create-jmsdest	JMS (Java Message Service) 대상 만들기
create-jms-resource	JMS 자원 만들기
create-jndi-resource	JNDI 자원 만들기
create-jvm-options	java-config 또는 프로파일러 요소에 JVM 옵션 만들기
create-lifecycle-module	lifecycle 모듈 만들기
create-mime	MIME 유형 파일 만들기
create-persistence-resource	지속성 관리자 팩토리 자원 만들기
create-profiler	JVM 프로파일러 만들기
create-ssl	HTTP Listener, IIOP Listener 또는 IIOP 서비스의 SSL 설정 만들기
create-virtual-server	가상 서버 만들기
delete-acl	ACL 삭제
delete-authdb	인증 데이터베이스 삭제
delete-auth-realm	인증 영역 삭제
delete-custom-resource	사용자 정의 자원 삭제
delete-domain	도메인 삭제. 이 명령은 로컬에서만 실행할 수 있습니다.
delete-file-user	키 파일에서 파일 영역 사용자 삭제
delete-http-listener	HTTP Listener 삭제
delete-http-qos	응용 프로그램 서버 인스턴스 또는 가상 서버를 위한 HTTP QOS (Quality of Service) 설정 삭제
delete-iiop-listener	IIOP Listener 삭제
delete-instance	응용 프로그램 서버 인스턴스 삭제
delete-javamail-resource	JavaMail 자원 삭제
delete-jdbc-connection-pool	JDBC 연결 풀 삭제
delete-jdbc-resource	JDBC 자원 삭제
delete-jmsdest	JMS 대상 삭제
delete-jms-resource	JMS 자원 삭제
delete-jndi-resource	JNDI 자원 삭제
delete-jvm-options	java-config 또는 프로파일러 요소의 JVM 옵션 삭제
delete-lifecycle-module	lifecycle 모듈 삭제
delete-mime	MIME 유형 파일 삭제
delete-persistence-resource	지속성 관리자 팩토리 자원 삭제
delete-profiler	JVM 프로파일러 삭제
delete-ssl	HTTP Listener, IIOP Listener 또는 IIOP 서비스의 SSL 설정 삭제
delete-virtual server	가상 서버 삭제
deploy	EJB, WEB, 커넥터, 응용 프로그램 클라이언트 또는 응용 프로그램 구성 요소를 응용 프로그램 서버 인스턴스에 배포
deploydir	디렉토리에 있는 EJB, WEB, 커넥터, 응용 프로그램 클라이언트 또는 응용 프로그램 구성 요소를 응용 프로그램 서버 인스턴스에 배포
disable	응용 프로그램 서버 인스턴스의 배포된 구성 요소 비활성화
display-license	사용권 정보 표시. 이 명령은 로컬에서만 실행될 수 있습니다.
enable	응용 프로그램 서버 인스턴스의 배포된 구성 요소 활성화
export	asadmin 환경 변수의 값을 후속 asadmin 명령에서 사용하도록 내보내기
get	속성 값 가져오기
help	특정 명령에 대한 도움말(설명, 사용법, 구문, 예) 또는 asadmin에 대한 일반적인 도움말 표시
install-license	사용권 파일 설치. 이 명령은 로컬에서만 실행될 수 있습니다.
jms-ping	JMS 공급자 실행 여부 확인을 위한 Ping
list	구성 가능한 요소 나열
list-acls	응용 프로그램 서버 인스턴스의 ACL 나열
list-authdbs	인증 데이터베이스 나열
list-auth-realms	인증 영역 나열
list-components	서버 인스턴스의 배포된 구성 요소 나열
list-custom-resources	서버 인스턴스의 사용자 정의 자원 나열
list-domains	도메인 나열
list-file-users	서버 인스턴스의 모든 파일 영역 사용자 나열
list-file-groups	지정된 파일 영역 사용자의 모든 그룹 나열. 사용자를 지정하지 않으면 서버 인스턴스의 모든 그룹이 나열됩니다.
list-http-listeners	서버 인스턴스의 HTTP Listener 나열
list-instances	도메인에 있는 응용 프로그램 서버 인스턴스 나열
list-iiop-listeners	서버 인스턴스의 IIOP Listener 나열
list-javamail-resources	서버 인스턴스의 JavaMail 자원 나열
list-jdbc-connection-pools	서버 인스턴스의 JDBC 연결 풀 나열
list-jdbc-resources	서버 인스턴스의 JDBC 자원 나열
list-jmsdest	서버 인스턴스의 JMS 대상 나열
list-jms-resources	서버 인스턴스의 JMS 자원 나열
list-jndi-resources	서버 인스턴스의 JNDI 자원 나열
list-lifecycle-modules	서버 인스턴스의 lifecycle 모듈 나열
list-mimes	서버 인스턴스의 MIME 파일 나열
list-persistence-resources	서버 인스턴스의 지속성 관리자 팩토리 자원 나열
list-profilers	서버 인스턴스의 JVM 프로파일러 나열
list-sub-components	배포된 모듈 또는 배포된 응용 프로그램 모듈에 있는 한 개 이상의 EJB 또는 서블릿 나열
list-virtual-servers	서버 인스턴스의 가상 서버 나열
multimode	환경 설정을 유지하고 asadmin 내에 있으면서 여러 명령 실행
reconfig	변경 사항을 서버에 적용. 대부분의 변경 사항은 적용될 때까지는 반영되지 않습니다.
restart-instance	서버 인스턴스 다시 시작
set	속성 값 설정
show-component-status	배포된 구성 요소 상태 표시
show-instance-status	서버 인스턴스 상태 즉, 실행 여부 표시
shutdown	Administration Server 종료
start-appserv	Administration Server 및 모든 서버 인스턴스 시작. 이 명령은 로컬에서만 실행될 수 있습니다.
start-domain	도메인에 있는 모든 인스턴스 시작. 이 명령은 로컬에서만 실행될 수 있습니다.
start-instance	서버 인스턴스 시작
stop-appserv	Administration Server 및 모든 서버 인스턴스 중단. 이 명령은 로컬에서만 실행될 수 있습니다.
stop-domain	도메인에 있는 모든 인스턴스 중단
stop-instance	서버 인스턴스 중단
undeploy	서버 인스턴스에서 배포된 구성 요소 제거
unset	asadmin를 위해 내보낸 환경 변수 설정 해제
update-file-user	기존 파일 영역 사용자 갱신
version	Sun ONE Application Server의 버전 정보 표시

점으로 구분된 이름 및 속성 목록

get 및 set 명령을 사용하여 속성을 가져오고 설정하는 경우에는 asadmin에서 서비스, 자원 등에 사용하는 이름을 알아야 이 이름을 사용하여 특정 객체의 속성을 가져올 수 있습니다.

이러한 이름은 이름 사이에 마침표를 넣어 구분하는 구문을 사용하기 때문에 점으로 구분된 이름으로 불립니다.

asadmin에서 사용하는 점으로 구분된 이름

다음 표에서는 asadmin을 사용하여 항목을 구성하는 데 사용하는 이름을 나열합니다. 이 이름들은 다음과 같은 범주로 나뉩니다.

• 서비스 이름
• 자원 이름
• 응용 프로그램 이름
• 기타 이름

서비스 이름

다음 표에서는 서비스의 속성을 가져오고 설정하는 데 사용되는 서비스 이름을 보여줍니다.

   명령줄 인터페이스의 서비스 이름

서비스	점으로 구분된 이름
JMS 서비스 구성	jms-service
트랜잭션 서비스 구성	transaction-service
MDB 컨테이너 구성	mdb-container
EJB 컨테이너 구성	ejb-container
웹 컨테이너 구성	web-container
JVM 구성	java-config
ORB 구성	orb 또는 iiop-service
ORB Listener 구성	orblistener 또는 iiop-listener orblistener 또는 iiop-listener는 유효한 이름이 아닙니다. 이 이름 뒤에 Listener의 이름이 나와야 합니다. 예: ORB listener configuration orblistener.<listener name> or iiop-listener.<listener name>
로그 구성	log-service
보안 구성	security-service
HTTP 구성	http-service

자원 이름

다음 표에서는 자원의 속성을 가져오고 설정하는 데 사용하는 자원 이름을 보여줍니다. 이 이름만으로는 유효하지 않으며, 이름 뒤에 자원 이름이 와야 합니다.

   명령줄 인터페이스의 자원 이름

자원	점으로 구분된 이름
JDBC 자원 구성	jdbc-resource
JNDI 자원 구성	jndi-resource
JDBC 연결 풀 자원 구성	jdbc-connection-pool
사용자 정의 자원 구성	custom-resource
JMS 자원 구성	jms-resource
지속성 관리자 팩토리 자원 구성	persistence-manager-factory-resource
JavaMail 자원 구성	mail-resource

응용 프로그램 이름

다음 표에서는 응용 프로그램 관련 구성의 속성을 가져오고 설정하는 데 사용하는 점으로 구분된 이름을 보여줍니다. 이 이름만으로는 유효하지 않으며 이름 뒤에 응용 프로그램의 이름이 와야 합니다.

   명령줄 인터페이스의 응용 프로그램 이름

응용 프로그램 구성 요소	점으로 구분된 이름
응용 프로그램 구성	application
EJB 모듈 구성	ejb-module
웹 모듈 구성	web-module
커넥터 모듈 구성	connector-module

기타 이름

다음 표에서는 get 및 set 명령을 사용하여 구성할 수 있는 기타 항목의 점으로 구분된 이름을 보여줍니다. 이 이름만으로는 유효하지 않으며, 이름 뒤에 자원의 이름이 와야 합니다(예: http-listener.listener_name, lifecycle-module.module-name).

   명령줄 인터페이스의 기타 항목 이름

항목	점으로 구분된 이름
HTTP listener	http-listener 또는 http-server.http-listener
MIME 유형 파일	mime
ACL	acl
가상 서버	virtual-server
인증 데이터베이스	auth-db
보안 영역	authrealm
lifecycle 모듈	lifecycle-module
프로파일러 구성	프로파일러
서버 구성	서버 구성(서버 인스턴스 이름)

속성

다음 절에서는 위에 나열된 명명된 지정 항목의 속성과 그 사용 예를 설명합니다. 일부 속성은 읽기 전용으로 get 명령에만 사용 가능하고 set 명령에는 사용할 수 없습니다.

---

주	이 절에 포함된 예에서는 사용자, 암호, 호스트 및 포트가 환경 변수로 정의된 것으로 가정하며 구문으로 그 옵션을 나열하지 않습니다.

---

jms-service

다음 표에서는 왼쪽 열에 해당 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   JMS 서비스 속성

server.xml 이름	asadmin 이름
port	port
admin-username	adminUserName
admin-password	adminPassword
log-level	logLevel
enabled	enabled
init-timeout-in-seconds	initTimeoutInSeconds
start-args	startArgs

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.jms-service.*

adminPassword라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.jms-service.adminPassword

속성 adminPassword에 admin의 값을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.jms-service.adminPassword=admin

transaction-service

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   트랜잭션 서비스 속성

server.xml 이름	asadmin 이름
automatic-recovery	automaticTransactionRecovery
timeout-in-seconds	transactionRecoveryTimeout
tx-log-dir	transactionLogFile
heuristic-decision	heuristicDecision
keypoint-interval	keypointInterval
log-level	logLevel
monitoring-enabled	monitoringEnabled

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.transaction-service.*

transactionRecoveryTimeout라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.transaction-service.transactionRecoveryTimeout

속성 transactionRecoveryTimeout의 값을 49로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.transaction-service.transactionRecoveryTimeout=49

mdb-container

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   MDB 컨테이너 속성

server.xml 이름	asadmin 이름
steady-pool-size	steadyPoolSize
pool-resize-quantity	poolResizeQuantity
max-pool-size	maxPoolSize
idle-timeout-in-seconds	idleInPoolTimeoutInSeconds
log-level	logLevel
monitoring-enabled	monitoringEnabled

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.mdb-container.*

steadyPoolSize라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.mdb-container.steadyPoolSize

속성 steadyPoolSize의 값을 10으로 다음 작업을 수행합니다.

asadmin> set server1.mdb-container.steadyPoolSize=10

ejb-container

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   EJB 컨테이너 속성

server.xml 이름	asadmin 이름
steady-pool-size	steadyPoolSize
pool-resize-quantity	poolResizeQuantity
max-pool-size	maxPoolSize
cache-resize-quantity	cacheResizeQuantity
max-cache-size	maxCacheSize
pool-idle-timeout-in-seconds	idleInPoolTimeoutInSeconds
cache-idle-timeout-in-seconds	idleInCacheTimeoutInSeconds
removal-timeout-in-seconds	removalTimeoutInSeconds
victim-selection-policy	victimSelectionPolicy
commit-option	commitOption
log-level	logLevel
monitoring-enabled	monitoringEnabled

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.ejb-container.*

maxPoolSize라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.ejb-container.maxPoolSize

속성 maxPoolSize의 값을 12로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.ejb-container.maxPoolSize=12

web-container

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   웹 컨테이너 속성

server.xml 이름	asadmin 이름
log-level	logLevel
monitoring-enabled	monitoringEnabled (not used)

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.web-container.*

logLevel이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.web-container.logLevel

monitoringEnabled라는 속성에 경고를 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.web-container.logLevel=WARNING

java-config

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   JVM 속성

server.xml 이름	asadmin 이름
java-home	javahome
debug-enabled	debugEnabled
debug-options	debugOptions
javac-options	javacoptions
rmic-options	rmicoptions
classpath-prefix	classpathprefix
server-classpath	serverClasspath
classpath-suffix	classpathsuffix
native-library-path-prefix	libpathprefix
native-library-path-suffix	libpathsuffix
env-classpath-ignored	envpathignore

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.java-config.*

classpathprefix라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.java-config.classpathprefix

속성 classpathprefix의 값을 com.sun으로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.java-config.classpathprefix=com.sun

orb 또는 iiop-service

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   ORB/IIOP 서비스 속성

server.xml 이름	asadmin 이름
message-fragment-size	msgSize
steady-thread-pool-size	minThreads
max-thread-pool-size	maxThreads
max-connections	maxConnections
idle-thread-timeout-in-seconds	idleThreadTimeout
log-level	log
monitoring-enabled	monitor
cert-nickname	cert
ssl2-enabled	ssl2
ssl2-ciphers	ssl2Ciphers
ssl3-enabled	ssl3
ssl3-tls-ciphers	ssl3Ciphers
tls-enabled	tls
tls-rollback-enabled	tlsRollback
client-auth-enabled	clientAuth

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.orb.*

또는

asadmin> get server1.iiop-service.*

msgSize라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.orb.msgSize

또는

asadmin> get server1.iiop-service.msgSize

idleThreadTimeout이라는 속성을 300으로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.orb.idleThreadTimeout=300

또는

asadmin> set server1.iiop-service.idleThreadTimeout=300

orblistener 또는 iiop-listener

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   IIOP Listener 속성

server.xml 이름	asadmin 이름
id	id
address	address
port	port
enabled	enabled
cert-nickname	cert
ssl2-enabled	ssl2
ssl2-ciphers	ssl2Ciphers
ssl3-enabled	ssl3
ssl3-tls-ciphers	ssl3Ciphers
tls-enabled	tls
tls-rollback-enabled	tlsRollback
client-auth-enabled	clientAuth

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.orblistener.orb_listener_id.*

또는

asadmin> get server1.iiop-listener.orb_listener_id.*

port라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.orblistener.orb_listener_id.port

또는

asadmin> get server1.iiop-listener.orb_listener_id.port

address라는 속성을 bluestar로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.orblistener.orb_listener_id.address=bluestar

또는

asadmin> set server1.iiop-listener.orb_listener_id.address=bluestar

log-service

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   로그 구성 속성

server.xml 이름	asadmin 이름
file	file
level	level
log-stdout	stdout
log-stderr	stderr
echo-log-messages-to-stderr	echoToStderr
create-console	createConsole
log-virtual-server-id	LogVirtualServerId
use-system-logging	useSystemLogging

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.log-service.*

level이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.log-service.level

echoToStderr라는 속성을 true로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.log-service.echoToStderr=true

security-service

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   보안 영역 구성 속성

server.xml 이름	asadmin 이름
default-realm	defaultRealm
default-principal	defaultPrinicpal
default-principal-password	defaultPrinicpalPassword
anonymous-role	anonymousRole
audit-enabled	auditEnabled
log-level	logLevel

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.security-service.*

anonymousRole이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.security-service.anonymousRole

encryptPasswords라는 속성을 true로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.security-service.auditEnabled=true

http-service

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   HTTP 서비스 속성

server.xml 이름	asadmin 이름
qos-metrics-interval-in-seconds	qos-metrics-interval-in-seconds
qos-recompute-time-interval-in-millis	qos-recompute-time-interval-in-millis
qos-enabled	qos-enabled
bandwidth-limit	bandwidthLimit
enforce-bandwidth-limit	enforceBandwidthLimit
connection-limit	connectionLimit
enforce-connection-limit	enforceConnectionLimit

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.http-service.*

bandwidthLimit이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.http-service.bandwidthLimit

qos-enabled라는 속성을 true로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.http-service.qos-enabled=true

jdbc-resource

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   JDBC 자원 속성

server.xml 이름	asadmin 이름
jndi-name	name
pool-name	pool
enabled	enabled
description	description

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.jdbc-resource.jdbc_resource_name.*

pool이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.jdbc-resource.jdbc_resource_name.pool

enabled라는 속성을 true로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.jdbc-resource.jdbc_resource_name.enabled=true

jndi-resource

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   JNDI 자원 속성

server.xml 이름	asadmin 이름
jndi-name	name
jndi-lookup-name	LookupName
res-type	resType
factory-class	factory
enabled	enabled
description	description

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.jndi-resource.jndi_name.*

factory라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.jndi-resource.jndi_name.factory

factory라는 속성을 com.sun으로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.jndi-resource.jndi_name.factory=com.sun

jdbc-connection-pool

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   JDBC 연결 풀 속성

server.xml 이름	asadmin 이름
name	name
datasource-classname	dsClassName
res-type	resType
description	description
steady-pool-size	steadyPoolSize
max-pool-size	maxPoolSize
max-wait-time-in-millis	maxWaitTime
pool-resize-quantity	resizeValue
idle-timeout-in-seconds	idleTimeout
transaction-isolation-level	transactionIsolationLevel
is-isolation-level-guaranteed	isIsolationLevelGuaranteed
connection-validation-method	validationMethod
is-connection-validation-required	isValidationRequired
fail-all-connections	failAll
validation-table-name	validationTable

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.jdbc-connection-pool.pool_name.*

dsClassName이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.jdbc-connection-pool.pool_name.dsClassName

resizeValue라는 속성을 2로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.jdbc-connection-pool.pool_name.resizeValue=2

custom-resource

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   사용자 정의 자원 속성

server.xml 이름	asadmin 이름
jndi-name	name
res-type	resType
factory-class	factory
enabled	enabled
description	description

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.custom-resource.jndi_name.*

factory라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.custom-resource.jndi_name.factory

factory라는 속성을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.custom-resource.jndi_name.factory=myclass

jms-resource

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   JMS 자원 속성

server.xml 이름	asadmin 이름
jndi-name	name
res-type	resType
enabled	enabled
description	description

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.jms-resource.jms_resource_name.*

res-type이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.jms-resource.jms_resource_name.resType

enabled라는 속성을 true로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.jms-resource.jms_resource_name.enabled=true

persistence-manager-factory-resource

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   지속성 관리자 팩토리 자원 속성

server.xml 이름	asadmin 이름
jndi-name	jndiName
jdbc-resource-jndi-name	JdbcResourceJndiName
factory-class	factoryClass
enabled	enabled
description	description

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.persistence-manager-factory-resource.jndi_name

factoryClass라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.persistence-manager-factory-resource.jndi_name.factoryClass

enabled라는 속성을 true로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.persistence-manager-factory-resource.jndi_name.enabled=true

mail-resource

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   JavaMail 자원 속성

server.xml 이름	asadmin 이름
jndi-name	name
enabled	enabled
store-protocol	storeProtocol
store-protocol-class	storeProtocolClass
transport-protocol	transportProtocol
transport-protocol-class	transportProtocolClass
host	host
user	user
from	from
debug	debug
description	description

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.mail-resource.jndi_name.*

host라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.mail-resource.jndi_name.host

enabled라는 속성을 true로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.mail-resource.jndi_name.enabled=true

application

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   응용 프로그램 속성

server.xml 이름	asadmin 이름
name	name
location	location
virtual-servers	virtualServers
description	description
enabled	enabled

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.application.application_name.*

응용 프로그램에 있는 속성 location을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.application.application_name.location

location이라는 속성을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.application.application_name.location=
"/export/home/as7se/as1/repository/applications/ASConverter"

ejb-module

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   EJB 모듈 속성

server.xml 이름	asadmin 이름
name	name
location	location
description	description
enabled	enabled

인스턴스(server1)에 있는 독립 실행형 EJB 모듈의 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.ejb-module.ejb_jar_name.*

인스턴스(server1)에 대한 응용 프로그램의 한 EJB 모듈의 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.j2ee-application.application_name.ejb-module.ejb_jar_name.*

또는

asadmin>get server1.application.application_name.ejb-module.ejb_jar_name.*

독립 실행형 EJB 모듈에서 location이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.ejb-module.ejb_jar_name.location

응용 프로그램의 EJB 모듈에서 location이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.j2ee-application.application_name.ejb-module.ejb_jar_name.
location

또는

asadmin> get server1.application.application_name.ejb-module.ejb_jar_name.location

독립 실행형 EJB 모듈에서 location이라는 속성을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.ejb-module.ejb_jar_name.location="/export/home/as7se/as1/repos itory/modules/ejb_jar_name"

응용 프로그램에 번들된 EJB 모듈에서 location이라는 속성을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.j2ee-application.application_name.ejb-module.ejb_jar_name.
location="/export/home/as7se/as1/repository/modules/ejb_jar_name"

또는

asadmin>set server1.application.application_name.ejb-module.ejb_jar_name.location="/ex port/home/as7se/as1/repository/modules/ejb_jar_name"

web-module

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   WEB 모듈 속성

server.xml 이름	asadmin 이름
name	name
location	location
context-root	contextRoot
virtual-servers	virtualServers
description	description
enabled	enabled

인스턴스(server1)에 있는 독립 실행형 웹 모듈의 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.web-module.web_war_name.*

인스턴스(server1)의 응용 프로그램에 있는 웹 모듈의 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.web-module.application_name.web_war_name.*

독립 실행형 웹 모듈에서 location이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.web-module.web_war_name.location

응용 프로그램에 있는 웹 모듈에서 location이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.web-module.application_name.web_war_name.location

독립 실행형 모듈에 있는 location이라는 속성을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.web-module.war-ic.location=
"/export/home/as7se/as1/repository/modules/web_war_name"

응용 프로그램에 번들화된 웹 모듈에서 location이라는 속성을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.web-module.application_name.web_war_name.location=
"/export/home/as7se/as1/repository/modules/web_war_name"

connector-module

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   커넥터 모듈 속성

server.xml 이름	asadmin 이름
name	name
location	location
description	description
enabled	enabled

인스턴스(server1)에 있는 독립 실행형 커넥터 모듈의 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.connector-module.connector_rar_name.*

독립 실행형 커넥터 모듈에서 location이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.connector-module.connector_rar_name.location

독립 실행형 커넥터 모듈에 있는 location이라는 속성을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.connector-module.connector_rar_name.location=
"/export/home/as7se/as1/repository/modules/connector_rar_name"

http-listener 또는 http-server.http-listener

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   HTTP Listener 속성

server.xml 이름	asadmin 이름
id	id
address	address
port	port
family	family
acceptor-threads	acceptorThreads
blocking-enabled	blockingEnabled
security-enabled	securityEnabled
default-virtual-server	defaultVirtualServer
server-name	serverName
enabled	enabled
cert-nickname	cert
ssl2-enabled	ssl2
ssl2-ciphers	ssl2Ciphers
ssl3-enabled	ssl3
ssl3-tls-ciphers	ssl3Ciphers
tls-enabled	tls
	tlsRollback
client-auth-enabled	clientAuth

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.http-listener.http_listener_name.*

또는

asadmin> get server1.http-server.http-listener.http_listener_name.*

factory라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.httpl-listener.http_listener_name.address

또는

asadmin> get server1.http-server.http-listener.http_listener_이름.address

address라는 속성을 IP 주소 0.0.0.0으로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.http-listener.http_listener_name.address=0.0.0.0

또는

asadmin> set server1.http-server.http-listener.http_listener_name.address=0.0.0.0

mime

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   MIME 유형 속성

server.xml 이름	asadmin 이름
id	id
file	file

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.mime.mime_name.*

file이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.mime.mime_name.file

file이라는 속성을 mime.types로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.mime.mime_name.file=mime.types

acl

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   ACL 속성

server.xml 이름	asadmin 이름
id	id
file	file

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.acl.acl_name.*

file이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.acl.acl_name.file

file이라는 속성을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.acl.acl_name.file=com/as1.acl

virtual-server

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   가상 서버 속성

server.xml 이름	asadmin 이름
id	id
http-listeners	httpListeners
config-file	configFile
default-object	defaultObject
accept-language	acceptLanguage
log-file	logFile
default-web-module	defaultWebModule
hosts	hosts
mime	mime
state	state
acls	acls
bandwidth-limit	bandwidthLimit
enforce-bandwidth-limit	enforceBandwidthLimit
connection-limit	connectionLimit
enforce-connection-limit	enforceConnectionLimit
property name="dir" value=	property.dir
property name="nice" value=	property.nice
property name="user" value=	property.user
property name="group" value=	property.group
property name="chroot" value=	property.chroot
property name="docroot" value=	property.docroot
property name="accesslog" value=	property.accesslog

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get instance_name.virtual-server..virtual-server..*

예:

asadmin> get server1.virtual-server.server1.*

가상 서버 server1의 httpListeners라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.virtual-server.server1.httpListeners

acceptLanguage라는 속성을 false로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.virtual-acceptLanguage=false

auth-db

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   인증 데이터베이스 속성

server.xml 이름	asadmin 이름
id	id
database	database
basedn	basedn
certmaps	certmaps

인스턴스에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get instancename.virtual-server.vserver_id.auth-db.authdb_id.*

예를 들어, 인스턴스 server1의 가상 서버 server1을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.virtual-server.server1.auth-db.authdb_id.*

database라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.virtual-server.server1.auth-db.authdb_id.database

database라는 속성을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.virtual-server.server1.auth-db.authdb_id.database=Oracle

authrealm

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   인증 영역 속성

server.xml 이름	asadmin 이름
name	name
classname	classname

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.authrealm.authrealm_id.*

classname이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.authrealm.authrealm_id.classname

classname이라는 속성을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.authrealm.authrealm_id.classname=com.sun.as.security.auth.real m.sharedpassword.SharedPasswordRealm

lifecycle-module

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   lifecycle 모듈 속성

server.xml 이름	asadmin 이름
name	name
enabled	enabled
class-name	className
classpath	classPath
load-order	loadOrder
is-failure-fatal	isFailureFatal
description	description

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.lifecycle-module.lifecycle_module_id.*

lifecycle 모듈의 className이라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.lifecycle-module.lifecycle_module_id.className

className이라는 속성을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.lifecycle-module.lifecycle_module_id.className=com.lifecycle_module_id. lifecycle

프로파일러

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   JVM 프로파일러 구성 속성

server.xml 이름	asadmin 이름
name	name
classpath	classPath
native-library-path	nativeLibraryPath
enabled	enabled

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.profiler.*

enabled라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.profiler.enabled

enabled라는 속성을 false로 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.profiler.enabled=false

서버 구성(서버 인스턴스 이름)

다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.

   서버 구성 속성

server.xml 이름	asadmin 이름
instance-name	name
locale	locale
log-root	logRoot
session-store	sessionStore
application-root	applicationRoot
dynamic-reload-enabled	appDynamicReloadEnabled
dynamic-reload-poll-interval-in-seconds	appReloadPollInterval

인스턴스(server1)에서 모든 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.*

logRoot라는 속성을 가져오려면 다음 작업을 수행합니다.

asadmin> get server1.logRoot

logRoot라는 속성을 설정하려면 다음 작업을 수행합니다.

asadmin> set server1.logRoot="/space/log"

긴 옵션 및 짧은 옵션 형식, 기본값 및 환경 변수 대응

다음 표는 명령줄 옵션의 긴 형식과 짧은 형식의 목록입니다. 짧은 형식이 나열되지 않은 경우에는 해당 옵션에 짧은 형식이 없는 것입니다.

   긴 옵션 및 짧은 옵션 형식, 기본값 및 환경 변수

옵션 이름	긴 형식	짧은 형식	기본값	환경 변수
acceptlang	--acceptlang			AS_ADMIN_ACCEPT_
acceptorthreads	--acceptorthreads			AS_ADMIN_ACCEPTOR_THREADS
acls	--acls			AS_ADMIN_ACLS
address	--address			AS_ADMIN_ADDRESS
adminpassword	--adminpassword			AS_ADMIN_ADMINPASSWD
adminport	--adminport		4848	AS_ADMIN_ADMINPORT
adminuser	--adminuser			AS_ADMIN_ADMINUSER
basedn	--basedn			AS_ADMIN_BASEDN
blockingenabled	--blockingenabled			AS_ADMIN_BLOCKINGENABLED
bwlimit	--bwlimit			AS_ADMIN_BWLIMIT
certmaps	--certmaps			AS_ADMIN_CERTMAPS
certname	--certname			AS_ADMIN_CERTNAME
classname	--classname			AS_ADMIN_CLASSNAME
classpath	--classpath			AS_ADMIN_CLASSPATH
clientauthenabled	--clientauthenabled			AS_ADMIN_CLIENTAUTHENABLED
configfile	--configfile			AS_ADMIN_CONFIGFILE
connectionpoolid	--connectionpoolid			AS_ADMIN_CONNECTIONPOOLID
connlimit	--connlimit			AS_ADMIN_CONNLIMIT
contextroot	--contextroot			AS_ADMIN_CONTEXTROOT
database	--database			AS_ADMIN_DATABASE
debug	--debug		false	AS_ADMIN_DEBUG
defaultobj	--defaultobj			AS_ADMIN_DEFAULTOBJ
defaultwebmodule	--defaultwebmodule			AS_ADMIN_DEFAULTWEBMODULE
description	--description			AS_ADMIN_DESCRIPTION
discardmanualchanges	--discardmanualchanges	-d	false	AS_ADMIN_DISCARDMANUALCHANGES
echo	--echo	-e	false	AS_ADMIN_ECHO
enabled	--enabled			AS_ADMIN_ENABLED
enforcebwlimit	--enforcebwlimit			AS_ADMIN_ENFORCEBWLIMIT
enforceconnlimit	--enforceconnlimit			AS_ADMIN_ENFORCECONNLIMIT
failconnection	--failconnection		false	AS_ADMIN_FAILCONNECTION
failurefatal	--failurefatal		false	AS_ADMIN_FAILUREFATAL
family	--family			AS_ADMIN_FAMILY
file	--file	-f		AS_ADMIN_FILE
force	--force	-F	true	AS_ADMIN_FORCE
help	--help	-h		AS_ADMIN_HELP
host	--host	-H		AS_ADMIN_HOST
hosts	--hosts			AS_ADMIN_HOSTS
httplistenerid	--httplistenerid			AS_ADMIN_HTTPLISTENERID
httplisteners	--httplisteners			AS_HTTP_LISTENERS
idletimeout	--idletimeout		300	AS_ADMIN_IDLETIMEOUT
instance	--instance	-i	server1	AS_ADMIN_INSTANCE
instanceport	--instanceport			AS_ADMIN_INSTANCEPORT
interactive	--interactive	-I	true	AS_AMDIN_INTERACTIVE
isconnectvalidaterequired	--isconnectvalidaterequired		false	AS_ADMIN_ISCONNECTVALIDATEREQUIRED
jdbcjndiname	--jdbcjndiname	-a		AS_ADMIN_JDBCJNDINAME
jndilookupname	--jndilookupname	-l		AS_ADMIN_JNDILOOKUPNAME
keepmanualchanges	--keepmanualchanges	-k	false	AS_ADMIN_KEEPMANUALCHANGES
loadorder	--loadorder			AS_ADMIN_LOADORDER
local	--local	-l	false
logfile	--logfile			AS_ADMIN_LOGFILE
maxpoolsize	--maxpoolsize		32	AS_ADMIN_MAXPOOLSIZE
maxwait	--maxwait		6000	AS_ADMIN_MAXWAIT
mime	--mime			AS_ADMIN_MIME
mimefile	--mimefile			AS_ADMIN_MIMEFILE
monitor	--monitor	-m	false	AS_ADMIN_MONITOR
name	--name	-n		AS_ADMIN_NAME
nativelibpath	--nativelibpath			AS_ADMIN_NATIVELIBPATH
objtype	--objtype	-o		AS_ADMIN_OBJTYPE
password	--password	-w		AS_ADMIN_PASSWORD
poolresize	--poolresize		2	AS_ADMIN_POOLRESIZE
port	--port	-p	8000	AS_ADMIN_PORT
prefix	--prefix	-x		AS_ADMIN_PREFIX
printprompt	--printprompt	-P	true	AS_ADMIN_PROMPT
property	--property			AS_ADMIN_PROPERTY
securityenabled	--securityenabled			AS_ADMIN_SECURITYENABLED
servername	--servername			AS_ADMIN_SERVERNAME
ssl2ciphers	--ssl2ciphers			AS_ADMIN_SSL2CIPHERS
ssl2enabled	--ssl2enabled			AS_ADMIN_SSL2ENABLED
ssl3enabled	--ssl3enabled			AS_ADMIN_SSL3ENABLED
ssl3tlsciphers	--ssl3tlsciphers			AS_ADMIN_SSL3TLSCIPHERS
state	--state			AS_ADMIN_STATE
steadypoolsize	--steadypoolsize	8		AS_ADMIN_STEADYPOOLSIZE
storeprotocol	--storeprotocol			AS_ADMIN_STOREPROTOCOL
storeprotocolclass	--storeprotocolclass			AS_ADMIN_STOREPROTOCOLCLASS
tlsenabled	--tlsenabled			AS_ADMIN_TLSENABLED
tlsrollbackenabled	--tlsrollbackenabled			AS_ADMIN_TLSROLLBACKENABLED
transprotocol	--transprotocol		smtp	AS_ADMIN_TRANSPROTOCOL
type	--type			S_ADMIN_TRANSPROTOCOLCLASS
upload	--upload	-U	true	AS_ADMIN_TYPE
url	--url			AS_ADMIN_URL
user	--user	-u		AS_ADMIN_USER
validationmethod	--validationmethod		auto-commit	AS_ADMIN_VALIDATIONMETHOD
validationtable	--validationtable			AS_ADMIN_VALIDATIONTABLE
version	--version	-v		AS_AMDIN_VERSION
virtualserver	--virtualserver			AS_ADMIN_VIRTUALSERVER