5.2. 단일 인스턴스 업그레이드
이 섹션에서는 단일 Neo4j 인스턴스를 업그레이드하는 방법을 설명합니다.
Neo4j HA클러스터(Neo4j Enterprise Edition)를 업그레이드하려면 매우 구체적인 절차를 따라야 합니다. 섹션 5.4,"Neo4j HA클러스터 업그레이드"를 참조하십시오.
5.2.1. 2.x에서 업그레이드
데비안을 사용하는 경우 섹션 2.2.1.2"업그레이드"를 참조하십시오.
- 데이터베이스가 실행 중이면 완전히 종료합니다.
- 데이터베이스 디렉터리와 neo4j.conf의 백업 복사본을 만듭니다.
- Neo4j EnterpriseEdition과 함께 제공되는 온라인 백업 도구를 사용하는 경우 백업이 성공적으로 완료되었는지 확인합니다.
이전 설치의 구성 파일에 있는 설정을 검토하고 모든 사용자 지정 설정을 3.3.5 설치에 적용합니다.
· Neo4j 2.x와 3.3.5 사이에 많은 설정이 변경되었으므로 2.x-config-migrator(tools 디렉터리에서 포함)를 사용하여 구성 파일을 마이 그레이션 하는 것이 좋습니다. 예를 들어 다음과 같은 명령으로 2.x-config-migrator를 호출할 수 있습니다.
java -jar 2.x-config-migrator.jar path/to/neo4j2.3 path/to/neo4j3.3.5
.
· 출력된 경고를 메모하고 편집된 구성 파일을 수동으로 검토합니다.다음 명령을 사용하여 이전 설치에서 데이터를 가져옵니다.
neo4j-admin import --mode=database --database=<database-name> --from=<source-directory>
데이터베이스를 graph.db라고 하지 않는 경우 neo4j.conf 에서
dbms.active_database
를 데이터베이스 이름으로 설정합니다.- 3.3.5 설치의 neo4j.conf 에서
dbms.allow_format_migration=true
로 설정합니다. 이 설정을 안하면 Neo4j는 기동에 실패합니다. - Neo4j 3.3.5.를 시작합니다. 데이터베이스 업그레이드는 시작할 때 수행됩니다.
- 업그레이드 및 진행률에 대한 자세한 내용은 debug.log에 기록됩니다.
- 업그레이드가 완료되면
dbms.allow_upgrade
옵션은false
로 설정되거나 제거되어야 합니다. 업그레이드 후에는 즉시 전체 백업을 수행하는 것이 좋습니다.
사이퍼 호환성
Cypher언어는 Neo4j 버전 사이에서 진화할 수 있습니다. 이전 버전과의 호환성을 위해 Neo4j는 이전 Cypher언어 버전을 명시적으로 선택할 수 있는 지침을 제공합니다. 이 작업은 Neo4j Developer Manual에 설명된 대로 전체 또는 개별 문장에 대해 적용할 수 있습니다.
5.2.2. 3.x에서 업그레이드
- 데이터베이스가 실행 중이면 완전히 종료합니다.
- 데이터베이스 디렉터리와 neo4j.conf의 백업 복사본을 만듭니다.
Neo4j Enterprise Edition와 함께 제공되는 온라인 백업 도구를 사용하는 경우 백업이 성공적으로 완료되었는지 확인합니다. - 다음 방법 중 하나를 사용하여 Neo4j를 설치합니다.
a. 설치 시 tarball또는 zip파일을 사용하는 경우:
i. Neo4j 3.3.5의 압축을 풉니다.
ii. 이전 설치의 neo4j.conf 에 있는 설정을 검토하고 모든 사용자 지정 설정을 3.3.5 설치로 전송합니다. 특히dbms.directories.data
및dbms.active_database
에 주의해야 합니다.
iii. 3.3.5 설치의 neo4j.conf 에서dbms.allow_format_migration=true
로 설정합니다. 이 설정을 안하면 Neo4j는 기동에 실패합니다.
iv. 이전 설치의 data 디렉터리를 새 설치로 복사합니다.dbms.directories.data
가 NEO4J_HOME 외부의 디렉터리를 가리키는 경우에는 이 단계를 적용할수 없습니다.
b. Debian또는 RPM 배포를 사용하는 경우:
i. neo4j.conf에서dbms.allow_upgrade=true
로 설정합니다.
ii. Neo4j 3.3.5를 설치합니다.
iii. 메시지가 표시되면 이전 버전과 Neo4j 3.3.5 의 neo4j.conf 파일의 차이를 검토하고 사용자가 지정한 설정을 전송합니다. 위의 지침에 설정한 대로dbms.allow_format_migration=true
로 설정합니다. 이 설정을 안하면 Neo4j는 기동에 실패합니다. - Neo4j 3.3.5.를 시작합니다. 데이터베이스 업그레이드는 시작할 때 수행됩니다.
- 업그레이드 및 진행률에 대한 자세한 내용은 debug.log에 기록됩니다.
- 업그레이드가 완료되면
dbms.allow_upgrade
옵션은false
로 설정되거나 제거되어야 합니다. - 업그레이드 후에는 즉시 전체 백업을 수행하는 것이 좋습니다.