우분투 24.04 서버에 Apache Solr 설치하는 방법

Apache Solr는 Apache Lucene을 기반으로 구축된 오픈 소스 검색 플랫폼으로, 강력한 애플리케이션 검색 및 인덱싱 기능을 생성하도록 설계되었습니다. 고급 전체 텍스트 검색, 패싯 검색, 실시간 인덱싱 및 분산 검색을 제공하여 검색 엔진 및 데이터 검색 시스템 구축에 인기 있는 선택입니다.

Solr는 매우 확장 가능하며 대량의 데이터에 최적화되어 있어 웹사이트 검색, 전자상거래 및 빅 데이터 분석과 같은 작업을 위해 기업 환경에서 자주 사용됩니다. REST와 유사한 API를 통해 다른 시스템과의 통합이 용이하며, 쿼리 제안 강조 표시 및 지리적 검색과 같은 기능을 지원합니다. Solr의 유연성, 성능 및 커뮤니티 지원은 강력한 검색 기능이 필요한 조직을 위한 주요 솔루션이 되었습니다.

이 가이드에서는 우분투 24.04 서버에 Apache Solr를 설치하는 방법을 배웁니다. 또한 BasicAuthentication으로 Apache Solr를 보호하고 solr 명령줄로 첫 번째 컬렉션을 만드는 방법도 배웁니다.

전제 조건

이 가이드를 시작하기 전에 다음 사항을 확인하세요:

• 우분투 24.04 서버
• 관리자 권한이 있는 비루트 사용자

우분투 서버 준비

Apache Solr를 설치하기 전에 shmmax 및 nr_hugepages를 커널 매개변수에서 증가시켜 우분투 시스템을 준비하고 구성한 다음 기본 최대 열린 파일 및 프로세스를 증가시킵니다.

다음 명령을 실행하여 우분투 서버에서 shmmax 및 nr_hugepages를 증가시킵니다.

sudo echo 4294967295 > /proc/sys/kernel/shmmax  
sudo echo 1536 > /proc/sys/vm/nr_hugepages

이제 다음 명령을 실행하여 /etc/security/limits.conf 파일을 수정합니다.

sudo nano /etc/security/limits.conf

사용자 solr의 최대 열린 파일 및 프로세스를 다음 구성으로 증가시킵니다.

solr soft nofile 65000  
solr hard nofile 65000  
solr soft nproc 65000  
solr hard nproc 65000

파일을 저장하고 편집기를 종료합니다.

Java OpenJDK 설치

이제 시스템을 구성했으므로 Java OpenJDK를 시스템에 설치합시다. Apache Solr는 시스템에 최소한 Java 11이 설치되어 있어야 하며, 이 가이드에서는 최신 안정적인 Java OpenJDK 버전을 제공하는 default-jdk 패키지를 사용할 것입니다.

먼저 다음 명령으로 우분투 패키지 인덱스를 업데이트합니다.

sudo apt update

이제 아래 명령을 사용하여 default-jdk 패키지를 설치합니다. 설치를 확인하려면 Y를 입력합니다.

sudo apt install default-jdk

설치가 완료되면 다음 명령으로 Java 버전을 확인합니다.

java --version

아래에서 Java 21이 설치된 것을 확인할 수 있습니다.

Apache Solr 설치

이제 우분투 시스템이 구성되고 Java OpenJDK가 설치되었으므로 Apache Solr 설치를 시작합시다. 이 가이드에서는 Solr 패키지에서 제공하는 설치 스크립트를 사용하여 Apache Solr를 설치합니다.

시작하려면 아래 명령을 실행하여 curl, lsof, bc와 같은 기본 도구를 설치합니다.

sudo apt install curl lsof bc

이제 아래의 wget 명령으로 Apache Solr 바이너리 패키지를 다운로드합니다.

wget https://www.apache.org/dyn/closer.lua/solr/solr/9.7.0/solr-9.7.0.tgz?action=download

Apache Solr 패키지의 이름을 바꾸고 아래 명령을 사용하여 설치 프로그램 install_solr_service.sh 스크립트를 추출합니다.

mv solr-9.7.0.tgz?action=download solr-9.7.0.tgz  
tar -xf tar xzf solr-9.7.0.tgz solr-9.7.0/bin/install_solr_service.sh --strip-components=2

이제 install_solr_service.sh 스크립트를 실행하여 Apache Solr를 설치합니다.

sudo bash ./install_solr_service.sh solr-9.7.0.tgz

아래에서 Apache Solr 설치의 세부 정보를 확인할 수 있습니다.

• 기본 설치 디렉토리는 /opt/solr 디렉토리에 있습니다.
• 새로운 사용자 solr가 자동으로 생성됩니다.
• Apache Solr 서비스를 관리하기 위한 새로운 서비스 파일 solr.service가 생성됩니다.

이제 아래 명령으로 solr 상태를 확인합니다. solr의 상태가 active(exited)로 표시되며, 이는 서비스가 실행 중이지만 systemd가 모니터링할 파일을 찾을 수 없음을 의미합니다.

sudo systemctl status solr

아래의 ss 명령을 사용하여 시스템에서 열린 포트를 확인할 수도 있습니다. Apache Solr는 포트 8893에서 실행되어야 합니다.

ss -tulpn

Apache Solr 구성

이제 Apache Solr가 설치되었으므로 /etc/default/solr.in.sh 스크립트 내에서 Apache Solr 매개변수를 수정하여 구성합시다. 그런 다음 기본 최대 메모리 힙과 Apache Solr을 실행하는 데 사용되는 IP 주소를 증가시킵니다.

vim 편집기를 사용하여 Solr 구성 파일 /etc/default/solr.in.sh를 엽니다.

sudo vim /etc/default/solr.in.sh

Apache Solr에 대한 최대 메모리 할당으로 기본 SOLR_HEAP 옵션을 변경합니다. 이 예에서는 4GB의 RAM을 사용할 것입니다.

SOLR_HEAP="4g"

SOLR_HOST 및 SOLR_JETTY_HOST 옵션에 IP 주소를 입력합니다. 이 예에서는 Apache Solr가 로컬 IP 주소 192.169.10.60에서 실행됩니다.

SOLR_HOST="192.168.10.15"  
SOLR_JETTY_HOST="192.168.10.15"

이제 아래의 systemctl 명령을 실행하여 Apache Solr 서비스를 재시작하고 변경 사항을 적용합니다.

sudo systemctl restart solr

아래의 ss 명령을 사용하여 열린 포트와 Apache Solr에 의해 사용되는 IP 주소를 확인할 수 있습니다.

ss -tulpn

인증으로 Apache Solr 보호

Apache Solr를 구성한 후 다음 단계는 배포를 보호하는 것입니다. 이 예에서는 기본 인증을 사용하여 Apache Solr를 보호합니다. 이는 새 파일 /var/solr/data/security.json을 생성하여 수행할 수 있습니다.

vim 편집기를 사용하여 새 구성 /var/solr/data/security.json을 생성합니다.

sudo vim /var/solr/data/security.json

아래 구성을 삽입하여 Apache Solr에 대한 인증을 설정하고 사용자 solr를 비밀번호 solrRocks로 생성합니다.

{  
 "authentication":{  
 "blockUnknown": true,  
 "class":"solr.BasicAuthPlugin",  
 "credentials":{"solr":"IV0EHq1OnNrj6gvRCwvFwTrZ1+z1oBbnQdiVC3otuq0= Ndd7LKvVBAaZIF0QAVi1ekCfAJXr1GGfLtRUXhgrF8c="},  
 "realm":"My Solr users",  
 "forwardCredentials": false  
 },  
 "authorization":{  
 "class":"solr.RuleBasedAuthorizationPlugin",  
 "permissions":[{"name":"all", "role":"admin"}],  
 "user-role":{"solr":"admin"}  
 }  
}

파일을 저장하고 편집기를 종료합니다.

이제 아래의 systemctl 명령을 실행하여 solr 서비스를 재시작하고 변경 사항을 적용합니다.

sudo systemctl restart solr

다음으로 웹 브라우저를 열고 Apache Solr 설치 http://192.168.10.60:8983/를 방문합니다. Apache Solr 로그인 페이지로 리디렉션됩니다.

사용자 solr와 비밀번호 solrRocks를 입력하면 Apache Solr 대시보드에 접근할 수 있습니다.

Apache Solr에서 첫 번째 컬렉션 만들기

이 단계에서 Apache Solr를 구성하고 보호했습니다. 이제 명령줄에서 Apache Solr에서 첫 번째 컬렉션을 만듭니다.

다시 vim 편집기를 사용하여 파일 /etc/default/solr.in.sh를 엽니다.

sudo vim /etc/default/solr.in.sh

SOLR_AUTH_TYPE 및 SOLR_AUTHENTICATION_OPTS의 주석을 제거하고 둘 다 기본값으로 유지합니다.

SOLR_AUTH_TYPE="basic"  
SOLR_AUTHENTICATION_OPTS="-Dbasicauth=solr:SolrRocks"

파일을 저장하고 편집기를 종료합니다.

이제 아래 명령을 실행하여 Apache Solr 서비스를 재시작합니다.

sudo systemctl restart solr

다음으로 아래 명령을 실행하여 이름이 my_first_index인 첫 번째 컬렉션을 생성합니다.

su - solr -c "/opt/solr/bin/solr create -c my_first_index -n MyIndex"

이제 Apache Solr 대시보드로 이동하면 새로운 컬렉션 my_first_index가 생성된 것을 볼 수 있습니다.

결론

축하합니다! 우분투 24.04 서버에 Apache Solr 설치를 완료했습니다. Java OpenJDK 21로 설치하고, 로컬 IP 주소에서 실행되도록 구성하고, BasicAuthentication으로 보호했습니다. 마지막으로 Solr 명령줄을 사용하여 첫 번째 컬렉션을 생성했습니다.