7장 Address Book Server로 개인 주소록 데이터 마이그레이션

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

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

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

• 데이터 마이그레이션 프로세스

• 사후 구성 단계

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

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

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

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

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

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

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

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

마이그레이션 시나리오

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

• 동적 마이그레이션

• 일괄 마이그레이션

동적 마이그레이션

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

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

1. 응용 프로그램은 uwcuath.properties 파일에서 pab_mig_required 매개 변수를 사용하여 마이그레이션이 활성화되었는지 확인합니다.

   pab_mig_required 매개 변수가 true로 설정되어 있으면 마이그레이션 프로세스가 시작됩니다.

2. 그런 다음 로그인 논리는 사용자의 LDAP 항목에 있는 nswmextendedprefs 속성을 비교합니다. 여기서는 mepabmigration 매개 변수의 값을 검사하여 사용자의 데이터가 이전에 마이그레이션되었는지 확인합니다.

3. PAB 마이그레이션이 완료되면 Address Book Server는 로그인된 사용자 항목에서 nswmextendedprefs, mepabmigration 등록 정보를 1로 설정하여 마이그레이션 프로세스가 완료된 것을 나타냅니다.

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

메일을 받으려면 migrate.properties 파일에서 매개 변수를 설정해야 합니다.

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

일괄 마이그레이션

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

일괄 마이그레이션을 수행하는 방법

runMigrate.sh 스크립트에서 다음 매개 변수를 설정합니다. 이 스크립트는 uwc-deployed-path/WEB-INF/classes 디렉토리에 있습니다.

• BASE_DIR: 이 매개 변수를 Communications Express 설치의 uwc-deployed-path로 설정합니다.

• JAVA_HOME: 이 매개 변수를 Java가 설치되는 디렉토리로 설정합니다.

• o=siroe.com, o=isp: siroe.com 및 isp 값을 구성된 도메인의 inetDomainBaseDN으로 바꿉니다.

일괄 마이그레이션 스크립트를 실행합니다.

# ./runMigrate.sh

일괄 마이그레이션이 실패하면 명령줄 프롬프트에 예외가 표시됩니다.

단일 사용자 및 사용자 집합 마이그레이션

마이그레이션 스크립트를 사용하면 관리자는 모든 사용자, 단일 사용자 또는 사용자 집합을 마이그레이션할 수 있습니다. 옵션 없이 일괄 마이그레이션 스크립트를 실행하면 전체 사용자 집합이 마이그레이션됩니다. 단일 사용자를 마이그레이션하려면 해당 사용자 아이디를 지정합니다. 사용자 집합을 마이그레이션하려면 사용자 목록을 텍스트 파일로 제공해야 합니다. runMigrate.sh 명령에는 다음 구문이 사용됩니다.

./runMigrate.sh{ [-u < [uid] |  [-f <uids-file]} [-h]

여기서 다음을 참조하십시오.

• -u 옵션은 runMigrate 스크립트에 단일 사용자 마이그레이션을 수행하는 것을 알립니다. —u 옵션 뒤에는 마이그레이션할 사용자의 아이디를 표시해야 합니다. 예를 들면 다음과 같습니다.

  ./runMigrate.sh -u user1

• -f 옵션은 파일에 지정된 사용자 집합을 마이그레이션하는 것을 runMigrate 스크립트에 알립니다. —f 옵션 뒤에는 마이그레이션할 사용자 집합의 사용자 아이디가 포함된 파일의 이름이 필요합니다. 예를 들면 다음과 같습니다.

  ./runMigrate.sh -f usersToMigrate.txt

  usersToMigrate.txt 파일에는 한 줄에 사용자 아이디 하나를 포함해야 합니다. 예:

  user1
  user2
  user3
  ...
  ....
  and so on..

데이터 마이그레이션 프로세스

Communications Express는 마이그레이션 스크립트를 사용하여 사용자의 Messenger Express 주소록 데이터를 Communications Express에 속한 Address Book Server로 마이그레이션합니다.

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

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

siroe.com 도메인에 있는 User1의 PAB에 마이그레이션해야 할 항목 Entry1이 있는 경우 해당 항목은 그림 7–2에 표시된 대로 ou=User1 아래의 PAB 트리에 있습니다.

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

마이그레이션 후 새로 만들어진 Address Book Server 항목은 그림 7–3과 같이 Address Book Server 트리의 o=siroe.com, piEntryID=Entry 1 아래에 추가됩니다.

그림 7–3 Address Book Server 트리에서 Entry 1의 위치

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

사후 구성 단계

Communications Express를 구성하여 마이그레이션을 활성화해야 합니다.

마이그레이션에 필요한 구성 매개 변수는 관리자가 직접 입력해야 합니다.

다음 표에는 마이그레이션 스크립트가 사용하는 구성 파일이 나열되어 있습니다.

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

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	piEmail1Type:work piEmail1:
postoffice+street	homePostalAddress
l	homecity
st	homeState
postalcode	homePostalCode
co	homeCountry
labeleduri	piWebsite1
description	description
memberofpabgroup	memberOfOIGroup
dateOfBirth	dateOfBirth 주의 – Messenger Express의 제한 때문에 생일을 MM/DD/YY 형식으로 지정한 경우에는 이 등록 정보의 마이그레이션이 잘못될 수 있습니다. 하지만 마이그레이션이 끝난 후에 이 등록 정보를 편집하면 올바른 날짜로 수정할 수 있습니다. 이 값의 설정 방법에 대한 자세한 내용은 온라인 도움말을 참조하십시오.