Debian Wheezy에서 TYPO3와 함께 Solr 사용하기

버전 1.0
저자: Falko Timme
Twitter에서 나를 팔로우하세요

TYPO3의 기본 검색 확장인 “Indexed Search”는 작은 웹사이트에는 괜찮지만, 웹사이트가 더 크면 (> 500 페이지) 매우 느려집니다. 다행히도, 초고속 Apache Solr 검색 서버를 사용하는 검색 확장으로 교체할 수 있습니다. 이 튜토리얼에서는 Debian Wheezy에서 TYPO3와 함께 Apache Solr를 사용하는 방법을 설명합니다.

이것이 당신에게 작동할 것이라는 보장은 하지 않습니다!

1 사전 참고

이 튜토리얼에서는 두 개의 서버를 사용합니다:

server1.example.com (IP: 192.168.0.100): TYPO3 4.7 소개 패키지가 설치된 웹 서버 (www.example.com vhost에 설치됨).
server2.example.com (IP: 192.168.0.101): Apache Solr를 설치할 별도의 서버.

물론, 웹 서버와 동일한 시스템에 Solr를 설치하는 것도 가능하지만, 두 서비스를 분리하여 서로의 성능에 영향을 주지 않도록 하고 싶습니다.

2 Solr 설치하기

server2.example.com:

먼저 Java를 설치합니다:

apt-get install openjdk-6-jdk openjdk-6-jre unzip

update-alternatives --config java  
update-alternatives --config javac

TYPO3 프로젝트는 다음과 같이 다운로드하는 Solr 설치 스크립트를 제공합니다:

wget http://forge.typo3.org/projects/extension-solr/repository/revisions/master/raw/resources/shell/install-solr.sh  
chmod 755 install-solr.sh

다음으로, http://tomcat.apache.org/download-60.cgi를 방문하여 현재 Apache Tomcat 6 버전이 무엇인지 확인합니다. 이 글을 작성할 당시 버전은 6.0.37이었습니다. 이제 install-solr.sh를 엽니다…

vi install-solr.sh

… TOMCAT_VER 변수가 올바른 버전 번호를 가지고 있는지 확인합니다 - 필요하다면 변경합니다:

| [...] TOMCAT_VER=6.0.37 [...] |

이제 Solr를 설치합니다. 기본적으로 (언어를 매개변수로 제공하지 않으면) Solr는 영어만 지원하도록 설치됩니다. 더 많은 언어 지원이 필요하면, 다음과 같이 명령어에 추가하면 됩니다:

./install-solr.sh german english french

이 명령은 Tomcat 서버(여기서 Solr가 실행됨)와 Solr를 설치합니다. 기본적으로 Tomcat은 127.0.0.1에서만 수신 대기합니다. 원격 호스트에서 Solr에 접근하려면 Tomcat이 모든 인터페이스에서 수신 대기하도록 구성해야 하므로, /opt/solr-tomcat/tomcat/conf/server.xml에서 127.0.0.1을 0.0.0.0으로 교체합니다:

vi /opt/solr-tomcat/tomcat/conf/server.xml

| [...] [...] |

Tomcat을 재시작합니다:

/opt/solr-tomcat/tomcat/bin/shutdown.sh  
/opt/solr-tomcat/tomcat/bin/startup.sh

다음으로 Solr에서 코어를 구성할 수 있습니다. 기본적으로 영어 코어가 이미 구성되어 있습니다. 더 많은 언어가 필요하면 /opt/solr-tomcat/solr/solr.xml에 추가할 수 있습니다. 예를 들어:

vi /opt/solr-tomcat/solr/solr.xml

| |

그 후 Solr를 재시작합니다:

/opt/solr-tomcat/tomcat/bin/shutdown.sh  
/opt/solr-tomcat/tomcat/bin/startup.sh

서버가 부팅될 때마다 Tomcat을 수동으로 시작하고 싶지 않기 때문에, Tomcat 시작 명령을 /etc/rc.local에 추가할 수 있습니다:

vi /etc/rc.local

| [...] /opt/solr-tomcat/tomcat/bin/startup.sh [...] |

2.1 Solr에 인증 추가하기

Solr가 모든 인터페이스에서 수신 대기하고 있기 때문에, 인증을 추가하는 것이 좋습니다. 이제 영어 코어에 대해 비밀번호가 secret인 사용자 user1을 구성하겠습니다.

/opt/solr-tomcat/tomcat/conf/web.xml을 엽니다…

vi /opt/solr-tomcat/tomcat/conf/web.xml

… 그리고 컨테이너 내부의 어딘가에 다음 섹션을 추가합니다:

| [...] Solr 인증된 애플리케이션 /core_en/* role1 BASIC 관리자 및 업데이트 보호 [...] |

보시다시피, 이것은 영어 코어에만 유효합니다 (/core_en/*), 그리고 저는 이 역할 role1에 대해 구성했습니다. 따라서 유효한 사용자는 해당 역할에 속해야 합니다. 사용자 user1과 그의 비밀번호를 해당 역할에 추가하려면 /opt/solr-tomcat/tomcat/conf/tomcat-users.xml을 엽니다…

vi /opt/solr-tomcat/tomcat/conf/tomcat-users.xml

… 그리고 컨테이너 내부에 다음 섹션을 추가합니다:

| [...] [...] |

그 후 Tomcat을 재시작합니다:

/opt/solr-tomcat/tomcat/bin/shutdown.sh  
/opt/solr-tomcat/tomcat/bin/startup.sh

이제 브라우저를 열고 http://192.168.0.101:8080/solr에서 Solr를 방문하면 모든 구성된 코어를 볼 수 있어야 합니다:

영어 코어를 방문하면 (우리가 방금 인증을 구성한), 사용자 이름과 비밀번호를 요청받아야 합니다:

성공적으로 인증을 마치면, Solr가 성공적으로 실행되고 있다는 것을 의미하는 다음 페이지를 볼 수 있어야 합니다: