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

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