[워드프레스] Duplicator 이전 실패 - 'INSTALL ERROR!'

Duplicator는 로컬에서 작업한 워드프레스 사이트를 그대로 실제 웹호스팅 사이트로 이전하거나 테스트 사이트에서 작업한 내용을 실제 운영할 사이트로 쉽게 이전(마이그레이션)이 가능한 유용한 플러그인입니다.

하지만 다양한 요인에 의해 Duplicator를 사용한 자동 이전 방식이 실패할 수 있습니다.

1. 웹호스팅 서버의 설정이 Duplicator에서 요구하는 사양과 맞지 않는 경우가 많습니다.
2. 데이터 파일이 너무 큰 경우에 압축이 제대로 되지 않을 수 있습니다.
3. DB 파일이 너무 큰 경우에도 이전에 실패합니다.

또, 이전 사이트와 새로운 사이트 사이의 PHP 버전, MySQL 버전 등의 차이로 인해서도 실패할 수 있습니다.  오류가 발생할 때에는 다양한 메시지가 표시될 수 있습니다.

INSTALL ERROR!
Failed to open zip archive file. Please be sure the archive is completely downloaded before running the installer. Try to extract the archive manually to make sure the file is not corrupted.

또는

INSTALL ERROR!
Failed in extracting zip file. Please be sure the archive is completely downloaded. Try to extract the archive manually to make sure the file is not corrupted.

경험상 Duplicator에서 실패하더라도 문제를 분석하여 원인을 찾아내면 해결되는 경우가 많았습니다. 원인은 여러 가지가 있을 수 있습니다. 서버 자체의 설정 때문에 Duplicator 사용이 제한되는 경우(예: Root Directory Fail)도 있습니다. Character Set 문제로 인해 실패하는 경우(Deploy 오류)도 있습니다. 모든 문제에서와 마찬가지로 원인을 제대로 파악해야 빠른 해결이 가능합니다. 이를 위해서는 경험이 도움이 될 수 있고 install-log 파일을 잘 파악하여 올바르게 대응하는 것이 중요할 것 같습니다.

Duplicator를 이용한 자동 이전(마이그레이션) 방식이 실패하면 수동으로 이전을 시도해보시기 바랍니다.

1. 데이터 파일을 백업합니다.
2. DB를 백업합니다.
3. 새로운 사이트에 데이터 파일을 업로드합니다.
4. 새로운 사이트에서 DB를 Import합니다.
5. wp-config.php 파일에서 DB 정보를 수정합니다.
6. DB에서 정보를 적절히 수정합니다(이전 URL -> 새로운 URL).

대강 위와 같은 방식으로 진행하면 됩니다. 카페24 등 일부 웹호스팅 업체에서는 데이터 파일과 DB를 쉽게 백업할 수 있는 기능을 제공합니다. 데이터 파일을 업로드하는 방법은 FTP를 사용하여 덮어쓰기하는 방식으로 이루어집니다. DB를 임포트하는 방법은 phpMyAdmin을 사용하면 됩니다.

phpMyAdmin을 통해 Import할 수 있는 DB의 크기는 이용하는 웹호스팅 서비스에 따라 50MB에서 약 100MB 사이입니다. (Import할 수 있는 크기가 너무 작은 경우 upload_max_filesize 설정을 변경해보시기 바랍니다.) 가령 현재 이 블로그가 호스팅되고 있는 Bluehost VPS에서 phpMyAdmin을 통해 최대 105MB까지 DB를 Import(가져오기)가 가능한 것으로 표시되네요. phpMyAdmin을 통해 DB를 업로드할 수 없는 경우에는 SSH에서 DB를 Import합니다.

가령 다음과 같은 명령으로 DB를 Export(내보내기)할 수 있습니다.

mysqldump -p -u username database_name > dbname.sql

그리고 DB를 Import(가져오기)하려면 다음 명령을 SSH에서 사용할 수 있습니다.

mysql -p -u username database_name < file.sql

개별 테이블을 임포트하는 경우:

mysql -u username -p -D database_name < tableName.sql

이전 과정에서 문제가 발생하는 경우 문제의 원인을 파악하여 해결을 시도해보고, 잘 해결이 안 되면 수동 이전 절차를 시도해보시기 바랍니다. 그래도 잘 안 되는 이 페이지에서 서비스(유료)를 의뢰하실 수 있습니다.

참고:

• 워드프레스 사이트 마이그레이션 플러그인 – Super Backup & Clone – Migrate for WordPress