DCMigrator를 사용하여 데이터를 마이그레이션하는 방법
개요
DirectCloud는 회사 파일 서버 및 NAS(Network Hard Disk)에서 DirectCloud로 데이터를 마이그레이션하기 위해 데이터 마이그레이션 도구 DCMigrator를 제공합니다. DCMigrator는 Windows PowerShell을 사용하여 파일과 폴더를 DirectCloud에 업로드합니다. 이 절에서는 DCMigrator를 사용하여 데이터를 마이그레이션하는 방법에 대해 설명합니다.
제한·보충사항
DCMigrator를 구하는 방법과 라이센스는 DCMigrator를 다운로드하는 방법을 참조하십시오.
DCMigrator의 작동 환경, 성능, 사양, 가격 등에 대한 자세한 정보는 DCMigrator를 다운로드하는 방법를 참조하십시오.
사용자에게 1차 계층 폴더를 만들 수 있는 권한을 부여하는 방법 에 따라 DirectCloud 관리자 페이지에서 DCMigrator를 실행하는 관리자 또는 사용자에게 1차 계층 폴더 만들기 권한을 부여합니다.
여러 PC에서 동시에 DCMigrator를 실행하는 경우 동일한 원본 폴더를 지정하지 마십시오. 파일 무결성에 문제가 발생할 수 있습니다.
여러 PC에서 동시에 5대 이상의 DCMigrator를 실행할 수 없습니다.
마이그레이션할 총 파일 용량이 300GB를 초과하면 업로드한 후 파일 정보와 문서 내 텍스트가 데이터베이스에 반영되기까지 시간이 걸릴 수 있습니다.
100MB 이상의 파일을 업로드하는 경우 20MB 단위로 분할됩니다.
다음 문자가 파일 이름에 포함되어 있으면 파일을 마이그레이션할 수 없습니다. \ ¥ / : * ? “ < >
마이그레이션할 파일의 이름에 이전 글꼴 문자가 포함된 경우 일부 문자는 자동으로 새 글꼴로 변환됩니다.
대상 폴더에는 관리자 권한이 설정되어 있거나 마스터 권한이 설정되어 있어야 합니다. 적절한 액세스 권한이 설정되어 있지 않으면 DCMigrator가 데이터를 마이그레이션하지 못합니다.
My Box 메뉴 바로 아래로 데이터를 마이그레이션할 수 있지만 Shared Box 메뉴 바로 아래로 데이터를 마이그레이션할 수는 없습니다.
마스터 권한이 있는 사용자가 DCMigrator를 실행하면 대상 폴더의 액세스 수준 검사가 생략되므로 데이터를 빠르게 마이그레이션할 수 있습니다.
DCMigrator로 업로드할 때 덮어쓴 파일을 복구할 수 없습니다.
DCMigrator는 인증 유형 프록시를 지원하지 않습니다.
DCMigrator에서 마이그레이션하는 폴더와 파일을 조작하지 마십시오.
DCMigrator를 처음 사용하는 경우 직접 클라우드 측에서 DCMigrator를 사용할 수 있는 권한을 활성화해야 합니다. 이용을 시작하기 전에 고객 센터로 문의해주세요.
지금까지 DCMigrator를 사용한 적이 있다면 사용을 신청할 필요가 없습니다.
절차
PowerShell 시작
Windows 키 + R 키를 누릅니다. 파일 이름으로 실행 화면이 표시됩니다.
이름에 powershell을 입력하고 확인 버튼을 클릭합니다. Windows PowerShell 화면(이하 PowerShell)이 시작됩니다.
PowerShell 프롬프트에 표시되는 현재 디렉터리가 사용자의 홈 디렉터리인지 확인합니다. 사용자 이름은 자신의 사용자 이름을 표시합니다.
PS C: \ Users \ 사용자 이름 >사용자의 홈 디렉토리에 없는 경우 명령에서 " cd C: \ Users \ 사용자 이름 "과 같이 실행하고 이동합니다.
cd 명령으로 바탕화면으로 이동합니다. 복사한 명령을 PowerShell에 붙여넣을 때 제대로 작동하지 않으면 PowerShell에 수동으로 명령을 입력합니다.
PS C: \ Users \ 사용자 이름 > cd Desktop ⏎ PS C: \ Users \ 사용자 이름 \ Desktop >다음 단계에서는 프롬프트에서 "PS C:\Users\사용자 이름\Desktop>"을 ">"로 생략하여 설명합니다.
데이터 마이그레이션 테스트
실제 데이터를 마이그레이션하기 전에 더미 데이터를 만들어 데이터 마이그레이션을 테스트합니다.
md 명령으로 테스트용 "testfolder" 폴더를 만든 다음 fsutil 명령으로 테스트용 1KB 파일을 세 개 만듭니다.
> md testfolde r ⏎ > fsutil file createnew testfolder \ testfile.txt 1024 ⏎ > fsutil file createnew testfolder \ testfile2.txt 1024 ⏎ > fsutil file createnew testfolder \ testfile3.txt
다음 명령 형식에서 1단계에서 "testfolder" 폴더 아래에 만든 파일을 DirectCloud로 마이그레이션하는 명령을 실행합니다.
NOTE
--mirror 옵션을 사용하여 실행하면 대상 폴더가 원본과 동일한 상태가 됩니다. 하위 폴더가 있는 경우 해당 폴더도 처리 대상이 됩니다. 대상 폴더의 파일을 덮어쓰거나 삭제할 수 있으므로 실행할 때는 주의하십시오. 명령행 옵션에 대해서는 DCMigrator의 명령행 옵션 을 참조하십시오.
원본 폴더의 경로에 지정한 폴더 자체는 업로드되지 않습니다. 이름이 같은 폴더 아래로 데이터를 마이그레이션하려면 대상 폴더의 경로에 이름이 같은 폴더를 지정해야 합니다. 대상에 지정한 폴더가 없으면 자동으로 만들어집니다.
명령 형식:DCMigrator.exe " < 원본 폴더 경로 > " "/ 공유 / < 대상 폴더 경로 > /" --mirror데스크톱의 "testfolder" 폴더를 마이그레이션하는 경우의 실행 예 :> . \ DCMigrator.exe "testfolder" "/ 공유/mig/testfolder/" --mirror ⏎
회사 ID, 사용자 ID, 비밀번호를 입력하라는 메시지가 표시되므로 순서대로 입력하고 Enter 키를 누릅니다.
Company ID: < 회사 ID> ⏎ User ID: < 사용자 ID> ⏎ Password: < 비밀번호> ⏎인증에 성공하면 데이터 마이그레이션이 시작됩니다.
데이터 마이그레이션이 완료되고 INFO Ended : 행이 출력되었는지 확인합니다.
(생략) 2023-11-30 11:03:53 INFO NewFolder (3 files) /mig/testfolder/ 2023-11-30 11:03:54 INFO NewFile (1.0K) /mig/testfolder/testfile3.txt (생략 ) 2023-11-30 11:03:54 INFO Total : 3.0K, 1 Folders, 3 Files 2023-11-30 11:03:54 INFO Uploaded : 3.0K, 1 Folders, 3 Files 2023-11-30 03:54 INFO Outdated : 0B, 0 Folders, 0 Files 2023-11-30 11:03:54 INFO Failed : 0B, 0 Folders, 0 Files 2023-11-30 11:03:54 INFO Ended : 1 30 11:03:54 (00h: 01m: 30s)데이터 마이그레이션이 완료되면 데스크톱에 'logs' 폴더가 만들어지고 업로드 실행 결과가 로그 파일에 기록됩니다. 로그 파일에 대한 자세한 내용은 DCMigrator 실행 로그 및 오류 로그를 확인하는 방법을 참조하십시오.
DCMigrator 명령 옵션
옵션
설명
–-mirror
대상 폴더를 원본과 동일한 상태로 만듭니다. 하위 폴더가 있는 경우 해당 폴더도 처리 대상이 됩니다.
대상에 존재하지 않는 데이터는 새로 업로드됩니다.
대상에 작성 날짜 또는 갱신 날짜 및 시간이 다른 파일이 저장된 경우 겹쳐씁니다.
이름, 작성일시, 갱신일시가 모두 같은 파일이 보존되고 있는 경우, 처리는 스킵 됩니다.
대상에 원본에 없는 데이터가 있는 경우 대상 데이터가 삭제됩니다.
--print-outdated-files
"--mirror"와 이 옵션을 사용하여 DCMigrator.exe 명령을 실행하면 마이그레이션 대상에 동일한 파일 이름, 작성 날짜 및 시간, 업데이트 날짜 및 시간 파일이 있으므로 처리를 건너뛴 경우 "Outdated <path >' 형식으로 로그가 기록됩니다.
--max-worker=<스레드 수>
업로드할 때 PC 한 대에서 처리할 스레드 수를 지정할 수 있습니다. 표준 스레드 수는 16개이지만 이 옵션을 지정하면 최대 30개까지 늘릴 수 있습니다. 그러나 스레드 수에 30을 지정한 경우 제대로 작동하려면 다음을 확보해야 합니다.
충분한 메모리(RAM)
고속 CPU
처리 속도가 빠른 디스크(SSD 등)
DCMigrator가 제대로 작동하지 않으면 "--max-worker" 옵션의 숫자를 낮추고 다시 실행하십시오.
--upload_timeout=<초>
시간 초과 시간을 지정할 수 있습니다. 최대 60개까지 지정할 수 있습니다.
데이터 마이그레이션
데이터 마이그레이션 테스트에 사용한 명령을 수정하고 실제 데이터를 마이그레이션합니다. 예를 들어 D 드라이브의 수동 폴더를 DirectCloud의 공유 > 수동 폴더로 마이그레이션하는 경우 다음과 같이 실행합니다.
다음 명령 형식에서 실제 폴더를 업로드하는 명령을 실행합니다.
> . \ DCMigrator.exe "D: \ 매뉴얼" "/공유/매뉴얼/" --mirror ⏎데이터 마이그레이션을 테스트하고 자격 증명을 입력하고 명령을 실행하면 실행한 DCMigrator.exe가 있는 폴더에 세션 정보가 기록된 DCMigrator.session 파일이 만들어집니다. 이 파일이 있는 상태에서 명령을 실행하면 자격 증명을 입력할 필요가 없습니다.
데이터 마이그레이션이 완료되고 "INFO Ended:" 행이 출력되었는지 확인합니다. 대상에 DirectCloud 루트 폴더('공유' 폴더)를 지정하면 'INFO Total'에 '0B'가 표시됩니다.
(생략) 2023-11-30 11:23:15 INFO Total : 147.2M, 7 Folders, 43 Files 2023-11-30 11:23:15 INFO Uploaded : 147.2M, 7 Folders, 43 Files1-20 11:23:15 INFO Outdated : 0B, 0 Folders, 0 Files 2023-11-30 11:23:15 INFO Failed : 0B, 0 Folders, 0 Files 2023-11-30 11:23:15 INFO Ended 11-30 11:23:15 (00h: 00m: 13s)
Last updated