| Sun ONE Application Server 관리자 설명서 |
부록 A
명령줄 인터페이스 사용이 부록에서는 명령줄 인터페이스인 asadmin 유틸리티를 시스템 명령 프롬프트에서 한 번에 하나의 명령을 실행하는 단일 모드, 환경 수준 정보를 다시 입력할 필요 없이 여러 개의 명령을 실행할 수 있는 다중 모드, 스크립트 및 프로그램으로 사용하는 방법을 제공합니다. 관리 인터페이스 화면 대신 명령줄 인터페이스를 사용할 수 있습니다.
이 부록에서는 다음 내용을 설명합니다.
명령줄 인터페이스 정보이 절에서는 다음 항목에 대해 설명합니다.
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에는 추가적인 명령줄 유틸리티가 있습니다. 다음 표에는 유틸리티 목록과 그에 대한 간단한 설명이 있습니다.
이러한 유틸리티에 대한 자세한 내용은 온라인 도움말을 참조하십시오.
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 유틸리티 구문은 다음과 같습니다.
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를 대체하기 때문입니다.
내보낸 변수를 사용하지 않는 경우에는 대부분의 명령과 함께 다음 옵션을 사용하거나 기본값을 사용해야 합니다. 다음 기본값 목록은 "긴 옵션 및 짧은 옵션 형식, 기본값 및 환경 변수 대응"을 참조하십시오.
다음 "export 명령과 함께 사용되는 환경 변수" 표에서는 export 명령과 함께 사용하는 환경 변수에 대해 설명합니다. 이 변수들은 특히 환경을 설정하므로 가장 일반적으로 사용됩니다. 첫 번째 열은 환경 변수 이름을 나타내고 두 번째 열은 사용 목적을 설명하며 아무것도 설정되지 않은 경우에는 기본값을 보여줍니다. 전체 환경 변수 목록은 "긴 옵션 및 짧은 옵션 형식, 기본값 및 환경 변수 대응"을 참조하십시오.
비밀번호 파일 옵션 사용
명령줄에 비밀번호를 입력하지 않거나 비밀번호에 대한 환경 변수를 설정하려면 비밀번호 파일을 만들어 명령줄 옵션으로 사용할 수 있습니다.
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에 대한 자세한 내용은 2장, "Administration Server 기본 설정"을 참조하십시오.
다음 명령은 로컬 및 원격으로 실행될 수 있습니다.
이러한 명령의 경우에는 로컬 옵션을 지정하지 않고도 명령을 로컬로 실행하도록 선택할 수 있습니다. 기본적으로 명령 구문에서 사용자, 비밀번호, 호스트 및 포트의 값을 지정하는 경우 이러한 옵션에 대해 로컬 값을 지정할 수 있음에도 불구하고 이 명령은 원격 명령으로 취급됩니다. 이러한 옵션의 값을 지정하지 않으면 명령은 기본적으로 로컬로 실행됩니다.
명령이 로컬로 실행될 때 도메인 옵션이 있으면 도메인이 한 개뿐인 경우 외에는 필수 옵션입니다. 지정한 도메인 옵션은 명령이 원격으로 실행되는 경우에는 무시됩니다.
명령줄 호출 사용
명령줄을 다음 항목에 설명된 여러 방법으로 호출할 수 있습니다.
명령줄에서 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에서는 작동하지 않을 수 있습니다.
이스케이프 문자 사용
콜론(:), 별표(*) 및 백슬래시(\) 등 일부 문자는 명령 구문에 사용할 때 이스케이프 문자를 함께 써야만 오류가 발생하는 것을 막을 수 있습니다. 이스케이프 문자 사용은 사용 플랫폼 및 단일 모드 또는 다중 모드 사용 여부에 따라 다릅니다.
이 절에서는 다음 항목에 대해 설명합니다.
단일 모드 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_lookup_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
"단일 모드 모든 플랫폼상의 이스케이프 문자"에 설명된 방법을 사용할 수도 있습니다.
단일 모드 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_lookup_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 명령을 사용하십시오.
표 A-3 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 = 2MDB 컨테이너 속성인 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"
fiWindows상의 종료 상태
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
사용법: 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 명령과 그 용도에 대해 설명합니다. 명령 구문 및 그 사용법에 대한 자세한 내용은 온라인 도움말을 참조하십시오.
왼쪽 열은 명령 이름이고 오른쪽 열은 그 사용법입니다.
점으로 구분된 이름 및 속성 목록
get 및 set 명령을 사용하여 속성을 가져오고 설정하는 경우에는 asadmin에서 서비스, 자원 등에 사용하는 이름을 알아야 이 이름을 사용하여 특정 객체의 속성을 가져올 수 있습니다.
이러한 이름은 이름 사이에 마침표를 넣어 구분하는 구문을 사용하기 때문에 점으로 구분된 이름으로 불립니다.
asadmin에서 사용하는 점으로 구분된 이름
다음 표에서는 asadmin을 사용하여 항목을 구성하는 데 사용하는 이름을 나열합니다. 이 이름들은 다음과 같은 범주로 나뉩니다.
서비스 이름
다음 표에서는 서비스의 속성을 가져오고 설정하는 데 사용되는 서비스 이름을 보여줍니다.
자원 이름
다음 표에서는 자원의 속성을 가져오고 설정하는 데 사용하는 자원 이름을 보여줍니다. 이 이름만으로는 유효하지 않으며, 이름 뒤에 자원 이름이 와야 합니다.
표 A-6 명령줄 인터페이스의 자원 이름
자원
점으로 구분된 이름
JDBC 자원 구성
JNDI 자원 구성
JDBC 연결 풀 자원 구성
사용자 정의 자원 구성
JMS 자원 구성
지속성 관리자 팩토리 자원 구성
JavaMail 자원 구성
응용 프로그램 이름
다음 표에서는 응용 프로그램 관련 구성의 속성을 가져오고 설정하는 데 사용하는 점으로 구분된 이름을 보여줍니다. 이 이름만으로는 유효하지 않으며 이름 뒤에 응용 프로그램의 이름이 와야 합니다.
기타 이름
다음 표에서는 get 및 set 명령을 사용하여 구성할 수 있는 기타 항목의 점으로 구분된 이름을 보여줍니다. 이 이름만으로는 유효하지 않으며, 이름 뒤에 자원의 이름이 와야 합니다(예: http-listener.listener_name, lifecycle-module.module-name).
표 A-8 명령줄 인터페이스의 기타 항목 이름
항목
점으로 구분된 이름
HTTP Listener
MIME 유형 파일
ACL
가상 서버
인증 데이터베이스
보안 영역
lifecycle 모듈
프로파일러 구성
서버 구성
속성
다음 절에서는 위에 나열된 명명된 지정 항목의 속성과 그 사용 예를 설명합니다. 일부 속성은 읽기 전용으로 get 명령에만 사용 가능하고 set 명령에는 사용할 수 없습니다.
jms-service
다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
표 A-13 웹 컨테이너 속성
server.xml 이름
asadmin 이름
log-level
logLevel
monitoring-enabled
monitoringEnabled (사용 안 함)
인스턴스(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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
표 A-20 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에서 사용하는 이름을 보여줍니다.
표 A-21 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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
표 A-23 사용자 정의 자원 속성
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에서 사용하는 이름을 보여줍니다.
표 A-24 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에서 사용하는 이름을 보여줍니다.
표 A-25 지속성 관리자 팩토리 자원 속성
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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
표 A-27 응용 프로그램 속성
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에서 사용하는 이름을 보여줍니다.
표 A-28 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/repository/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="/export/home/as7se/as1/repository/modules/ejb_jar_name"
web-module
다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.
표 A-29 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에서 사용하는 이름을 보여줍니다.
표 A-30 커넥터 모듈 속성
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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
인스턴스(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에서 사용하는 이름을 보여줍니다.
표 A-35 인증 데이터베이스 속성
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에서 사용하는 이름을 보여줍니다.
인스턴스(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.realm.sharedpassword.SharedPasswordRealm
lifecycle-module
다음 표에서는 왼쪽 열에 속성의 server.xml 이름, 오른쪽 열에 asadmin에서 사용하는 이름을 보여줍니다.
표 A-37 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에서 사용하는 이름을 보여줍니다.
표 A-38 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에서 사용하는 이름을 보여줍니다.
인스턴스(server1)에서 모든 속성을 가져오려면 다음을 수행합니다.
asadmin> get server1.*
logRoot라는 속성을 가져오려면 다음을 수행합니다.
asadmin> get server1.logRoot
logRoot라는 속성을 설정하려면 다음을 수행합니다.
asadmin> set server1.logRoot="/space/log"
긴 옵션 및 짧은 옵션 형식, 기본값 및 환경 변수 대응
다음 표는 명령줄 옵션의 긴 형식과 짧은 형식의 목록입니다. 짧은 형식이 나열되지 않은 경우에는 해당 옵션에 짧은 형식이 없는 것입니다.
