Linux 설치 (상세 절차)

이 페이지에서는 Linux 환경에 Fess 를 설치하는 절차를 설명합니다. TAR.GZ, RPM, DEB 각 패키지 형식에 대응합니다.

경고

운영 환경에서는 내장 OpenSearch를 사용한 운영을 권장하지 않습니다. 반드시 외부 OpenSearch 서버를 구축하시기 바랍니다.

전제 조건

시스템 요구사항 에 기재된 시스템 요구사항을 충족할 것
Java 21이 설치되어 있을 것
OpenSearch 3.3.2를 사용 가능한 상태로 할 것(또는 신규 설치)

설치 방법 선택

Linux 환경에서는 다음 설치 방법 중에서 선택할 수 있습니다:

방식	권장 환경	특징
TAR.GZ	개발 환경, 커스터마이징이 필요한 환경	임의의 디렉터리에 압축 해제 가능
RPM	RHEL, CentOS, Fedora 계열	systemd를 통한 서비스 관리 가능
DEB	Debian, Ubuntu 계열	systemd를 통한 서비스 관리 가능

TAR.GZ 버전 설치

단계 1: OpenSearch 설치

OpenSearch 다운로드

Download OpenSearch 에서 TAR.GZ 버전을 다운로드합니다.
```
$ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.3.2/opensearch-3.3.2-linux-x64.tar.gz
$ tar -xzf opensearch-3.3.2-linux-x64.tar.gz
$ cd opensearch-3.3.2
```
참고

이 예제에서는 OpenSearch 3.3.2를 사용하고 있습니다. 버전은 Fess 의 지원 버전을 확인하시기 바랍니다.

OpenSearch 플러그인 설치

Fess 가 필요로 하는 플러그인을 설치합니다.

$ cd /path/to/opensearch-3.3.2
$ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.3.2
$ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.3.2
$ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.3.2
$ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.3.2

중요

플러그인 버전은 OpenSearch 버전과 일치시켜야 합니다. 위의 예제에서는 모두 3.3.2를 지정하고 있습니다.

OpenSearch 설정

config/opensearch.yml 에 다음 설정을 추가합니다.
```
# 설정 동기화용 경로(절대 경로로 지정)
configsync.config_path: /path/to/opensearch-3.3.2/data/config/

# 보안 플러그인 비활성화(개발 환경 전용)
plugins.security.disabled: true
```
경고

보안 관련 중요 주의사항

plugins.security.disabled: true 는 개발 환경이나 테스트 환경에서만 사용하십시오. 운영 환경에서는 OpenSearch의 보안 플러그인을 활성화하고 적절한 인증·권한 설정을 수행하십시오. 자세한 내용은 보안 설정 를 참조하십시오.
팁

클러스터 이름 및 네트워크 설정 등 기타 설정은 환경에 맞게 조정하십시오. 설정 예:
```
cluster.name: fess-cluster
node.name: fess-node-1
network.host: 0.0.0.0
discovery.type: single-node
```

단계 2: Fess 설치

Fess 다운로드 및 압축 해제

다운로드 사이트 에서 TAR.GZ 버전을 다운로드합니다.

$ wget https://github.com/codelibs/fess/releases/download/fess-15.3.2/fess-15.3.2.tar.gz
$ tar -xzf fess-15.3.2.tar.gz
$ cd fess-15.3.2

Fess 설정

bin/fess.in.sh 를 편집하여 OpenSearch 연결 정보를 설정합니다.
```
$ vi bin/fess.in.sh
```
다음 설정을 추가하거나 변경합니다:
```
# OpenSearch의 HTTP 엔드포인트
SEARCH_ENGINE_HTTP_URL=http://localhost:9200

# 사전 파일 배치 경로(OpenSearch의 configsync.config_path와 동일)
FESS_DICTIONARY_PATH=/path/to/opensearch-3.3.2/data/config/
```
참고

OpenSearch를 다른 호스트에서 실행하는 경우 SEARCH_ENGINE_HTTP_URL 을 적절한 호스트 이름 또는 IP 주소로 변경하십시오. 예: SEARCH_ENGINE_HTTP_URL=http://192.168.1.100:9200

설치 확인

설정 파일이 올바르게 편집되었는지 확인합니다:

$ grep "SEARCH_ENGINE_HTTP_URL" bin/fess.in.sh
$ grep "FESS_DICTIONARY_PATH" bin/fess.in.sh

단계 3: 시작

시작 절차는 시작, 중지, 초기 설정 을 참조하십시오.

RPM 버전 설치

RPM 버전은 Red Hat Enterprise Linux, CentOS, Fedora 등 RPM 기반 Linux 배포판에서 사용합니다.

단계 1: OpenSearch 설치

OpenSearch RPM 다운로드 및 설치

Download OpenSearch 에서 RPM 패키지를 다운로드하여 설치합니다.
```
$ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.3.2/opensearch-3.3.2-linux-x64.rpm
$ sudo rpm -ivh opensearch-3.3.2-linux-x64.rpm
```
또는 리포지토리를 추가하여 설치할 수도 있습니다. 자세한 내용은 Installing OpenSearch 를 참조하십시오.

OpenSearch 플러그인 설치

$ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.3.2
$ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.3.2
$ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.3.2
$ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.3.2

OpenSearch 설정

/etc/opensearch/opensearch.yml 에 다음 설정을 추가합니다.
```
$ sudo vi /etc/opensearch/opensearch.yml
```
추가할 설정:
```
configsync.config_path: /var/lib/opensearch/data/config/
plugins.security.disabled: true
```
경고

운영 환경에서는 plugins.security.disabled: true 를 사용하지 마십시오. 보안 설정 를 참조하여 적절한 보안 설정을 수행하십시오.

단계 2: Fess 설치

Fess RPM 설치

다운로드 사이트 에서 RPM 패키지를 다운로드하여 설치합니다.

$ wget https://github.com/codelibs/fess/releases/download/fess-15.3.2/fess-15.3.2.rpm
$ sudo rpm -ivh fess-15.3.2.rpm

Fess 설정

/usr/share/fess/bin/fess.in.sh 를 편집합니다.

$ sudo vi /usr/share/fess/bin/fess.in.sh

다음 설정을 추가하거나 변경합니다:

SEARCH_ENGINE_HTTP_URL=http://localhost:9200
FESS_DICTIONARY_PATH=/var/lib/opensearch/data/config/

서비스 등록

chkconfig 사용 시:

$ sudo /sbin/chkconfig --add opensearch
$ sudo /sbin/chkconfig --add fess

**systemd 사용 시**(권장):

$ sudo systemctl daemon-reload
$ sudo systemctl enable opensearch.service
$ sudo systemctl enable fess.service

단계 3: 시작

시작 절차는 시작, 중지, 초기 설정 을 참조하십시오.

DEB 버전 설치

DEB 버전은 Debian, Ubuntu 등 DEB 기반 Linux 배포판에서 사용합니다.

단계 1: OpenSearch 설치

OpenSearch DEB 다운로드 및 설치

Download OpenSearch 에서 DEB 패키지를 다운로드하여 설치합니다.
```
$ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.3.2/opensearch-3.3.2-linux-x64.deb
$ sudo dpkg -i opensearch-3.3.2-linux-x64.deb
```
또는 리포지토리를 추가하여 설치할 수도 있습니다. 자세한 내용은 Installing OpenSearch 를 참조하십시오.

OpenSearch 플러그인 설치

$ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.3.2
$ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.3.2
$ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.3.2
$ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.3.2

OpenSearch 설정

/etc/opensearch/opensearch.yml 에 다음 설정을 추가합니다.
```
$ sudo vi /etc/opensearch/opensearch.yml
```
추가할 설정:
```
configsync.config_path: /var/lib/opensearch/data/config/
plugins.security.disabled: true
```
경고

운영 환경에서는 plugins.security.disabled: true 를 사용하지 마십시오. 보안 설정 를 참조하여 적절한 보안 설정을 수행하십시오.

단계 2: Fess 설치

Fess DEB 설치

다운로드 사이트 에서 DEB 패키지를 다운로드하여 설치합니다.

$ wget https://github.com/codelibs/fess/releases/download/fess-15.3.2/fess-15.3.2.deb
$ sudo dpkg -i fess-15.3.2.deb

Fess 설정

/usr/share/fess/bin/fess.in.sh 를 편집합니다.

$ sudo vi /usr/share/fess/bin/fess.in.sh

다음 설정을 추가하거나 변경합니다:

SEARCH_ENGINE_HTTP_URL=http://localhost:9200
FESS_DICTIONARY_PATH=/var/lib/opensearch/data/config/

서비스 등록

systemd를 사용하여 서비스를 활성화합니다:

$ sudo systemctl daemon-reload
$ sudo systemctl enable opensearch.service
$ sudo systemctl enable fess.service

단계 3: 시작

시작 절차는 시작, 중지, 초기 설정 을 참조하십시오.

설치 후 확인

설치가 완료되면 다음을 확인하십시오:

설정 파일 확인
- OpenSearch 설정 파일(opensearch.yml)
- Fess 설정 파일(fess.in.sh)
디렉터리 권한

설정에서 지정한 디렉터리가 존재하며 적절한 권한이 설정되어 있는지 확인합니다.

TAR.GZ 버전의 경우:
```
$ ls -ld /path/to/opensearch-3.3.2/data/config/
```
RPM/DEB 버전의 경우:
```
$ sudo ls -ld /var/lib/opensearch/data/config/
```
Java 버전 확인
```
$ java -version
```
Java 21 이상이 설치되어 있는지 확인합니다.

다음 단계

설치가 완료되면 다음 문서를 참조하십시오:

시작, 중지, 초기 설정 - Fess 시작 및 초기 설정
보안 설정 - 운영 환경의 보안 설정
문제 해결 - 문제 해결

자주 묻는 질문

Q: OpenSearch 버전은 다른 버전에서도 작동합니까?

A: Fess 는 특정 버전의 OpenSearch에 의존합니다. 플러그인 호환성을 보장하기 위해 권장 버전(3.3.2)을 사용할 것을 강력히 권장합니다. 다른 버전을 사용하는 경우 플러그인 버전도 적절히 조정해야 합니다.

Q: 여러 Fess 인스턴스에서 동일한 OpenSearch를 공유할 수 있습니까?

A: 가능하지만 권장하지 않습니다. 각 Fess 인스턴스에는 전용 OpenSearch 클러스터를 준비할 것을 권장합니다. 여러 Fess 인스턴스에서 OpenSearch를 공유하는 경우 인덱스 이름 충돌에 주의하십시오.

Q: OpenSearch를 클러스터 구성으로 만드는 방법은?

A: OpenSearch 공식 문서 Cluster formation 을 참조하십시오. 클러스터 구성으로 만드는 경우 discovery.type: single-node 설정을 제거하고 적절한 클러스터 설정을 추가해야 합니다.

메뉴

전반

입문

문서

튜토리얼

개발

기타

아카이브

Linux 설치 (상세 절차)

전제 조건

설치 방법 선택

TAR.GZ 버전 설치

단계 1: OpenSearch 설치

단계 2: Fess 설치

단계 3: 시작

RPM 버전 설치

단계 1: OpenSearch 설치

단계 2: Fess 설치

단계 3: 시작

DEB 버전 설치

단계 1: OpenSearch 설치

단계 2: Fess 설치

단계 3: 시작

설치 후 확인

다음 단계

자주 묻는 질문

Q: OpenSearch 버전은 다른 버전에서도 작동합니까?

Q: 여러 Fess 인스턴스에서 동일한 OpenSearch를 공유할 수 있습니까?

Q: OpenSearch를 클러스터 구성으로 만드는 방법은?