KB: Elasticsearch를 초기화할 수 없어 Altium Enterprise Server가 시작되지 않는 문제
Updated: September 23, 2026
Elasticsearch 서비스가 초기화되지 않으면 Altium On-Prem Enterprise Server(AES)가 시작되지 않을 수 있습니다. 이전 AES 버전에서 관찰된 원인 중 하나는 서비스 계정이 사용하는 Windows 임시 디렉터리에 Elasticsearch 폴더가 없거나 해당 폴더에 접근할 수 없는 경우입니다. Elasticsearch 서비스가 시작되지 않으면 로그를 검토하고 임시 디렉터리, 접근 권한, 사용 가능한 디스크 공간, 검색 인덱스 상태를 확인하세요. 임시 폴더가 없어 문제가 발생한 경우, 해당 폴더를 다시 생성하고 서비스를 재시작하면 정상 작동이 복구될 수 있습니다. 일반적으로 최신 AES 버전에서는 이러한 문제가 해결되었을 것으로 예상됩니다.
해결 방법 상세 정보
Elasticsearch 시작 실패로 인한 서버 접근 불가
Windows Services 콘솔에서 Elasticsearch 서비스를 시작하려고 할 때 다음 오류가 표시될 수 있습니다:
Windows could not start the Elasticsearch service.
Elasticsearch 초기화에 실패하면 Altium On-Prem Enterprise Server가 시작을 완료할 수 없으며 검색 관련 기능을 사용할 수 없습니다.
임시 폴더 누락으로 인한 시작 실패
서비스 시작 오류만으로는 구체적인 근본 원인을 알 수 없습니다. 가능한 원인으로는 디스크 공간 부족, 검색 인덱스 문제, 권한 문제 또는 임시 디렉터리 접근 불가 등이 있습니다.
이전 AES 버전의 지원 사례에서는 정리 작업, 유지보수 작업 또는 타사 백업 프로세스 이후 Elasticsearch 임시 폴더가 누락된 경우가 확인되었습니다. 이로 인해 서비스가 시작 시 정상적으로 초기화되지 못했습니다.
임시 디렉터리는 서비스를 실행하는 계정에 따라 달라집니다. 일반적인 예는 다음과 같습니다:
C:\Users\username\AppData\Local\Temp
변경하기 전에 환경 확인
- 다음 위치에 있는 Elasticsearch 로그를 검토합니다:
C:\ProgramData\Altium\Altium365Data\logs\ElasticSearch - Elasticsearch 서비스를 실행하도록 설정된 계정을 확인합니다.
- 해당 계정이 실제로 사용하는 임시 디렉터리를 확인합니다.
- 임시 디렉터리에 Elasticsearch 폴더가 있는지 확인합니다.
- 서비스 계정에 해당 폴더에 대한 적절한 접근 권한이 있는지 확인합니다.
- 디스크 공간이 충분한지 확인합니다.
- Enterprise Server Health Monitor에서 Elasticsearch 또는 검색 인덱스 관련 경고를 확인합니다.
- 로그에서 임시 폴더가 누락되었거나 접근할 수 없는 것으로 확인되면 폴더를 다시 생성하고 서비스를 다시 시작합니다.
- 이전 릴리스를 사용 중이라면 현재 지원되는 AES 버전으로 업그레이드하는 것을 고려합니다.
임시 폴더 재생성 및 서비스 다시 시작 절차
- Windows Services 콘솔을 열고 Elasticsearch 서비스를 실행하도록 설정된 계정을 확인합니다.
- 해당 계정과 연결된 임시 디렉터리로 이동합니다. 예:
C:\Users\username\AppData\Local\Temp - Elasticsearch 폴더가 있는지 확인합니다.
- 폴더가 없으면 Elasticsearch 이름으로 새 빈 폴더를 생성합니다. 폴더에 파일을 복원하거나 복사할 필요는 없습니다.
- Elasticsearch 서비스 계정에 다시 생성한 폴더에 접근할 수 있는 충분한 권한이 있는지 확인합니다.
- Windows Services 콘솔에서 Elasticsearch 서비스를 찾습니다.
- Restart을 선택합니다. 서비스가 중지되어 있으면 Start을 선택합니다.
- 서비스 상태가 Running 상태로 변경되는지 확인합니다.
- 서비스가 시작되지 않으면 다음 위치의 Elasticsearch 로그를 검토합니다:
C:\ProgramData\Altium\Altium365Data\logs\ElasticSearch
또한 임시 디렉터리 구조와 권한이 올바르게 유지되어 있는지 확인합니다. - AES를 시작합니다.
- 다음 사항을 확인합니다:
- Elasticsearch 서비스 상태가 Running 상태입니다.
- AES가 정상적으로 시작됩니다.
- 검색 및 인덱싱 기능이 정상적으로 작동합니다.