Elasticsearch는 단계적인 규칙으로 이루어진 upgrade process를 이용하여 서비스 중단 없이 upgrade될 수 있다.  이 섹션에서는 어떻게 단계적으로 upgrade를 수행하거나 재시작할 수 있는지를 살펴본다. Rolling upgrade를 설치하고자 하는 elasticsearch release에서 지원하는지 아닌지 알기 위해서 다음 표를 활용하라.

[TIP]

Elasticsearch를 upgrade하기 전에 breaking changes (http://www.elastic.co/guide/en/elasticsearch/reference/current/breaking-changes.html) docs를 통해 컨설팅을 받아보는 것도 좋은 생각이다.

Backup Your Data!

Upgarde를 수행하기 전에 system의 data를 backup 하는 것이 좋다. Upgrade과정 중에 오류가 발생해서 원래 상태로 roll back하는데 필요하다. Upgrade는 때로 Elasticsearch가 index file에 접근하는데 필요한 Lucene libraries를 upgrade하기도 한다. 그리고 한번 Lucene이 새로운 버전으로 upgrade되고 나면, 이전 버전의 elasticsearch release에서는 현재 Lucene 버전으로 접근할 수 없다.

0.90.x 이전 버전

0.90.x system을 백업하고, index flushing을 하지 않도록 한다. 백업 과정에서 index를 disk에 flush하지 않도록 방지한다.

$ curl -XPUT 'http://localhost:9200/_all/_settings' -d '{
   "index": {
      "translog.disable_flush": "true"
   }
}'

그리고 재할당을 하지 않도록 한다. 백업 과정 중에 하나의 노드로부터 다른 노드로 data를 옮기는 것을 방지한다.

$ curl -XPUT 'http://localhost:9200/_cluster/settings' -d '{
   "transient" : {
      "cluster.routing.allocation.disable_allocation": "true"
   }
}'

재할당과 index flush를 하지 않도록 설정한 다음에, 선호하는 백업 방식(tar, storage array snapshot, backup software)으로 Elasticsearch Data를 백업한다. 백업이 완료되고 더 이상 Elasticsearch data path에서 읽을 데이터가 없으면 재할당과 index flush를 가능하도록 설정한다.

$ curl -XPUT 'http://localhost:9200/_all/_settings' -d '{
   "index": {
      "translog.disable_flush": "false"
   }
}'

$ curl -XPUT 'http://localhost:9200/_cluster/settings' -d '{
   "transient" : {
      "cluster.routing.allocation.disable_allocation": "false"
   }
}'

1.0 이후 버전

1.0 이후 버전을 백업하기 위해서는 snapshot 기능을 사용하여 간단하게 할 수 있다. 자세한 방법은 backup and restore with snapshots (http://www.elastic.co/guide/en/elasticsearch/reference/current/modules-snapshots.html) 을 통해서 알 수 있다.

APT나 YUM 기반 배포판을 이용할 수 있도록 Repositories도 제공하고 있다. Source가 아니라 Elasticsearch를 빌드한 Binary package만을 제공한다. Major 버전을 통한 우발적인 upgrade를 피하기 위해서 major 버전별로 url을 나누었다. 0.90.x 버전은 전부 0.90으로, 1.0.x는 1.0으로, 1.1.x는 1.1과 같은 숫자로 표시한다.

Elasticsearch의 서명 키로는 PGP key D88E42B4 를 사용한다.

Fingerprint는 다음과 같다.

4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4

http://pgp.mit.edu 에서 사용할 수 있다.

APT

Public Singing Key를 다운로드 하고 설치한다.

wget -qO - https://packages.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -

/etc/apt/source.list 파일에 repositories 정의를 추가한다.

echo "deb http://packages.elastic.co/elasticsearch/1.5/debian stable main" | sudo tee -a /etc/apt/sources.list

[WARINIG]

Elasticsearch repositories를 추구하기 위해서 echo method를 사용하라. Source를 제공하지 않기 때문에 Add-apt-repository나 deb-src를 사용하지 말라. Deb-src entry를 추가했다면, 다음과 같은 error가 발생할 것이다.

Unable to find expected entry 'main/source/Sources' in Release file (Wrong sources.list entry or malformed file)

Just delete the deb-src entry from the /etc/apt/sources.list file and the installation should work as expected.

Repository가 준비되었다면 apt-get update를 실행하라. 다음과 같이 설치할 수 있다.

sudo apt-get update && sudo apt-get install elasticsearch

부팅할 때 자동으로 Elasticsearch를 실행하도록 설정하려면 다음과 같이 하면 된다.

sudo update-rc.d elasticsearch defaults 95 10

YUM

public Signing Key를 다운로드 받아서 설치한다.

rpm --import https://packages.elastic.co/GPG-KEY-elasticsearch

/etc/yum.repos.d/ 디렉토리에 .repo 확장자를 가진 파일을 추가하라. 예를 들어 elasticsearch.repo 파일을 만든다.

[elasticsearch-1.5]
name=Elasticsearch repository for 1.5.x packages
baseurl=http://packages.elastic.co/elasticsearch/1.5/centos
gpgcheck=1
gpgkey=http://packages.elastic.co/GPG-KEY-elasticsearch
enabled=1

그러면 repository를 사용할 준비가 된 것이다. 이제 설치할 수 있다.

yum install elasticsearch

부팅 시에 elasticsearch를 자동으로 시작하도록 설정해 보자. SysV init을 사용한 배포판이라면 다음과 같이 실행할 수 있다.

chkconfig --add elasticsearch

[WARNING]

CentOS5와 같은 RPM v3을 사용한 예전 rpm 기반 배포판이라면 repositories는 동작하지 않는다.

아니면 systemd를 사용하여 설치할 수 있다.

sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable elasticsearch.service

설치된 이후 폴더 구조는 다음과 같다.

Multiple data location은 stripe를 허용한다. Striping은 간단하게 하나의 location에 모든 파일을 위치시킬 수도 있고, index.store.distributor의 값에 근거해서 파일 위치를 결정할 수도 있다.

• least_used (default) : 항상 가장 적합한 space로 directory를 선택한다.

• random : 랜덤하게 directory를 선택한다. 특정 디렉토리가 선택될 가능성은 디렉토리에서 이용할 수 있는 space에 비례한다. 즉, 이용가능한 space가 많을수록 선택될 가능성이 높아진다.

동일한 데이터를 여러 번 복사하는 것이 아니라, RAID 0과 같음에 유의하라. 간단하지만, RAID를 사용하여 복잡하게 구성하고 싶지 않은 사람들에게 좋은 솔루션이 될 수 있다. 다음과 같이 설정하면 된다.

path.data: /mnt/first, /mnt/second

혹은 다음과 같이 array 형태로 설정할 수도 있다.

path.data: ["/mnt/first", "/mnt/second"]

Default Paths

아래 값들은 특별히 수정하지 않았다면, elasticsearch가 사용하는 default path들이다.

deb and rpm

zip and tar.gz