7장 PAB 데이터를 AddressBook Server로 마이그레이션

이전 목차 색인 다음
Sun Java System Communications Express 6 2005Q1 관리 설명서

7장
PAB 데이터를 AddressBook Server로 마이그레이션

이전에는 사용자 연락처를 Sun Java System Messaging Server에 저장하기 위해 PAB(Personal Address Book)를 사용했으며 PAB는 Messaging Server에 배포된 웹 기반 클라이언트에서만 액세스할 수 있었습니다. Communications Express용 Messaging Server는 PAB 대신 AddressBook Server를 사용하여 사용자의 연락처 세부 정보를 저장합니다. 따라서 기존 Messaging Server 설치를 사용하여 Communications Express에 액세스하는 사용자는 PAB 데이터를 AddressBook Server로 마이그레이션해야 합니다.

이 장은 다음 내용으로 구성되어 있습니다.

개요

마이그레이션 시나리오

사후 구성 단계

수평 확장성 지원에 필요한 추가 구성

마이그레이션 시나리오

개요

마이그레이션 도구는 사용자의 Messenger Express 주소록 데이터를 Communications Express의 일부인 AddressBook Server로 마이그레이션합니다.

그림 7-1  데이터 마이그레이션 프로세스 개요

Messenger Express의 LDAP PAB 트리에 상주하는 데이터가 Address Book Server LDAP PAB 트리로 마이그레이션됩니다. 아래 예에서는 마이그레이션 프로세스에 대해 설명합니다.

siroe.com 도메인에 있는 User1의 PAB에 마이그레이션해야 할 항목 Entry1이 있는 경우 해당 항목은 PAB 트리의 ou=User1 아래에 위치합니다(그림 7-2에 녹색으로 표시).

그림 7-2  PAB 트리에서 Entry1의 위치

마이그레이션 후 새로 만들어진 AddressBook Server 항목은 AddressBook Server 트리의 o=siroe.com, piEntryID=Entry 1 아래에 추가됩니다(그림 7-3에 빨간색으로 표시).

그림 7-3  AddressBook Server 트리에서 Entry 1의 위치

주

마이그레이션 유틸리티는 사용자가 처음으로 로그인할 때 모든 데이터를 Messenger Express의 PAB에서 Communication Express의 주소록으로 마이그레이션합니다. 하지만 일단 데이터가 주소록으로 마이그레이션되면 Messenger Express를 사용하여 만든 새 연락처나 그룹이 Communications Express의 주소록에 표시되지 않습니다. 그 반대의 경우도 마찬가지입니다.

마이그레이션 시나리오

데이터 마이그레이션은 다음 두 가지 방법으로 수행됩니다.

동적 마이그레이션

일괄 마이그레이션

동적 마이그레이션

동적 마이그레이션은 기존 Messenger Express 사용자가 Communication Express에 로그인할 때 수행됩니다. 사용자는 마이그레이션이 완료된 후 전자 메일을 받습니다.

동적 마이그레이션 프로세스:

응용 프로그램은 uwcuath.properties 파일에서 마이그레이션이 활성화되어 있는지 확인한 다음 마이그레이션 프로세스를 진행합니다.

그러면 로그인 논리는 nswmextendedprefs 속성을 mepabmigration 값과 비교하여 사용자 데이터가 이전에 마이그레이션되었는지 확인합니다.

PAB 마이그레이션이 완료되면 마이그레이션 프로세스 완료를 나타내기 위해 Address Book Server가 로그인된 사용자 항목에서 nswmextendedprefs, mepabmigration을 "1"로 설정합니다.

PAB 데이터가 성공적으로 마이그레이션되면 사용자가 메일을 받습니다.

메일을 받으려면 표 7-2에 설명된 매개 변수를 정의해야 합니다.

일괄 마이그레이션

일괄 마이그레이션 프로세스에서 마이그레이션은 최종 사용자의 개입 없이 서버 수준에서 발생합니다. 관리자는 runMigrate.sh 일괄 처리 스크립트를 실행하여 주어진 도메인에 있는 메일 사용자 PAB 데이터를 마이그레이션합니다. 다중 도메인에 있는 메일 사용자를 위해 관리자는 각 도메인에 대해 runMigrate.sh 스크립트를 호출하여 주어진 inetDomainBaseDN의 사용자 PAB 데이터를 Address Book Server로 마이그레이션합니다.

사후 구성 단계

마이그레이션을 사용하도록 Communications Express를 구성해야 합니다.

주

마이그레이션에 필요한 구성 매개 변수는 관리자가 수동으로 제공해야 합니다.

표 7-1에서는 마이그레이션 유틸리티가 사용하는 config 파일을 나열합니다.

표 7-1 구성 파일 및 목적

파일 이름

설명

migrate.properties

데이터를 PAB에서 Address Book Server로 마이그레이션하는 데 필요한 매개 변수가 포함되어 있습니다. 이러한 매개 변수에 대한 자세한 내용은 표 7-2를 참조하십시오.

uwcauth.properties

마이그레이션 유틸리티가 마이그레이션이 필요한지 여부를 확인할 때 참조합니다.

마이그레이션 도구는 pab_mig_required 값을 확인합니다. 값이 true이면 동적 마이그레이션을 수행합니다.

uwcconfig.properties

관리자는 로그 수준을 지정하고 문제 해결을 위해 로깅을 활성화할 수 있습니다. 기본적으로 이 매개 변수는 비활성화되어 있습니다.

runMigrate.sh

(일괄 마이그레이션에만 적용 가능)

스크립트는 다음 세 인수를 사용하여 필요한 변수를 설정하고 java 프로그램 MigratePab을 호출합니다.

# migrate.properties 파일의 절대 경로입니다. 기본 경로는 ../WEB-INF/config/migrate.properties로 설정됩니다.

# uwcauth.properties 및 다른 구성 파일이 있는 구성 디렉토리의 절대 경로입니다. 기본 경로는 ../WEBINF/config로 설정됩니다.

# 사용자의 inetDomainBaseDN입니다.

이 파일을 적절하게 편집하여 필요한 경로와 인수를 제공해야 합니다.

xlate-pabperson.xml
(표 7-3)

xlate-pabgroup.xml
(표 7-4)

마이그레이션 유틸리티는 Communications Express의 주소록 API를 사용하여 Messenger Express의 PAB에서 데이터를 로드합니다.

xlate 파일은 PAB의 LDAP 속성을 AddressBook Server의 주소록 속성에 매핑하는 데 필요합니다.

사용자의 메일 호스트에 따라 표 7-2에 나열된 PAB 구성 항목이 검색되며 PAB Server에 대한 연결이 설정됩니다.

표 7-2 migrate.properties에서 PAB 마이그레이션을 위해 구성 가능한 매개 변수

매개 변수

기본값

설명

hostname.pabldappoolmin

4

PAB LDAP에 대해 생성할 최소 LDAP 사용자 연결 수를 지정합니다.

hostname.pabldappoolmax

20

PAB LDAP에 대해 생성할 최대 LDAP 사용자 연결 수를 지정합니다.

hostname.pabldappooltimeout

50

LDAP 연결 시간이 초과되기까지의 시간(초)을 지정합니다.

hostname.alwaysusedefaulthost

1

PAB URI에서 언급한 사용자 PAB 호스트 사용 여부와 유지 관리되는 목록에서 첫 번째 정규화된 PAB 호스트 이름 사용 여부를 지정합니다.

1로 설정하면 첫 번째 정규화된 PAB 호스트를 사용하여 PAB 항목을 검색합니다.

delete_pabentry

0

성공적으로 마이그레이션한 후 PAB 항목과 PABURI를 삭제합니다.

maxthreads

10

마이그레이션 스레드 수를 지정합니다.

mailhost.pabhosts

PAB 항목이 위치한 PAB 호스트 목록에 메일 호스트 이름이 지정됩니다.

PAB 호스트 목록을 지정합니다.

mailhost.pabports

PAB 호스트의 포트 번호를 지정합니다.

mailhost.pabbinddns

PAB의 바인드 DN을 지정합니다.

mailhost.pabpasswds

PAB에 사용자 바인딩에 대해 비밀번호를 지정합니다.

<pabhost.pabport>.abhostport=<abldaphost>:<abldapport>

migrate.properties 파일의 조회 테이블에서 사용 가능한 pabhost 및 pabport 항목을 지정합니다.

이 매개 변수에서 <pabhost.pabport>는 소스 디렉토리 인스턴스를 나타내고 <abldaphost> 및 <abldaport>는 PAB 데이터를 마이그레이션하는 데 필요한 대상 디렉토리 인스턴스를 나타냅니다.

표 7-3 연락처에 대한 필드 매핑

PAB

주소록

cn

DisplayName

sn

sn

givenName

givenName

telephonenumber

piPhone1Type:work

piPhone1:

homephone

piPhone2Type:home

piPhone2;

pager

piPhone4Type:pager

piPhone4:

mobile

piPhone3Type:mobile

piPhone3:

facsimiletelephonenumber

piPhone5Type:fax

piPhone5:

mail

piEmail2Type:home

piEmail1:

mailalternateaddress

piEmail2Type:work

piEmail2:

postoffice+street

homePostalAddress

l

homecity

st

homeState

postalcode

homePostalCode

co

homeCountry

labeleduri

piWebsite1

description

description

memberofpab

memberOfPIBook

memberofpabgroup

memberOfOIGroup

표 7-4 그룹에 대한 필드 매핑

PAB

주소록

cn

displayName

description

description

메일을 받으려면 표 7-5에 설명된 매개 변수를 정의해야 합니다.

표 7-5 PAB 마이그레이션 전자 메일 매개 변수

매개 변수

기본값

설명

emailReqd

True

PAB 데이터를 성공적으로 마이그레이션한 후 메일을 보낼 수 있게 합니다.

허용 가능한 값은 True”와 False”입니다.

smtphost

로컬 메일 호스트

예: budgie.siroe.com

SMTP 중계 호스트 이름을 지정합니다.

smtpport

25

SMTP 중계 호스트를 지정합니다.

mailsubject

PAB 마이그레이션 상태

메일의 제목을 지정합니다.

from

admin@hostname

보낸 사람 이름을 지정합니다.

팁

처음 로그인할 때 PAB 데이터 마이그레이션이 실행되므로 초기 세션 중에 주소록이 표시되지 않을 것임을 알리는 전자 메일을 관리자가 모든 사용자에게 보내는 것이 좋습니다. 2, 3일 후에도 데이터가 표시되지 않는 경우에는 관리자에게 문의해야 합니다.

수평 확장성 지원에 필요한 추가 구성

사용자 LDAP 항목의 psRoot 속성은 사용자의 개인 주소록 항목이 저장 및 검색되는 LDAP 위치를 정의하는 AddressBook Server 호환 URL입니다. psRoot 속성은 모든 사용자의 PAB 데이터를 여러 디렉토리 위치에 분산시키도록 관리자 관리 사용자를 활성화합니다.

기존의 웹 메일 사용자의 경우 PAB 마이그레이션을 활성화하면 기존 pabURI 속성을 사용하여 psRoot 속성이 구성되고 매핑 테이블이 uwc-deploy-dir/WEB-INF/config/migrate.properties에 정의됩니다.

migrate.properties 파일의 조회 테이블은 다음 형식의 pabhost 및 pabport 항목으로 구성됩니다.

pabhost.pabport.abhostport = abldaphost:abldapport

여기서 pabhost.pabport는 소스 디렉토리 인스턴스를 나타내고 abldaphost 및 abldaport는 PAB 데이터를 마이그레이션해야 하는 대상 디렉토리 인스턴스를 나타냅니다.

따라서, pab 데이터를 pab.example.com:389에 실행 중인 디렉토리에서 abs.example.com:389에서 실행 중인 주소록 디렉토리로 마이그레이션하려면 migrate.properties 파일의 항목이 다음과 같이 표시되어야 합니다.

pab.example.com.389.abhostport = abs.example.com:389

migrate.properties 파일에서 필요한 만큼의 조회를 찾을 수 있습니다. 사용자의 pabURI 속성이 pabhost 및 pabport를 사용하는 경우 기본 psRoot 패턴을 사용하여 구성되는 psRoot의 형식은 다음과 같습니다.

ldap://abldaphost:abldapport/piPStoreOwner=%U,o=%D,o=PiServerDb

pabURI 값에 대한 조회가 정의되어 있지 않은 경우 즉, 매핑 테이블에 pabURI와 일치하는 항목이 없는 경우 pabhost 및 pabport 값이 abldaphost 및 abport에 대한 기본값으로 사용됩니다. 매핑 테이블이 없는 경우 Messaging Server의 PAB 항목이 각 주소록 스키마와 동일한 디렉토리 인스턴스의 다른 루트에 마이그레이션된다는 것을 의미합니다. 이 시나리오에서 [Target] 디렉토리 인스턴스는 [Source] 디렉토리 인스턴스와 같습니다.

주

조회 테이블은 패치 설치 프로그램에서 자동으로 정의되지 않습니다. 패치를 설치한 후 조회 테이블을 직접 정의한 다음 웹 서버를 다시 시작해야 합니다.

abldaphost:abldapport 디렉토리 서버 인스턴스는 해당 도메인의 personalstore.properties에 지정된 db_config.properties 파일에 정의해야 합니다.

마이그레이션 배포 시나리오

다음 대상에서 마이그레이션을 수행할 수 있습니다.

기본 단일 PAB 호스트를 가리키는 단일 Messenger Express 인스턴스

다중 PAB 호스트를 가리키는 단일 Messenger Express 인스턴스

기본 PAB 호스트 집합을 갖는 다중 PAB 호스트를 가리키는 단일 Messenger Express 인스턴스

단일 PAB 호스트를 가리키는 다중 Messenger Express 인스턴스

다중 PAB 호스트를 가리키는 다중 Messenger Express 인스턴스

이전      목차      색인      다음

부품 번호: 819-1066. Copyright 2005 Sun Microsystems, Inc. 모든 권리는 저작권자의 소유입니다.


주	마이그레이션 유틸리티는 사용자가 처음으로 로그인할 때 모든 데이터를 Messenger Express의 PAB에서 Communication Express의 주소록으로 마이그레이션합니다. 하지만 일단 데이터가 주소록으로 마이그레이션되면 Messenger Express를 사용하여 만든 새 연락처나 그룹이 Communications Express의 주소록에 표시되지 않습니다. 그 반대의 경우도 마찬가지입니다.


주	마이그레이션에 필요한 구성 매개 변수는 관리자가 수동으로 제공해야 합니다.

파일 이름	설명
migrate.properties	데이터를 PAB에서 Address Book Server로 마이그레이션하는 데 필요한 매개 변수가 포함되어 있습니다. 이러한 매개 변수에 대한 자세한 내용은 표 7-2를 참조하십시오.
uwcauth.properties	마이그레이션 유틸리티가 마이그레이션이 필요한지 여부를 확인할 때 참조합니다. 마이그레이션 도구는 pab_mig_required 값을 확인합니다. 값이 true이면 동적 마이그레이션을 수행합니다.
uwcconfig.properties	관리자는 로그 수준을 지정하고 문제 해결을 위해 로깅을 활성화할 수 있습니다. 기본적으로 이 매개 변수는 비활성화되어 있습니다.
runMigrate.sh (일괄 마이그레이션에만 적용 가능)	스크립트는 다음 세 인수를 사용하여 필요한 변수를 설정하고 java 프로그램 MigratePab을 호출합니다. # migrate.properties 파일의 절대 경로입니다. 기본 경로는 ../WEB-INF/config/migrate.properties로 설정됩니다. # uwcauth.properties 및 다른 구성 파일이 있는 구성 디렉토리의 절대 경로입니다. 기본 경로는 ../WEBINF/config로 설정됩니다. # 사용자의 inetDomainBaseDN입니다. 이 파일을 적절하게 편집하여 필요한 경로와 인수를 제공해야 합니다.
xlate-pabperson.xml (표 7-3) xlate-pabgroup.xml (표 7-4)	마이그레이션 유틸리티는 Communications Express의 주소록 API를 사용하여 Messenger Express의 PAB에서 데이터를 로드합니다. xlate 파일은 PAB의 LDAP 속성을 AddressBook Server의 주소록 속성에 매핑하는 데 필요합니다.

매개 변수	기본값	설명
hostname.pabldappoolmin	4	PAB LDAP에 대해 생성할 최소 LDAP 사용자 연결 수를 지정합니다.
hostname.pabldappoolmax	20	PAB LDAP에 대해 생성할 최대 LDAP 사용자 연결 수를 지정합니다.
hostname.pabldappooltimeout	50	LDAP 연결 시간이 초과되기까지의 시간(초)을 지정합니다.
hostname.alwaysusedefaulthost	1	PAB URI에서 언급한 사용자 PAB 호스트 사용 여부와 유지 관리되는 목록에서 첫 번째 정규화된 PAB 호스트 이름 사용 여부를 지정합니다. 1로 설정하면 첫 번째 정규화된 PAB 호스트를 사용하여 PAB 항목을 검색합니다.
delete_pabentry	0	성공적으로 마이그레이션한 후 PAB 항목과 PABURI를 삭제합니다.
maxthreads	10	마이그레이션 스레드 수를 지정합니다.
mailhost.pabhosts	PAB 항목이 위치한 PAB 호스트 목록에 메일 호스트 이름이 지정됩니다.	PAB 호스트 목록을 지정합니다.
mailhost.pabports		PAB 호스트의 포트 번호를 지정합니다.
mailhost.pabbinddns		PAB의 바인드 DN을 지정합니다.
mailhost.pabpasswds		PAB에 사용자 바인딩에 대해 비밀번호를 지정합니다.
<pabhost.pabport>.abhostport=<abldaphost>:<abldapport>		migrate.properties 파일의 조회 테이블에서 사용 가능한 pabhost 및 pabport 항목을 지정합니다. 이 매개 변수에서 <pabhost.pabport>는 소스 디렉토리 인스턴스를 나타내고 <abldaphost> 및 <abldaport>는 PAB 데이터를 마이그레이션하는 데 필요한 대상 디렉토리 인스턴스를 나타냅니다.

PAB	주소록
cn	DisplayName
sn	sn
givenName	givenName
telephonenumber	piPhone1Type:work piPhone1:
homephone	piPhone2Type:home piPhone2;
pager	piPhone4Type:pager piPhone4:
mobile	piPhone3Type:mobile piPhone3:
facsimiletelephonenumber	piPhone5Type:fax piPhone5:
mail	piEmail2Type:home piEmail1:
mailalternateaddress	piEmail2Type:work piEmail2:
postoffice+street	homePostalAddress
l	homecity
st	homeState
postalcode	homePostalCode
co	homeCountry
labeleduri	piWebsite1
description	description
memberofpab	memberOfPIBook
memberofpabgroup	memberOfOIGroup

매개 변수	기본값	설명
emailReqd	True	PAB 데이터를 성공적으로 마이그레이션한 후 메일을 보낼 수 있게 합니다. 허용 가능한 값은 True”와 False”입니다.
smtphost	로컬 메일 호스트 예: budgie.siroe.com	SMTP 중계 호스트 이름을 지정합니다.
smtpport	25	SMTP 중계 호스트를 지정합니다.
mailsubject	PAB 마이그레이션 상태	메일의 제목을 지정합니다.
from	admin@hostname	보낸 사람 이름을 지정합니다.


팁	처음 로그인할 때 PAB 데이터 마이그레이션이 실행되므로 초기 세션 중에 주소록이 표시되지 않을 것임을 알리는 전자 메일을 관리자가 모든 사용자에게 보내는 것이 좋습니다. 2, 3일 후에도 데이터가 표시되지 않는 경우에는 관리자에게 문의해야 합니다.


주	조회 테이블은 패치 설치 프로그램에서 자동으로 정의되지 않습니다. 패치를 설치한 후 조회 테이블을 직접 정의한 다음 웹 서버를 다시 시작해야 합니다. abldaphost:abldapport 디렉토리 서버 인스턴스는 해당 도메인의 personalstore.properties에 지정된 db_config.properties 파일에 정의해야 합니다.