|
| |
| Sun Java System Identity Server 2004Q2 관리 설명서 | |
10장
amadmin 명령줄 도구이 장에서는 amadmin 명령줄 도구에 대해 설명하며 다음 내용으로 구성되어 있습니다.
amadmin 명령줄 실행 파일명령줄 실행 파일 amadmin의 주 목적은 XML 서비스 파일을 Directory Server로 로드하고 DIT에서 일괄 관리 작업을 수행하는 것입니다. amadmin은 IdentityServer_base/SUNWam/bin에 위치하며 다음 작업을 수행하는 데 사용됩니다.
- XML 서비스 파일 로드 - 관리자가 sms.dtd에 정의된 XML 서비스 파일 형식을 사용하는 Identity Server로 서비스를 로드합니다. 모든 서비스는 amadmin을 사용하여 로드해야 하며, Identity Server 콘솔을 통해 가져올 수 없습니다.
주
XML 서비스 파일은 Identity Server에서 참조하는 XML 데이터의 정적 blob으로 Directory Server에 저장됩니다. 이 정보는 LDAP만 이해하는 Directory Server에서는 사용되지 않습니다.
- DIT에 대한 identity 객체 일괄 업데이트 수행 - 관리자는 amadmin.dtd에 정의된 일괄 처리 XML 파일 형식을 사용하여 Directory Server DIT를 일괄적으로 업데이트할 수 있습니다. 예를 들어, 관리자가 10개의 조직, 1000명의 사용자 및 100개의 그룹을 만들고자 할 경우 하나 이상의 일괄 처리 XML 파일에 요청을 입력한 다음 amadmin을 사용하여 로드하여 해당 작업을 한 번에 수행할 수 있습니다. 이 작업에 관한 자세한 내용은 Identity Server Developer's Guide의 "Service Management"장을 참조하십시오.
amadmin 구문
amadmin을 사용할 경우에 따라야 하는 많은 구조적 규칙이 있습니다. 도구 사용을 위한 일반 구문은 다음과 같습니다.
- amadmin -u | --runasdn dnname -w | --password password [-l | --locale localename] [[-v | --verbose] | [-d |--debug]] -t | --data xmlfile1 [xmlfile2 ...]
- amadmin -u | --runasdn dnname -w | --password password [-l | --locale localename] [[-v | --verbose] | [-d | --debug]] -s | --schema xmlfile1 [xmlfile2 ...]
- amadmin -u | --runasdn dnname -w | --password password [-l | --locale localename] [[-v | --verbose] | [-d | --debug]] -r | --deleteService serviceName1 [serviceName2 ...]
- amadmin -u | --runasdn dnname -w | --password password or -f | --password file passwordfile [-c | --continue] [-l | --locale localename] [[-v | --verbose] | [-d | --debug]] -m | --session servername pattern
- amadmin -h | --help
- amadmin -n | --version
- amadmin -u | --runasdn dnname -w | --password password or - f |--passwordfile passwordfile [-l | --locale localename] [[-v | --verbose] | [-d] |--debug]] -a |--addAttributes serviceName schemaType xmlfile[xmlfile2] ...
amadmin 옵션
amadmin 명령줄 매개 변수 옵션의 정의는 다음과 같습니다.
--runasdn (-u)
--runasdn은 LDAP 서버에 사용자를 인증하는 데 사용됩니다. 인자는 amadmin을 실행하도록 인증된 사용자의 고유 이름(DN) 인수와 동일한 값입니다. 예를 들면 다음과 같습니다.
--runasdn uid=amAdmin,ou=People,o=iplanet.com,o=isp
각 도메인 구성 요소 사이에 공백을 삽입하고 전체 DN을 큰 따옴표로 묶어 (예: --runasdn "uid=amAdmin, ou=People, o=iplanet.com, o=isp") DN 서식을 지정할 수도 있습니다.
--password (-w)
--password는 필수 옵션이며 --runasdn 옵션으로 지정한 DN의 비밀번호와 동일한 값을 가집니다.
--locale (-l)
--locale은 로켈 이름과 동일한 값을 갖는 옵션입니다. 이 옵션은 메시지 언어 사용자 정의에 사용될 수 있습니다. 이 옵션을 지정하지 않으면 기본 로켈 en_US가 사용됩니다.
--continue (-c)
--continue는 오류가 발생하더라도 XML 파일 처리를 계속하라는 옵션입니다. 예를 들어, 세 XML 파일을 동시에 로드할 때 첫 번째 XML 파일이 실패할 경우 amadmin은 나머지 파일을 계속해서 로드합니다.
--session (-m)
--session (-m)은 세션을 관리하거나 현재 세션을 표시하는 옵션입니다. --runasdn을 지정할 경우 AMConfig.properties에 있는 수퍼유저의 DN 또는 최상위 관리자의 아이디와 같아야 합니다.
다음 예에서는 특정 서비스 호스트 이름에 대한 모든 세션을 표시합니다.
amadmin -u uid=amadmin,ou=people,dc=iplanet,dc=com -v -w 12345678 -m http://sun.com:58080
다음 예에서는 특정 사용자 세션을 표시합니다.
amadmin -u uid=amadmin,ou=people,dc=iplanet,dc=com -v -w 12345678 -m http://sun.com:58080 username
해당 색인 번호를 입력하여 특정 세션을 종료할 수도 있고 여러 색인 번호(공백으로 구분)를 입력하여 여러 세션을 종료할 수도 있습니다.
다음 옵션을 사용하는 경우:
amadmin -m | --session servername pattern
pattern은 와일드카드(*)일 수 있습니다. 이 패턴으로 와일드카드(*)를 사용할 경우 쉘에서 메타 문자(\)를 사용하여 패턴을 제어해야 합니다.
--debug (-d)
--debug는 identity_server_root/var/opt/SUNWam/debug 디렉토리에 생성된 amadmin 파일에 메시지를 기록하는 옵션입니다. 이러한 메시지는 기술적으로 자세히 설명되지만 국제화 조건을 준수하지는 않습니다. amadmin 작업 로그를 생성하려면 데이터베이스에 기록할 때 데이터베이스 드라이브에 대한 클래스 경로를 수동으로 추가해야 합니다. 예를 들어, amadmin의 mysql에 기록할 경우 다음 줄을 추가합니다.
CLASSPATH=$CLASSPATH:/opt/IS61/SUNWam/lib/mysql-connector-java-3.0.6-stable-bin.jar
export CLASSPATH
--verbose (-v)
--verbose는 화면에 amadmin 명령의 전체 진행 과정을 인쇄하는 옵션입니다. 세부 정보는 파일에 인쇄되지 않습니다. 명령줄에 대한 메시지 출력은 국제화 조건을 준수합니다.
--data (-t)
--data는 가져올 일괄 처리 XML 파일 이름을 값으로 갖는 옵션입니다. XML 파일을 하나 이상 지정할 수 있습니다. 이 XML 파일은 서비스를 등록 및 등록 취소할 수 있을 뿐만 아니라 다양한 디렉토리 객체를 만들고, 삭제하고, 읽을 수 있습니다. 이 옵션에 전달될 수 있는 XML 파일 유형에 대한 자세한 내용은 Identity Server Developer's Guide의 "Servic Management"장을 참조하십시오.
--schema (-s)
--schema는 Identity Server 서비스의 속성을 Directory Server로 로드하는 옵션입니다. 이 옵션은 서비스 속성이 정의되는 XML 서비스 파일을 인수로 가집니다. 이 XML 서비스 파일은 sms.dtd를 기반으로 합니다. XML 파일을 하나 이상 지정할 수 있습니다.
--deleteservice (-r)
--deleteservice는 서비스와 해당 스키마만 삭제하는 옵션입니다.
--serviceName
--serviceName은 XML 서비스 파일의 Service name=... 태그에 정의되는 서비스 이름과 같은 값을 갖는 옵션입니다. 해당 내용이 코드 예 10-1에 표시되어 있습니다.
--help (-h)
--help는 amadmin 명령에 대한 구문을 표시하는 인수입니다.
--version (-n)
--version은 유틸리티 이름, 제품 이름, 제품 버전 및 사용권에 대한 고지 사항을 표시하는 인수입니다.
연합 관리를 위해 amadmin 사용
이 절에서는 연합 관리와 함께 사용하는 amadmin 매개 변수를 나열합니다. 연합 관리에 대한 자세한 내용은 Identity Server Federation Management Guide를 참조하십시오.
Directory Server에 Liberty 메타 호환 XML 로드
amadmin -u|--runasdn <user's DN>
-w|--password <password> or -f|--passwordfile <passwordfile>
-e|--entityname <entity name>
-g|--import <xmlfile>
--runasdn (-u)
사용자의 DN
--password (-w)
사용자의 비밀번호.
--passwordfile (-f)
사용자의 비밀번호가 포함된 파일의 이름.
--entityname (-e)
엔티티 이름. 예: http://www.example.com 하나의 엔티티는 하나의 조직에만 소속되어야 합니다.
--import (-g)
메타 정보가 포함된 XML 파일의 이름. 이 파일은 Liberty 메타 사양과 XSD를 준수해야 합니다.
XML 파일에 엔티티 내보내기(XML 디지털 서명 사용 안함)
amadmin -u|--runasdn <user's DN>
-w|--password <password> or -f|--passwordfile <passwordfile>
-e|--entityname <entity name>
-o|--export <filename>
--runasdn (-u)
사용자의 DN
--password (-w)
사용자의 비밀번호.
--passwordfile (-f)
사용자의 비밀번호가 포함된 파일의 이름.
--entityname (--e)
Directory Server에 상주하는 엔티티의 이름
--export (-o)
엔티티의 XML을 포함하는 파일의 이름. XML은 Liberty 메타 XSD를 준수합니다.
XML 파일에 엔티티 내보내기(XML 디지털 서명 사용)
amadmin -u|--runasdn <user's DN>
-w|--password <password> or -f|--passwordfile <passwordfile>
-e|--entityname <entity name>
-q|--exportwithsig <filename>
--runasdn (-u)
사용자의 DN
--password (-w)
사용자의 비밀번호.
--passwordfile (-f)
사용자의 비밀번호가 포함된 파일의 이름.
--entityname (--e)
Directory Server에 상주하는 엔티티의 이름
--exportwithsig (-o)
엔티티의 XML이 포함된 파일의 이름. 이 파일에는 디지털 서명이 부가됩니다. XML은 Liberty 메타 XSD 호환이라야 합니다.
자원 번들에 대해 amadmin 사용
다음 절에서는 자원 번들을 추가, 위치 파악 및 제거하기 위한 amadmin 구문을 보여줍니다.
자원 번들 추가
amadmin -u|--runasdn <user-dn> -w|--password <user-password>
-b|--addresourcebundle <name-of-resource-bundle>
-i|--resourcebundlefilename <resource-bundle-file-name>
[-R|--resourcelocale] <locale>
자원 문자열 가져오기
amadmin -u|--runasdn <user-dn> -w|--password <user-password>
-z|--getresourcestrings <name-of-resource-bundle>
[-R|--resourcelocale] <locale>
자원 번들 제거
amadmin -u|--runasdn <user-dn> -w|--password <user-password>
-j|--deleteresourcebundle <name-of-resource-bundle>
[-R|--resourcelocale] <locale>