DEVINFO 데빈포 그누보드 포럼 쉽게 찾는 그누보드 실전 정보
BOARD

강좌·기초

BOARD 강좌·기초

그누보드 영카트 수동 패치 및 버전 관리 가이드

페이지 정보

profile_image
작성자 최고관리자
댓글 0건 조회 7회 작성일 26-10-09 17:23

본문

그누보드 영카트 수동 패치 및 버전 관리 가이드

그누보드와 영카트 운영 시 자동 패치를 지원하지 않아 수동 관리가 필요한 환경에서, 현재 버전을 확인하고 상위 버전 패치 파일을 단계적으로 안전하게 적용하는 방법을 알아봅니다.

그누보드 및 영카트 버전 확인 방법

그누보드와 영카트의 현재 버전은 관리자 페이지에 표시되지 않으며, 서버 소스 코드 파일을 통해 직접 확인할 수 있습니다.

확인 위치 및 방법

  • 확인 파일: /config.php 또는 /version.php 파일에서 확인할 수 있습니다.
  • 그누보드 5.0.33 버전 이후부터는 config.php 파일 상단에 버전 정보 상수가 추가되어 있습니다.
  • 해당 파일에서 아래와 같은 상수 정의 코드를 찾아 현재 설치된 버전을 파악할 수 있습니다.
    • define('G5_VERSION', '그누보드5');
    • define('G5_GNUBOARD_VER', '5.x.x');
    • define('G5_YOUNGCART_VER', '5.x.x');

예외 및 다음 행동

  • 만약 사용 중인 버전이 5.0.x 이하의 매우 오래된 버전이어서 관련 코드가 없다면, 소스 내에서 별도의 버전 정보를 찾기 어려울 수 있습니다.
  • 현재 버전을 정확히 파악해야 이후 상위 패치 파일을 선택하여 단계적으로 수동 업데이트를 진행할 수 있으므로, 패치 작업 전 반드시 서버에 접속하여 config.php 파일을 열어 확인해야 합니다.

SIR 공식 자료실 파일 구분 방법

SIR 공식 자료실 각 버전을 클릭하면 두 종류의 파일이 등록되어 있으며, 설치 목적에 따라 다음과 같이 구분하여 사용해야 합니다.

  • 전체 설치 파일 (위에 있는 파일): 그누보드를 새로 설치할 때 사용하는 파일입니다.
  • 패치 파일 (아래에 있는 파일): 기존에 설치된 버전을 상위 버전으로 업데이트할 때 사용하는 파일입니다. 새로 설치할 때는 패치 파일을 받을 필요가 없습니다.

확인 및 다음 행동

  • 새로 설치하는 경우가 아니라 기존 사이트를 업데이트하는 상황이라면, 패치 파일을 다운로드하여 단계별로 적용해야 합니다.
  • 현재 사용 중인 버전은 config.php 파일에서 확인할 수 있습니다.

그누보드와 영카트는 자동 패치 기능을 지원하지 않으므로, 운영자가 직접 수동으로 업데이트를 관리해야 합니다. 패치를 진행할 때 가장 최근 버전의 패치 파일 하나만 적용해서는 안 되며, 현재 사용 중인 버전에서 최신 버전까지 상위 버전으로 단계적이고 순차적으로 전부 진행해야 합니다.

중간 단계를 건너뛰고 최신 버전만 한 번에 적용할 경우, 이전 버전들에서 누적된 파일 구조 변화, 버그 수정, 보안 패치 및 필수 코드 변경 사항이 올바르게 반영되지 않아 시스템 오류나 파일 누락이 발생할 수 있습니다. 따라서 현재 버전을 확인한 뒤 상위 버전의 패치 파일을 하나씩 순차적으로 적용하여 시스템의 안정성을 유지해야 합니다.

수정한 적이 있는 파일의 패치 처리 방법

그누보드 패치 파일을 적용할 때, 원본 상태에서 조금이라도 수정한 적이 있는 파일은 무작정 덮어씌우면 안 됩니다. 수정한 파일은 덮어쓰기를 진행하는 대신 패치 상세 내역을 보고 변경된 내용을 직접 수정해야 합니다.

확인 및 처리 순서

  1. 사전 백업: 패치 작업을 진행하기 전 기존 파일을 PC에 별도로 백업해 둡니다.
  2. 파일 비교: 윈머지(WinMerge) 등의 파일 비교 프로그램을 이용하여 기존 파일과 패치 파일의 소스를 비교합니다.
  3. 변경 내역 반영: 각 버전별 본문 내용에 있는 깃허브 링크 주소의 상세 내역을 참고하여, 수정한 소스 코드에 변경된 내용을 직접 심어 넣습니다.

패치 전 사전 준비와 백업 방법

그누보드와 영카트 업데이트 패치 작업을 진행하기 전에는 문제가 발생했을 때 기존 상태로 안전하게 복원할 수 있도록 철저한 준비가 필요합니다.

필수 사전 백업

  • 패치를 진행할 때는 반드시 기존 파일 전체를 PC에 별도로 백업해놓고 진행해야 합니다.
  • 문제나 오류가 발생했을 경우 백업해둔 기존 파일로 원상 복구할 수 있는 유일한 안전장치입니다.
  • 홈페이지 전체 리뉴얼이나 대규모 업데이트 시에는 기존 홈페이지 파일 전체를 백업한 뒤 진행하는 것이 원칙입니다.

수정 파일 및 이력 관리

  • 패치를 몰아서 하더라도 어떤 파일을 수정했고 어느 부분을 수정했는지 쉽게 확인할 수 있도록 작업 노트를 준비하거나 백업본 폴더에 메모장 등으로 기록해 두는 습관이 필요합니다.
  • 수정 내역을 기록해 두면 시간이 오래 지난 후 패치를 진행할 때 손댄 적이 없는 파일과 직접 수정해야 하는 파일을 구분하기 수월해집니다.

그누보드 영카트 버전 업데이트 시 DB 변경사항 처리 방법

그누보드 버전 업데이트 진행 시, 기능 추가 및 개선사항이 적용된 버전에 따라 데이터베이스 업그레이드 기능을 함께 이용할 수 있다. 관리자 페이지의 환경설정 내 DB 업그레이드 기능을 통해 프로그램 버전과 데이터베이스 구조를 일치시킬 수 있다.

데이터베이스 업그레이드 진행 방법

  • DB 업그레이드 기능 활용: 버전 업데이트 진행 시 DB 업데이트를 같이 진행할 수 있도록 선택 항목이 추가된 버전을 사용하는 경우, 업데이트 버전에 맞는 DB 변경사항을 적용할 수 있다. 예를 들어 관리자 페이지에서 라디오 버튼 등으로 DB 업그레이드 사용 여부를 선택하여 수동으로 처리해야 하는 부분을 줄일 수 있다.
  • 수동 반영 및 관리: 기존 홈페이지 파일을 백업한 뒤 최신 그누보드 파일을 업로드하고 기존 데이터베이스를 그대로 설정한 상태에서, 관리자 페이지의 환경설정 내 DB업그레이드를 실행한다. 이후 백업한 파일의 코드를 새 파일에 다시 반영하는 방식으로 처리한다.
  • 주의 사항: 다운그레이드 시에는 해당 기능을 이용할 수 없으며 DB 변경사항이 원복되지 않는다. 또한 데이터 망실 가능성이 있으므로 작업 전 데이터베이스와 설정 파일을 반드시 백업해야 한다.

상황별 수동 패치 가이드

  1. 상황 확인: 자동 패치를 지원하지 않는 환경에서 보안 및 기능 개선을 위해 수동 업데이트가 필요한 경우
  2. 선택 기준 및 절차:
    • 버전 확인: /config.php 또는 /version.php 파일 상단의 G5_GNUBOARD_VER 상수를 통해 현재 버전 파악
    • 패치 적용: 현재 버전부터 최신 버전까지 상위 버전 패치 파일을 순차적으로 다운로드하여 단계별 적용 (최신 버전만 단독 적용 불가)
    • 파일 처리: 수정 이력이 없는 파일은 덮어쓰기, 수정 이력이 있는 파일은 윈머지(WinMerge)로 변경 내역 대조 후 직접 수정
  3. 다음 행동:
    • 작업 전 반드시 전체 파일 및 DB 백업 수행
    • SIR 공식 자료실에서 순차적 패치 파일 다운로드 및 적용
    • 관리자 페이지 환경설정 내 DB 업그레이드 실행 여부 확인

실전 FAQ

  • Q: 패치가 너무 많이 밀려 순차 적용이 어려운 경우 어떻게 하나요?
    • A: 현실적으로 감당하기 어렵다면 최신 버전 전체 설치 파일을 받아 사이트를 재구성하는 대안이 있습니다. 이때 기존 data 폴더와 DB는 유지하되, 커스텀 파일은 백업본과 대조하여 수동으로 이식해야 합니다.
  • Q: 수정 파일 식별이 어려운 경우 어떻게 하나요?
    • A: 과거 수정 이력을 기록해두지 않았다면, 현재 파일과 원본 패치 파일을 비교 프로그램(WinMerge 등)으로 일일이 대조하여 변경 사항을 찾아내야 합니다. 향후에는 별도의 작업 노트를 작성하는 습관을 권장합니다.

참고자료

기타 참고자료

댓글목록

등록된 댓글이 없습니다.