Sun Java System Communications Express 6 2005Q4 관리 설명서

8장 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 데이터를 Address Book Server로 마이그레이션해야 합니다.

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

개요

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

그림 8–1 데이터 마이그레이션 프로세스 개요

데이터 마이그레이션

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

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

그림 8–2 PAB 트리에서 Entry1의 위치

PAB 트리 구조

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

그림 8–3 Addressbook Server 트리에서 Entry 1의 위치

Address Book Server 트리


주 –

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


마이그레이션 시나리오

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

동적 마이그레이션

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

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

일괄 마이그레이션

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

사후 구성 단계

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


주 –

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


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

표 8–1 구성 파일 및 목적

파일 이름 

설명 

migrate.properties 

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

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( 사후 구성 단계)

xlate-pabgroup.xml( 사후 구성 단계)

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

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

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

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

매개 변수 

기본값 

설명 

hostname.pabldappoolmin

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

hostname.pabldappoolmax

20 

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

hostname.pabldappooltimeout

50 

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

hostname.alwaysusedefaulthost

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

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

delete_pabentry 

성공적으로 마이그레이션한 후 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 데이터를 마이그레이션하는 데 필요한 대상 디렉토리 인스턴스를 나타냅니다.

표 8–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 

homecity 

st 

homeState 

postalcode 

homePostalCode 

co 

homeCountry 

labeleduri 

piWebsite1 

description 

description 

memberofpab 

memberOfPIBook 

memberofpabgroup 

memberOfOIGroup 

표 8–4 그룹에 대한 필드 매핑

PAB 

주소록 

cn 

displayName 

description 

description 

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

표 8–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는 소스 디렉토리 인스턴스를 나타내고 abldaphostabldaport는 PAB 데이터를 마이그레이션해야 하는 대상 디렉토리 인스턴스를 나타냅니다.

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

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

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

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

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


주 –

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

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


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

다음 대상으로부터 마이그레이션을 수행할 수 있습니다.

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

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

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

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

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