Yona 프로젝트 내에 있는 Wiki에 다양한 설명이 있다.

하지만, 중간 중간 업데이트를 하고,  실제 의견을 주고 받는 분들과 Wiki를 업데이트 하시는 분들은 Linux 기반으로 운영을 하는 것 같다 보니 내용이 많이 분산되어 있다.Wiki의 특징이 빠른 Hipher Link 구성이다 보니 여차하면 Link로 대체하는데 이게 내용 따라가는데 쉽지는 않다.

워낙 다양한 케이스와 설치 방법들이 있으니, 당연한 것인지도 모르겠다.
(더욱이 프로젝트를 계속 업그레이드 하는 중이라, 이 내용도 정확히 안맞을 수 있다.)

 

2019년 2월 19일 기준으로 설치시 고려해야 할 내용과 설치 과정들을 간단하게 설명하도록 한다.

 

준비물

  1. Yona 최신 버전.
    Yona 결과물은 압축 파일이 달랑 한개 있다. 물론 그 안에 많은 내용들이 담겨 있지만…Yona Github에서 Release를 통해서 다운로드 받으면 된다.
    (현재 v1.11.1 Hotfix까지 나왔으며, 설명 하단의 Link 를 통해 다운로드 받으면 된다. – yona-v1.11.1-bin.zip )
  2. MariaDB
    Yona에서 관리적인 모든 내용은 DB를 통해서 작성된다. 이 때 사용하는 DB가 MariaDB이다. 현재 Wiki 상의 MariaDB 다운로드 Link는 10.1 버전인데, 이게 오류가 있다. 최신 버전 Yona를 실행할 때, 버전에 맞지 않은 SQL을 실행한다는 오류가 발생하여 제대로 실행되지 않는다.
    반드시, 10.3 버전을 다운로드 받는다. -
  3. 설치 위치 구성.
    Yona가 설치될 위치, Yona 데이터가 쌓일 위치를 잡는다.
    예전에는 Yona가 설치되는 위치가 데이터 위치였는데, 유지보수의 편의를 위해 Data 영역을 나눴다. 이 Yona 데이터 영역에는 설정 파일, Git/SVN 파일들, 로그 등이 쌓이는 위치이다. 나중에 Yona를 업그레이드 하더라도 이 설정 파일 위치가 변화하지 않으면 계속 프로그램만 업그레이드를 할 수 있다.

    Yona 설치 위치는 크게 문제가 없다면 C 혹은 D의 Root에 원본 버전 폴더 이름 그래도 구성한다.
    C:\yona-v1.11.1
    데이터 역시 C혹은 D Root에 구성하는데, 가급적 프로그램과 다른이름으로 구성한다.
    다만, Git 혹은 SVN의 이용률에 따라 용량이 많이 필요할 수 있으므로, 디스크 속도 및 용량등을 고려해서 위치를 잘 잡도록 한다.
    C:\yona-data

 

데이터베이스 설치 및 설정

Maria DB를 설치한다.

Windows 버전의 Maria DB의 경우 MSI로 패키징을 제공한다. 설치용 Wizard를 제공하기 때문에, 메시지들을 잘 읽고 내용을 채우기만 하면 그리 어렵지 않게 구성할 수 있다.(물론 기존에 설치된 MySQL 과 안겹치게 설치하거나, 위치 변경 등의 다양한 변화가 있을 수 있는데 여기서는 범위가 벗어나므로, 그냥 단독 설치, Clean 설치로 판단한다.)

  1. MariaDB MSI 파일 실행
    최신버전 Maria DB MSI 파일을 실행해 설치한다. 이 때 설정하는 root 계정의 암호를 반드시 기억해야 한다. 그래야 이 후 작업 하는데 문제가 없다.

Maria DB를 설정한다.

  1. Maria DB 데이터 폴더 이동 및 my.ini 설정.
    DB 서버 전역 설정 작업은 my.ini 파일을 수정해야 한다.
    문제는 이 파일이 MariaDB의 데이터 폴더에 위치한다는 점이다.
    (설치 폴더 위치를 변경하지 않았다면, MariaDB 설치 위치 밑의 data 폴더 이다.c:\Program Files\MariaDB 10.3\data\)
    이 위치에 있는 my.ini 파일을 연다.
    보통 아래와 같은 내용으로 되어 있다.
    [mysqld]
datadir=C:/Program Files/MariaDB 10.3/data
port=3306
innodb_buffer_pool_size=2034M
character-set-server=utf8
[client]
port=3306
plugin-dir=C:/Program Files/MariaDB 10.3/lib/plugin
    이 내용을 아래와 같이 만들면 된다. (잘 비교해보면, 같은 내용은 그래도 두고 다른 내용들을 추가하기만 하면 된다.)
    [mysqld]
datadir=C:/Program Files/MariaDB 10.3/data
port=3306
sql_mode="STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION"
default_storage_engine=innodb
innodb_buffer_pool_size=2034M
innodb_log_file_size=50M
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci
init-connect='SET NAMES utf8mb4'
lower_case_table_names=1

[client]
port=3306
default-character-set=utf8mb4

[mysql]
default-character-set=utf8mb4
  2. services.msc에서 MySQL 서비스 재시작.
    서비스 관리 창에서 MySQL 서비스를 찾아 재시작한다.
    services.msc 를 입력하면 서비스 관리를 위한 창이 뜨는데, 여기서 나열된 서비스 목록 중 MySQL을 찾아 재시작 하면 된다.

 

SQL 처리

  1. 설치 위치의 bin 폴더 이동.
    MySQL 접속용 클라이언트 프로그램이 있으면 그걸 그대로 사용해도 되지만, 만일 없다면, mysql 클라이언트 콘솔 프로그램을 실행한다.
    (별도 설치 경로를 바꾸지 않았다면, c:\Program Files\MariaDB 10.3\bin\ 위치가 될 것이다.중간에 MariDB 10.3 부준은 다른 버전으로 설치했다면 다른 위치 일듯…)
    Command 창을 연다. 그리고 난 뒤 아래의 명령을 넣는다.
    cd "c:\Program Files\MariaDB 10.3\bin\"
  2. mysql 클라이언트 실행.
    이동된 상태에서 다음 명령을 입력해 mysql을 띄운다. 아래의 내용 중 {root암호} 부분에 앞서 mariaDB 설치시 입력했던 root 암호를 넣어주면 된다. 
    mysql -u root -p"{root암호}"
  3. 다음 SQL을 실행한다. – 계정 생성
    연결 계정을 만든다. 단, 아래 쿼리에 있는 yonadan은 다른 암호로 변경하도록 한다.(예제일 뿐…)
    create user 'yona' IDENTIFIED BY 'yonadan';
create user 'yona'@’localhost’ IDENTIFIED BY 'yonadan';
  4. 다음 SQL을 실행한다. –  DB 생성 
    create database yona DEFAULT CHARACTER SET utf8mb4 DEFAULT COLLATE utf8mb4_bin;
  5. 다음 SQL을 실행한다 – 권한할당.
    GRANT ALL ON yona.* to 'yona';

 

YONA 설치

  1. 다운 받은 yona 압축파일을 해제.
    앞서 결정한 위치에 압축파일을 해제해서 설치한다.
    내부에는 bin, lib, share 등의 폴더가 보이면 된다.

  2. yona-data 폴더 작성.
    앞서 결정한 위치의 yona-data 폴더를 생성한다.

  3. 환경 변수 설정.
    YONA_HOME을 설정한다.
    다운받아 압축 해제한 yona 본체의 경로를 넣으면 된다.

YONA 실행

  1. 그냥 실행.
    YONA_HOME\bin 위치로 이동해서,다음 명령을 넣어 실행한다.
    "%YONA_HOME%\bin\yona.bat”
  2. conf 폴더를 yona-data 폴더에 옮기기.
    1번 대로 실행하면, conf 폴더가 새로 생기는데, 이 폴더의 내용을 yona-data 폴더에 옮긴다.

  3. conf 폴더 내 application.conf 파일 수정.
    이 파일이 yona 설정 파일인데, 각종 사이트 관련 중심 정보를 수정할 수 있다.
    자세한 내용은 wiki를 참조하고 여기서는 DB 접속 관련된 정보만 업데이트 한다.
    수정할 내용은 DB 접속 정보 중 암호 부분만 수정하면 된다.
    db.default.password="{yona db 계정 접속 암호}"
  4. 환경 변수 추가.
    이제 마지막으로 환경변수 YONA_DATA를 추가한다.
    yona-data 폴더 전체 경로를 담아서 제공하면 된다.

  5. yona.bat 실행.
    1번과는 다르게 Path를 YONA_HOME 으로 옮기고, 대신 실행을 할 때,
    아래와 같이 bin 폴더를 직접 이동하여 실행한다.

2019. 2. 19. 오후 6:31

728x90
저작자표시

+ Recent posts

티스토리툴바