test

Service Registry 3 2005Q4 관리 설명서

2장 관리 도구 사용

이 장에서는 Service Registry에 대한 관리 도구(“관리 도구”)를 사용하는 방법에 대해 설명합니다.

이 장은 다음 절로 구성되어 있습니다.

관리 도구 정보

Service Registry 관리 도구는 레지스트리에 연관 추가, 레지스트리에서 객체 제거 등과 같은 일반적인 관리 작업을 위한 간단한 명령줄 인터페이스를 제공합니다.

관리 도구는 다음 두 모드 중 하나에서 작동할 수 있습니다.

ls 및 rm과 같은 여러 명령은 파일 및 폴더에 실행되는 잘 알려진 UNIX® 명령의 이름과 동작을 따릅니다. 다른 명령에는 해당하는 UNIX 명령이 없습니다.

관리 도구 시작

관리 도구를 시작하려면 admin-tool.jar 파일을 다음과 같이 실행합니다. 


java -jar ServiceRegistry-base/lib/admin-tool.jar [options]...

ServiceRegistry-base 위치는 Solaris 운영 환경에서는 /opt/SUNWsoar이고, Linux 시스템에서는 /opt/sun/SUNWsoar입니다.

도구를 시작할 때 표시되는 경고는 중요하지 않으므로 무시합니다.

관리 도구를 종료하려면 quit 명령을 사용합니다.

관리자에게 제한된 명령을 수행하려면 명령줄에 다음과 같이 인증서 파일(키 저장소)의 유형, 위치 및 비밀번호를 명령줄에 지정해야 합니다(모두 한 줄로 표시).


java -Djaxr-ebxml.security.storetype=PKCS12 \
-Djaxr-ebxml.security.keystore=security/filename.p12 \
-Djaxr-ebxml.security.storepass=password -jar admin-tool.jar

여기서 filename은 인증서 파일의 루트 이름(기본값: generated-key)이고 password는 인증서를 만들 때 이 파일을 보호하기 위해 지정한 비밀번호입니다. security/filename.p12 위치는 $HOME/soar/3.0/jaxr-ebxml 디렉토리에 상대적입니다.

입력 내용을 저장하려면 이 명령을 실행하는 스크립트를 만듭니다.

일괄 처리 모드

관리 도구를 일괄 처리 모드로 실행하려면 관리 도구를 시작할 때 명령줄에 -command 옵션을 지정합니다.

예를 들어, 다음 명령은 ls 명령을 실행합니다. 


java -jar ServiceRegistry-base/lib/admin-tool.jar -command "ls *.html"

관리 도구는 명령 및 도구 응답을 화면에 표시하며 명령이 실행된 후에는 종료됩니다.

해당 쉘에 중요한 문자를 적절한 이스케이프 문자로 처리해야 합니다.

대화형 모드

관리 도구를 대화형 모드로 실행하려면 명령줄에서 -command 이외의 옵션을 지정하여(또는 옵션 없음) 관리 도구 쉘을 시작합니다. 


java -jar ServiceRegistry-base/lib/admin-tool.jar

관리 도구는 다음 프롬프트를 표시하고 사용자의 입력을 기다립니다.


admin>

관리 도구 명령줄 옵션

관리 도구는 다음의 개요에 나열되고 옵션에 설명된 명령줄 옵션을 인식합니다.

개요

[-alias alias] [- command commands] [-debug] [-help] [-keypass keypass ] [-localdir localdir] [-locale locale] [- registry url] [-root locator [-create]] [-sqlselect SQL_statement] [-verbose]

옵션

-alias

키 저장소에서 사용자 인증서에 액세스할 때 사용하는 별칭입니다. 사용자로 등록할 때 사용한 별칭을 지정합니다.

-command

대화형 쉘에서 명령을 가져오는 대신 실행할 관리 도구 명령 시퀀스입니다. 세미콜론(;)을 사용하여 여러 명령을 구분합니다. commands에 quit 명령을 포함할 필요는 없습니다. 명령 구분자가 아닌 세미콜론을 사용해야 하는 경우 백슬래시 앞에 세미콜론을 입력합니다.


\;

관리 도구를 실행하는 쉘에서는 이 백슬래시에 백슬래시를 하나 더 사용하여 이스케이프 문자로 처리해야 할 수도 있습니다.


\\;

명령에 공백이 포함되어 있는 경우에는 도구에서 해당 시퀀스를 여러 명령줄 매개 변수가 아닌 단일 명령줄 매개 변수로 취급하도록 전체 명령 시퀀스를 작은따옴표 또는 큰따옴표로 묶습니다. 또한 쉘에서 세미콜론을 쉘 구분 명령으로 해석하는 경우에는 여러 관리 도구 명령의 시퀀스를 항상 따옴표로 묶어야 합니다.

-create

필요한 경우 -root 옵션에 지정된 RegistryPackage 및 상위 RegistryPackage 객체를 만듭니다. 이 옵션은 관리 도구를 실행하는 사용자가 객체 만들기 권한이 있는 경우에만 사용할 수 있습니다.

-debug

디버깅할 때 유용한 추가 정보를 출력합니다.

-help

이러한 옵션 목록을 제공합니다.

-keypass

키 저장소에서 사용자 인증서에 액세스할 때 사용하는 비밀번호입니다. 사용자로 등록할 때 사용한 비밀번호를 지정합니다.

-localdir

로컬 파일 시스템에 있는 파일과 관련된 명령에 대한 로컬 파일 시스템의 기본 디렉토리입니다.

-locale

오류 및 상태 메시지에 대해 사용할 자원 번들을 선택하는 데 사용되는 로켈(예: en 또는 fr)입니다. 기본값은 JVM(Java Virtual Machine)에 의해 결정됩니다.

-registry

연결할 ebXML 레지스트리의 URL입니다. 기본값은 http://localhost:6060/soar/registry/soap입니다.

-root

저장소를 서로 다른 RegistryObject 및 RegistryPackage 객체를 포함하는 RegistryPackage 객체의 트리로 취급하는 이러한 명령의 기초로 사용하는 RegistryPackage의 로케이터(예: /registry/userData)입니다. 기본값은 모든 사용자 데이터 /registry/userData에 대해 정의된 RegistryPackage입니다.

-sqlselect

SQL_statement를 실행하여 레지스트리 객체를 선택합니다. 이 문은 select로 시작하는 전체 SQL 문이어야 합니다. SQL 문은 따옴표로 묶어야 하지만 세미콜론으로 종료할 필요는 없습니다. 이 옵션을 지정한 다음 select 명령을 인수 없이 사용하면 SQL_statement 이외의 인수와 함께 select 명령을 사용할 때까지는 SQL_statement가 실행됩니다.

-v | -verbose

상태 메시지의 세부 정보 표시 출력을 지정합니다.

주 –

-help 옵션의 출력에는 이 릴리스에서 지원되지 않는 -class 및 -property가 나열됩니다.

관리 도구 기능

이 절에서는 다음과 같은 관리 도구 기능에 대해 설명합니다.

권한

관리 도구를 사용하는 경우에는 도구를 시작할 때 키 별칭 및 비밀번호를 지정한 사용자에게 허용되는 작업만 수행할 수 있습니다. 특정 명령(예: chown)은 관리자 역할을 가진 사용자만 수행할 수 있습니다. 자세한 내용은 관리자 만들기를 참조하십시오.

예외 표시

관리 도구를 사용하면 명령이 실패할 때 자세한 스택 추적 정보가 표시되지 않습니다.

명령이 실패할 경우 관리 도구는 스택 추적의 첫 번째 행을 인쇄하고 다음과 같은 메시지를 표시합니다.


An error occurred when executing the function.  Use the show exception 
command to view messages.

자세한 내용을 보려면 show exception 명령을 실행하여 전체 스택 추적을 참조하십시오.

show exception 명령은 항상 바로 앞에 실행된 명령의 스택 추적을 표시합니다.

레지스트리 객체 식별

레지스트리 객체를 식별할 때는 기본적으로 이름을 사용합니다. 하지만 일반적으로 registry 루트에서 RegistryPackage까지의 경로를 통해 RegistryPackage 객체를 식별합니다. 예를 들어, /registry/userData는 userData RegistryPackage의 경로입니다.

일부 이름 일치에서는 와일드카드를 지원합니다. 단일 문자와 일치시키려면 물음표(?)를 사용하고 0개 이상의 문자를 일치시키려면 별표(*)를 사용합니다.

일부 명령(예: cd 및 chown)은 URN(Uniform Resource Name)을 통한 객체 식별을 지원하므로 앞에 urn:을 붙여야 합니다. 예를 들어, urn:uuid:2702f889-3ced-4d49-82d1-e4cd846cb9e4는 유효한 URN입니다.

또한 chown 명령에서는%number를 사용하여 이전 users 명령에 나열된 User를 참조할 수 있습니다.

일부 명령에서는 전체 이름을 큰따옴표로 묶거나 이름의 각 공백 앞에 백슬래시를 입력하여 공백을 포함하는 이름을 입력할 수 있습니다.

select 명령은 다음과 같은 SQL 와일드카드 사용을 지원합니다. 백분율 기호(%)는 여러 문자와 일치하고 밑줄(_)은 단일 문자와 일치합니다.

이름 지정에 대한 로켈 효과

RegistryObject(또는 RegistryPackage)는 각각 서로 다른 로켈에 연결되는 여러 이름을 가질 수 있습니다.

지정하는 경로 및 객체 이름은 현재 로켈에 대해서만 평가됩니다. 여러 이름을 가진 레지스트리 객체를 이름별로 선택할 경우 레지스트리는 제공된 이름을 해당 레지스트리 객체의 모든 이름이 아니라 레지스트리 객체 이름에 대한 단일 선택 항목(로켈이 현재 로켈과 가장 일치하는 선택 항목)에 대해서만 일치시킵니다.

예를 들어, 현재 RegistryPackage에 en(영어) 로켈의 red 및 fr(프랑스어) 로켈의 rouge와 같이 서로 다른 로켈에 연관된 두 개의 이름을 가진 구성원 객체가 있다고 가정합니다. 현재 로켈이 en인 경우 ls rouge 명령은 해당 구성원 객체를 표시하지 않지만 로켈이 fr(또는 해당 변형 중 하나)인 경우에는 해당 구성원 객체를 표시합니다.

대소문자 구분

관리 도구에서 인식되는 명령 이름 및 리터럴 매개 변수는 대소문자 구분이 없습니다. 예를 들어, ls, Ls 및 LS는 모두 같은 값을 갖습니다.

값이 제공된 옵션은 해당 옵션을 사용하는 코드에 문자 그대로 전달됩니다.

관리 도구 명령 사용

다음 절에서는 사용 가능한 명령에 대해 설명합니다. 각 명령의 옵션 및 피연산자에 대한 개요 및 설명에서는 다음의 활자체 규약을 따릅니다.

그 외의 활자체는 명령을 실행할 때 포함시켜야 하는 리터럴 텍스트입니다.

add association

레지스트리에 Association 객체를 추가합니다.

개요

add association -type association-type sourceURN targetURN

설명

add association 명령은 지정된 유형의 Association 객체를 레지스트리에 추가합니다. 다음과 같은 유형을 사용할 수 있습니다.

옵션

-type

Association 객체 유형입니다.

피연산자

sourceURN

소스 객체의 URN입니다.

targetURN

대상 객체의 URN입니다.

예

다음 명령(모두 한 줄로 표시)은 지정된 두 URN이 있는 객체 간의 RelatedTo 관계를 만듭니다.


admin> add association -type RelatedTo 
urn:uuid:ab80d8f7-3bea-4467-ad26-d04a40045446 
urn:uuid:7a54bbca-2131-4a49-8ecc-e7b4ac86c4fd

add user

레지스트리에 사용자를 추가합니다.

개요

add user [-edit] [- load filename] [-firstname string] [-lastname string] [-middleName string] - alias string - keypass string [-post1.type string] [-post1.city string] [-post1.country string] [- post1.postalcode string] [-post1.stateOrProvince string] [-post1.street string] [-post2.streetNumber string ] [-post2.type string] [-post2.city string] [- post2.country string] [-post2.postalcode string] [-post2.stateOrProvince string] [-post2.street string] [-post2.streetNumber string ] [-post3.type string] [-post3.city string] [- post3.country string] [-post3.postalcode string] [-post3.stateOrProvince string] [-post3.street string] [-post3.streetNumber string ] [-telephone1.type string] [-telephone1.areaCode string] [-telephone1.countryCode string] [-telephone1.extension string] [-telephone1.number string] [- telephone1.URL string] [-telephone2.type string] [-telephone2.areaCode string] [-telephone2.countryCode string] [-telephone2.extension string] [-telephone2.number string] [-telephone2.URL string ] [-telephone3.type string] [-telephone3.areaCode string] [-telephone3.countryCode string] [-telephone3.extension string] [-telephone3.number string] [- telephone3.URL string] [-email1.type string] [-email1.address string] [-email2.type string] [-email12address string] [- email3.type string] [-email3.address string]

설명

add user 명령은 User 객체를 추가합니다. User 객체는 일반적으로 하나 이상의 PostalAddress , TelephoneNumber 및 EmailAddress 객체를 포함합니다.

명령줄을 사용하거나 -load 옵션을 통해 정보가 있는 Java 등록 정보 파일을 지정하여 사용자에 대한 정보를 지정합니다. 정보 옵션 및 -load 옵션은 명령줄에 표시된 순서대로 평가됩니다. 예를 들어, 명령줄에서 일부 등록 정보를 지정하고 등록 정보 파일에서 다른 등록 정보를 로드한 다음 이후의 명령줄 옵션으로 등록 정보 파일의 정보를 대체할 수 있습니다.

새 사용자에 대해 최대 세 개의 주소, 전화 번호 및 전자 메일 주소를 지정할 수 있습니다. 더 많은 정보를 지정할 필요가 있는 경우에는 나중에 웹 콘솔 또는 JAXR을 사용하여 추가할 수 있습니다.

주소, 전화 번호 또는 전자 메일 주소를 지정할 때는 -emailType OfficeEmail과 같이 해당 유형에 대한 값을 제공해야 합니다.

모든 사용자에게 필요한 일부 일반 정보의 경우 명령줄에서 약자 옵션(예: -fn)을 사용할 수 있지만 등록 정보에서 정보를 입력할 때는 긴 형식을 사용해야 합니다. 예를 들어, 명령줄에서 -email1.address, -emailAddress 또는 -email을 사용하여 사용자의 첫 번째 전자 메일 주소를 지정할 수 있지만, 등록 정보 파일에서 첫 번째 전자 메일 주소를 지정할 때는 email1.address=를 사용해야 합니다. 사용자의 두 번째 전자 메일 주소 지정 옵션은 하나만 있으므로 명령줄에서는 -email2.address를 사용하고 등록 정보 파일에서는 email2.address=를 사용해야 합니다.

-edit 옵션을 지정하는 경우 관리 도구는 사용자가 새 사용자 정보를 편집할 수 있도록 편집기를 시작합니다. 자세한 내용은 옵션 설명을 참조하십시오.

주 –

-load를 사용하여 로드하거나 -edit를 사용하여 편집하는 등록 정보 파일은 모든 Java 등록 정보 파일과 마찬가지로 IS0-8859-1 문자 집합을 사용합니다. 등록 정보 파일에서 ISO-8859-1이 아닌 다른 문자를 표시하는 방법에 대한 자세한 내용은 java.util.Properties.load(InputStream)에 대한 설명서를 참조하십시오.

옵션

-edit

새 사용자 정보를 편집할 수 있도록 관리 도구에서 편집기를 시작합니다. 관리 도구는 다른 명령줄 매개 변수를 평가한 후에 편집기를 시작하므로 명령줄이나 등록 정보 파일에 지정된 정보의 평가 결과를 사용하여 편집이 시작됩니다. 편집 프로그램이 오류 없이 종료되어야 명령을 계속 실행할 수 있습니다. 관리 도구는 set editor 명령( set 참조)에서 지정한 편집기(기본적으로 vi 편집기)를 시작합니다.

주 –

이 릴리스에서 -edit는 emacsclient 및 NetBeansTM 명령 bin/runide.sh --open(원활하게 작동되지는 않음)과 함께 작동하지만 vi에서는 작동하지 않습니다.

-load

해당 컨텐트에서 사용자에 대한 등록 정보를 지정하는 Java 등록 정보 파일을 지정합니다. 등록 정보 이름은 긴 형식의 add user 명령 옵션과 동일합니다(예: lastName 및 post1.type).

-fn | -firstName

사용자의 이름을 지정합니다.

-ln | -lastName

사용자의 성을 지정합니다. 성은 필수 항목이며 명령줄 또는 등록 정보 파일에서 지정해야 합니다.

-mn | -middleName

사용자의 중간 이름을 지정합니다.

-alias

키 저장소에서 사용자 인증서에 액세스할 때 사용하는 별칭입니다. 이 옵션은 필수 항목입니다. 별칭은 최소 길이가 3자 이상이어야 합니다.

-keypass

키 저장소에서 사용자 인증서에 액세스할 때 사용하는 비밀번호입니다. 이 옵션은 필수 항목입니다. 비밀번호는 최소 길이가 6자 이상이어야 합니다.

-postalType | -post1.type

첫 번째 PostalAddress의 유형입니다. 유형은 필수 항목이며 명령줄 또는 등록 정보 파일에서 지정해야 합니다. 이 값은 임의의 문자열(예: Office 또는 Home)입니다.

-city | -post1.city

첫 번째 PostalAddress의 구/군/시입니다.

-country | -post1.country

첫 번째 PostalAddress의 국가입니다.

-postalCode | -postcode | - zip | -post1.postalcode

첫 번째 PostalAddress의 우편 번호입니다.

-stateOrProvince | -state | - province | -post1.stateOrProvince

첫 번째 PostalAddress의 시/도입니다.

-street | -post1.street

첫 번째 PostalAddress의 주소입니다.

-streetNumber | -number | - -post1.streetNumber

첫 번째 PostalAddress의 상세 주소입니다.

-post2.type

두 번째 PostalAddress의 유형입니다. 두 번째 PostalAddress를 지정하는 경우 유형은 필수 항목이며 명령줄 또는 등록 정보 파일에서 지정해야 합니다. 이 값은 임의의 문자열(예: Office 또는 Home)입니다.

-post2.city

두 번째 PostalAddress의 구/군/시입니다.

-post2.country

두 번째 PostalAddress의 국가입니다.

-post2.postalcode

두 번째 PostalAddress의 우편 번호입니다.

-post2.stateOrProvince

두 번째 PostalAddress의 시/도입니다.

-post2.street

두 번째 PostalAddress의 주소입니다.

-post2.streetNumber

두 번째 PostalAddress의 상세 주소입니다.

-post3.type

세 번째 PostalAddress의 유형입니다. 세 번째 PostalAddress를 지정하는 경우 유형은 필수 항목이며 명령줄 또는 등록 정보 파일에서 지정해야 합니다. 이 값은 임의의 문자열(예: Office 또는 Home)입니다.

-post3.city

세 번째 PostalAddress의 구/군/시입니다.

-post3.country

세 번째 PostalAddress의 국가입니다.

-post3.postalcode

세 번째 PostalAddress의 우편 번호입니다.

-post3.stateOrProvince

세 번째 PostalAddress의 시/도입니다.

-post3.street

세 번째 PostalAddress의 주소입니다.

-post3.streetNumber

세 번째 PostalAddress의 상세 주소입니다.

-phoneType | -telephone1.type

첫 번째 TelephoneNumber의 유형입니다. 유형은 필수 항목이며 명령줄 또는 등록 정보 파일에서 지정해야 합니다. 이 값은 임의의 문자열이지만 Beeper, FAX, HomePhone, MobilePhone 또는 OfficePhone과 같은 알려진 유형 중에서 하나를 지정할 수 있습니다.

-areaCode | -telephone1.areaCode

첫 번째 TelephoneNumber의 지역 번호입니다.

-countryCode | -telephone1.countryCode

첫 번째 TelephoneNumber의 국가 코드입니다.

-extension | -telephone1.extension

첫 번째 TelephoneNumber의 내선 번호입니다.

-number | -telephone1.number

국가 코드 또는 지역 번호를 제외한 첫 번째 TelephoneNumber의 전화 번호 접미어입니다. 번호는 필수 항목이며 명령줄 또는 등록 정보 파일에서 지정해야 합니다.

-URL | -telephone1.URL

첫 번째 TelephoneNumber의 URL(이 번호에 온라인으로 전화를 걸 수 있는 URL)입니다.

-telephone2.type

두 번째 TelephoneNumber의 유형입니다. 두 번째 TelephoneNumber를 지정하는 경우 유형은 필수 항목이며 명령줄 또는 등록 정보 파일에서 지정해야 합니다. 이 값은 임의의 문자열이지만 Beeper, FAX, HomePhone, MobilePhone 또는 OfficePhone과 같은 알려진 유형 중에서 하나를 지정할 수 있습니다.

-telephone2.areaCode

두 번째 TelephoneNumber의 지역 번호입니다.

-telephone2.countryCode

두 번째 TelephoneNumber의 국가 코드입니다.

-telephone2.extension

두 번째 TelephoneNumber의 내선 번호입니다.

-telephone2.number

국가 코드 또는 지역 번호를 제외한 두 번째 TelephoneNumber의 전화 번호 접미어입니다. 두 번째 TelephoneNumber를 지정하는 경우 번호는 필수 항목이며 명령줄 또는 등록 정보 파일에서 지정해야 합니다.

-telephone2.URL

두 번째 TelephoneNumber의 URL(이 번호에 온라인으로 전화를 걸 수 있는 URL)입니다.

-telephone3.type

세 번째 TelephoneNumber의 유형입니다. 세 번째 TelephoneNumber를 지정하는 경우 유형은 필수 항목이며 명령줄 또는 등록 정보 파일에서 지정해야 합니다. 이 값은 임의의 문자열이지만 Beeper, FAX, HomePhone, MobilePhone 또는 OfficePhone과 같은 알려진 유형 중에서 하나를 지정할 수 있습니다.

-telephone3.areaCode

세 번째 TelephoneNumber의 지역 번호입니다.

-telephone3.countryCode

세 번째 TelephoneNumber의 국가 코드입니다.

-telephone3.extension

세 번째 TelephoneNumber의 내선 번호입니다.

-telephone3.number

국가 코드 또는 지역 번호를 제외한 세 번째 TelephoneNumber의 전화 번호 접미어입니다. 세 번째 TelephoneNumber를 지정하는 경우 번호는 필수 항목이며 명령줄 또는 등록 정보 파일에서 지정해야 합니다.

-telephone3.URL

세 번째 TelephoneNumber의 URL(이 번호에 온라인으로 전화를 걸 수 있는 URL)입니다.

-emailType | -email1.type

첫 번째 EmailAddress의 유형입니다. 유형은 필수 항목이며 명령줄 또는 등록 정보 파일에서 지정해야 합니다. 이 값은 임의의 문자열이지만 HomeEmail 또는 OfficeEmail과 같은 알려진 유형 중에서 하나를 지정할 수 있습니다.

-emailAddress | -email | - email1.address

첫 번째 전자 메일 주소입니다. 첫 번째 전자 메일 주소는 필수 항목입니다.

-email2.type

두 번째 EmailAddress의 유형입니다. 두 번째 EmailAddress를 지정하는 경우 유형은 필수 항목이며 명령줄 또는 등록 정보 파일에서 지정해야 합니다. 이 값은 임의의 문자열이지만 HomeEmail 또는 OfficeEmail과 같은 알려진 유형 중에서 하나를 지정할 수 있습니다.

-email2.address

두 번째 전자 메일 주소입니다.

-email3.type

세 번째 EmailAddress의 유형입니다. 세 번째 EmailAddress를 지정하는 경우 유형은 필수 항목이며 명령줄 또는 등록 정보 파일에서 지정해야 합니다. 이 값은 임의의 문자열이지만 HomeEmail 또는 OfficeEmail과 같은 알려진 유형 중에서 하나를 지정할 수 있습니다.

-email3.address

세 번째 전자 메일 주소입니다.

예

다음 명령은 사용자 홈 디렉토리의 JaneSmith.properties 파일에서 User 등록 정보를 로드합니다. 


admin> add user -load ~/JaneSmith.properties

다음 명령(모두 한 줄로 표시)은 User 객체를 만드는 데 필요한 최소 등록 정보를 지정합니다.


admin> add user -ln Smith -postaltype Office -country US 
-phonetype Office -number 333-3333 -emailtype OfficeEmail 
-emailaddress JaneSmith@JaneSmith.com -alias 123 -keypass 123456

cd

RegistryPackage 위치를 변경합니다.

개요

cd { locator | URN}

설명

cd 명령은 디렉토리(상징적인 개념)를 지정된 경로에 있거나 지정된 URN을 가진 RegistryPackage로 변경합니다.

이 명령은 현재 로켈에 대해 동일한 경로를 가진 RegistryPackage 객체가 여러 개 있는 경우 지정된 URN으로 변경합니다.

피연산자

locator

레지스트리 객체 이름에 대해 저장소 루트에서 저장소 객체까지에 해당하는 경로이며 각 이름 앞에는 슬래시(/)가 붙어 있습니다.

예를 들어, registry RegistryPackage의 구성원(로케이터 자체는 RegistryPackage의 구성원이 아님)인 userData RegistryPackage에 대한 로케이터는 /registry/userData이고, userData RegistryPackage의 구성원인 folder1 RegistryPackage에 대한 로케이터는 /registry/userData/folder1입니다.

URN

RegistryPackage의 URN이며 urn:으로 시작해야 합니다.

예

다음 명령은 urn:uuid:92d3fd01-a929-4eba-a5b4-a3f036733017 URN을 사용하여 디렉토리를 RegistryPackage로 변경합니다.


admin> cd urn:uuid:92d3fd01-a929-4eba-a5b4-a3f036733017

다음 명령은 디렉토리를 /registry/userData/myData 위치로 변경합니다.


admin> cd /registry/userData/myData

chown

RegistryObject의 소유자를 변경합니다.

개요

chown { URN | %index}

설명

chown 명령은 이전 select 명령을 사용하여 선택한 객체의 소유자를 이전 users 명령에 나열된 사용자 URN에 대한 참조 또는 URN에 지정된 사용자로 변경합니다.

관리자 역할을 가진 사용자만 이 명령을 실행할 수 있습니다.

피연산자

URN

URN에 지정된 User 객체입니다.

%index

이전 users 명령에 나열된 User 객체의 URN에 대한 숫자 참조입니다.

예

다음 명령은 선택된 객체의 소유권을 urn:uuid:26aa17e6-d669-4775-bfe8-a3a484d3e079 URN에 지정된 사용자로 변경합니다. 


admin> chown urn:uuid:26aa17e6-d669-4775-bfe8-a3a484d3e079

다음 명령은 선택된 객체의 소유권을 이전 users 명령에서 숫자 2로 표시된 사용자로 변경합니다.


admin> chown %2

cp

파일 및 폴더를 레지스트리에 복사합니다.

개요

cp [-owner {URN | % index}] [- exclude pattern]… [-include pattern]… pattern…

설명

cp 명령은 폴더 및 파일을 레지스트리에 RegistryPackage 객체와 ExtrinsicObject 객체로 각각 복사합니다.

로컬 파일 시스템에서 파일 및 폴더를 복사할 원본 로컬 디렉토리의 기본값은 관리 도구를 시작한 현재 디렉토리입니다. 관리 도구를 시작할 때 -localdir 옵션을 사용하여 로컬 디렉토리를 변경할 수 있으며 관리 도구를 시작한 후에는 lcd 명령을 사용하여 로컬 디렉토리를 변경할 수 있습니다. show localdir 명령을 사용하여 현재 로컬 디렉토리의 절대 경로를 가져올 수 있습니다.

명령은 순환적입니다. 즉, 디렉토리를 지정하면 이 명령이 해당 디렉토리의 모든 파일과 폴더를 복사합니다.

옵션

-owner

복사된 레지스트리 객체의 소유자를 URN 또는 %index 인수에 지정된 사용자로 설정합니다. 이러한 인수에 대한 설명은 chown 명령의 설명을 참조하십시오. 자신 이외의 소유자를 지정하려면 관리자 역할을 갖고 있어야 합니다.

-exclude

이름에 지정된 패턴이 있는 파일을 제외한 모든 파일을 복사합니다. 여기서 pattern은 리터럴 문자와 특수 문자인 별표(*)(0개 이상의 문자를 나타냄) 및 물음표(?)(1과 하나의 문자를 나타냄)로 구성되는 패턴입니다.

이 옵션은 여러 번 지정할 수 있습니다.

-include

이름에 지정된 패턴이 있는 모든 파일을 복사합니다. 여기서 pattern은 리터럴 문자와 특수 문자인 별표(*)(0개 이상의 문자를 나타냄) 및 물음표(?)(1과 하나의 문자를 나타냄)로 구성되는 패턴입니다.

이 옵션은 여러 번 지정할 수 있습니다.

피연산자

pattern

리터럴 문자와 특수 문자인 별표(*)(0개 이상의 문자를 나타냄) 및 물음표(?)(1과 하나의 문자를 나타냄)로 구성되는 패턴으로 지정된 복사할 파일 또는 폴더입니다. 여러 pattern을 지정할 수 있습니다.

예

다음 명령은 이전 users 명령에서 숫자 4인 사용자가 소유하도록 mydir 디렉토리를 레지스트리에 복사합니다.


admin> cp -owner %4 mydir

다음 명령은 .z 또는 .c 문자열로 끝나는 파일과 디렉토리를 제외하고 mydir 디렉토리를 레지스트리에 복사합니다.


admin> cp mydir -exclude \\.z -exclude \\.c

echo

문자열을 표시합니다.

개요

echo string

설명

echo 명령은 지정된 string을 출력으로 표시합니다. 이 명령은 일괄 처리 모드에서 관리 도구를 실행할 때 -command 옵션에서 지정하면 가장 유용합니다.

피연산자

string

문자 시퀀스입니다.

예

다음 명령은 ls 명령의 결과와 날짜를 로그 파일에 인쇄합니다.


java -jar admin-tool.jar -command "echo ”date”; ls" > admin.log

help

명령에 대한 정보를 표시합니다.

개요

help [command_name]

설명

help 명령은 사용 가능한 명령 또는 지정된 명령에 대한 정보를 표시합니다.

add 및 show와 같이 명령에 하위 명령이 있는 경우 help 명령은 하위 명령에 대한 정보를 표시합니다.

인수를 지정하지 않은 경우 help 명령은 모든 명령에 대한 사용 정보를 표시합니다.

피연산자

command_name

관리 도구 명령의 이름입니다.

예

다음 명령은 모든 명령에 대한 사용 정보를 표시합니다.


admin> help

다음 명령은 lcd 명령에 대한 사용 정보를 표시합니다. 


admin> help lcd

다음 명령은 add 하위 명령에 대한 사용 정보를 표시합니다. 


admin> help add

lcd

로컬 파일 시스템에서 현재 디렉토리를 변경합니다.

개요

lcd [path_name]

설명

lcd 명령은 로컬 파일 시스템에서 현재 로컬 디렉토리를 변경합니다.

인수를 지정하지 않을 경우 lcd 명령은 현재 디렉토리를 기본 홈 디렉토리로 변경합니다.

피연산자

path_name

절대적 또는 상대적 디렉토리 이름입니다.

예

다음 명령은 현재 로컬 디렉토리를 /usr/share 디렉토리로 변경합니다.


admin> lcd /usr/share

다음 명령은 현재 로컬 디렉토리를 로컬 파일 시스템의 기본 홈 디렉토리로 변경합니다.


admin> lcd

ls

현재 RegistryPackage에 있는 객체를 나열합니다.

개요

ls [ { pattern | URN}…]

설명

인수를 지정하지 않을 경우 ls 명령은 현재 RegistryPackage에 있는 객체를 나열합니다. pattern 또는 URN이 제공된 경우 현재 RegistryPackage에서 이름(현재 로켈) 또는 고유 식별자가 pattern 또는 URN과 일치하는 객체를 나열합니다.

피연산자

pattern

리터럴 문자와 특수 문자인 별표(*)(0개 이상의 문자를 나타냄) 및 물음표(?)(1과 하나의 문자를 나타냄)로 구성되는 패턴입니다. 여러 pattern을 지정할 수 있습니다.

URN

urn:으로 시작하는 URN(예: urn:uuid:4a6741e7-4be1-4cfb-960a-e5520356c4fd)입니다. 여러 URN을 지정할 수 있습니다. URN은 로컬 식별자가 아니라 객체의 고유 식별자여야 합니다.

예

다음 명령은 현재 RegistryPackage에 있는 모든 객체를 나열합니다.


admin> ls

다음 명령은 이름이 urn:bird:poultry:chicken 패턴과 일치하거나 ID가 urn:bird:poultry:chicken인 모든 객체를 나열합니다.


admin> ls urn:bird:poultry:chicken

다음 명령은 이름이 *bird* 패턴과 일치하는 모든 객체를 나열합니다. 또한 ID가 *bird*인 객체를 나열합니다(*bird*가 유효한 ID인 경우).


admin> ls *bird*

다음 명령은 이름이 *bird* 또는 urn:bird:poultry:chicken 패턴과 일치하거나 ID가 urn:bird:poultry:chicken인 모든 객체를 나열합니다.


admin> ls *bird* urn:bird:poultry:chicken

pwd

현재 RegistryPackage의 경로를 표시합니다.

개요

pwd

설명

pwd 명령은 현재 로켈에 대해 가장 일치하는 이름을 사용하여 현재 RegistryPackage의 경로와 함께 해당 경로에 대한 로켈을 표시합니다.

예


admin> pwd
(en_US) /registry/userData

quit

관리 도구를 종료합니다.

개요

quit

설명

quit 명령은 관리 도구를 종료합니다.

예


admin> quit

rm

RegistryPackage에서 객체를 제거합니다.

개요

rm [-d] [-r] { pattern | URN}…

설명

rm 명령은 이름(현재 로켈)이 pattern 또는 URN에 지정된 패턴과 일치하는 현재 RegistryPackage의 구성원 객체를 제거합니다.

일치하는 RegistryObject가 여러 RegistryPackage 객체의 구성원인 경우 이 명령은 현재 RegistryPackage와 객체 간의 연관만 제거합니다. 연관을 제거할 때 다른 RegistryObject와 연관이 없는 객체가 남아 있는 경우에만 레지스트리에서 해당 객체가 제거됩니다.

일치하는 구성원 객체 자체가 다른 객체를 포함하는 RegistryPackage일 때는 -r 또는 -d 옵션을 지정한 경우에만 현재 RegistryPackage와 구성원 RegistryPackage 간의 연관과 해당 객체가 제거됩니다.

-d 옵션과 -r 옵션을 모두 지정할 경우 -d 옵션이 순환적으로 적용되므로 -r에 의해 선택되는 모든 객체와 해당 연관은 다른 연관이 있는지 여부에 관계 없이 모두 제거됩니다.

옵션

-d

현재 RegistryPackage와 지정된 RegistryPackage 사이의 연관을 제거합니다. 구성원 객체에 대한 연관만 남아 있는 경우에만 지정된 RegistryPackage를 제거합니다. 다른 HasMember 연관의 대상으로 지정되어 고정되지 않은 현재 제거된 RegistryPackage 구성원 객체를 레지스트리의 루트 구성원으로 액세스할 수 있습니다.

-r

지정된 RegistryPackage 객체와 모든 해당 하위 객체(객체에 다른 연관이 있는 경우는 제외)를 제거합니다.

피연산자

pattern

리터럴 문자와 특수 문자인 별표(*)(0개 이상의 문자를 나타냄) 및 물음표(?)(1과 하나의 문자를 나타냄)로 구성되는 패턴입니다. 여러 pattern을 지정할 수 있습니다.

URN

urn:으로 시작하는 URN(예: urn:uuid:4a6741e7-4be1-4cfb-960a-e5520356c4fd)입니다. 여러 URN을 지정할 수 있습니다.

예

다음 명령은 "stat" 문자열을 포함하는 모든 RegistryPackage 객체와 모든 해당 하위 객체를 제거합니다.


admin> rm -r *stat*

select

select SQL 문을 실행합니다.

개요

select [SQL]

설명

select 명령은 전체 명령을 SQL 쿼리로 평가하여 지정된 객체를 선택하고 나열합니다. 인수를 지정하지 않을 경우 이 명령은 이전 select 명령 또는 -sqlselect 옵션으로 선택한 모든 객체를 나열합니다.

피연산자

SQL

select SQL 문입니다. 선행 select는 명령의 이름으로 이미 표시되어 있으므로 사용되지 않습니다.

예

다음 명령은 레지스트리에 있는 모든 ClassificationScheme 객체를 나열합니다.


admin> select s.* from ClassificationScheme s

set

등록 정보 값을 설정합니다.

개요

set property value

설명

set 명령은 관리 도구 쉘의 등록 정보 값을 설정합니다.

관리 도구는 다음과 같은 등록 정보와 값을 지원합니다.

set debug {true | on | yes | false | off | no}

디버깅 메시지 출력을 활성화 또는 비활성화합니다.

set editor string

관리 도구에서 대화형 편집기를 시작할 때 사용할 명령을 설정합니다. UNIX 및 Linux 시스템에서 기본값은 /bin/vi입니다.

set verbose { true | on | yes | false | off | no}

명령을 실행할 때 추가적인 세부 정보 표시 메시지의 출력을 활성화 또는 비활성화합니다.

피연산자

property

다음 등록 정보 중 하나입니다. debug, editor, verbose.

value

지정된 등록 정보에 지원되는 값입니다. 자세한 내용은 설명 절을 참조하십시오.

예

다음 명령은 편집기를 기본 /bin/vi 대신 /usr/bin/vi로 설정합니다.


admin> set editor /usr/bin/vi

다음 명령은 디버깅을 설정합니다.


admin> set debug true

다음 명령은 세부 정보 표시 출력을 해제합니다.


admin> set verbose off

show

등록 정보 값을 표시합니다.

개요

show [property]

설명

show 명령은 관리 도구 쉘의 등록 정보 값을 표시합니다.

인수를 지정하지 않을 경우 이 명령은 모든 등록 정보 값을 표시합니다.

이 명령은 다음 등록 정보를 지원합니다.

debug

디버깅 출력이 활성화되는지 여부를 지정합니다.

editor

관리 도구에서 대화형 편집기를 시작할 때 사용하는 편집기를 지정합니다.

exception

바로 앞에 실행한 명령에서 예외 스택(있는 경우)을 추적합니다.

localdir

로컬 파일 시스템의 현재 디렉토리를 지정합니다. lcd 명령을 사용하여 이 등록 정보를 설정합니다. 자세한 내용은 lcd를 참조하십시오.

locale

현재 로켈을 지정합니다.

verbose

세부 정보 표시 출력을 활성화할지 여부를 지정합니다.

피연산자

property

현재 값을 표시할 등록 정보를 지정합니다. exception 및 locale 등록 정보를 표시할 수 있지만 set 명령을 사용하여 해당 등록 정보를 설정할 수는 없습니다.

예

다음 명령은 이전 명령의 예외를 표시합니다.


admin> show exception

users

현재 User 객체를 나열합니다.

개요

users

설명

users 명령은 현재 레지스트리에 있는 User 객체를 나열합니다.

다음과 같은 형식으로 출력됩니다.


%index: URN lastname, firstname middlename

출력에서 index는 chown 또는 cp 명령을 실행할 때 사용자를 참조하는 데 사용할 수 있는 백분율 기호(%)를 포함한 숫자 값입니다. lastname, firstname 및 middlename은 사용자의 성, 이름 및 중간 이름입니다.

예

다음 명령은 현재 사용자를 표시합니다.


admin> users
%0:  urn:freebxml:registry:predefinedusers:registryoperator  Operator, Registry 
%1:  urn:freebxml:registry:predefinedusers:registryguest  Guest, Registry 
%2:  urn:freebxml:registry:predefinedusers:farrukh  Najmi, Farrukh Salahudin
%3:  urn:freebxml:registry:predefinedusers:nikola  Stojanovic, Nikola 
%4:  urn:uuid:799cc524-b7cd-4e51-8b34-d93b79ac52de  User, Test 
%5:  urn:uuid:85428d8e-1bd5-473b-a8c8-b9d595f82728  Parker, Miles