문서

설치

검색

관리

API

설정

소개
- 대상 독자
- 읽기 전에
- 전제 조건
- 온라인 액세스
- 기술 지원 문의
  - 상용 지원
- 관련 타사 웹사이트 참조
- 의견 및 제안 제출 방법
포트 및 네트워크 설정
- 개요
- 사용 포트 설정
- 프록시 설정
- HTTP 통신 설정
- 가상 호스트 설정
  - 개요
  - 기본 설정
- 리버스 프록시와의 연계
- 방화벽 설정
  - 필요한 포트 개방
  - 보안 그룹 설정(클라우드 환경)
- 문제 해결
- 참고 정보
메모리 설정
- 개요
- Fess 웹 애플리케이션의 메모리 설정
- 크롤러의 메모리 설정
- OpenSearch의 메모리 설정
- 제안 및 썸네일 처리의 메모리 설정
  - 제안 생성 프로세스
  - 썸네일 생성 프로세스
- 메모리 모니터링 및 튜닝
- 문제 해결
- 참고 정보
Windows 서비스 등록
- Windows 서비스로 등록
크롤러 설정: 웹, 파일 서버, 데이터베이스 크롤링
- 개요
- 크롤러의 기본 개념
  - 크롤러란
  - 크롤러의 종류
- 크롤링 설정 생성
- 크롤링 실행
- 기본 설정 항목
- 파일 크기 설정
  - 가져올 파일 크기 상한
  - 인덱싱할 파일 크기 상한
- 단어 길이 제한
  - 개요
  - 설정 방법
- 프록시 설정
- robots.txt 설정
  - 개요
  - 설정 방법
- User-Agent 설정
  - 웹 크롤러의 경우
  - 파일 크롤러 등의 경우
- 인코딩 설정
  - 크롤링 데이터 인코딩
  - 파일명 인코딩
- 크롤링 문제 해결
- 모범 사례
  - 크롤링 설정 권장 사항
  - 스케줄 설정 권장 사항
- 참고 정보
크롤러 고급 설정
- 개요
- 전반 설정
- 문서 처리 설정
- 프로토콜 설정
- robots.txt 설정
- 오류 처리 설정
- 시스템 모니터링 설정
  - 핫 스레드 설정
    - 설정 예
- 메타데이터 설정
- HTML 크롤러 설정
- 파일 크롤러 설정
- 캐시 설정
  - 문서 캐시
    - 설정 예
- JVM 옵션
- 성능 튜닝
- 문제 해결
- 모범 사례
- S3/GCS 크롤러 설정
  - S3 크롤러
    - 설정 예
  - GCS 크롤러
    - 설정 예
- 참고 정보
썸네일 이미지 설정
- 개요
- 지원하는 파일 형식
- 필요한 외부 도구
- HTML 파일의 썸네일 이미지
- 설정
  - 설정 파일
  - 주요 설정 항목（fess_config.properties）
- generate-thumbnail 스크립트
- 썸네일 저장 위치
  - 기본 경로
  - 디렉터리 구조
- 썸네일 작업 비활성화
- 트러블슈팅
- 플랫폼 지원
데이터스토어 커넥터 가이드
- 데이터스토어 커넥터 개요
- Box 커넥터
- Dropbox 커넥터
- Google Workspace 커넥터
- Microsoft 365 커넥터
- Atlassian 커넥터
- Slack 커넥터
- Git 커넥터
- Elasticsearch/OpenSearch 커넥터
- Salesforce 커넥터
- 데이터베이스 커넥터(데이터베이스 검색)
- CSV 커넥터
- JSON 커넥터
검색 기능
- 개요
- 검색 결과 건수 표시
  - 기본 동작
  - 정확한 히트 건수 표시
- 검색 옵션
- 검색 결과 정렬
- 패싯 검색
- 검색 결과 하이라이트
- 추천 기능
- 검색 로그
- 성능 튜닝
- 문제 해결
검색 관련 설정
- 퍼지 검색
- 검색 시 타임아웃 값
- 검색 시 최대 문자 수
- 검색 시 타임아웃 로그 출력
- 히트 건수 표시
- 검색 결과의 최대 오프셋
- OR 검색에 의한 재검색 임계값
- 위치 정보 검색 시 필드명
- 요청 매개변수의 언어 지정
- 검색 대상 기본 언어
- 언어 코드 매핑
- 전방 일치 검색 지정
- 하이라이트 문자열
- 하이라이트 프래그먼트
- 하이라이트 생성 방법
- 하이라이트 대상 태그
- OpenSearch 하이라이터에 전달할 값
- 고급 하이라이트 설정
- 응답에 추가할 필드명
- 필드명 추가
- 유사 문서 접기(collapse)
- 검색 프리퍼런스
- 관련도(부스트) 설정
- 쿼리 타입 설정
- 프리픽스 검색 및 퍼지 검색 상세 설정
- 패싯 설정
- 검색 결과를 GSA 호환 XML 형식으로 가져올 때의 설정
위치 정보 검색
- 개요
- 활용 사례
- 설정 방법
  - 인덱스 생성 시 설정
  - 검색 시 설정
- 검색 예
- 필드 이름 사용자 정의
  - 기본 필드 이름 변경
- 구현 예
  - 웹 애플리케이션에서의 구현
  - Google Maps와의 연계
- 성능 최적화
  - 인덱스 설정 확인
  - 검색 범위와 응답 최적화
- 문제 해결
- 참고 정보
검색 결과 일괄 취득
- 개요
- 활용 사례
- 설정 방법
- 사용 방법
- 응답 형식
- 데이터 처리 예
- 성능 및 모범 사례
  - 효율적인 사용 방법
  - 메모리 사용량 최적화
- 보안 고려 사항
  - 접근 제한
  - 속도 제한
- 문제 해결
- 참고 정보
검색 폼 배치
- 검색 폼 배치 방법
  - 검색 폼
  - 제안 기능
하이브리드 검색과 Rank Fusion(시맨틱 + 키워드)
- 개요
- Rank Fusion이란
- 지원 알고리즘
  - RRF (Reciprocal Rank Fusion)
- 설정
  - fess_config.properties
  - JVM 시스템 프로퍼티
- 하이브리드 검색과의 연계
- 사용 예
  - 기본 하이브리드 검색
- 성능 고려 사항
  - 메모리 사용량
  - 처리 시간
- 문제 해결
- 참고 정보
역할 기반 검색 설정
- 역할 기반 검색에 대하여
- 역할 기반 검색 설정
가상 호스트
- 가상 호스트에 대하여
  - 시스템 설정
  - 크롤 설정
LDAP 통합 가이드
- 개요
- 지원 LDAP 서버
- 전제 조건
- 설정 방법 개요
- 연결·인증 설정
- LDAP 관리 기능·동작 설정
- Active Directory 설정
- OpenLDAP 설정
- 보안 설정
  - LDAPS(SSL/TLS)
  - 비밀번호 보호
- 페일오버
- 문제 해결
- 참고 정보
멀티테넌시 설정
- 개요
- 가상 호스트 기능
  - 구조
- 가상 호스트 헤더 설정
- 관리 화면에서 설정
  - 크롤 설정
- 접근 제어
  - 가상 호스트와 역할의 조합
  - 역할 기반 검색
- UI 커스터마이즈
- API 경유 접근
  - API 요청
- DNS 설정
  - 동일 서버로의 서브도메인
  - 리버스 프록시 설정
- 데이터 분리
  - 인덱스 레벨 분리
- 모범 사례
- 제한 사항
- 참고 정보
SAML 인증을 통한 SSO 설정
- 개요
  - SAML 인증의 구조
- 전제 조건
- 기본 설정
- IdP 측 설정
  - IdP에서 취득하는 정보
- 사용자 속성 매핑
  - 그룹 속성 설정
  - 역할 속성 설정
- 보안 설정
- 설정 예
  - 최소 구성（검증 환경용）
  - 권장 구성（운영 환경용）
- 문제 해결
  - 자주 발생하는 문제와 해결 방법
  - 디버그 설정
- 참고 정보
OpenID Connect를 통한 SSO 설정
- 개요
  - OpenID Connect 인증 동작 방식
- 전제조건
- 기본 설정
- OP 측 설정
  - OP에서 취득하는 정보
- 설정 예
  - 최소 구성（검증 환경용）
  - 권장 구성（운영 환경용）
- 문제 해결
  - 자주 발생하는 문제와 해결 방법
  - 디버그 설정
- 참고 정보
Microsoft Entra ID를 이용한 SSO 설정
- 개요
  - Entra ID 인증의 동작 방식
- 전제조건
- 기본 설정
- Entra ID 측 설정
- 그룹 및 역할 매핑
  - 중첩 그룹
  - 기본 그룹 설정
- 설정 예
- 문제 해결
  - 자주 발생하는 문제와 해결 방법
  - 디버그 설정
- 참고 정보
Windows 통합 인증을 통한 SSO 설정
- 개요
  - Windows 통합 인증의 동작 방식
- 전제조건
- Active Directory 측 설정
  - 서비스 프린시펄 이름(SPN) 등록
- 기본 설정
- LDAP 설정
- 브라우저 설정
- 설정 예
  - 최소 구성(검증용)
  - 권장 구성(프로덕션용)
- 문제 해결
  - 자주 발생하는 문제와 해결 방법
  - 디버그 설정
- 참고 정보
AI 검색(RAG) 및 LLM 통합 개요
- 개요
- 지원 프로바이더
  - 프로바이더 비교
- 플러그인 도입
- 아키텍처
- 기본 설정
  - 관리 화면의 전반 설정 / system.properties
  - fess_config.properties
- 공통 설정
- 세션 관리
- 동시 실행 제어
- 평가 설정
- 프롬프트 타입별 설정
  - 프롬프트 타입 목록
  - 설정 패턴
- 다음 단계
Ollama 설정 (로컬 LLM / RAG)
- 개요
  - 주요 특징
  - 지원 모델
- 전제조건
  - Ollama 설치
  - 모델 다운로드
- 플러그인 설치
- 기본 설정
  - 최소 구성
  - 권장 구성(프로덕션 환경)
- 설정 항목
  - 상세 설정
  - 동시 실행 제어
- 프롬프트 타입별 설정
- Ollama 모델 옵션
- 사고 모델 지원
  - 사고 레벨(thinking level)
- 네트워크 구성
  - Docker 구성
  - 원격 Ollama 서버
- HTTP 프록시 경유 사용
- 모델 선택 가이드
  - GPU 지원
- 문제 해결
- 참고 정보
OpenAI 설정 (AI 검색 / RAG)
- 개요
  - 주요 특징
  - 지원 모델
- 전제조건
  - API 키 발급
- 플러그인 설치
- 기본 설정
  - 최소 구성
  - 권장 구성(프로덕션 환경)
- 설정 항목
- 프롬프트 타입별 설정
- 재시도 동작
- 스트리밍과 사용량 정보
- 로그 출력 및 이상 감지
  - URL 로그 내 인증 정보 마스킹
- 추론 모델 지원
  - 추론 모델용 추가 파라미터
  - 설정 예
- JVM 옵션 설정
  - Docker 환경
  - systemd 환경
- HTTP 프록시 경유 사용
- Azure OpenAI 사용
- 모델 선택 가이드
  - 비용 기준
- 동시 요청 제어
  - OpenAI의 Tier별 제한
- 문제 해결
- 보안 관련 주의사항
- 참고 정보
Google Gemini 설정 (AI 검색 / RAG)
- 개요
  - 주요 특징
  - 지원 모델
- 전제조건
  - API 키 발급
- 플러그인 설치
- 기본 설정
  - fess_config.properties 설정
  - LLM 프로바이더 설정
    - 최소 구성
    - 권장 구성(프로덕션 환경)
- 설정 항목
- 인증 방식
- 재시도 동작
- 프롬프트 타입별 설정
- 사고 모델 지원
  - 모델 세대별 매핑
- JVM 옵션 설정
  - Docker 환경
  - systemd 환경
- HTTP 프록시 경유 사용
- Vertex AI 경유 사용
- 모델 선택 가이드
  - 컨텍스트 윈도우
  - 비용 기준
- 동시 요청 제어
  - 무료 할당량 제한(참고)
- 문제 해결
- 보안 관련 주의사항
- 참고 정보
AI 검색 모드 기능 설정
- 개요
- 검색 파이프라인
- AI 검색 모드의 구조
- 기본 설정
  - 코어 설정 (fess_config.properties)
  - 프로바이더 설정 (system.properties / 관리 화면)
- 설정 경로 빠른 참조
- 코어 설정 목록
- 생성 파라미터
- 컨텍스트 설정
- 시스템 프롬프트
  - 프롬프트 커스터마이즈
- 세션 관리
  - 세션 동작
- 동시 실행 제어
  - 동시 실행 제어 고려 사항
- 대화 이력 모드
- 쿼리 재생성
- Markdown 렌더링
- API 사용
- 웹 인터페이스
- 문제 해결
- 참고 정보
스크립팅 개요
- 개요
- 지원 스크립트 언어
- 스크립트 사용 장면
- 기본 구문
- 실행 컨텍스트와 사용 가능한 객체
- 보안
- 성능
- 디버그
- 참고 정보
Groovy 스크립트 가이드
- 개요
- 기본 구문
- 데이터 스토어 스크립트
- 사용 가능한 객체
- 스케줄 작업 스크립트
- Java 클래스 사용
- Fess 컴포넌트 접근
- 오류 처리
- 디버그와 로그 출력
  - 로그 출력
  - 디버그용 출력
- 모범 사례
- 참고 정보
속도 제한 설정
- 개요
- HTTP 요청 속도 제한
  - 설정
  - 동작
- AI 검색 모드 속도 제한
- 크롤러 속도 제한
  - 웹 크롤 설정
  - robots.txt 준수
- 속도 제한 전체 설정 항목
- 고급 속도 제한 설정
  - 커스텀 속도 제한
- 제외 설정
- 모니터링과 알림
  - 로그 출력
- 문제 해결
- 참고 정보
부하 제어 설정
- 개요
- HTTP 요청 부하 제어 설정
- 동작 원리
  - 모니터링 메커니즘
  - 요청 제어
- 설정 예시
  - 웹 요청만 제한하기
  - 웹과 API 모두 제한하기
- 속도 제한과의 차이
- 적응형 부하 제어
  - 설정
  - 동작
- 문제 해결
- 참고 정보
로그 설정
- 개요
- 로그 파일의 종류
- 로그 레벨 설정
- 크롤러 로그 설정
  - 스케줄러에서 설정
- 로그 로테이션
- 로그 모니터링
- 로그 형식
  - 기본 형식
  - 사용자 정의 형식 예
    - JSON 형식으로 로그 출력
    - 더 상세한 정보 포함
- 성능에 대한 영향
  - 모범 사례
  - 성능 측정
- 문제 해결
- 참고 정보
로그 통지
- 개요
- 동작 원리
- 설정
  - 활성화
    - 관리 화면에서 활성화
    - 시스템 프로퍼티를 통한 활성화
  - 통지 대상 설정
- 설정 프로퍼티
- 통지 메시지 형식
  - 메일 통지
  - Slack / Google Chat 통지
- 운영 가이드
  - 권장 설정
  - OpenSearch 인덱스
- 문제 해결
- 참고 정보
인덱스 관리
- 개요
- 인덱스 구성
- 인덱스 백업 및 복원
- 설정 파일 백업
  - 백업 대상 파일
  - 설정 파일 백업 예시
- 데이터 이전
  - 다른 환경으로의 이전 절차
  - 버전 업그레이드 시 주의 사항
- 문제 해결
- 관련 항목
- 참고 정보
인덱스 내보내기 기능
- 개요
- 작동 방식
- 설정 속성
- 작업 활성화
- 사용자 정의 쿼리 필터링
- 내보낸 파일 구조
- 모범 사례
- 문제 해결
- 관련 주제
Analyzer 설정
- Analyzer에 대하여
- Analyzer 정의 파일
- Analyzer 등록
- 사전에 의한 조정
- 주의사항
검색 로그 시각화 설정
- 검색 로그 시각화에 대하여
  - 시각화 가능한 정보
- OpenSearch Dashboards를 통한 데이터 시각화 설정