wish me luck

그누보드5가 나온지도 어느덧 수년이 흘렀다.

그러나 그보다 이전에 그누보드로 만들어진 사이트들은 그누보드4가 대부분이며

그중에는 utf-8도 있겠지만 euc-kr로 만들어진 사이트도 많이 있다.

이러한 사이트들이 사이트 리뉴얼을 하는 등의 이유로 그누보드5로 넘어와야 할 수 있는데 그동안 쌓인 게시판 글 등 DB문제로 골머리를 앓는 사람도 있을 것이다. 이번 포스팅에서는 그누보드4에서 그누보드5로 이전하는 방법에 대해 알아보겠다.

다행히 그누보드5에서는 그누보드4에서 쉽게 이전할 수 있도록 방법을 제공하고 있어서 크게 어려운 점은 없을 것이다.

이 글에서 사용하는 버전

그누보드4 : 4.37.38 (euc-kr)

그누보드5 : 5.2.9.8 (utf-8) // 그누보드5는 euc-kr을 지원하지 않으므로 무조건 'utf-8' 이다.

버전은 어느 것을 사용하던 자유이다.

이 글을 보고 실전에 바로 사용하는 것은 권하지 않으며, 연습용 사이트에서 충분히 연습해보고 사용하길 권장한다.

우선, 옮겨야할 사이트를 보겠다. 총 3개의 게시판으로 이루어져 있으며 게시글은 그림과 글로 작성되있다.

이제 하나씩 해보도록 하자.

먼저 그누보드4의 DB를 백업한다.

필자는 phpmyadmin에서 백업을 했다. 

혹시 phpmyadmin에 접근하는 방법을 모르겠다면, 호스팅한 사이트에서 찾아보도록 한다. ex) 닷홈일경우 : 마이닷홈 -> 상세보기 -> 제공내역

phpMyAdmin에 접속하면 아래와 같은 화면이 보일텐데 빨간색 네모를 클릭해준다.

여기서 g4_로 보이는 것들이 그누보드4의 데이터베이스들이다. 

※ xe로 시작하는 것들은 XE(前, 제로보드)의 DB이다. 필자가 XE도 같이 사용해서 보이는 것이며 그누보드만 쓰는 이들에게는 없을 것이다.

아무튼 이 화면에서는 내보내기(export)를 눌러준다.

내보내기 방법으로는 '퀵, 커스텀' 2가지가 있는데 대부분의 경우 퀵을 사용해도 상관없으나 

필자와 같이 제외하고 싶은 DB 테이블이 있다면 커스텀을 사용해서 체크를 해제해줘야한다.

그누보드5는 utf-8을 쓰기 때문에 파일 문자셋은 utf-8로 설정한다. (아마 자동으로 설정되었을 것이다.)

이외의 것들은 특별한 경우가 아니면 건드리지 않아도 되며 실행버튼을 눌러준다.

'실행' 버튼을 누르면 sql 확장자의 파일이 다운받아진다.

이제 그누보드5를 설치한다.

(그누보드5의 설치순서는 크게 상관이 없으나 그누보드4의 DB를 옮기기 전에는 어떠한 DB관련 작업도 해서는 안된다.)

설치를 할때는 MySQL 정보를 정확히 입력해준다.

그누보드5 설치를 완료했다. 그러나 빈 껍데기만 있을 뿐 게시글이 존재하지 않는다.

이제 본격적으로 그누보드4에서 작성되었던 DB들을 옮기기 시작한다.

phpMyAdmin 에서 가져오기(import)를 눌러주고 파일 선택을 클릭하여 이전에 다운받은 DB 파일을 선택한 후 실행을 눌러준다.

만약 이런 오류가 발생한다면 당황하지 않고, g4_로 시작하는 테이블들을 지워준 후 다시 실행한다.

그러면 이렇게 2가지 버전의 DB가 동시에 존재하게 된다.

다음으로는 그누보드4의 config.php 파일을 그누보드5로 복사한다. 위치는 자유이며 필자는 g4conf 라는 디렉터리(폴더)를 만들어서 그 안에 넣었다.

넣기 전에 반드시 config.php 를 utf-8로 인코딩해주고 코드도 수정해준다.

이제 그누보드5 안에 포함되있는 DB 이전 프로그램을 사용할 차례이다.

접근 방법은 그누보드5에 접속한 주소 뒤에 /g4_import.php를 추가하여 접속한다.

※ 관리자 아이디로 로그인 되있어야한다.

ex) http://도메인/g5/g4_import.php

아래와 같은 화면이 보인다면 성공이다.

이제 config.php 파일 경로를 상대경로로 지정해주고 확인 버튼을 누른다.

아래와 같은 화면이 보여야한다.

그리고 그누보드5 로 가보니 글은 있는데 그림이 없다.

왜냐하면 DB만 옮겼고 이외의 것들이 오지 않았기 때문이다.

그누보드4 에서 /data/file 안에 것들을 모두 그누보드5 의 /data/file 안으로 복사한 후 다시 접속해보면

아래처럼 그림까지 모두 출력되는 것을 볼 수 있다. 

※ 게시판들의 table 명이 같아야하며 table명이 다르다면 file 안의 디렉터리 이름을 변경해주면 된다.

XpressEngine (eXpress+press+Engine, 구 제로보드 XE)

: LGPL 기반 오픈 프로젝트로, 제로보드 4나 zb5와는 별개로 완전히 새로 개발한 웹 프레임워크이다.

제로보드의 다음 버전이라고 생각하면 될 것 같고 우리나라의 대표적인 CMS 툴 중 하나이다.

※ XE 외에 CMS툴은 그누보드와 워드프레스가 있다.

이번에 포스팅할 내용은 XE의 설치방법이며 FTP 서버를 활용하겠다.

https://www.xpressengine.com/

먼저 XE 홈페이지에 들어가서 다운로드 메뉴를 클릭한다.

그리고 XE Core를 다운로드해준다. XE Core는 XE사이트의 기본 틀이다.

설치가 완료되면 압축을 풀면 되고 이렇게 여러 파일들이 XE 폴더에 있는 것을 볼 수 있다.

그리고 자신의 FTP 서버에 파일들을 올려준 뒤 다운받은 링크로 이동하면 아래와 같은 설치 화면이 나타난다.

필자는 FTP 정보 입력이 이미 되있어서인지 생략됬는데 해당 페이지가 보이면 정보를 입력해주면 되며

아래의 화면에서는 자신이 사용하면 DB를 선택하면 되는데 필자는 mysql을 사용했다.

DB에 대한 정보 입력을 하면 되는데 이때 호스팅을 한 사이트에서 정보를 확인해가며 입력한다.

DB 호스트네임은 모르겠다면 localhost를 사용하면 될 것이다.

DB Port와 테이블 접두사는 그대로 사용되도 된다.

이메일 주소, 비밀번호 등은 이번에 새로 만든다는 느낌으로 만들어주면 된다.

설치가 정상적으로 완료되면 아래와 같이 화면이 나타날 것이다.

지난 포스팅에서는 모달팝업(레이어팝업)을 다뤘었다.

모달(레이어) 팝업 : http://wishml.tistory.com/45

이번에 다룰 팝업은 잠깐 언급했었던 window.open() 을 이용한 팝업이다.

사실 이 방법은 필자는 별로 좋아하지 않는다. 왜냐하면 팝업이 차단되면 팝업창을 사용할 수 없기 때문이다.

그래도 알아두면 좋으니 계속 이어나가겠다.

이 방법은 '일반 페이지 + 팝업창 갯수' 만큼의 파일을 필요로 한다.

A 페이지와 B 페이지가 있다고 했을 때, A는 부모창, B는 자식창(팝업창) 이라고 생각하면 될 것 같다.

이번에도 역시 닫기 버튼이 있으며 오늘 하루 이 창 열지 않음 버튼을 클릭시 쿠키가 생성 및 유지되어 열리지 않는다.

window_popup_ex.zip

window.open()을 이용한 팝업을 이용할 경우 브라우저에서 팝업을 차단했을 때 열리지 않는다.

window.open 팝업 : http://wishml.tistory.com/46

그래서 요즘은 모달(레이어)팝업 이라고 하는 것을 많이 쓰는데 사용 방법을 공유하겠다.

여기서 사용하는 것은 html, css, javascript 그리고 jquery와 쿠키유지를 하기 위해서 제이쿼리 플러그인 중에서 쿠키 플러그인을 사용하겠다.

팝업창이 이렇게 있을 때 닫기버튼을 누르면 팝업창이 사라지고, 

'오늘 하루 이 창 열지 않음' 버튼을 클릭하면 하루동안 쿠키가 유지되어 팝업창이 나타나지 않는다.

예제를 통해 직접 다뤄볼 수 있도록 파일을 첨부했으며 조금만 수정하면 실제 사이트에서 바로 적용이 가능하다.

popup_ex.zip

그누보드를 설치 할 때 아래의 과정을 거쳐야한다.

그리고 가끔 이런 문구를 만날 수 있다.

Warning: mysqli_connect(): (HY000/1045): Access denied for user '(아이디)'@'localhost' (using password: YES) in (경로)/lib/common.lib.php on line 1435

Connect Error: Access denied for user '(아이디)'@'localhost' (using password: YES) 

mysqli_connect(): (28000/1045) 이든 mysqli_connect(): (HY000/1045) 이든 대부분의 경우 DB의 아이디와 비밀번호가 틀렸을 때 이 페이지를 볼 수 있다.

직접 서버를 만들었다면 DB 아이디를 다시 한번 확인해줘야 하며 웹호스팅의 경우에는 호스팅한 업체(사이트)에서 다시 한번 확인해야한다.

(닷홈)

이처럼 호스팅 업체에서 사이트의 DB정보를 볼 수 있다.

간혹 웹호스팅을 신청하고 생성할 때 DB 설치를 하지 않는 곳도 있는데 이런 경우에는 DB를 새로 만들어 줘야한다.

(호스팅어)

+ 가비아(Gabia)를 사용할 경우 조금 다르다.

이처럼 host 와 DB 앞에 db를 추가해줘야 한다. 

ex)

Host : db.abc.com

User : aaa

Password : pass123

DB : dbaaa

mysql를 이용해 만든 DB 데이터를 다른 서버나 컴퓨터로 옮기는 방법은 여러가지가 있다.

대표적인 예시로는 콘솔을 이용하는 방법과 workbench에서 하는 방법이 있으며,

이번에 다루는 방법은 workbench를 사용하는 방법이다.

workbench를 사용하면 콘솔 사용법을 모르더라도 쉽게 따라할 수 있다는 장점이 있다.

DB를 옮기는 방법은 아래와 같다.

MySQL DB 옮기기

먼저 MySQL Workbench를 실행 시키면 아래와 같은 화면이 나올 것이다.

지금부터 옮길 파일의 스키마는 test_db 인데 예시를 위해 간단하게 데이터를 입력시켜 두었다.

왼쪽에 보면 Data Exprot 라는 것이 보일텐데 이것을 클릭해주면 해당 페이지로 이동한다.

여기서 우리가 옮길 것은 test_db 안의 test_db_table이다. 

test_db 안에 다른 테이블이 있었다면 추가로 표시됬을텐데 현재는 1개의 테이블만 보이는 모습이다.

Export to Dump Project Folder를 이용하여 파일을 저장하고자 하는 폴더를 선택한다.

필자는 DB_BACKUP 디렉토리를 만들어 사용했다.

Start Export 버튼을 누르면 백업파일이 만들어 진다.

(백업 파일)

이제 백업파일을 사용할 차례인데 이때는 Data Import/Restore를 선택한다.

Import form Self-Contained File 를 선택하여 백업하고자 하는 sql 파일을 선택하고

어떤 스키마로 넣을 것인지 선택한다. 여기서는 test_db2 스키마를 New... 를 이용하여 새로 만들었다.

이때 구조만 가져올지 데이터를 가져올지 둘다 가져올지를 고를 수 있는데

둘다 선택하겠다.

Start Import 를 누르면 test_db2 스키마에 test_db_table이 생겼고 구조와 데이터 모두 복사된 것을 알 수 있다.

이것으로 Workbench를 이용한 MySQL DB 이전 및 백업 방법을 마치겠다.

앞서 관계형 dbms의 종류에 대해 포스팅한 적이 있다.

이번에 다룰 프로그램은 오픈소스의 장점을 가진 MySQL 이다.

MySQL 다운로드 하기

먼저 아래 링크로 이동한다.

https://dev.mysql.com/downloads/windows/installer/

특별한 사항이 없으면 계속 NEXT 버튼을 눌러주면 된다.

아래 사진의 화면에서는 필요한 프로그램을 다운 받으면 되는데 굳이 할 필요가 없다면 넘어가도 좋다.

여기서부터 중요하다.

관리자 계정의 패스워드를 설정해야 하며

추가로 Add User를 선택하여

root계정 외에 사용자 아이디를 추가할 수 있다.

실제 애플리케이션에서 root 계정으로 접속하기보단 추가로 만든 사용자 아이디에 적절한 권한을 부여하여 접속할 것을 추천한다.

(귀찮으면 root 를 사용해도 된다 ㅎ)

마지막으로 설정한 비밀번호를 입력하면 실행될 것이다.

+

사실 처음에 설치를 할 때는 몇몇 오류가 발생했다. 

MySQL Server 의 설치를 실패하는 것이었는데

프로그램을 삭제도 해보고 레지스트리 정리도 해보았으나 결국 안되었고 이것저것 만지다보니 해결했다.

아래는 문제의 오류 사진이다.

이처럼 설치도 안되고 무시하고 넘어가니 설치 과정에서 계속 오류가 발생한다.

이 상태로 접속하면 연결(connect)이 되지 않고 스키마도 생성이 안된다.

설치가 안되는 이유를 찾아보니 윈도우의 bit 문제라는 말이 있었는데

이제부턴 필자가 해결한 방법을 알아보자.

MySQL server failed 오류 해결 방법

앞서 다운받은 installer 를 다시 실행시키면 아래와 같을 것이다.

추가로 프로그램들을 다운받을 수 있는 것인데 add를 선택한다.

그리고 설치하지 못한 MySQL Servers로 들어가서 자신에게 맞는 것을 선택하여 설치한다.

자신의 windows운영체제가 32bit는 X86, 64bit는 x64 이며 필자는 이미 다운 받아서 x64비트가 없는 모습이다.

여기서 다시 오류가 발생한다면 아래의 파일을 다운 받고 다시 해보도록 한다.

vcredist_x64.exe

(이미 다운 받아서 '복구/ 제거/ 닫기' 가 보인다.)

이것은 오랜 검색 끝에 어떤 사이트에서 발견한 것인데, 필자는 이것을 먼저 설치하고 위의 과정대로 했다.

이제 다시 설치해보면 이 글의 과정처럼 설치가 잘 될 것이다.

아파치 톰캣(Apache Tomcat)은 웹 서버 소프트웨어의 하나이며, 

'서블릿 컨테이너' 라고도 한다.(서블릿과 JSP를 실행할 수 있는 환경을 말한다.)

[Apache Tomcat] 다운로드 방법

자신에게 필요한 버전을 받으면 되며, java JDK 버전과 일치해야하는데

eclipse 에서 [window] - [Preferences] - [Server] - [RunTime]에 들어가서 add를 눌러보면 톰캣이 어디까지 지원하는지 확인할 수 있다. 

설치 과정에서는 계속 next 를 누르면 되며 아래와 같은 화면일 때는 jdk의 경로를 입력한다.

톰캣을 실행한 뒤 http://localhost:8080/ 에 접속했을 때 아래와 같은 화면이 나와야 하며 설치 과정에서 [HTTP/1.1 Connector port] 을 변경했다면 8080 대신 설정한 번호를 사용하면 된다.

그리고 필요하다면 환경 변수 설정을 할 수 있는데,

[내컴퓨터] - [속성] - [고급 시스템 설정] - [환경 변수]에서 설정할 수 있다.

톰캣이 설치된 경로를 복사하여 환경변수를 설정할 때 사용한다.

[새로만들기]를 눌러서 변수 이름과 변수 값을 만들고 [path]를 눌러서 환경변수 편집 창을 띄운 뒤 추가해주고 위로 올려준다.

이클립스는 노트패드나 에디트 플러스와 같은 단순한 편집기가 아니기 때문에 툴에 대한 적응기간이 필요하며, 구조는 단순하나 복잡한 숨은 기능이 많이 있다.

이클리스는 이클립스 홈페이지에서 다운받을 수 있다.

https://www.eclipse.org/downloads/

다운받은 프로그램을 실행하면 아래와 같다.

각자 용도에 맞는 프로그램을 다운받으면 되는데 JSP 사용을 위해 다운받을 프로그램은 'Eclipse IDE for EE Developer' 이다.

설치를 완료했으면 기본적으로 설정해야할 것이 있다.

꼭 해야하는 건 아니기 때문에 필요하지 않다면 생략해도 된다.

[Window] -> [Preference]를 선택하면 이클립스의 옵션들을 조정할 수 있는데 기본적인 설정들은 General 항목 아래에 있다.

( [Show line numbers]를 선택하면 행 번호가 표시된다. )

( 텍스트 인코딩 값을 설정할 수 있다. )

( JSP와 관련된 기본 인코딩 설정을 변경할 수 있다. )

( HTML 파일 인코딩 설정 )

( JSP 파일 인코딩 설정)

그누보드를 사용하면서 alert 경고창으로 이런 문구를 본 적이 있을 것이다.

'정상적으로 로그인하여 접근하시기 바랍니다.'

이것은 그누보드의 관리자 화면에 접속할 때 몇몇 사람들에게 생기는 현상인데 처음 접한 사람이라면 당황할 수 밖에 없을 것이다.

뿐만 아니라 관리자 화면에 접속하고서도 메뉴 등 버튼을 눌렀을 때 로그아웃 되는 현상이 발생할 수 있다.

이것에는 여러가지 이유가 있을 수 있으나 필자가 해결한 방법은 아래와 같다.

우선 필자는 처음에 데스크톱으로 ftp를 활용하여 서버에 그누보드를 설치했는데 다른 PC와 노트북으로 사이트에 접속하여 adm페이지, 관리자화면에 접속했을 때 오류가 발생하였다.

'정상적으로 로그인하여 접근하시기 바랍니다' 라는 경고창의 소스는 admin.lib.php 파일에서 찾을 수 있는데 이를 통하여 오류의 발생 원인 또한 이 파일에 있다는 것을 알 수 있다. 참고로 admin.lib.php 파일은 gnuboard/adm 폴더에 있다.

문제가 발생하는 원인을 추측해보자면 누군가가 해킹 등 나쁜 목적으로 관리자 페이지에 접근하는 것을 막기 위해 관리자 pc와 정보가 다를 때 접근을 막는 것이 이러한 문제를 일으키는 것 같다.

해결 방법

: 오류의 원인이 되는 소스를 삭제, 변경하거나 주석처리한다.