asadmin 유틸리티

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

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

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

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

로컬 하위 명령은 관리 서버가 없는 상태에서 실행할 수 있습니다. 그러나 사용자는 하위 명령을 실행하고 설치 및 도메인 디렉토리에 대한 액세스 권한을 갖기 위해 도메인을 호스팅하는 시스템에 로그인해야 합니다. 원격 하위 명령은 항상 관리 서버에 연결하여 해당 서버에서 명령을 실행함으로써 실행됩니다. 관리 서버가 실행 중이어야 합니다. 모든 원격 하위 명령에는 다음 옵션이 필요합니다.

• -u -‐user 인증된 도메인 응용 프로그램 서버 관리 사용자 이름입니다.

• -‐passwordfile 다음 형식으로 된 도메인 응용 프로그램 서버 비밀번호를 포함하는 파일: AS_ADMIN_PASSWORD=password. 여기서 password는 실제 관리자 비밀번호입니다.

• -H -‐host 도메인 응용 프로그램 서버가 실행되는 시스템 이름입니다.

• -p -‐port 관리 요청을 수신하는 도메인 응용 프로그램 서버의 포트 번호입니다. Platform Edition의 기본 포트 번호는 4848입니다.

• -s -‐secure true인 경우 SSL/TLS를 사용하여 도메인 응용 프로그램 서버와 통신합니다.

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

• -e -‐echo true로 설정하면 명령줄 명령이 표준 출력에 표시됩니다. 기본값은 false입니다.

• -I -‐interactive true(기본값)로 설정하면 필수 비밀번호 옵션에 대한 프롬프트만 표시됩니다.

• -h -‐help 명령에 대한 도움말 텍스트를 표시합니다.

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

로컬로 실행할 수 있는 하위 명령에는 --domain 옵션을 사용하여 도메인이 하나뿐인 경우 기본 도메인으로 간주되도록 도메인을 지정할 수 있습니다. 둘 이상의 도메인이 있는 경우에는 --domain 옵션이 필수 옵션입니다. 로컬 또는 원격으로 실행할 수 있는 하위 명령에 --host, --port, --user 및 --passwordfile 옵션을 지정하여 원격으로 실행하면 --domain 옵션이 무시됩니다. 하위 명령이 원격 모드로 실행되는 경우 --domain 옵션이 무시됩니다. 도메인당 한 개의 관리 인스턴스가 있으므로 단일 시스템에 여러 도메인이 있는 경우 로컬 실행 시 도메인을 지정해야 하며, 원격 실행에서는 해당 도메인의 관리 인스턴스에 대해 --host, --port, --user 및 --passwordfile 옵션을 지정해야 합니다.

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

예 C–1 passwordfile 내용

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

AS_ADMIN_PASSWORD를 전역 환경으로 내보낸 경우 --passwordfile 옵션을 지정하면 --password 옵션 사용에 대한 경고가 표시됩니다. AS_ADMIN_PASSWORD를 설정 해제하면 이러한 경고 표시를 방지할 수 있습니다. 마스터 비밀번호는 명령줄이나 환경 변수에서 전파되지 않으며 passwordfile에서 지정할 수 있습니다.

--secure 옵션을 사용하려면 set 명령을 사용하여 domain.xml의 admin http-listener에서 보안 --enabled 플래그를 활성화해야 합니다. asadmin 하위 명령을 사용하여 명령을 만들거나 삭제할 경우 서버를 다시 시작해야 새로 만든 명령이 적용됩니다. start-domain 명령을 사용하여 서버를 다시 시작합니다.

Solaris 플랫폼에서 Application Server 명령줄 인터페이스 하위 명령에 대한 설명서 페이지에 액세스하려면 MANPATH 환경 변수에 $AS_INSTALL/man을 추가합니다.

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