[Fastcat] 2부. Windows에 Fastcat 설치하기

2016. 1. 14. 11:40 IT 및 개발

안녕하세요.

Fastcat 두번째 시간입니다.

이번 시간에는 윈도우에 Fastcat을 설치해 보도록 하겠습니다.

리눅스에 설치하실 분은 패스트캣 홈페이지 리소스 메뉴에서 통합매뉴얼을 참고하시면 됩니다.


1. 사전준비

1-1. 설치 폴더 설정

 Fastcat 설치 폴더

 D:\fastcat

 Java 설치 폴더

 D:\Java

 * 폴더의 위치는 원하시는 위치로 설정을 하세요. 전 위와 같이 설정을 하였습니다.


1-2. 프로그램 다운로드

 검색엔진

 https://github.com/fastcat-co/fastcatsearch/releases

 최신버전의 릴리즈(tar.gz)된 파일을 Fastcat 설치 폴더에 다운로드 합니다. (fastcatsearch-2.32.0.tar.gz)

 관리도구
 최신버전의 릴리즈(tar.gz)된 파일을 Fastcat 설치 폴더에 다운로드 합니다. (fastcatsearch-console-2.22.1.tar.gz)

 JDK 1.6

 Java SE Development Kit 6u45 다운로드 페이지로 이동

 1.7이나 1.8 버전을 사용해도 된다고 써있긴하나 저는 권장하는 버전을 설치하였습니다.


1-3. JDK 설치하기

 - 다운로드 한 JDK 파일(jdk-6u45-windows-x64.exe)을 클릭하여 설치를 진행합니다.

 - JDK는 D:\Java\jdk1.6.0 / JRE는 D:\Java\jre6 에 설치를 하였습니다.



2. Fastcat 검색엔진 설치하기

2-1. 검색엔진 설치하기

 - 다운로드 한 검색엔진(fastcatsearch-2.32.0.tar.gz)과 관리도구(fastcatsearch-console-2.22.1.tar.gz)를 압축 해제합니다.

 - 버전을 제외하고 아래와 같이 폴더명을 변경합니다.

 검색엔진

 D:\fastcat\fastcatsearch

 관리도구

 D:\fastcat\fastcatsearch-console


2-2. 포트 설정

 - 검색엔진에서는 검색요청을 받을때 디폴트로 8090포트를, 내부노드끼리 통신은 9090포트를 사용합니다.

 - 웹관리도구는 8080포트를 사용합니다.

 - 만약 기존에 사용하는 포트와 겹쳐서 수정이 필요할때는 관련된 설정파일을 수정합니다.

 통신

 포트

 설정파일

 검색요청

 8090

 fastcatsearch\conf\id.properties

 내부통신

 9090

 fastcatsearch\conf\node-list.xml

 웹관리도구

 8080

 fastcatsearch-console\etc\jetty.xml



3. 서비스 시작 및 종료

 - 검색엔진을 운영하기 위해서는 총 2개의 프로세스가 실행되어야 합니다. 하나는 검색엔진 프로세스이고 또 하나는 관리도구 프로세스이므로 각각 실행해주도록 합니다.


3-1. 검색엔진 서비스 시작

 - D:\fastcat\fastcatsearch\bin\fastcatsearch.bat 파일을 더블 클릭하여 실행합니다. 종료는 cmd 창을 닫으면 됩니다.

 - 로그는 D:\fastcat\fastcatsearch\logs\system.log 파일을 텍스트편집기로 열어서 확인하면 됩니다.


3-2. 관리도구 서비스 시작

 - D:\fastcat\fastcatsearch-console\start-console.cmd 파일을 더블 클릭하여 실행합니다. 종료는 cmd 창을 닫으면 됩니다.

 - 로그는 D:\fastcat\fastcatsearch-console\logs\server.log 파일을 텍스트편집기로 열어서 확인하면 됩니다.

 

3-3. 관리도구 접속

 - 웹브라우저에서 http://[관리도구서버 IP]:[관리도구 PORT]/console 으로 접속하면 다음과 같이 관리도구의 로그인 화면 접속이 가능합니다.

 - 초기 관리자 아이디 : admin / 비밀번호 : 1111 입니다. 로그인 후 비밀번호 변경을 하면 됩니다.


3-4. 관리도구 접속 시 500 에러발생시

 - Java의 경로를 별도로 지정하지 않을 경우 시스템 PATH상의 Java를 사용하는데, Java JRE의 경우 아래와 같은 에러가 발생할수 있습니다.

2014-03-06 19:20:16.343:WARN:oejs.ServletHandler:/console/
org.apache.jasper.JasperException: PWC6345: There is an error in invoking javac.  A full JDK (not just JRE) is required
    at org.apache.jasper.compiler.DefaultErrorHandler.jspError(DefaultErrorHandler.java:92)
    at org.apache.jasper.compiler.ErrorDispatcher.dispatch(ErrorDispatcher.java:378)
    at org.apache.jasper.compiler.ErrorDispatcher.jspError(ErrorDispatcher.java:119)
    at org.apache.jasper.compiler.Jsr199JavaCompiler.compile(Jsr199JavaCompiler.java:208)

 - 관리도구 서비스 시작 파일인 start-console.cmd 를 열어서 java.exe 의 경로를 명시해줍니다.

@echo off
IF NOT EXIST temp mkdir temp
echo fastcatsearch-console start. see logs/server.log file.
REM SET JAVA_PATH=D:\Java\jdk1.6.0\bin\
"%JAVA_PATH%java.exe" -jar start.jar>>logs/server.log 2>&1

 - 4번째 줄의 주석(REM)을 제거하고 JAVA_PATH를 JDK의 bin 폴더로 지정합니다.

 - 관리도구 cmd 창을 닫고 start-console.cmd 를 다시 실행합니다.



4. 서비스 등록

 - 서비스에 등록을 해두면 운영체제가 재시작되는 경우에도 검색엔진이 자동으로 시작됩니다.

 검색엔진

 D:\fastcat\fastcatsearch\service\bat\installService.bat