2. 설치 및 삭제

올챙이는 크게 세가지 형태의 실행 방법이 존재합니다.
도커(https://hub.docker.com/r/hyunjongcho/tadpoledbhub/), 독립 실행 버전과, Apache Tomcat(7.x이상)에서 실행할수 있는 모듈이 존재합니다. 
또한 사용자의 데이터를 저장하기 위해 데이터베이스를 사용합니다.
개인 등 소규모 사용자는 SQLite을 사용하실 수 있으며, 서버 이중 화와 서버 확장이 필요한 사용자를 위해 MySQL을 사용하실 수 있습니다. 

실행 

  1. Windows, CentOS, Ubuntu, Mac에서 독립실행 모드 즉, Windows 운영체제일 경우 xxx.exe형태로 실행 할 수 있는 형태입니다.
  2. Tomcat에서 실행할 수 있는 서버 모드 즉, WAR(Web Application Archive) 형태가 있습니다.
     
  3. 엔진 디비
    1. 기본 설치는 SQLite를 사용하게 됩니다.  이 경우 사용자가 별도로 설정해 줄 필요가 없습니다.
    2. 개인이 사용할 경우에는 SQLite를 사용하고, 규모가 있는 곳은 MySQL 사용을 권합니다.  
      엔진 디비를 MySQL을 사용 하여 이중화 할 수 있습니다. (엔터프라이즈 버전에 대한 문의는 다음(조현종, hangum@tadpolehub.com)으로 주십시오)

사전 조건

  1. 최소 400메가 이상의 디스크 여유공간이 필요합니다. 
  2. 올챙이는 JAVA언어를 사용하여 만들어져 있습니다. (JRE가 포함된 바이너리를 따로 배포하고 있습니다.)

바이너리 다운로드

  1. 올챙이는 데스크톱(Mac, Windows, CentOS), 서버(Tomcat WAR)를 위해 바이너리가 준비 되어 있습니다.
  2. 1.6.5버전부터는 설치되어 있어 자바를 설치하실 필요가 없습니다. (시스템에 설치된 자바를 사용하려면 올챙이에 포함된 jre 폴더를 삭제하시고 재시작 하십시오)
    1.6.5 이전 버전은 JAVA가 미리 설치되어 있어야 합니다.
    바이너리 다운로드는 설치된 JRE의 버전에 맞추어 다운로드 합니다.
    설치한 JRE가 32비트 이면 올챙이 바이너리도 32비트를, 64비트이면 64비트를 설치 하셔야 합니다.
    • Windows :  win32.win32.x86.xx 으로 시작
    • Max OS X: macosx.cocoa.x86_xx 으로 시작
    • Ubuntu, CentOS : linux.gtk.x86.xx 으로 시작
    • 링크(다운로드)에서 가장 최신 버전을 다운로드해서 사용 하세요.
    • Docker(다운로드) 도 지원합니다. 

설치

  1. 데스크톱 버전은 다음과 같습니다.

    1. 다운로드 받은 바이너리를 자신의 적당한 폴더에 압축을 해제합니다.
      압축 해제가 정상적으로 종료되면 설치가 끝났습니다.


  2. 서버(Tomcat WAR) 버전

    1. 톰켓은 7.x, 8.x를 지원합니다.(9.x는 지원하지 않습니다.)

    2. WAR 파일을 다운로드 한 후에 자신의 톰켓 홈 디렉토리/webapps 아래 에 복사합니다.

      이름을 바꾸었으면 설치가 끝났습니다.
      주의) 이전에 올챙이를 설치한 적이 있다면 %TOMCAT_HOEM%/work 디렉토리를 삭제 후 재시작 하십시오. 

실행 및 디렉토리 구조

  1. 디렉토리 구조는 다음과 같습니다.


    Windows 의 경우 : tadpole-standalone.exe를 실행 시킵니다.
    Linux 의 경우 : tadpole-standalone 의 실행 권한을 주어야 합니다.  예) chmod 755 ./tadpole-standalone
    Mac 의 경우 :  MacOS/tadpole-standalone를 실행 시킵니다. 
순번이름내용비고
1configuration실행에 필요한 시스템 환경 정보가 있습니다.
2logs시스템 로그가 있는 폴더 입니다.
로그는 10메가 단위로 10개 쌓이며, 11번 째가 되면 제일 처음 로그에 덮여 씌여집니다. 

3p2시스템 구조에 관련 정보가 있습니다.
4plugins실제 프로그램등이 위치해 있습니다.
5workspace시스템이 동작하기 위한 정보가 있습니다.
6
TadpoleDBHub.url
Tadpole DB Hub.desktop 

단축 아이콘으로 바탕화면으로 복사하여서 실행하시면 편리합니다.

  • TadpoleDBHub.url : Window, mac 올챙이 바로가기 파일입니다.
  • Tadpole DB Hub.desktop: Linux 계열에서 사용하는 단축 파일입니다.

7tadpole-standalone.exe올챙이를 실행 파일입니다.
8tadpole-standalone.ini올챙이를 실행하기 위한 환경 파일입니다.
메모리 설정과 각종 환경 정보를 설정 하실 수 있습니다.
자세한 설정은 아래를 참고하십시오.


tadpole-standalone.init의 설정은 다음과 같습니다. (서버는 web.xml에서 합니다.)

옵션내용기본값비고
-test

테스트 데이터를 로드할것인지

  • 로그인시 테스트 계정이 보입니다.
  • 예제 데이터 베이스 정보가 보입니다.
옵션이 없을 경우 운영모드
-standalone

독립 실행모드인지 

  • 종료 버튼 클릭시 프로그램 종료 합니다.
  • 시작시 기본 브라우저 자동으로 열립니다.
옵션이 없을경우 경우 서버모드
-debuglog로그레벨을 debug 모드로 설정(즉 모든 로그 남김)옵션이 없을 경우 info 레벨
-dbServer시스템 데이터베이스를 MySQL을 사용 할 경우 MySQL
환경 정보가 있는 파일의 위치를 지정합니다. 
옵션이 없을 경우 엔진디비를
sqlite로 사용  
엔진을 mysql로 사용하고자 할 경우
올챙이 아빠(adi.tadpole@gmail.com)에게
디비 정보(회사/조직이름/ip/port/id/pass)를
보내세요. 
-dbPath시스템 데이터베이스를 SQLite를 사용 할 경우 파일의
위치를 지정합니다.


예)
-dbPath /Users/hangum/Documents/tadpole/tadpole-system.db
옵션이 없을 경우

tomcat일 경우
%TOMAT_HOME%/work/Catalina/localhost/
tadpole/eclipse/configuration/tadpole/db/tadpole-system.db

독립실행 모듈일 경우 
 TadpoleDBHub/configuration/tadpole/db/tadpole-system.db

-useDB

올챙이에서 관리 할 데이터 베이스 종류를 기록합니다.
모두 사용할 경우 -userDB all 이라고 적어줍니다.  

예를 들더 Oracle, mssql, mysql을 사용한다면
-useDB Oracle,MSSQL,MySQL

데이터베이스는 다음과 같습니다.

  • ORACLE : Oracle
  • MSSQL : MSSQL
  • MYSQL : MySQL
  • MARIADB : MariaDB
  • SQLite : SQLite
  • CUBRID : Cubrid
  • POSTGRE : PostgreSQL
  • MONGODB : MongoDB
  • AMAZONRDS : AmazonRDS
  • HIVE : Hive

옵션이 없을 경우 올챙이에서 지원하는 디비 모두 사용


-newUserPermit

신규 유저등록시 어드민의 허락이 필요한지 유무.

허락이 필요하면 YES, 옵션이 없으면 NO 입니다.

예) -newUserPermit YES

옵션이 없으면 NO
-Dfile.encoding=UTF-8시스템에서 사용 할 한글 엔코딩 옵션을 설정합니다.옵션이 없으면 시스템 캐릭터 셋
-Dorg.osgi.service.http.port=10081시스템에서 사용 할 기본 포트를 설정합니다.톰켓은 서버 환경설정값(server.xml)에 따름.
독립 실행 모듈은 옵션이 없으면 10081 포트를 기본으로 사용.

삭제/제거(Uninstall)

올챙이 삭제는 설치 하셨던 폴더를 삭제하시는 것으로 끝 납니다.

설치하셨던 Java의 JRE는 올챙이 이외의 프로그램에서 사용 될 수 있으니, 삭제하지 않기를 권합니다.