이전      목차      색인      다음
Sun Java System Identity Synchronization for Windows 1 2004Q3 설치 및 구성 설명서

부록A
Identity Synchronization for Windows 명령줄 유틸리티 사용

Identity Synchronization for Windows에서는 명령줄을 사용하여 다양한 작업을 수행할 수 있습니다. 이 부록에서는 Identity Synchronization for Windows 명령줄 유틸리티를 실행하여 다양한 작업을 수행하는 방법에 대하여 설명합니다. 정보는 다음과 같이 구성되었습니다.

공통 기능
idsync 명령 사용
forcepwchg 마이그레이션 유틸리티 사용

---

공통 기능

Identity Synchronization for Windows 명령줄에는 다음 기능이 공통으로 포함됩니다.

공통 인수
비밀번호 입력
도움말 열기

공통 인수

여기에서는 대부분의 명령줄 유틸리티에 공통적인 인수(옵션)에 대하여 설명합니다. 내용은 다음의 표와 같이 구성되었습니다.

표 A-1) 모든 하위 명령에 공통된 인수: 다음 인수를 설명하며 이는 idsync 하위 명령(prepds 제외) 및 마이그레이션 도구에 공통입니다.

-D <bind-DN> -w <bind-password | -> [-h <Configuration Directory-hostname>] [-p <Configuration Directory-port-no>] [-s <rootsuffix>] [-Z] [-P <cert-db-path>] [-m <secmod-db-path>]

참고	대괄호([ ])는 선택 사항 인수를 나타냅니다. Identity Synchronization for Windows 설치 프로그램은 설치 동안 입력한 정보를 기준으로 -h, -p, -D 및 -s 인수의 값을 자동으로 입력합니다. 그러나 명령줄에서 다른 값을 지정하여 기본 값을 대체할 수 있습니다. 복수 바이트 문자를 지원하려면 Identity Synchronization for Windows base64가 명령줄 인터페이스(CLI) 환경 파일의 -s <rootsuffix> 및 -D <bind-DN>의 기본 값을 암호화해야 합니다. rootsuffix 기본값은 변경되면 안 됩니다. 바인드 DN 기본값은 명령줄에서 대체하거나 CLI 환경 파일에서 적절한 base64 암호화 값으로 업데이트할 수 있습니다.

표 A-2) 모든 하위 명령에 공통적인 SSL 관련 인수: SSL(Secure Socket Layer)을 사용하여 안전하게 구성 Directory Server로 액세스하는 정보를 제공하는 선택 옵션입니다. 이들 인수는 또한 모든 idsync 하위 명령과 이전 도구에 공통적인 인수입니다.
표 A-3) 구성 디렉토리 인수: 구성 디렉토리에 관련된 인수입니다. 이들 인수는 둘 이상의 idsync 하위 명령 및 이전 도구에 공통인 인수입니다.

참고	특정 하위 명령에 고유한 인수는 관련 하위 명령 부분에서 설명합니다.

표 A-1) 모든 하위 명령에 공통된 인수

인수	설명
-h <Configuration Directory-hostname>	구성 디렉토리 호스트 이름을 지정합니다. 이 인수는 코어 설치 동안 지정한 값을 기본값으로 사용합니다.
-p <Configuration Directory-port-no>	구성 디렉토리 LDAP 포트 번호를 지정합니다.
-D <bind-DN>	구성 디렉토리 바인드 고유 이름(DN)을 지정합니다. 이 인수는 코어 설치 동안 지정한 값을 기본값으로 사용합니다.
-w <bind-password | ->	구성 디렉토리 바인드 비밀번호를 지정합니다. 값이 -이면 표준 입력(STDIN)에서 비밀번호를 읽습니다.
-s <rootsuffix>	구성 디렉토리 rootsuffix를 지정합니다. 여기에서 rootsuffix는 dc=example,dc=com 등의 고유한 이름입니다. 이 인수는 코어 설치 동안 지정한 값을 기본값으로 사용합니다.
-q <configuration_password | ->	구성 비밀번호를 지정합니다. 값이 -이면 표준 입력(STDIN)에서 비밀번호를 읽습니다. 이 인수는 prepds를 제외한 모든 하위 명령에 대하여 필수입니다.

표 A-2) 모든 하위 명령에 공통적인 SSL 관련 인수

인수	설명
-Z	SSL을 사용하여 보안 통신을 제공하도록 지정합니다. 명령줄 인터페이스 또는 기본/보조 Directory Server에 액세스하는 구성 디렉토리로 연결하는 경우 인증서 기반 클라이언트 인증을 제공합니다.
-P <cert-db-path>	클라이언트 인증서 데이터베이스의 경로와 파일 이름을 지정합니다. 이 인증서 데이터베이스에는 반드시 Directory Server의 인증서 데이터베이스에 서명하는 데 사용하는 CA 인증서가 있어야 합니다. -Z는 지정하고 -P는 사용하지 않는 경우, <cert-db-path>의 기본값으로 <current-working-directory>/cert8.db이 사용됩니다. 참고: Identity Synchronization for Windows가 지정한 디렉토리에서 인증서 데이터베이스를 찾을 수 없는 경우 프로그램을 해당 디렉토리에 "빈" 디렉토리를 만들면, 이는 cert8.db, key3.db 및 secmod.db의 세 가지 파일로 구성됩니다.
-m <secmod-db-path>	보안 모듈 데이터베이스의 경로를 지정합니다. 예: /var/Sun/MPS/slapd-<serverID>/secmod.db 보안 모듈 디렉토리가 인증서 데이터베이스 자체와 다른 디렉토리에 있는 경우에만 이 옵션을 지정합니다.

표 A-3) 구성 디렉토리 인수

인수	설명
-a <ldap_filter> forcepwchg 및 resync 하위 명령과 함께 사용합니다.	소스 SUL에서 사용자를 불러올 때 사용하는 LDAP 필터를 지정하고 사용자가 지정한 SUL에 해당하는지 판단하기 전에 지목된 일부 해당 사용자를 디렉토리에서 불러올 수 있습니다.
-f <filename> export10cnf, importcnf, 및 resync 하위 명령과 함께 사용합니다.	구성 XML 문서 파일의 이름을 지정합니다.
-n forcepwchg, importcnf 및 resetconn 하위 명령과 함께 사용합니다.	실제 변경 없이 작업의 효과를 미리 볼 수 있도록 안전 모드에서 실행합니다.

비밀번호 입력

비밀번호 인수(-w <bind-password> 또는
-q <configuration_password> 등)가 필요한 경우 해당 비밀번호에 "-" 인수를 사용하여 STDIN에서 비밀번호를 읽을 수 있습니다.

복수 비밀번호 옵션에 "-" 값을 사용하면 idsync에 인수의 순서를 기준으로 하여 비밀번호를 입력하라는 프롬프트가 표시됩니다.

이 경우 프로그램은 우선 <bind-password>를 찾은 후, <configuration-password>를 찾습니다.

도움말 열기

다음 명령 중 한 가지를 사용하여 명령 콘솔에서 idsync 또는 해당 하위 명령에 대한 사용 방법을 표시할 수 있습니다.

-help
--help
-?

사용 정보

idsync 정보(유효한 하위 명령 목록 포함)를 보려면 명령 프롬프트에서 앞의 도움말 옵션 중 한가지를 입력하고 Return을 누릅니다.
하위 명령 정보는 명령 프롬프트에서 해당 하위 옵션과 도움말 옵션을 입력하고 Return을 누릅니다.

---

idsync 명령 사용

idsync 명령을 다음 하위 명령과 함께 사용하여 Identity Synchronization for Windows 명령줄 유틸리티를 실행할 수 있습니다.

참고	idsync 명령을 사용하면 인수를 Directory Server로 전송하기 전에 모든 DN 값 인수(바인드 DN 또는 접미어 이름 등)가 해당 창에 대하여 지정된 문자 세트에서 UTF-8로 변환됩니다. 접미어 이름에서는 이스케이프 문자로 백슬래시를 사용하면 안 됩니다. Solaris에서 UTF-8 문자를 지정하려면 터미널 창의 로케일이 반드시 UTF-8을 기반으로 해야 합니다. 환경 변수의 LC_CTYPE 및 LANG.가 올바로 설정되었는지 확인하십시오.

별도로 명시하지 않는 한 다음 방법 중 한 가지를 사용하여 하위 명령이 있는 idsync 명령을 실행할 수 있습니다.

Solaris:
터미널 창을 열고 cd 명령으로 /opt/SUNWisw/bin 디렉토리로 이동합니다.
다음과 같이 idsync 명령을 하나의 하위 명령과 함께 입력합니다.

idsync <하위 명령>

Windows:
명령 창을 열고 cd 명령으로 <install_path>\isw-<hostname>\bin 디렉토리로 이동합니다.
다음과 같이 idsync 명령을 하나의 하위 명령과 함께 입력합니다.

idsync <하위 명령>

idsync 유틸리티 하위 명령과 용도는 의 목록과 같습니다.

표 A-4) idsync 하위 명령 빠른 참조

하위 명령	용도
certinfo	구성 및 SSL 설정에 기반하여 인증서 정보를 표시합니다. (certinfo 사용 참조)
changepw	Identity Synchronization for Windows 구성 비밀번호를 변경합니다. (changepw 사용 참조)
importcnf	내보내진 Identity Synchronization for Windows 버전 1.0 구성 XML 문서를 가져옵니다(importcnf 사용 참조)
prepds	Identity Synchronization for Windows가 사용하도록 Sun Java 시스템 Directory Server 소스를 준비합니다(prepds 사용 참조)
printstat	설치/구성 과정을 완료하기 위하여 반드시 수행해야 하는 단계 목록을 표시합니다. 또한 설치된 커넥터, 시스템 관리자 및 Message Queue의 상태를 제공합니다(printstat 사용 참조).
resetconn	구성 디렉토리의 커넥터 상태를 uninstalled로 재설정합니다. (resetconn 사용 참조)
resync	설치 과정의 일부분으로 기존 사용자를 링크 및 재동기화하고 디렉토리를 미리 채웁니다(resync 사용 참조).
startsync	동기화를 시작합니다(startsync 사용 참조).
stopsync	동기화를 시작합니다(stopsync 사용 참조).

certinfo 사용

certinfo 하위 명령을 사용하여 구성 및 SSL 설정에 따른 인증서 정보를 표시할 수 있습니다. 이 정보는 각 커넥터 및 Directory Server 플러그인 인증서 데이터베이스에 반드시 추가되어야 하는 인증서를 결정하는 데 도움이 됩니다.

인증서 정보를 표시하려면 터미널 창(또는 명령 창)을 열고 다음과 같이 idsync certinfo를 입력합니다.

idsync certinfo [<bind-DN>] -w <bind-password | -> [-h <Configuration Directory-hostname>] [-p <Configuration Directory-port-no>] [-s <rootsuffix>] -q <configuration_password> [-Z] [-P <cert-db-path>] [-m <secmod-db-path>]

참고	certinfo 하위 명령은 커넥터 및 Directory Server의 인증서 데이터베이스에 액세스할 수 없으므로 목록의 일부 필수 단계가 이미 수행되었을 수 있습니다.

예:

idsync certinfo -w <admin-password> -q <configuration-password>

참고	certinfo 인수에 대한 자세한 내용은 공통 인수를 참조하십시오.

changepw 사용

changepw 하위 명령을 사용하여 Identity Synchronization for Windows 구성 비밀번호를 변경할 수 있습니다.

Identity Synchronization for Windows의 구성 비밀번호를 변경하려면 다음과 같이 합니다.

모든 Identity Synchronization for Windows 프로세스를 정지합니다. (예: 시스템 관리자, 중앙 기록기, 커넥터, 콘솔, 설치/제거 프로그램)
모든 프로세스를 정지한 후 구성 디렉토리를 ldif로 내보내어 ou=Services 트리를 백업합니다.
다음과 같이 idsync changepw 명령을 입력합니다.

idsync changepw [-D <bind-DN>] -w <bind-password | -> [-h <Configuration Directory-hostname>] [-p <Configuration Directory-port-no>] [-s <rootsuffix>] -q <configuration_password> [-Z] [-P <cert-db-path>] [-m <secmod-db-path>] -b <new password | - > [-y]

예:

idsync changepw -w <admin password> -q <old config password> -b -q <new config password>

다음 인수는 changepw에 고유한 인수입니다.

표 A-5) idsync changepw 인수

인수	설명
-b <password>	새 구성 비밀번호를 지정합니다. 값이 -이면 표준 입력(STDIN)에서 비밀번호를 읽습니다.
[-y]	명령 확인용 프롬프트를 표시하지 않습니다.

참고	기타 changepw 인수에 대한 자세한 내용은 공통 인수를 참조하십시오.

터미널 창에 표시된 메시지에 대한 응답을 입력합니다.
예:

Are you sure that want to change the configuration password (y/n)? yes 시스템을 다시 시작하기 전에 반드시 $PSWHOME/resources/SystemManagerBootParams.cfg 파일을 편집하고 "deploymentPassword"를 새 값으로 변경해야 합니다. SUCCESS

시스템을 다시 시작하기 전에 반드시 SystemManagerBootParams.cfg 파일을 수정해야 합니다.

$PSWHOME\resources(여기에서 $PSWHOME은 <isw-설치 디렉토리>)의 SystemManagerBootParams.cfg에는 시스템 관리자가 구성 디렉토리에 연결할 때 사용하는 구성 비밀번호가 있습니다.

예를 들어 다음과 같이 비밀번호 값을 변경할 수 있습니다.

변경 전: <Parameter name="manager.configReg.deploymentPassword" value="oldpassword"/>

변경 후: <Parameter name="manager.configReg.deploymentPassword" value="newpassword"/>

프로그램에 오류가 보고되면 Step 2에서 ldif를 사용하여 구성 디렉토리를 복구하고 다시 하십시오. 오류의 가장 큰 원인은 비밀번호 변경 도중 구성 디렉토리를 호스팅하는 Directory Server가 사용 할 수 없게 되기 때문입니다.

importcnf 사용

주의	Identity Synchronization for Windows 1.0 또는 1.0 SP1에서 버전 1 2004Q3으로 이전하는 경우에만 idsync importcnf를 사용합니다.

코어(제 3장, "코어 설치")를 설치한 후, idsync importcnf 하위 명령을 사용하여 내보낸 Identity Synchronization for Windows 버전 1.0(SP1) 구성 XML 파일을 가져옵니다. 여기에는 코어 구성 정보가 있습니다.

버전 1.0 구성 XML 문서를 가져오려면 터미널 창(또는 명령 창)을 열고 다음과 같이 idsync importcnf 명령을 입력합니다.

idsync importcnf [-D <bind-DN>] -w <bind-password | -> [-h <Configuration Directory-hostname>] [-p <Configuration Directory-port-no>] [-s <rootsuffix>] -q <configuration_password> [-Z] [-P <cert-db-path>] [-m <secmod-db-path>] -f <filename> [-n]

예:

idsync importcnf -w <admin_password> -q <configuration_password> -f ?yConfig.cfg?

다음 인수는 importcnf에 고유한 인수입니다.

표 A-6) idsync importcnf 인수

인수	설명
-f <filename>	구성 XML 문서 파일의 이름을 지정합니다.
-n	실제 변경 없이 작업의 효과를 미리 볼 수 있도록 안전 모드에서 실행합니다.

참고	기타 importcnf 인수에 대한 자세한 내용은 공통 인수를 참조하십시오.

버전 1.0 구성 XML 문서를 가져온 후 반드시 동기화용으로 구성된 모든 Directory Server 소스에서 prepds를 실행합니다(prepds 사용 참조). 그런 후 Identity Synchronization for Windows 커넥터와 하위 구성요소를 설치할 수 있습니다.

prepds 사용

prepds 하위 명령을 사용하여 Identity Synchronization for Windows가 사용할 Sun Java 시스템 Directory Server 소스를 준비합니다. Directory Server 커넥터를 설치하기 전에 반드시 prepds를 실행해야 합니다.

idsync prepds 하위 명령을 실행하면 적절한 ACI를 cn=changelog 항목에 적용하며, 이 항목은 Retro-Changelog 데이터베이스의 루트 노드입니다.

Identity Synchronization for Windows가 사용하도록 preferred 마스터 Directory Server를 준비하는 경우 반드시 디렉토리 관리자 자격 증명을 입력해야 합니다.

디렉토리 관리자 사용자는 Directory Server의 특수 사용자로 Directory Server 인스턴스의 모든 위치에서 전체 권한을 가집니다. (ACI는 디렉토리 관리자 사용자에 적용되지 않습니다.)

예를 들어 오직 디렉토리 관리자만이 Retro-Changelog 데이터베이스의 액세스 제어를 설정할 수 있으며, 이는 Identity Synchronization for Windows에 기본 마스터 서버용 디렉토리 관리자 자격 증명이 필요한 이유 중 하나입니다.

참고	어떤 이유이든 기본 Sun 디렉토리 소스에 대하여 Retro-Changelog 데이터베이스를 다시 만드는 경우 기본 액세스 제어 설정으로 인하여 Directory Server 커넥터가 데이터베이스 내용을 읽을 수 없게 됩니다. Retro-Changelog 데이터베이스용 액세스 제어 설정을 복구하려면 idsync prepds를 실행하거나 콘솔에서 적절한 Sun 디렉토리 소스를 선택한 후 Prepare Directory Server 버튼을 누릅니다.

참고	지정된 시간이 경과하면 Change-log 항목을 자동으로 제거(또는 자르기)하도록 시스템을 구성할 수 있습니다. 명령줄에서 cn=Retro Changelog Plugin, cn=plugins, cn=config의 nsslapd-changelogmaxage 구성 속성을 수정합니다. nsslapd-changelogmaxage: IntegerTimeunit 여기에서, integer는 숫자입니다. Timeunit에서 s는 초, m은 분, h는 시, d는 일 및 w는 주입니다. (Integer와 Timeunit 변수 사이에 공백이 있으면 안 됩니다.) 예: nsslapd-changelogmaxage: 2d 자세한 내용은 Sun Java™ 시스템 Directory Server 5 2004Q2 Administration Guide의 "Managing Replication" 장을 참조하십시오.

관리 자격 증명을 사용하여 보조 서버를 준비할 수 있습니다.

참고	사용할 호스트와 접미어를 반드시 알아야 하므로 idsync prepds를 실행하기 전에 Identity Synchronization for Windows 구성을 계획해야 합니다. Directory Server 커넥터와 플러그인이 이미 설치된 위치의 Directory Server 접미어에서 idsync prepds를 실행하면 Directory Server 커넥터를 설치하라는 메시지가 표시됩니다. 이 메시지는 무시하십시오.

Sun Java System 디렉토리 소스를 준비하려면 터미널 창(또는 명령 창)을 열고 다음과 같이 idsync prepds 명령을 입력합니다.

idsync prepds [-D <bind-DN>] -w <bind-password | -> [-h <preferred host>] [-p <preferred-port>] [-s <database-suffix>] [-Z] [-P <cert-db-path>] [-m <secmod-db-path>] [-j <secondary_host>] [-r <secondary-port>] [-E <admin DN of secondary host>] [-u <password for secondary host | ->] [-x]

예:

idsync prepds -D ?n=Directory Manager?-w <preferred master password> -h <preferred-host> -p 389 -s dc=example,dc=com -j ?econdary host?-r 389 -E ?n=Administrator?-u <secondary master password> -s dc=example,dc=com

참고	-h, -p, -D, -w 및 -s 인수는 prepds 하위 명령에 대하여만 재정의(다음의 표에서 설명) 되었습니다. 또한 -q 인수는 적용되지 않습니다.

idsync prepds에 고유한 인수는 과 같습니다.

표 A-7) prepds 인수  

인수	설명
-h <name>	기본 호스트의 역할을 하는 Directory Server 인스턴스의 DNS 이름을 지정합니다.
-p <port>	기본 호스트의 역할을 하는 Directory Server 인스턴스의 포트 번호를 지정합니다. (기본값은 389입니다.)
-j <name> (선택)	보조 호스트의 역할을 하는 Directory Server 인스턴스의 DNS 이름을 지정합니다(Sun Java 시스템 Directory Server 5 2004Q2 복수 마스터 복제(MMR) 환경에서 적용).
-r <port> (선택)	보조 호스트의 역할은 하는 Directory Server의 포트를 지정합니다(Sun Java 시스템 Directory Server 5 2004Q2 복수 마스터 복제(MMR) 환경에서 적용). ((기본값은 389입니다.)
-D <dn>	기본 호스트의 Directory Manager 사용자에 대한 고유한 이름을 지정합니다.
-w <password>	기본 호스트의 Directory Manager 사용자에 대한 비밀번호를 지정합니다. 값이 -이면 표준 입력(STDIN)에서 비밀번호를 읽습니다.
-E <admin-DN>	보조 호스트의 Directory Manager 사용자에 대한 고유한 이름을 지정합니다.
-u <password>	보조 호스트의 Directory Manager 사용자에 대한 비밀번호를 지정합니다. 값이 -이면 표준 입력(STDIN)에서 비밀번호를 읽습니다.
-s <rootsuffix>	색인을 추가할 때 사용할 루트 접미어를 지정합니다(사용자를 동기화하는 위치의 루트 접미어). 참고: 기본 및 보조 호스트의 데이터베이스 이름은 변할 수 있으나 접미어는 변할 수 없습니다. 따라서 프로그램이 각 호스트의 데이터베이스 이름을 찾고 이를 사용하여 색인을 추가할 수 있습니다.
-x	dspswuserlink 속성의 동일성 및 존재 색인을 데이터베이스에 추가하지 않습니다.

복제된 환경(예를 들어 기본 마스터, 보조 마스터 및 두 개의 소비자가 있는 환경)에서 idsync prepds를 실행하는 경우 오직 기본 및 보조 마스터에 대하여 한 번만 idsync prepds를 실행합니다.

idsync prepds를 실행하려면 다음과 같이 합니다.

Directory Server 복제본이 실행 중인지 확인합니다(적용되는 경우).
콘솔 또는 명령 줄에서 idsync prepds를 실행합니다. 예:

idsync prepds -h M1.example.com -p 389 -j M2.example.com -r 389 . . .

idsync prepds 명령을 실행한 결과는 다음과 같습니다

M1:
RCL이 더욱 많은 속성(dspswuserlink 등)을 캡처할 수 있도록 기능이 강화됩니다.

RCL은 M1에서만 필요합니다.

스키마를 확장합니다.
ACI가 있는 uid=pswconnector,<접미어> 사용자를 추가합니다.
dspswuserlink 속성에 색인을 추가합니다. 이 속성은 색인화가 완료될 때가지 일시적으로 Directory Server를 읽기 전용으로 전환합니다.

서비스 중단 시간을 피하기 위하여 나중에 색인을 추가할 수 있으나, 반드시 Directory Server 커넥터를 설치하기 전에 색인을 추가해야 합니다.

M2에 색인을 추가합니다.

참고	복제를 사용하면 Identity Synchronization for Windows가 스키마 정보와 uid=pswconnector를 기본 마스터에서 보조 마스터와 두 소비자에 복사합니다. 반드시 Directory Server 커넥터를 한 번만 설치해야 합니다. 반드시 모든 디렉토리에 Directory Server 플러그인을 설치해야 합니다. 색인화는 기본 및 보조 마스터에만 필요합니다. (복제가 색인 구성을 기본 마스터에서 보조 마스터로 보내지는 않습니다.)

printstat 사용

다음에 printstat 하위 명령을 사용할 수 있습니다.

설치 및 구성 과정을 완료하기 위하여 수행해야 하는 나머지 단계 목록을 표시합니다.
설치된 커넥터, 시스템 관리자 및 Message Queue의 상태를 인쇄합니다.

가능한 상태 설정은 다음과 같습니다.

Uninstalled.커넥터가 설치되지 않았습니다.
Installed. 커넥터가 설치되었으나 아직 런타임 구성을 수신하지 않았으므로 동기화의 준비가 되지 않았습니다.
Ready. 커넥터가 동기화의 준비가 되었으나 아직 동기화하는 객체가 없습니다.
Syncing. 커넥터가 객체를 동기화하는 중입니다.

설치된 커넥터, 시스템 관리자 및 Message Queue의 상태를 인쇄하려면 터미널 창(또는 명령 창)을 열고 다음과 같이 idsync printstat 명령을 입력합니다.

idsync printstat [-D <bind-DN>] -w <bind-password | -> [-h <Configuration Directory-hostname>] [-p <Configuration Directory-port-no>] [-s <rootsuffix>] -q <configuration_password> [-Z] [-P <cert-db-path>] [-m <secmod-db-path>]

예:

idsync printstat -w <admin password> -q <configuration password>

참고	printstat 인수에 대한 자세한 내용은 공통 인수를 참조하십시오.

resetconn 사용

resetconn 하위 명령을 사용하여 구성 디렉토리에 있는 커넥터 상태를 uninstalled로 재설정합니다. 예를 들어 하드웨어 이상으로 인하여 커넥터를 제거할 수 없는 경우 해당 커넥터를 다시 설치할 수 있도록 resetconn을 사용하여 커넥터의 상태를 uninstalled로 변경합니다.

주의	resetconn 명령은 하드웨어 또는 제거 프로그램 오유의 경우에만 사용됩니다.

명령줄에서 커넥터의 상태를 재설정하려면 터미널 창(또는 명령 창)을 열고 다음과 같이 idsync resetconn 명령을 입력합니다.

idsync resetconn [-D <bind-DN>] -w <bind-password> | -> [-h <Configuration Directory-hostname>] [-p <Configuration Directory-port-no>] [-s <rootsuffix>] -q <configuration_password> [-Z] [-P <cert-db-path>] [-m <secmod-db-path>] -e <directory-source-name> [-n]

예:

idsync resetconn -w <admin password> -q <configuration_password> -e ?c=example,dc=com?

resetconn에 고유한 인수는 과 같습니다.

표 A-8) idsync resetconn 인수

인수	설명
-e <dir-source>	재설정할 디렉토리 소스의 이름을 지정합니다.
-n	실제 변경 없이 작업의 효과를 미리 볼 수 있도록 안전 모드에서 실행합니다.

참고	idsync printstat는 디렉토리 소스 이름을 찾을 때 사용할 수 있습니다. 기타 resetconn 인수에 대한 자세한 내용은 공통 인수를 참조하십시오.

resync 사용

resync 하위 명령을 사용하여 기존 사용자를 부팅시 구현에 연결할 수 있습니다. 이 명령은 다음에 대한 관리자가 지정한 일치 규칙을 사용합니다.

기존 항목 링크
원격 디렉토리의 내용으로 빈 디렉토리 입력
두 개의 기존 사용자 입력 사이의 속성 값 일괄 동기화

참고	사용자 링크 및 동기화에 대한 자세한 내용은 "기존 사용자 동기화" 페이지 175를 참조하십시오.

기존 사용자를 재동기화하고 디렉토리를 미리 채우려면 터미널 창(또는 명령 창)을 열고 다음과 같이 idsync resync 명령을 입력합니다.

idsync resync [-D <bind-DN>] -w <bind-password> | -> [-h <Configuration Directory-hostname>] [-p <Configuration Directory-port-no>] [-s <rootsuffix>] -q <configuration_password> [-Z] [-P <cert-db-path>] [-m <secmod-db-path>] [-n] [-f <xml filename for linking>] [-k] [-a <ldap-filter>] [-l <sul-to-sync>] [-o Sun | Windows] [-c] [-x] [-u] [-i ALL_USERS | NEW_USERS | NEW_LINKED_USERS]

예:

idsync resync -w <admin password> -q <configuration_password>

resync에 고유한 인수는 와 같습니다.

표 A-9) idsync resync 사용법  

인수	의미
-f <filename>	Identity Synchronization for Windows가 제공한 지정된 XML 구성 파일 중 하나를 사용하여 링크되지 않은 사용자 항목  사이의 링크를 만듭니다. (부록 B, "LinkUsers XML 문서 예제" 참조)
-k	링크되지 않은 사용자 사이에만 링크를 만듭니다(사용자를 만들거나 기존 사용자를  수정하지 않음).
-a <ldap-filter>	동기화할 항목을 제한하는 LDAP 필터를 지정합니다. 필터는 재동기화 작업의 소스에 적용됩니다. 예를 들어 idsync resync -o Sun -a "uid=*"를 지정하면 uid속성이 있는 모든 Directory Server 사용자가 Active Directory로 동기화됩니다.
-l <sul-to-sync>	동기화할 개별 동기화 사용자 목록(SUL)을 지정합니다. 참고: 복수 SUL ID를 지정하여 복수 SUL을 재동기화하거나, SUL ID를 지정하지 않는 경우 프로그램은 모든 SUL을 재동기화합니다.
-o (Sun | Windows)	재동기화 작업의 소스를 지정합니다. Sun: Windows 항목용 속성 값을 Sun Java 시스템 Directory Server 디렉토리 소스 항목에 있는 해당 속성 값으로 설정합니다. Windows: Sun Java 시스템 Directory Server 항목의 속성 값을 Windows 디렉토리 소스 항목에 있는 해당 속성 값으로 설정합니다. (기본값은 Windows입니다.)
-c	대상에서 해당 사용자를 찾을 수 없는 경우 사용자 항목을 자동으로 만듭니다. Active Directory 또는 Windows NT에서 만든 사용자에 대하여 무작위로 비밀번호를 생성합니다. Directory Server에서 만든 사용자에 대하여 특수 비밀번호 값((PSWSYNC)*INVALID PASSWORD*)을 자동으로 만듭니다(-i 옵션을 지정하지 않은 경우).
-i (ALL_USERS | NEW_USERS | NEW_LINKED_USERS)	Sun 디렉토리 소스에서 동기화된 사용자 항목의 비밀번호를 재설정하고 이후 사용자 비밀번호가 필요할 때 해당 사용자에 대하여 현재 도메인 내의 비밀번호 동기화를 수행하도록 합니다. ALL_USERS: 모든 동기화된 사용자에 대하여 요청시 비밀번호 동기화를 수행하도록 합니다. NEW_USERS: 새로 생성된 사용자에 대하여 요청시 비밀번호 동기화를 수행하도록 합니다. NEW_LINKED_USERS: 모든 새로 생성된 사용자 및 새로 링크된 사용자에 대하여 요청시 비밀번호 동기화를 수행하도록 합니다.
-u	객체 캐시를 업데이트만 합니다. 수정되는 항목은 없습니다. 이 인수는 Windows 디렉토리 소스용 사용자 항목의 로컬 캐시만 업데이트하며, 따라서 이미 존재하는 Windows 사용자가 Directory Server에서 생성되지 않도록 방지합니다. 이 인수를 사용하는 경우 Windows 사용자 항목이 Directory Server 사용자 항목과 동기화되지 않습니다. 이 인수는 resync 소스가 Windows인 경우에만 유효합니다.
-x	소스 항목과 일치하지 않는 모든 대상 사용자 항목을 삭제합니다.
-n	실제 변경 없이 작업의 효과를 미리 볼 수 있도록 안전 모드에서 실행합니다.

참고	사용 상태를 보려면 인수 없이 idsync resync를 실행합니다. resync 인수에 대한 자세한 내용은 공통 인수를 참조하십시오. 기존 사용자의 재동기화에 대한 자세한 내용은 "기존 사용자 동기화" 페이지 175를 참조하십시오.

resync를 실행한 후 중앙 감사 로그에 있는 resync.log를 확인합니다. 오류가 있는 경우 제 9장, "문제해결"을 참조하십시오.

startsync 사용

startsync 하위 명령을 사용하여 명령줄에서 동기화를 시작합니다.

동기화를 시작하려면 터미널 창(또는 명령 창)을 열고 다음과 같이 idsync startsync 명령을 입력합니다.

idsync startsync [-D <bind-DN>] -w <bind-password | -> [-h <Configuration Directory-hostname>] [-p <Configuration Directory-port-no>] [-s <rootsuffix>] -q <configuration_password> [-Z] [-P <cert-db-path>] [-m <secmod-db-path>]

예:

idsync startsync -w <admin password> -q <configuration_password>

startsync에 고유한 인수는 과 같습니다.

표 A-10) idsync startsync 인수

인수	설명
[-y]	명령 확인용 프롬프트를 표시하지 않습니다.

참고	기타 startsync 인수에 대한 자세한 내용은 공통 인수를 참조하십시오.

stopsync 사용

stopsync 하위 명령을 사용하여 명령줄에서 동기화를 정지합니다.

동기화를 정지하려면 터미널 창(또는 명령 창)을 열고 다음과 같이 idsync stopsync 명령을 입력합니다.

idsync stopsync [-D <bind-DN>] -w <bind-password | -> [-h <Configuration Directory-hostname>] [-p <Configuration Directory-port-no>] [-s <rootsuffix>] -q <configuration_password> [-Z] [-P <cert-db-path>] [-m <secmod-db-path>]

예:

idsync stopsync -w <admin password> -q <configuration_password>

참고	stopsync인수에 대한 자세한 내용은 공통 인수를 참조하십시오.

---

forcepwchg 마이그레이션 유틸리티 사용

마이그레이션 작업이 진행되는 동안 비밀번호를 변경하는 사용자는 Windows NT와 Directory Server에 각기 다른 비밀번호를 갖게 됩니다. forcepwchg 유틸리티를 사용하여 Identity Synchronization for Windows 버전 1.0에서 버전 1 2004Q3으로의 마이그레이션 과정 동안 비밀번호를 변경한 사용자가 비밀번호를 변경하도록 합니다.

참고	forcepwchg 유틸리티는 Windows 패키지에만 함께 제공됩니다.

forcepwchg를 사용하기 전에 반드시 다음을 확인해야 합니다.

userpassword 속성용 7비트 값을 강화하기 위하여 Directory Server에 7비트 검사 플러그인을 구성하지 않도록 해야 합니다. Directory Server 콘솔을 사용하여 수행합니다.
인증용으로 사용하는 클라이언트가 현재 로케일에서 UTF-8로 정확히 변환되는지 확인합니다. (예를 들어 Directory Server와 함께 제공되는 ldapsearch의 -i 옵션)

forcepwchg 명령줄 유틸리티를 실행하려면 다음과 같이 합니다.

명령 프롬프트 창을 열고 cd를 사용하여 이전을 수행하는 위치의 호스트에서 Windows migration로 이동합니다. (Identity Synchronization for Windows 1.0 NT 구성요소(커넥터, 변경 검출기 DLL, 비밀번호 필터 DLL)는 반드시 PDC 호스트에 설치되어야 합니다.)
migration 디렉토리에서 다음을 입력합니다.

java -jar forcepwchg.jar [-n] [-a] [-t <time_specification>]

예:

forcepwchg.jar -n -a
forcepwchg.jar -t 33m

forcepwchg에 고유한 인수는 과 같습니다.

표 A-11) forcepwchg 인수  

옵션	설명
-n	미리 보기 모드를 지정합니다. 미리 보기 모드에서 유틸리티가 다음을 제외한 모든 정상적인 사용자의 이름을 인쇄합니다. -a 인수를 지정하는 경우 내장 계정(Administrator 및 Guest). -t 인수를 사용하여 지정한 시간 동안 비밀번호를 변경한 사용자. 미리 보기에서는 모든 사용자가 forcepwchg를 실행할 수 있습니다. 미리 보기 모드가 아닌 경우 오직 Administrator만 forcepwchg를 실행할 수 있습니다.
-a	모든 사용자(Administrator 및 Guest 제외)가 비밀번호를 변경하도록 합니다. -t 인수를 사용하는 경우 이 인수는 사용할 수 없습니다.
-t <time_specification>	이전 <time specification> 동안 비밀번호를 변경한 모든 사용자가 비밀번호를 변경하도록 합니다. 여기에서 <time specification>의 형식은 다음과 같습니다. <숫자>: 초 단위 시간(예, -t 30) <숫자>m: 분 단위 시간(예, -t 25m) <숫자>h: 시 단위 시간(예, -t 6h) 예를 들어 forcepwchg -t 6h를 지정하는 경우 지난 여섯 시간 동안 비밀번호를 변경한 모든 사용자는 다시 자신의 비밀번호를 변경해야 합니다.
-?	사용 정보를 인쇄합니다.

참고	forcepwchg에 대한 더 자세한 내용은 "Windows NT에서 비밀번호 강제 변경" 페이지 196를 참조하십시오.

이전      목차      색인      다음

---

부품 번호: 817-6199-05.   Copyright 2004 Sun Microsystems, Inc. All rights reserved.