Notes® 단일 사용자에서 복수 사용자로 마이그레이션 보조자 도구 사용

이 절차를 사용하여 단일 Notes® 릴리스 내에서 기존 Notes® 단일 사용자 설치 또는 시뮬레이션된 복수 사용자 설치를 실제 Notes® 복수 사용자 설치로 변환합니다. 마이그레이션 후 Notes® 복수 사용자 클라이언트의 릴리스 레벨을 업그레이드할 수 있습니다.

시작하기 전에

Notes® 단일 사용자에서 복수 사용자로 마이그레이션 보조자 도구 이해 항목에 있는 정보를 검토하십시오.
이 도구를 실행하려면 관리자로 Windows™에 로그인하여 데이터를 복사하고 이동하는 데 필요한 권한을 확보해야 합니다.
도구를 실행하기 전에 Notes® 클라이언트 백업을 고려하십시오. 자세한 정보는 이 항목의 끝 부분에 포함된 Notes® 클라이언트 데이터 백업 및 복원 문서를 참조하십시오.
사용자에게 새 대상 디렉토리에 대한 읽기/쓰기/삭제 필수 권한이 있는지 확인하십시오.

이 태스크 정보

프로시저

Notes® 애플리케이션을 종료합니다. 마이그레이션 중에 Notes®를 실행해서는 안 됩니다.
Notes® 설치 킷의 Utility 폴더에서 MUMigrationAssistant.vbs 및 MUMigrationAssistant.ini 파일을 찾으십시오.
MUMigrationAssistant.vbs 스크립트를 열고 임베드된 문서를 검토합니다.

문서 편집기에서 MUMigrationAssistant.ini 구성 파일을 열고 다음 값을 지정하십시오.

옵션	설명
CURRENTINIPATH	(필수) 현재 NOTES.INI 파일 위치를 지정합니다. 도구는 NOTES.INI 파일에서 사용자의 데이터 디렉토리 위치를 얻습니다.
NOTESPROGRAM	(선택사항) 사용자의 notes.exe 파일의 현재 위치를 지정합니다. 파일의 현재 위치가 지정되지 않는 경우, 이 도구는 먼저 Windows 레지스트리(버전 8.5.x 및 이전 버전의 경우 HKLM/SOFTWARE/Notes/`version`/Path먼저, Notes 9.0 이상의 경우 HKLM/SOFTWARE/Notes/Path)에서 위치를 판별한 후 사용자의 NOTES.INI 파일에서 위치를 판별하려고 시도합니다.
MULTIUSERBASEDIR	(선택사항) 사용자 데이터 디렉토리의 대상 위치를 지정합니다. 도구를 실행하면 지정된 디렉토리가 있는지와 디렉토리에 대한 읽기/쓰기 권한이 도구에 있는지 확인합니다. 도구에서는 Notes® 9.0 이전 버전의 경우 Notes\Data를 추가하고 Notes® 9.0 이후 버전의 경우 HCL\Notes\Data를 추가합니다. 이 값을 설정할 때 MULTIUSERBASEDIR에 %USERNAME%을 포함해야 합니다. MULTIUSERBASEDIR의 값을 지정하지 않으면 기본값 CSIDL_APPDATA가 사용됩니다. 중요사항: 이 설정의 값을 지정한 경우에는 MULTIUSERCOMMONDIR의 값도 지정해야 합니다.
MULTIUSERCOMMONDIR	(선택사항) 공통 공유 데이터 디렉토리의 위치를 지정합니다. 도구를 실행하면 데이터가 이동될 사용자에게 지정된 디렉토리에 대한 읽기 권한이 있는지 확인합니다. 값을 지정하면 도구가 이 값에 %USERNAME% 환경 변수가 포함되었는지 확인합니다. MULTIUSERCOMMONDIR의 값을 지정하지 않으면 기본값 CSIDL_COMMON_APPDATA가 사용됩니다. 도구에서는 Notes® 9.0 이전 버전의 경우 Notes\Data를 추가하고 Notes® 9.0 이후 버전의 경우 HCL\Notes\Data를 추가합니다. 중요사항: 이 설정의 값을 지정한 경우에는 MULTIUSERBASEDIR의 값도 지정해야 합니다.
DRYRUN	(선택사항) True(기본값) - 도구를 실행하면 도구 실행 결과 발생하는 변경사항을 나열한 보고서가 생성되지만, 마이그레이션이 수행되지는 않습니다. False - 도구를 실행하면 마이그레이션이 수행됩니다
MIGRATE_REGISTRY	True - 도구가 모든 사용자에 대해 HKLM 레지스트리 설정을 마이그레이션하고 데스크탑 바로 가기 및 시작 메뉴 바로 가기를 업데이트합니다. False - 도구가 레지스트리 설정을 마이그레이션하거나 바로 가기를 업데이트하지 않습니다. 시뮬레이션된 복수 사용자 Notes® 설치에서 마이그레이션하는 경우, cscript 명령을 실행할 때 명령 프롬프트에서 이 옵션을 지정할 수 있습니다.
MIGRATE_USER_REGISTRY	True - 도구가 이 도구를 실행 중인 사용자에 대해서만 레지스트리 설정을 마이그레이션하고 데스크탑 바로 가기 및 시작 메뉴 바로 가기를 업데이트합니다. False - 도구가 레지스트리 설정을 마이그레이션하거나 바로 가기를 업데이트하지 않습니다. 시뮬레이션된 복수 사용자 Notes® 설치에서 마이그레이션하는 경우, cscript 명령을 실행할 때 명령 프롬프트에서 이 옵션을 지정할 수 있습니다.
MIGRATE_SHARED_DIR	True - 도구가 모든 사용자 간에 공유될 공통 데이터 파일을 마이그레이션합니다. 이 파일은 Notes® 복수 사용자 설치 중 공통 공유 디렉토리에 설치되는 파일입니다. False - 도구가 공통 데이터 파일을 마이그레이션하지 않습니다. 사용자 템플리트와 같은 이동할 다른 파일이 있는 경우, 한 파일에 이 파일들을 나열하고 MIGRATE_SHARED_FILES 설정에 위치를 지정할 수 있습니다. 이동되는 파일의 대상 위치를 사용자 정의하려 MULTIUSERCOMMONDIR 설정을 사용하십시오. 시뮬레이션된 복수 사용자 Notes® 설치에서 마이그레이션하는 경우, cscript 명령을 실행할 때 명령 프롬프트에서 이 옵션을 지정할 수 있습니다.
MIGRATE_SHARED_FILES	대상 공유 디렉토리로 이동할 다른 파일(예: 사용자 정의 템플리트 또는 Notes®에 의해 설치되지 않은 파일)을 나열하는 migratefilelist.txt 텍스트 파일의 이름과 위치를 지정합니다. 이 설정을 사용하려면 이전 설정 MIGRATE_SHARED_DIR의 값을 `True`로 설정해야 합니다. 시뮬레이션된 복수 사용자 Notes® 설치에서 마이그레이션하는 경우, cscript 명령을 실행할 때 명령 프롬프트에서 이 옵션을 지정할 수 있습니다.
MIGRATE_USERDATA_DIR	시뮬레이션된 복수 사용자 설치를 실제 복수 사용자 설치로 마이그레이션할 때만 이 설정을 사용합니다. True - 도구가 사용자의 개인 데이터 파일(예: 사용자 ID, 템플리트, 데이터베이스)을 MULTIUSERBASEDIR 설정으로 지정된 디렉토리로 마이그레이션합니다. 모든 사용자에 대해 이 값을 true로 설정해야 합니다. False - 도구가 개인 데이터를 이동하지 않습니다. 도구는 NOTES.INI 파일에서 소스 데이터 디렉토리의 위치를 판별한 후 마이그레이션될 각 파일이 데이터 디렉토리에 있는지와 파일에 대해 조작할 권한이 도구에 있는지를 확인합니다. 시작 그룹 또는 RunOnce 레지스트리 키에 스크립트를 실행할 일괄처리 파일을 작성하여 사용자가 마이그레이션 후 처음으로 Windows에 로그인할 때 모든 사용자의 데이터를 자동으로 마이그레이션할 수 있습니다. 각 사용자의 소스 데이터 디렉토리가 별도 드라이브에 있는 경우, 각 사용자에 대해 도구를 별도로 실행해야 합니다. MULTIUSERBASEDIR의 값을 설정하지 않으면 기본 사용자 데이터 경로로 지정된 위치로 데이터가 마이그레이션됩니다. Notes® 8.5x 및 이전 버전의 기본 경로는 C:\Documents and Settings\`username`\Local Settings\Application Data\Notes\Data이고, Notes® 9.0 및 이후 버전의 기본 경로는 C:\Documents and Settings\`username`\Local Settings\Application Data\HCL\Notes\Data를 참조하십시오. 시뮬레이션된 복수 사용자 Notes® 설치에서 마이그레이션하는 경우, cscript 명령을 실행할 때 명령 프롬프트에서 이 옵션을 지정할 수 있습니다.

MUMigrationAssistant.ini 파일을 저장하고 닫으십시오.
MUMigrationAssistant.vbs 스크립트를 닫습니다.
구성 파일에서 DRYRUN 옵션의 값을 true로 설정한 후 명령 프롬프트에서 다음을 입력하여 마이그레이션에 대해 테스트 실행을 수행하십시오.
```
cscript MUMigrationAssistant.vbs configuration_setting=value
```
도구를 실행하면 도구가 마이그레이션을 수행하기 전에 구성 파일의 설정을 확인합니다. notes.exe 및 notes.ini 파일의 위치를 지정하는 NOTESPATH 및 CURRENTINIPATH 설정이 유효하지 않으면 마이그레이션이 중지됩니다.

주: 명령행과 구성 파일에서 지정한 설정 간에 충돌이 발생하면 명령행에 지정한 설정이 우선합니다.
출력 보고서를 검토하여 MUMigrationAssistant.ini 파일 조정이 필요한지 판별합니다. 그런 경우 지금 조정하십시오.
구성 파일에서 DRYRUN 옵션의 값을 false로 설정한 후 명령 프롬프트에서 다음을 입력하여 마이그레이션을 수행하십시오.
```
cscript MUMigrationAssistant.vbs configuration_setting=value
```
공유 데이터 디렉토리에 NOTES.INI 파일이 생성됩니다. 원래의 NOTES.INI 파일은 MULTIUSERBASEDIR 변수로 지정된 디렉토리로 이동합니다. 새 데이터 디렉토리는 MULTIUSERBASEDIR 변수로 지정된 디렉토리에 위치하고 공유 디렉토리는 MULTIUSERCOMMONDIR 변수로 지정된 디렉토리가 됩니다.

결과

도구는 설치 사용자의 My Documents 폴더 및 마이그레이션된 사용자의 데이터 디렉토리에 있는 Install.log 파일에 활동을 로그합니다.

예

예: 시뮬레이션된 복수 사용자 설치에서 (실제) 복수 사용자 설치

이 시나리오에서는 몇몇 사용자를 시뮬레이션된 복수 사용자 환경과 공통 및 사용자 특정 데이터 파일이 포함된 공유 드라이브를 사용하는 단일 컴퓨터에서 작업하도록 구성합니다.

NOTES.INI 파일은 H:\data\notes.ini입니다.
Notes® 설치 프로그램 setup.exe 파일은 C:\Program Files\HCL\Notes에 있습니다.
사용자의 데이터 디렉토리는 H:\data입니다.
공유 데이터 디렉토리는 C:\notes\common\Notes\data입니다.
마이그레이션 도구를 실행하는 디렉토리에 있는 migratefilelist.txt 파일은 다음 파일이 추가로 이동될 것임을 지정합니다.
- H:\data\template1.ntf
- H:\data\template2.ntf
- H:\data\template3.ntf

적용 가능한 사용 사례를 기반으로 다음과 같이 사용자를 마이그레이션합니다.

사용 사례 1 - 모든 버전의 Notes에 대한 단일 사용자에서 복수 사용자로 마이그레이션 Notes®

이 사용 사례에서는 Notes® 8.5.1이 단일 사용자 모드에서 설치되고 프로그램 파일은 C:\Program Files\HCL\Notes에, 데이터 파일은 C:\Program Files\HCL\Notes\Data에 설치됩니다.

도구를 실행하여 다음을 수행하십시오.

실제 복수 사용자 설치가 되도록 레지스트리 항목을 마이그레이션합니다.
모든 사용자가 사용할 공통 파일을 C:\Documents and Settings\AllUsers\Application Data\Notes\Data로 마이그레이션합니다.
사용자의 데이터 파일 및 NOTES.INI를 C:\Documents and Settings\username\Local Settings\Application Data\Notes\Data로 마이그레이션합니다.

MUMigrationAssistant.ini에 지정된 값은 다음과 같습니다.

DRYRUN=true
CURRENTINIPATH=C:\Program Files\HCL\Notes\Data\notes.ini
NOTESPROGRAM=C:\Program Files\HCL\Notes
IS_SIMULATED_MODE=false
MIGRATE_REGISTRY=true
MIGRATE_USER_REGISTRY=true
MIGRATE_SHARED_DIR=true
MIGRATE_USERDATA_DIR=true
MULTIUSERCOMMONDIR= 
MULTIUSERBASEDIR=

주: 기본값을 사용하려면 MULTIUSERBASEDIR 및 MULTIUSERCOMMONDIR을 공백으로 둡니다.

사용 사례 2 - 시뮬레이션된 복수 사용자에서 실제 복수 사용자로 마이그레이션 - 모든 공유 데이터를 이동시키기 위한 첫 번째 도구 실행

이 사용 사례에서는 Notes® 8.5.1이 단일 사용자 모드에서 설치되지만 각 사용자의 데이터 디렉토리가 네트워크 드라이브에서 대응됩니다. 프로그램 파일은 C:\Program Files\HCL\Notes에 설치되고 데이터 파일은 H:\data에 설치됩니다. 모든 사용자의 소스 데이터 디렉토리가 로컬에 있거나 공통 네트워크 드라이브에 있으면, 도구를 실행하여 해당 Notes® 클라이언트 인스턴스의 모든 사용자에 대해 데이터를 대상 데이터 디렉토리 위치로 이동할 수 있습니다.

사용자의 대응된 데이터 드라이브에 대해 액세스 권한이 있는 시스템에서 관리자로서 MUMigrationAssistant를 실행하여 다음을 수행하십시오.

HKLM 레지스트리 설정을 변환하여 실제 복수 사용자 설치를 지정합니다.
공유 데이터 디렉토리 C:\notes\common\Data를 작성합니다.
모든 사용자의 공통 파일을 공유 디렉토리로 마이그레이션합니다.

MUMigrationAssistant.ini에 지정된 값은 다음과 같습니다.

DRYRUN=true
CURRENTINIPATH=H:\data\notes.ini
NOTESPROGRAM=C:\Program Files\HCL\Notes
IS_SIMULATED_MODE=true
MIGRATE_REGISTRY=true
MIGRATE_USER_REGISTRY=false
MIGRATE_SHARED_DIR=true
MIGRATE_USERDATA_DIR=false
MULTIUSERCOMMONDIR=C:\notes\common
MULTIUSERBASEDIR=H:\data

사용 사례 3 - 각 사용자가 로그인하여 각 사용자의 데이터를 이동시킬 때 도구의 후속 실행으로 시뮬레이션된 복수 사용자에서 실제 복수 사용자로 마이그레이션

이 사용 사례에서는 Notes® 8.5.1은 단일 사용자 모드에서 설치되지만, 각 사용자의 데이터 디렉토리는 대응된 드라이브에 있습니다. 관리자가 Notes® 클라이언트의 단일 사용자 설정을 복수 사용자 설치로 마이그레이션했습니다(사용 사례 2에 따라). 이제 각 사용자가 시스템에 로그인합니다.

사용자가 로그인하여 다음을 수행할 때 MUMigrationAssistant를 실행합니다.

해당 특정 사용자에 대한 HKCU 레지스트리 항목을 마이그레이션합니다.
대응된 드라이브에서 기본 위치 C:\Documents and Settings\username\Local Settings\Application Data\Notes\Data로 사용자의 데이터를 이동시킵니다.

MUMigrationAssistant.ini에 지정된 값은 다음과 같습니다.

DRYRUN=true
CURRENTINIPATH=H:\data\notes.ini
NOTESPROGRAM=C:\Program Files\HCL\Notes
IS_SIMULATED_MODE=true
MIGRATE_REGISTRY=false
MIGRATE_USER_REGISTRY=true
MIGRATE_SHARED_DIR=false
MIGRATE_USERDATA_DIR=true
MULTIUSERCOMMONDIR=C:\notes\common
MULTIUSERBASEDIR=

주: MULTIUSERBASEDIR은 기본값인 공백으로 두십시오.