최근 라이트세일 PHP 업그레이드를 진행하면서 기존 워드프레스 데이터를 새 인스턴스로 이전하는 작업도 같이 진행했습니다. 일반 호스팅처럼 버튼만 누르면 끝나는 구조가 아니라 Bitnami 기반 OpenLiteSpeed 환경 자체를 새로 옮겨야 했기 때문에 생각보다 확인할 부분이 많았습니다.
특히 OpenLiteSpeed와 Bitnami 조합은 일반 Apache 단독 서버와 설정 위치가 다르게 나뉘는 경우가 많았습니다. 단순 복원만으로 끝나는 것이 아니라 Authorization 헤더, .htaccess, Apache 모듈, 캐시 동작 여부까지 다시 점검해야 정상적으로 운영할 수 있는 상태가 됐습니다.
목차
백업 전에 먼저 확인했던 부분
인스턴스를 새로 생성하기 전에 가장 먼저 확인했던 것은 백업 안정성이었습니다. 라이트세일 PHP 업그레이드 과정에서는 예상하지 못한 복원 오류가 발생할 수 있기 때문에 기존 인스턴스 스냅샷까지 함께 만들어 두는 것이 안전했습니다.
특히 이미지 파일이 많은 워드프레스 사이트는 복원 중 일부 파일이 누락되는 경우가 있어서 업로드 폴더 백업 여부도 같이 확인하는 편이 좋았습니다.
UpdraftPlus 플러그인을 설치하는 화면입니다. 라이트세일 PHP 업그레이드 과정에서는 데이터 이전 전에 워드프레스 전체 백업을 먼저 진행하는 것이 중요했습니다.
특히 이미지가 많은 사이트는 DB만 백업하면 복원 후 미디어 파일이 깨질 수 있기 때문에 uploads 폴더 포함 여부까지 같이 확인해야 했습니다. 백업이 정상적으로 완료되지 않으면 관리자 화면 오류나 일부 게시물 이미지 누락으로 이어질 수 있었습니다.
새 인스턴스를 생성할 때 같이 확인했던 설정
라이트세일은 새 인스턴스를 생성한 이후 바로 접속되지 않는 경우가 있기 때문에 생성 직후에는 몇 분 정도 기다리는 과정이 필요했습니다. 기존 인스턴스를 삭제하기 전에 새 인스턴스가 정상 실행되는지 먼저 확인하는 흐름으로 진행하는 것이 안전했습니다.
라이트세일에서 새 워드프레스 인스턴스를 생성하는 화면입니다. 특히 라이트세일 PHP 업그레이드를 위해서는 기존 인스턴스를 수정하는 방식보다 새 버전 인스턴스를 생성한 뒤 데이터를 이전하는 구조가 안정적인 경우가 많았습니다.
인스턴스를 잘못 삭제하면 복구 시간이 오래 걸릴 수 있기 때문에 기존 서버는 유지한 상태로 테스트하는 흐름이 중요했습니다.
Bitnami 비밀번호를 찾는 과정에서 헷갈렸던 부분
새 인스턴스를 만들고 가장 먼저 필요한 것은 Bitnami 관리자 비밀번호였습니다. 관리자 로그인 자체가 되지 않으면 복원 작업을 진행할 수 없기 때문입니다.
Bitnami 환경에서는 SSH 접속 후 명령어로 비밀번호를 확인하는 구조라 일반 호스팅과 방식이 조금 달랐습니다.
SSH에서 cat bitnami_application_password 명령어를 실행해 Bitnami 초기 비밀번호를 확인하는 화면입니다. 라이트세일 Bitnami 환경에서는 초기 워드프레스 관리자 비밀번호를 SSH에서 직접 확인해야 합니다.
이 과정을 놓치면 관리자 로그인 자체가 되지 않아 복원 작업이 중단될 수 있습니다. 이 부분 역시 라이트세일 PHP 업그레이드 과정에서 처음 진행하면 헷갈릴 수 있는 부분이었습니다.
인증 헤더가 없습니다 오류가 발생했던 원인
복원을 마친 뒤 가장 먼저 확인된 문제는 워드프레스 사이트 건강의 “인증 헤더가 없습니다” 경고였습니다. 처음에는 REST API 오류처럼 보였지만 실제 원인은 Authorization 헤더 전달 누락 문제였습니다.
OpenLiteSpeed와 Bitnami 조합에서는 이 설정이 기본적으로 빠져 있는 경우가 있었습니다. 특히 라이트세일 PHP 업그레이드 이후 새 인스턴스로 옮기면 기존 설정이 같이 넘어오지 않는 경우도 있었습니다.
특히 Bitnami 기반 OpenLiteSpeed 환경에서는 서버 설정 일부가 초기화되는 경우도 있기 때문에 라이트세일 PHP 업그레이드 이후 사이트 건강 상태를 다시 확인하는 과정이 중요했습니다.
htaccess.conf 파일을 수정했던 이유
문제를 해결하기 위해 Bitnami 워드프레스 설정 폴더 안에 있는 htaccess.conf 파일을 직접 수정했습니다. 일반 Apache 서버와 다르게 Bitnami는 설정 파일 위치가 나뉘어 있기 때문에 기존 워드프레스 경험만으로 접근하면 경로를 찾기 어려운 경우가 많았습니다.
FileZilla에서 Bitnami 워드프레스 conf 폴더 내부의 htaccess.conf 파일을 찾는 화면입니다. 인증 헤더 문제는 단순 워드프레스 설정이 아니라 서버 레벨 설정에서 발생하는 경우가 많았습니다.
따라서 WordPress 관리자 화면이 아니라 실제 서버 설정 파일 수정이 필요했습니다.
Authorization 헤더를 추가했던 설정
htaccess.conf 파일 가장 상단에 Authorization 헤더 전달 코드를 추가하자 사이트 건강 경고가 사라졌습니다. 이 과정은 REST API 요청 처리와도 연결되기 때문에 일부 보안 플러그인이나 API 인증 구조에도 영향을 줄 수 있었습니다.
htaccess.conf 상단에 SetEnvIf Authorization “(.*)” HTTP_AUTHORIZATION=$1 코드를 추가한 화면입니다. 이 설정이 빠져 있으면 워드프레스 REST API 요청이 정상 처리되지 않을 수 있으며, 사이트 건강 경고와 인증 오류가 발생하는 경우도 있습니다.
.htaccess 리다이렉트가 동작하지 않았던 이유
IP 주소 접속 차단 리다이렉트를 넣었는데 제대로 작동하지 않는 문제가 있었습니다. 원인을 확인해보니 AllowOverride가 비활성화되어 있어서 .htaccess 규칙 자체를 읽지 못하고 있었습니다.
OpenLiteSpeed와 Bitnami 환경에서는 이 부분이 기본적으로 막혀 있는 경우가 있었습니다. 특히 라이트세일 PHP 업그레이드 이후 새 인스턴스로 이동하면 기존 리다이렉트 규칙이 무시되는 경우도 있었습니다.
httpd-app.conf 내부의 AllowOverride 설정을 All로 변경한 화면입니다. 이 항목이 None 상태이면 .htaccess 리다이렉트 규칙이나 캐시 규칙이 정상적으로 동작하지 않을 수 있습니다. 특히 IP 리다이렉트나 보안 차단 규칙이 무시되는 경우가 발생할 수 있습니다.
Apache 모듈 활성화도 같이 확인했던 이유
Expires Headers가 제대로 적용되지 않는 경우도 있었는데, 확인해보니 Apache 모듈 자체가 비활성화된 상태였습니다. 캐시 플러그인을 사용하더라도 서버 모듈이 비활성화되어 있으면 만료 헤더가 정상적으로 추가되지 않을 수 있었습니다.
Apache httpd.conf 파일에서 expires_module 과 headers_module 활성화 상태를 확인하는 화면입니다. 이 모듈이 비활성화되어 있으면 브라우저 캐시 최적화가 제대로 적용되지 않을 수 있으며, PageSpeed 점수나 Core Web Vitals에도 영향을 줄 가능성이 있습니다.
브라우저 캐시와 expires 헤더 문제는 라이트세일 PHP 업그레이드 이후 서버 환경이 바뀌면서 같이 발생하는 경우도 있기 때문에 Apache 모듈 활성화 여부를 다시 확인하는 편이 안전했습니다.
고정 IP 연결 과정에서 주의했던 부분
새 인스턴스 복원이 끝났다고 바로 기존 인스턴스를 삭제하면 위험할 수 있었습니다. 고정 IP 연결이 정상적으로 바뀌는지 먼저 확인해야 기존 도메인 접속이 끊기지 않았습니다.
라이트세일 네트워킹 메뉴에서 고정 IP를 새 인스턴스로 연결하는 화면입니다. 고정 IP 연결이 늦게 반영될 경우 일시적으로 기존 서버와 새 서버가 섞여 보이는 현상이 발생할 수도 있었습니다. DNS 반영 시간을 고려해 여유를 두고 확인하는 것이 안전했습니다.
적용 후 체감됐던 변화
설정을 모두 마친 이후에는 사이트 건강 오류가 사라졌고, 일부 REST API 요청 문제도 함께 해결됐습니다. 특히 .htaccess 리다이렉트가 정상 작동하면서 IP 직접 접속 문제도 정리됐고, 캐시 응답도 이전보다 안정적으로 유지되는 느낌이 있었습니다.
이미지 깨짐 문제 역시 uploads 폴더를 직접 복사하면서 해결할 수 있었고, 전체적으로 관리자 화면 반응 속도도 안정화된 상태로 돌아왔습니다. 전체적으로 보면 이번 라이트세일 PHP 업그레이드 과정은 단순 PHP 변경이 아니라 서버 설정 전체를 다시 점검하는 작업에 가까웠습니다.
특히 라이트세일 PHP 업그레이드 이후 이전보다 관리자 화면 반응 속도가 안정적으로 유지됐고, 일부 캐시 충돌 문제도 함께 줄어든 느낌이 있었습니다.
관련 설정 팁
- Bitnami 환경은 일반 Apache 경로와 설정 위치가 다를 수 있음
- AllowOverride 설정이 막혀 있으면 .htaccess 규칙이 무시될 수 있음
- REST API 오류는 Authorization 헤더 누락 문제인 경우가 있음
- 캐시 플러그인만 설정해도 서버 모듈이 비활성화되어 있으면 캐시가 정상 적용되지 않을 수 있음
- 인스턴스 이전 전 스냅샷 생성은 거의 필수에 가까움
