이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Apigee Edge 4.16.01을 4.16.05로 업데이트합니다.

Private Cloud용 Edge v. 4.16.05

4.16.05로 업데이트할 수 있는 Edge 버전

Apigee Edge 버전 4.16.01.x를 4.16.05로만 업데이트할 수 있습니다.

Edge 버전이 4.16.01.x 이전인 경우 먼저 버전 4.16.01.x로 마이그레이션한 다음 버전 4.16.05로 업데이트해야 합니다.

업데이트를 수행할 수 있는 사용자

업데이트를 실행하는 사용자는 원래 Edge를 설치한 사용자 또는 루트로 실행되는 사용자와 동일해야 합니다.

Edge RPM을 설치하면 모든 사용자가 구성할 수 있습니다.

자바 JDK 버전 8로 업그레이드해야 함

이 Edge 출시 버전에서는 모든 Edge 처리 노드에 자바 JDK 버전 8을 설치해야 합니다. Oracle JDK 8 또는 OpenJDK 8을 설치할 수 있습니다. 자바 JDK 8이 아직 설치되지 않은 경우 업데이트 스크립트가 자동으로 설치할 수 있습니다.

자바 8 업데이트의 일환으로 일부 TLS 암호화를 더 이상 Oracle JDK 8에서 사용할 수 없습니다. 전체 목록은 '기본적으로 사용 중지된 암호화 스위트' 섹션(http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html)을 참조하세요.

경고: 이 Edge 버전은 JDK 7을 지원하지 않습니다. 현재 JDK 7을 사용 중인 경우 JDK 8로 업그레이드해야 합니다. Edge 4.16.05 설치를 롤백하는 경우 자바 JDK 7을 사용하도록 Edge를 선택적으로 재구성할 수 있습니다.

Jokeeper 다운그레이드

Private Cloud용 Edge 4.16.01의 주키퍼 RPM 버전은 apigee-zookeeper-3.4.5-1.0.905.noarch.rpm입니다. Edge의 후속 버전에서는 주키퍼 버전이 apigee-zookeeper-3.4.5-0.0.948로 다시 변경되었습니다. 이렇게 하면 yum이 Jokeeper를 4.16.01에서 이후 버전으로 업그레이드할 수 없습니다. 이 상황을 상쇄하는 방법은 주키퍼를 업데이트하기 전에 yum 다운그레이드 apigee-zookeeper를 실행하는 것입니다.

다음 명령어를 사용하여 주키퍼 버전을 확인할 수 있습니다.

> rpm -qa |grep apigee-zookeeper

이 명령어가 주키퍼 버전을 반환하는 경우 다음을 실행합니다.

apigee-zookeeper-3.4.5-1.0.905

그런 다음 다운그레이드해야 합니다.

업데이트를 위한 디스크 공간 요구사항

업데이트를 수행하기 전에 1GB 이상의 디스크 여유 공간이 있는지 확인하세요.

4.16.01.x의 속성 설정 자동 전파

/opt/apigee/customer/application에서 .properties 파일을 수정하여 속성을 설정한 경우 이러한 값은 업데이트 시 보존됩니다.

apigee-validate 유틸리티 업데이트

4.16.01에서는 메시지 프로세서 노드에 apigee-validate 유틸리티를 설치하고 실행했습니다. 4.16.05에서 apigee-validate 유틸리티가 관리 서버 노드에서 실행되도록 업데이트되었습니다.

4.16.05로 업데이트하는 경우 apigee-validate 유틸리티를 업데이트하는 방법에 대해 두 가지 옵션이 있습니다.

Apigee 권장 - 관리 서버 노드에 apigee-validate 유틸리티를 설치하고 실행하세요.

원하는 경우 메시지 프로세서 노드에서 apigee-validate 유틸리티를 제거할 수 있습니다. 메시지 프로세서 노드에 그대로 두면 4.16.05로 업데이트해야 합니다.
또는 메시지 프로세서 노드의 apigee-validate 유틸리티를 업데이트하고 거기에서 실행하세요. 하지만 관리 서버에서 이를 설치하고 실행하는 것이 좋습니다.

기본 요건 업데이트

Apigee Edge를 업그레이드하기 전에 다음 기본 요건을 충족해야 합니다.

모든 노드 백업
업데이트하기 전에 안전을 위해 모든 노드의 전체 백업을 수행하는 것이 좋습니다. 현재 버전의 Edge에 대한 절차에 따라 백업을 수행합니다.

이렇게 하면 새 버전으로의 업데이트가 제대로 작동하지 않을 경우에 대비한 백업 계획을 마련할 수 있습니다. 백업에 대한 자세한 내용은 백업 및 복원을 참고하세요.
Edge가 실행 중인지 확인합니다.
다음 명령어를 사용하여 업데이트 프로세스 중에 Edge가 작동되어 실행 중인지 확인합니다.

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

업데이트 실패 처리

업데이트에 실패하면 문제 해결을 시도한 다음 update.sh를 다시 실행할 수 있습니다. 업데이트를 여러 번 실행할 수 있으며 마지막으로 중단된 부분부터 업데이트가 계속됩니다.

실패로 인해 업데이트를 이전 버전으로 롤백해야 하는 경우 4.16.05 롤백 프로세스에서 자세한 내용을 확인하세요.

Logging 업데이트 정보

기본적으로 update.sh 유틸리티는 다음 위치에 로그 정보를 작성합니다.

/opt/apigee/var/log/apigee-setup/update.log

update.sh 유틸리티를 실행하는 사용자에게 해당 디렉터리에 대한 액세스 권한이 없으면 로그를 /tmp 디렉터리에 update_username.log라는 파일로 작성합니다.

사용자가 /tmp에 액세스할 수 없는 경우 update.sh 유틸리티가 실패합니다.

제로 다운타임 업데이트

다운타임이 없는 업데이트 또는 순차적 업데이트를 사용하면 Edge를 중단하지 않고도 Edge 설치를 업데이트할 수 있습니다.

제로 다운타임 업데이트는 노드가 5개 이상인 구성에서만 가능합니다.

다운타임 없는 업그레이드의 핵심은 각 라우터를 한 번에 하나씩 부하 분산기에서 삭제하는 것입니다. 그런 다음 라우터와 동일한 머신의 라우터 및 기타 구성요소를 업데이트하고 라우터를 다시 부하 분산기에 추가합니다.

아래의 '머신 업데이트 순서'에 설명된 대로 설치 순서대로 머신을 업데이트합니다.
라우터를 업데이트할 때가 되면 서버(메시지 프로세서/라우터) 연결 가능성 사용 설정/사용 중지에 설명된 대로 라우터를 하나만 선택하고 연결할 수 없도록 설정합니다.
라우터와 동일한 머신에서 선택한 라우터 및 다른 모든 Edge 구성요소를 업데이트합니다. 모든 Edge 구성은 동일한 노드에 라우터와 메시지 프로세서를 표시합니다.
라우터에 다시 연결할 수 있도록 설정합니다.
나머지 라우터에 2~4단계를 반복합니다.
설치에 남아 있는 머신의 업데이트를 계속 진행합니다.

다음과 같은 업데이트 전/후에 유의하세요.

결합된 라우터 및 메시지 프로세서 노드에서 다음을 실행합니다.
- 업데이트 전: 다음 작업을 실행합니다.
  1. 라우터에 연결할 수 없도록 설정합니다.
  2. 메시지 프로세서에 연결할 수 없도록 설정합니다.
- 업데이트 후 - 다음을 수행합니다.
  1. 메시지 프로세서에 연결 가능하도록 설정합니다.
  2. 라우터에 연결할 수 있도록 설정합니다.
단일 라우터 노드에서:
- 업데이트하기 전에 라우터에 연결할 수 없도록 설정하세요.
- 업데이트 후 라우터에 연결할 수 있도록 설정합니다.
단일 메시지 프로세서 노드:
- 업데이트하기 전에 메시지 프로세서에 연결할 수 없도록 설정하세요.
- 업데이트 후에는 메시지 프로세서에 연결할 수 있도록 설정합니다.

자동 구성 파일 사용

update 명령어에 자동 구성 파일을 전달해야 합니다. 자동 구성 파일은 Edge 4.16.01을 설치하는 데 사용한 것과 동일해야 합니다.

외부 인터넷 연결이 있는 노드에서 4.16.05로 업데이트하는 절차

노드에서 Edge 구성요소를 업데이트하려면 다음 절차를 따르세요.

이 항목이 있다면 업데이트가 완료될 때까지 Cassandra에서 복구 작업을 수행하도록 구성된 크론 작업을 사용 중지합니다.
노드에 루트로 로그인하여 Edge RPM을 설치합니다.
참고: RPM 설치에는 루트 액세스가 필요하지만 루트 액세스 권한 없이 Edge 구성을 실행할 수도 있습니다.
Edge apigee-setup 유틸리티 설치에 설명된 대로 SELinux를 사용 중지합니다.
Edge 4.16.05 bootstrap_4.16.05.sh 파일을 /tmp/bootstrap_4.16.05.sh에 다운로드합니다.
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.
Edge 4.16.05 apigee-service 유틸리티와 종속 항목을 설치합니다.
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
여기서 uName:pWord는 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.
기본적으로 설치 프로그램은 자바 1.8이 설치되어 있는지 확인합니다. 그렇지 않으면 앱이 자동으로 설치됩니다. JAVA_FIX 옵션을 사용하여 자바 설치 처리 방법을 지정합니다. JAVA_FIX는 다음 값을 사용합니다.
I = Install OpenJDK 1.8 (기본값)
C = Java 설치 없이 계속
Q = Quit. 이 옵션의 경우 자바를 직접 설치해야 합니다.
apigee-service를 사용하여 apigee-setup 유틸리티를 업데이트합니다.
1. Edge 버전 4.15.07.0x를 업그레이드하여 4.16.01을 설치한 경우 apigee-setup 유틸리티를 설치해야 합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  이 명령어는 <inst_dir>/apigee/apigee-setup/bin에 update.sh 유틸리티를 설치합니다.
  
  apigee-setup 유틸리티를 이미 설치한 경우 업데이트합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. 4.16.01을 직접 설치한 경우, 즉 4.15.07.0x에서 업그레이드를 실행하지 않은 경우 apigee-setup 유틸리티를 업데이트해야 합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  이 업데이트는 apigee-service apigee-setup update
  이 apigee-service를 사용하여 update/apigee_setup 유틸리티를 설치합습니다.
관리 서버에 apigee-validate 유틸리티를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
참고: 메시지 프로세서 노드에 apigee-validate 유틸리티를 설치했다면 해당 노드에서 다음 명령어를 사용해 업데이트할 수 있습니다.
> /opt/apigee/apigee-service/bin/apigee-
apigee-validate 유틸리티에 전달된 구성 파일을 수정합니다. 이전 Edge 출시에서는 apigee-validate에서 사용한 구성 파일에 다음 속성이 필요했습니다.
APIGEE_ADMINPW=sysAdminPword
MP_POD=Gateway
REGION=dc-1
이 출시 버전에서는 구성 파일에 APIGEE_ADMINPW 속성만 필요합니다. 파일에서 다른 두 개의 속성을 삭제해도 됩니다.
아래의 '머신 업데이트 순서'에 설명된 순서대로 노드에서 업데이트 유틸리티를 실행합니다.
> /opt/apigee/apigee-setup/bin/update.sh -ccomponent -f configFile
구성 파일의 유일한 요구사항은 'apigee' 사용자가 구성 파일에 액세스하거나 읽을 수 있어야 한다는 것입니다. 예를 들어, 노드의 /tmp 디렉터리에 파일을 저장합니다.
'-c' 옵션을 사용하여 업데이트할 구성요소를 지정합니다. 가능한 구성요소 목록에는 다음이 포함됩니다.
- ldap = OpenLDAP(OpenLDAP)
- cs = Cassandra
- zk = 동물원키퍼
- qpid = qpidd
- ps = postgresql
- edge =Edge UI를 제외한 모든 에지 구성요소: 관리 서버, 메시지 프로세서, 라우터, QPID 서버, Postgres 서버
- ui = Edge UI
- all = 머신의 모든 구성요소 업데이트 (Edge aio 설치 프로필 또는 API BaaS asa 설치 프로필에만 사용)
- e = ElasticSearch
- b = API BaaS 스택
- p = API BaaS 포털
- ebp = 동일한 노드에 있는 ElasticSearch, API BaaS 스택 및 API BaaS 포털
설치 테스트에 설명된 대로 관리 서버에서 apigee-validate 유틸리티를 실행하여 업데이트를 테스트합니다.

나중에 업데이트를 롤백하려면 4.16.05 롤백 프로세스에 설명된 절차를 따르세요.

로컬 저장소에서 4.16.05로 업데이트하는 절차

Edge 노드가 방화벽으로 보호되거나 어떤 방식으로든 인터넷을 통해 Apigee 저장소에 액세스하는 것이 금지된 경우 Apigee 저장소의 로컬 저장소 또는 미러링에서 업데이트를 수행할 수 있습니다.

로컬 Edge 저장소를 만든 후 로컬 저장소에서 Edge를 업데이트하는 방법에는 두 가지가 있습니다.

저장소의 .tar 파일을 만들고 .tar 파일을 노드에 복사한 다음 .tar 파일에서 Edge를 업데이트합니다.
다른 노드에서 액세스할 수 있도록 로컬 저장소가 있는 노드에 웹 서버를 설치합니다. Apigee에서 제공하는 Nginx 웹 서버를 사용하거나 자체 웹 서버를 사용할 수 있습니다.

로컬 4.16.05 저장소에서 업데이트하려면 다음 단계를 따르세요.

Edge apigee-setup 유틸리티 설치의 '로컬 Apigee 저장소 만들기'에 설명된 대로 로컬 4.16.05 저장소를 만듭니다.
참고: 기존 4.16.01 저장소가 이미 있으면 4.16.05 저장소를 추가할 수 있습니다.
.tar 파일에서 apigee-service를 설치하려면 다음 안내를 따르세요.
1. 로컬 저장소가 있는 노드에서 다음 명령어를 사용하여 로컬 저장소를 /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz라는 단일 .tar 파일로 패키징합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. Edge를 업데이트하려는 노드에 .tar 파일을 복사합니다. 예를 들어 새 노드의 /tmp 디렉터리에 이 파일을 복사합니다.
3. 새 노드에서 파일을 /tmp 디렉터리로 압축 해제합니다.
  > tar -xzf apigee-4.16.05.tar.gz
  이 명령어는 .tar 파일이 있는 디렉터리에 repos라는 새 디렉터리를 만듭니다. 예를 들면 /tmp/repos입니다.
4. /tmp/repos의 Edge apigee-service 유틸리티와 종속 항목을 설치합니다.
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  이 명령어에는 저장소 디렉터리의 경로가 포함되어 있습니다.
Nginx 웹 서버를 사용하여 apigee-service를 설치하려면 다음 안내를 따르세요.
1. Edge apigee-setup 유틸리티 설치의 'Nginx 웹 서버를 사용하여 저장소에서 설치'에 설명된 대로 Nginx 웹 서버를 구성합니다.
2. 원격 노드에서 Edge bootstrap_4.16.05.sh 파일을 다운로드합니다.
3. 원격 노드에 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=http://
  여기에서 uName.Protocol=http://
  pWord
apigee-service를 사용하여 apigee-setup 유틸리티를 업데이트합니다.
1. Edge 버전 4.15.07.0x를 업그레이드하여 4.16.01을 설치한 경우 apigee-setup 유틸리티를 설치해야 합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  이 명령어는 <inst_dir>/apigee.apigee-setup/bin에 update.sh 유틸리티를 설치합니다.
  
  apigee-setup 유틸리티를 이미 설치한 경우 업데이트합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. 4.16.01을 직접 설치한 경우(즉, 4.15.07.0x에서 업그레이드를 실행하지 않은 경우) apigee-setup 유틸리티를 업데이트해야 합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  이 업데이트는 <apigee-service를 통해 update.shst_setup/apigeebin> 의 유틸리티를 설치합니다.
관리 서버 노드에 apigee-validate 유틸리티를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
참고: apigee-validate 유틸리티를 메시지 프로세서 노드에 설치한 경우 해당 노드에서 다음 명령어를 사용하여 업데이트할 수 있습니다.

> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
하지만 4.16.05의 경우 Apigee에서 관리 서버에 apigee-validate 유틸리티를 설치하고 실행하는 것이 좋습니다.
apigee-validate 유틸리티에 전달된 구성 파일을 수정합니다. 이전 Edge 출시에서는 apigee-validate에서 사용한 구성 파일에 다음 속성이 필요했습니다.
APIGEE_ADMINPW=sysAdminPword
MP_POD=Gateway
REGION=dc-1
이 출시 버전에서는 구성 파일에 APIGEE_ADMINPW 속성만 필요합니다. 파일에서 다른 두 개의 속성을 삭제해도 됩니다.
아래의 '머신 업데이트 순서'에 설명된 순서대로 노드에서 업데이트 유틸리티를 실행합니다.
> /opt/apigee/apigee-setup/bin/update.sh -ccomponent -f configFile
구성 파일의 유일한 요구사항은 'apigee' 사용자가 구성 파일에 액세스하거나 읽을 수 있어야 한다는 것입니다. 예를 들어, 노드의 /tmp 디렉터리에 파일을 저장합니다.
'-c' 옵션을 사용하여 업데이트할 구성요소를 지정합니다. 가능한 구성요소 목록에는 다음이 포함됩니다.
- ldap = OpenLDAP(OpenLDAP)
- cs = Cassandra
- zk = 동물원키퍼
- qpid = qpidd
- ps = postgresql
- edge =Edge UI를 제외한 모든 에지 구성요소: 관리 서버, 메시지 프로세서, 라우터, QPID 서버, Postgres 서버
- ui = Edge UI
- all = 머신의 모든 구성요소 업데이트 (Edge aio 설치 프로필 또는 API BaaS asa 설치 프로필에만 사용)
- e = ElasticSearch
- b = API BaaS 스택
- p = API BaaS 포털
- ebp = 동일한 노드에 있는 ElasticSearch, API BaaS 스택 및 API BaaS 포털
설치 테스트에 설명된 대로 관리 서버에서 apigee-validate 유틸리티를 실행하여 업데이트를 테스트합니다.

나중에 업데이트를 롤백하려면 4.16.05 롤백 프로세스에 설명된 절차를 따르세요.

머신 업데이트 순서

Edge 설치에서 머신을 업데이트하는 순서가 중요합니다. 업데이트에서 가장 중요한 고려사항은 다음과 같습니다.

다른 노드를 업데이트하기 전에 모든 Cassandra 및 JoKeeper 노드를 업데이트해야 합니다.
라우터 및 메시지 프로세서 노드를 업데이트하기 전에 모든 qpidd 및 postgresql 노드를 업데이트해야 합니다.
에지 구성요소 (관리 서버, 메시지 프로세서, 라우터, QPID 서버, Postgres 서버)가 여러 개 있는 시스템의 경우 '-c Edge' 옵션을 사용하여 한 번에 모두 업데이트할 수 있습니다.
단계에서 여러 머신에서 수행해야 한다고 지정하는 경우에는 지정된 머신 순서로 수행합니다.
수익 창출을 업데이트하기 위한 별도의 단계는 없습니다. 이는 '-c Edge' 옵션을 지정하면 업데이트됩니다.
라우터 노드를 업데이트한 후에는 /opt/nginx/conf.d 디렉터리에서 모든 파일을 삭제한 후 라우터를 다시 시작해야 합니다.