※ webMethods API Gateway 10.15 - Elasticsearch (8.2.3) 주요 변경 사항

  • Configuration - API Analytics 데이터 분리
    • API Gateway Configuration 데이터와, API Analytics 데이터의 분리 (nodes 로만 구성되었던 (10.11) 디렉터리가 세분화 됨)
      • _state : 변하지 않는 Configuration 데이터들인 듯 하며, 추가 확인 필요
      • indices : 기존 API Gateway 데이터 저장 디렉터리 (인덱스)
      • snapshot_cache : Backup 용 segments 파일들이 저장되는 공간 인 듯 하며, 추가 확인 필요

스냅샷 기능은 외부 클라우드 저장소에 저장하기 위해 파일(segments)을 생성하는 듯 하나,
API Gateway에서는 DR 을 위해 로컬에 segments 파일을 저장 하는 듯 함.



  • Elatsicsearch 를 실행 시 인덱스 별 write.lock 파일이 생성
    • find ./ -name "*.lock" 명령으로 확인 가능
    • 해당 파일들이 서버 다운 후 API GW 재 기동 시 문제를 일으키는 경우 발생




※ 메인 서버 다운 후 재 기동 시 이슈

Elasticsearch is not ready to serve the requests. 로그가 지속적으로 발생

  • 오류 원인
    • 메인 서버가 강제 다운 되면 프로세스는 Kill 되지만 .lock 파일들이 남아있어 생기는 현상


  • 해결 방안
    • InternalDatastore 폴더 아래 .lock 파일을 모두 삭제 후 API Gateway 재 기동
$ cd {SAG_HOME}/InternalDataStore/data


$ find ./ -name "*.lock" | xargs rm





$ cd {SAG_HOME}/IntegrationServer/instances/default/bin/


$ ./startup.sh

Note. node.lock 파일은 영향이 없으나 아래 write.lock 파일들이 기동 시 영향이 있는 듯 하다.