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

Apigee Edge 4.16.01/4.16.05를 4.17.09로 업데이트합니다.

Private Cloud용 Edge v. 4.17.09

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

이 절차에 따라 Apigee Edge 버전 4.16.01.0x 및 4.16.05.x를 4.17.09로 업데이트할 수 있습니다.

Edge 버전 4.16.01 이전이 있는 경우 먼저 버전 4.16.01로 마이그레이션한 후 버전 4.17.09로 업데이트해야 합니다.

Apigee Edge 버전 4.15.07을 4.16.01로 이전할 수 있습니다.
버전 4.15.07 이전 버전의 Edge를 사용하는 경우 먼저 버전 4.15.07로 이전한 다음 버전 4.16.01로 이전해야 합니다.
- Edge 버전 4.14.04 이상에서 이전하는 경우: 버전 4.15.07로 직접 이전합니다.
- Edge 버전 4.14.01에서 이전하는 경우: 먼저 버전 4.14.04로 이전한 다음 버전 4.15.07로 이전해야 합니다.

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

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

Edge RPM을 설치한 후에는 모든 사용자가 구성할 수 있습니다.

업데이트해야 하는 구성요소

모든 Edge 구성요소를 업데이트해야 합니다. Edge는 여러 버전의 구성요소가 포함된 설정을 지원하지 않습니다.

4.16.01에서 업데이트하는 경우 Zookeeper 다운그레이드

Private Cloud용 Edge 4.16.01에서 주키퍼 RPM의 버전은 apigee-zookeeper-3.4.5-1.0.905.noarch.rpm입니다. 후속 Edge 버전에서 Zookeeper 버전이 apigee-zookeeper-3.4.5-0.0.94x로 다시 변경되었습니다. 이렇게 하면 yum이 Zookeeper를 4.16.01에서 이후 버전으로 업그레이드하지 못합니다. 이 문제를 해결하려면 Zookeeper를 업데이트하기 전에 yum downgrade apigee-zookeeper를 실행합니다.

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

> rpm -qa |grep apigee-zookeeper

이 명령어가 Zookeeper 버전을 반환하는 경우:

apigee-zookeeper-3.4.5-1.0.905

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

숙박 시설 설정 자동 전파

/opt/apigee/customer/application에서 .properties 파일을 편집하여 속성을 설정한 경우에는 이 값이 업데이트에 의해 유지됩니다.

기본 요건 업데이트

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

모든 노드 백업
업데이트하기 전에 안전을 위해 모든 노드를 완전히 백업하는 것이 좋습니다. 현재 버전의 Edge에 해당하는 절차에 따라 백업을 실행합니다.

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

> /opt/apigee/apigee-service/bin/apigee-all status

업데이트 실패 처리

업데이트에 실패한 경우 문제를 해결한 후 update.sh를 다시 실행해 보세요. 업데이트를 여러 번 실행할 수 있으며, 업데이트는 마지막으로 중단된 지점부터 계속 진행됩니다.

실패로 인해 업데이트를 이전 버전으로 롤백해야 하는 경우 4.17.09 롤백 프로세스를 참고하세요.

업데이트 정보 로깅

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

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

update.sh 유틸리티를 실행하는 사용자가 해당 디렉터리에 액세스할 수 없는 경우 로그를 /tmp 디렉터리에 update_username.log라는 파일로 씁니다.

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

Java JDK 버전 8로 업그레이드 필요

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

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

EPEL 저장소를 사용 설정하는 데 필요

Edge를 설치하거나 업데이트하려면 Enterprise Linux용 추가 패키지 (EPEL)를 사용 설정해야 합니다. 사용하는 명령어는 사용 중인 RedHat/CentOS 버전에 따라 다릅니다.

RedHat/CentOS 7.x의 경우:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
RedHat/CentOS 6.x의 경우:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

SMTPMAILFROM 구성 매개변수 추가 필요

Edge 4.17.05에서는 SMTP 서버를 사용 설정할 때 사용되는 구성 파일에 새로운 필수 매개변수가 추가되었습니다. 4.17.01에서 업데이트하는 경우 SMTP 서버를 사용 설정할 때 구성 파일에서 SMTPMAILFROM을 설정해야 합니다.

API BaaS 버전 4.17.09에서는 SMTPMAILFROM 속성 지원도 추가되었습니다. API BaaS를 업데이트할 때는 구성 파일에서 SMTPMAILFROM을 설정해야 합니다.

이 매개변수의 형식은 다음과 같습니다.

SMTPMAILFROM="My Company <myco@company.com>"

외부 인증을 사용할 때 업데이트하는 경우 필요

외부 디렉터리 서비스를 기존 Apigee Edge 프라이빗 클라우드 설치에 통합할 수 있습니다. 이 기능은 Active Directory, OpenLDAP 등 LDAP를 지원하는 모든 디렉터리 서비스에서 작동하도록 설계되었습니다. 외부 LDAP 솔루션을 사용하면 시스템 관리자가 사용자 인증 정보를 사용하는 Apigee Edge와 같은 시스템 외부의 중앙 집중식 디렉터리 관리 서비스에서 사용자 인증 정보를 관리할 수 있습니다.

자세한 내용은 외부 인증 구성을 참고하세요.

외부 인증이 사용 설정된 경우 대부분의 고객은 Edge OpenLDAP 서버에서 사용하는 이메일 주소 대신 Active Directory SAM 계정 이름 필드를 인증 사용자 이름으로 사용합니다.

외부 디렉터리 서비스와 통합한 경우 Edge를 4.17.09로 업데이트할 때 구성 파일에 다음 줄을 추가합니다.

IS_EXTERNAL_AUTH="true"

이 줄은 Edge가 이메일 주소가 아닌 계정 이름을 사용자 이름으로 지원하도록 구성합니다.

Qpid 1.35로 업그레이드해야 함

이 출시에는 Qpid 1.35의 필수 업데이트가 포함되어 있습니다. Qpid 노드를 업데이트하는 과정에서 다음을 수행해야 합니다.

Qpid 노드에서 포트 5672를 차단하여 라우터와 메시지 프로세서가 Qpid 노드에 쓰지 못하도록 일시적으로 방지합니다. 다음 명령어를 사용하여 Qpid 노드에서 이 포트를 차단할 수 있습니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
업데이트 전에 Qpid 노드가 모든 메시지를 처리했는지 확인하기 위해 Qpid 큐에서 메시지가 비워질 때까지 기다립니다. 다음 명령어를 사용하여 Qpid 메시지 큐가 비어 있는지 확인합니다.
> qpid-stat -q
Qpid 노드를 업데이트합니다.
Qpid 노드에서 포트 5672를 차단 해제하여 라우터와 메시지 프로세서의 액세스를 허용합니다. 다음 명령어를 사용하여 이 포트를 차단 해제할 수 있습니다.
> sudo iptables -F

다른 규칙에 iptables를 사용하는 경우 -D 옵션을 사용하여 특정 변경사항을 되돌릴 수 있습니다.
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

이 프로세스는 각 에지 토폴로지에 대해 아래에 자세히 설명되어 있습니다.

Postgres 9.4로 업그레이드 필요

이 Edge 출시에는 Postgres 9.4로의 업그레이드가 포함되어 있습니다. 업그레이드의 일환으로 모든 Postgres 데이터가 Postgres 9.4로 마이그레이션됩니다.

업데이트 프로세스 중에 Postgres 노드가 업데이트 중일 때도 애널리틱스 데이터는 계속 Qpid 노드에 쓰여집니다. Postgres 노드가 업데이트되고 다시 온라인 상태가 되면 분석 데이터가 Postgres 노드로 푸시됩니다.

어떠한 이유로든 업데이트를 롤백해야 하는 경우 추가 Postgres 대기 노드가 필요합니다. 업데이트를 롤백해야 하는 경우 롤백 후 새 Postgres 대기 노드가 마스터 Postgres 노드가 됩니다. 따라서 새 Postgres 대기 노드를 설치할 때는 Edge 설치 요구사항에 정의된 대로 Postgres 서버의 모든 하드웨어 요구사항을 충족하는 노드에 있어야 합니다.

새 Postgres 대기 노드 설치

이 절차에서는 새 노드에 Postgres 대기 서버를 만듭니다. 버전 4.17.09가 아닌 기존 Edge 버전 (4.16.01 또는 4.16.05)에 새 Postgres 대기 서버를 설치해야 합니다.

설치를 실행하려면 현재 버전의 Edge를 설치하는 데 사용한 것과 동일한 구성 파일을 사용하세요.

새 Postgres 대기 노드를 만들려면 다음 단계를 따르세요.

현재 Postgres 마스터에서 /opt/apigee/customer/application/postgresql.properties 파일을 수정하여 다음 토큰을 설정합니다. 이 파일이 없는 경우 다음과 같이 만듭니다.

conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

여기서 existing_slave_ip는 현재 Postgres 대기 서버의 IP 주소이고 new_slave_ip는 새 대기 노드의 IP 주소입니다.
Postgres 마스터에서 apigee-postgresql을 다시 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
마스터에서 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 파일을 확인하여 새 대기 노드가 추가되었는지 확인합니다. 이 파일에는 다음 줄이 표시됩니다.
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
새 Postgres 대기 서버를 설치합니다.
1. 현재 버전의 Edge를 설치하는 데 사용한 구성 파일을 수정하여 다음을 지정합니다.
  
  # 현재 마스터의 IP 주소:
  PG_MASTER=192.168.56.103
  # 새 대기 모드 노드의 IP 주소
  PG_STANDBY=192.168.56.102
2. Edge apigee-setup 유틸리티 설치에 설명된 대로 SELinux를 사용 중지합니다.
3. Edge 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.sh를 업데이트하는 경우
  boot.6.1에서 .6.1 파일을 다운로드하고 참고.6.1은 참고: .6.1에서 참고:
4. Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
5. apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
6. Postgres 설치:
  > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
7. 새 대기 모드 노드에서 다음 명령어를 실행합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  대기 모드라고 표시되는지 확인합니다.

Postgres 노드 지원 중단

업데이트가 완료되면 새 대기 노드를 지원 중단합니다.

Postgres가 실행 중인지 확인하세요.
> /opt/apigee/apigee-service/bin/apigee-all status

Postgres가 실행 중이 아니면 시작하세요.
> /opt/apigee/apigee-service/bin/apigee-all start
새 대기 모드 노드에서 다음 명령어를 실행하여 새 대기 모드 노드를 중지합니다.
> /opt/apigee/apigee-service/bin/apigee-all stop
Postgres 마스터 노드에서 /opt/apigee/customer/application/postgresql.properties를 수정하여 conf_pg_hba_replication.connection에서 새 대기 노드를 삭제합니다.
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
Postgres 마스터에서 apigee-postgresql을 다시 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
마스터에서 /opt/apigee/apigee-postgresql/conf/pg_hba.conf를 확인하여 새 대기 노드가 삭제되었는지 확인합니다. 이 파일에는 다음 줄만 표시되어야 합니다.
host replication apigee existing_slave_ip/32 trust
관리 서버 노드에서 다음 Edge 관리 API를 호출하여 ZooKeeper에서 대기 모드 노드의 UUID를 삭제합니다.
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

제로 다운타임 업데이트

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

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

다운타임 없이 업그레이드하려면 각 라우터를 한 번에 하나씩 부하 분산기에서 제거해야 합니다. 그런 다음 라우터와 동일한 머신에서 라우터 및 기타 구성요소를 업데이트하고 라우터를 다시 부하 분산기에 추가합니다.

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

업데이트 전후에 다음 사항에 유의하세요.

라우터와 메시지 프로세서를 결합한 노드에서 다음을 실행합니다.
- 업데이트 전 – 다음을 실행합니다.
  1. 라우터에 연결할 수 없도록 합니다.
  2. 메시지 프로세서에 연결할 수 없도록 합니다.
- 업데이트 후 - 다음을 실행합니다.
  1. 메시지 프로세서에 연결할 수 있도록 합니다.
  2. 라우터에 연결할 수 있도록 합니다.
단일 라우터 노드:
- 업데이트하기 전에 라우터에 연결할 수 없도록 합니다.
- 업데이트 후 라우터에 연결할 수 있도록 합니다.
단일 메시지 프로세서 노드:
- 업데이트하기 전에 메시지 프로세서에 연결할 수 없도록 합니다.
- 업데이트 후 메시지 프로세서에 연결할 수 있도록 합니다.

자동 구성 파일 사용

업데이트 명령어에 무음 구성 파일을 전달해야 합니다. 무음 구성 파일은 Edge 4.16.01 또는 4.16.05를 설치할 때 사용한 것과 동일해야 합니다.

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

다음 절차에 따라 노드에서 Edge 구성요소를 업데이트합니다.

현재 Postgres 마스터-스탠바이 복제를 사용 중인 경우 위에 설명된 새 Postgres 스탠바이 노드 설치에 따라 새 Postgres 스탠바이 노드를 설치합니다.
크론 작업이 있다면 업데이트가 완료될 때까지 Cassandra에서 복구 작업을 수행하도록 구성된 크론 작업을 사용 중지합니다.
루트로 노드에 로그인하여 Edge RPM을 설치합니다.
참고: RPM 설치에는 루트 액세스가 필요하지만 루트 액세스 권한 없이 Edge 구성을 수행할 수도 있습니다.
yum-utils 및 yum-plugin-priorities를 설치합니다.
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Edge apigee-setup 유틸리티 설치에 설명된 대로 SELinux를 사용 중지합니다.
위에서 설명한 대로 EPEL 저장소를 사용 설정합니다.
AWS에 설치하는 경우 다음 yum-configure-manager 명령어를 실행합니다.
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Edge 4.17.09 bootstrap_4.17.09.sh 파일을 /tmp/bootstrap_4.17.09.sh에 다운로드합니다.
> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.
Edge 4.17.09 apigee-service 유틸리티와 종속 항목을 설치합니다.
> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

여기서 uName:pWord는 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.

기본적으로 설치 프로그램은 Java 1.8이 설치되어 있는지 확인합니다. 설치하지 않으면 자동으로 설치됩니다. JAVA_FIX 옵션을 사용하여 Java 설치를 처리하는 방법을 지정합니다. JAVA_FIX는 다음 값을 사용합니다.

I = Install OpenJDK 1.8 (기본값)
C = Java 설치 없이 계속
Q = Quit. 이 옵션을 사용하려면 Java를 직접 설치해야 합니다.
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
  
  이 명령어는 /opt/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 업데이트는 /opt/apigee/apigee-setup/bin에 update.sh 유틸리티를 설치합니다.
3. 4.16.05를 직접 또는 업데이트를 통해 설치한 경우 apigee-setup 유틸리티를 업데이트해야 합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  이 apigee-service 업데이트는 /opt/apigee/apigee-setup/bin에 update.sh 유틸리티를 설치합니다.
Edge의 현재 버전에 따라 관리 서버에 apigee-validate 유틸리티를 설치하거나 업데이트해야 합니다.
1. 현재 Edge 4.16.05를 사용 중인 경우: 관리 서버에서 apigee-validate 유틸리티를 업데이트하세요.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update를 참조하세요.
2. 현재 Edge 4.16.01을 사용 중인 경우: 관리 서버에 apigee-validate 유틸리티를 설치합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  참고: 4.16.01을 설치할 때 메시지 프로세서 노드에 apigee-validate 유틸리티를 설치한 경우 해당 노드에서 다음 명령어를 사용하여 업데이트할 수 있습니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  4.16.05 이상부터는 관리 서버에 apigee-validate 유틸리티를 설치하고 실행하는 것이 좋습니다.
3. 4.16.01에서 업그레이드하는 경우: apigee-validate 유틸리티에 전달된 구성 파일을 수정합니다. 4.16.01 Edge 출시에서는 apigee-validate에서 사용하는 구성 파일에 다음 속성이 필요했습니다.
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  이 출시에서는 구성 파일에 APIGEE_ADMINPW 속성만 필요합니다. 파일에서 다른 두 속성을 삭제할 수 있습니다.
apigee-provision 유틸리티를 업데이트합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
아래의 '머신 업데이트 순서'에 설명된 순서대로 노드에서 업데이트 유틸리티를 실행합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

구성 파일의 유일한 요구사항은 'apigee' 사용자가 구성 파일에 액세스하거나 읽을 수 있어야 한다는 것입니다.

'-c' 옵션을 사용하여 업데이트할 구성요소를 지정합니다.

ldap
설치 테스트에 설명된 대로 관리 서버에서 apigee-validate 유틸리티를 실행하여 업데이트를 테스트합니다.
새 Postgres 대기 노드를 설치한 경우 위에 설명된 대로 Postgres 노드 지원 중단에 따라 노드를 지원 중단합니다.

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

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

Edge 노드가 방화벽 뒤에 있거나 다른 방식으로 인터넷을 통해 Apigee 저장소에 액세스할 수 없는 경우 Apigee 저장소의 로컬 저장소 또는 미러에서 업데이트를 실행할 수 있습니다.

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

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

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

현재 Postgres 마스터-스탠바이 복제를 사용 중인 경우 위에 설명된 새 Postgres 스탠바이 노드 설치에 따라 새 Postgres 스탠바이 노드를 설치합니다.
Edge apigee-setup 유틸리티 설치의 '로컬 Apigee 저장소 만들기'에 설명된 대로 로컬 4.17.09 저장소를 만듭니다.
참고: 기존 4.16.01 또는 4.16.05 저장소가 이미 있는 경우 Edge apigee-setup 유틸리티 설치의 '로컬 Apigee 저장소 업데이트'에 설명된 대로 4.17.09 저장소를 추가할 수 있습니다.
.tar 파일에서 apigee-service를 설치하려면 다음 안내를 따르세요.
1. 로컬 저장소가 있는 노드에서 다음 명령어를 사용하여 로컬 저장소를 /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz라는 단일 .tar 파일로 패키징합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. .tar 파일을 Edge를 업데이트할 노드에 복사합니다. 예를 들어 새 노드의 /tmp 디렉터리에 복사합니다.
3. 새 노드에서 파일을 /tmp 디렉터리로 압축해제합니다.
  > tar -xzf apigee-4.17.09.tar.gz
  
  이 명령어는 .tar 파일이 포함된 디렉터리에 repos라는 새 디렉터리를 만듭니다. 예: /tmp/repos
4. /tmp/repos에서 Edge apigee-service 유틸리티와 종속 항목을 설치합니다.
  > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  이 명령어에는 repos 디렉터리의 경로가 포함됩니다.
Nginx 웹서버를 사용하여 apigee-service를 설치하려면 다음 단계를 따르세요.
1. Edge apigee-setup 유틸리티 설치의 'Nginx 웹 서버를 사용하여 저장소에서 설치'에 설명된 대로 Nginx 웹 서버를 구성합니다.
2. bootstrap_4.17.09.sh
3. 원격 노드에서 Edge apigee-service 유틸리티와 종속 항목을 설치합니다.
  > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  여기서 uName: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
  
  이 명령어는 /opt/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 업데이트는 /opt/apigee/apigee-setup/bin에 update.sh 유틸리티를 설치합니다.
3. 4.16.05를 직접 설치했거나 업데이트를 통해 Apigee-setup 유틸리티를 업데이트해야 합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  apigee-service에 대한 이 업데이트는 /opt/apigee/apigee-setup/bin에 대한 이 업데이트를 설치합니다.
Edge의 현재 버전에 따라 관리 서버에 apigee-validate 유틸리티를 설치하거나 업데이트해야 합니다.
1. 현재 Edge 4.16.05를 사용 중인 경우: 관리 서버에서 apigee-validate 유틸리티를 업데이트합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. 현재 Edge 4.16.01을 사용 중인 경우: 관리 서버에 apigee-validate 유틸리티를 설치합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  참고: 4.16.01을 설치할 때 메시지 프로세서 노드에 apigee-validate 유틸리티를 설치한 경우 해당 노드에서 다음 명령어를 사용하여 업데이트할 수 있습니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  4.16.05 이상부터는 관리 서버에 apigee-validate 유틸리티를 설치하고 실행하는 것이 좋습니다.
3. 4.16.01에서 업그레이드하는 경우: apigee-validate 유틸리티에 전달된 구성 파일을 수정하세요. 4.16.01 Edge 출시에서는 apigee-validate에서 사용하는 구성 파일에 다음 속성이 필요했습니다.
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  이 출시에서는 구성 파일에 APIGEE_ADMINPW 속성만 필요합니다. 파일에서 다른 두 속성을 삭제할 수 있습니다.
apigee-provision 유틸리티를 업데이트합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
아래의 '머신 업데이트 순서'에 설명된 순서대로 노드에서 업데이트 유틸리티를 실행합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

구성 파일의 유일한 요구사항은 'apigee' 사용자가 구성 파일에 액세스하거나 읽을 수 있어야 한다는 것입니다.

'-c' 옵션을 사용하여 업데이트할 구성요소를 지정합니다.

ldap
설치 테스트에 설명된 대로 관리 서버에서 apigee-validate 유틸리티를 실행하여 업데이트를 테스트합니다.
새 Postgres 대기 노드를 설치한 경우 위에 설명된 대로 Postgres 노드 지원 중단에 따라 노드를 지원 중단합니다.

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

머신 업데이트 순서

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

다른 노드를 업데이트하기 전에 모든 Cassandra 및 ZaKeeper 노드를 업데이트해야 합니다.
Edge 구성요소(관리 서버, 메시지 프로세서, 라우터, QPID 서버(Postgres 서버 제외))가 여러 개인 머신의 경우 '-c edge' 옵션을 사용하여 모두 동시에 업데이트합니다.
단계에서 여러 머신에서 실행해야 한다고 지정된 경우 지정된 머신 순서대로 실행합니다.
수익 창출을 업데이트하는 별도의 단계는 없습니다. '-c edge' 옵션을 지정하면 업데이트됩니다.

호스트 1대의 독립형 설치

Edge에서 SMTP를 사용 설정한 경우 구성 파일에서 SMTPMAILFROM을 설정합니다. 이 매개변수의 형식은 다음과 같습니다.
SMTPMAILFROM="My Company <myco@company.com>"
4.16.01에서 업데이트하는 경우 Zookeeper를 다운그레이드합니다.
> yum downgrade apigee-zookeeper
Cassandra 및 ZooKeeper 업데이트:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Qpid 메시지 대기열을 확인합니다.
> qpid-stat -q

'msg' 열의 수가 0이 될 때까지 대기열을 계속 확인합니다. Qpid가 모든 메시지를 처리할 때까지 업그레이드할 수 없습니다.
qpidd를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
iptables 플러시:
> sudo iptables -F
LDAP 업데이트:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Postgres 서버, Qpid 서버, PostgreSQL을 중지합니다.
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server Stop
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server Stop
> > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
postgresql 업데이트:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Postgres 데이터베이스를 업데이트합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
나머지 Edge 구성요소를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Edge UI 업데이트:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

호스트 2대의 독립형 설치

에지 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참고하세요.

Edge에서 SMTP를 사용 설정한 경우 구성 파일에 SMTPMAILFROM을 설정합니다. 이 매개변수의 형식은 다음과 같습니다.
SMTPMAILFROM="My Company <myco@company.com>"
4.16.01에서 업데이트하는 경우 머신 1에서 Zookeeper를 다운그레이드합니다.
> yum downgrade apigee-zookeeper
머신 1에서 Cassandra 및 ZaKeeper를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
머신 2에서 다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
머신 2에서 Qpid 메시지 대기열을 확인합니다.
> qpid-stat -q

'msg' 열의 수가 0이 될 때까지 대기열을 계속 확인합니다. Qpid가 모든 메시지를 처리할 때까지 업그레이드할 수 없습니다.
머신 2에서 qpidd 를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
머신 2에서 iptables를 플러시합니다.
> sudo iptables -F
머신 1에서 LDAP를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
머신 1에서 Edge 구성요소를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
머신 1에서 UI를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
머신 2에서 postgresql을 업데이트합니다.
1. Postgres 서버, Qpid 서버, postgresql을 중지합니다.
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
2. postgresql 업데이트:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
3. Postgres 데이터베이스를 업데이트합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
4. 머신 2 및 머신 1에서 Edge 구성요소를 업데이트합니다.
  > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
머신 2의 Edge 구성요소를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

호스트 5대 클러스터 설치의 경우

Edge 토폴로지와 노드 번호 목록은 설치 토폴로지를 참조하세요.

Edge에서 SMTP를 사용 설정한 경우 구성 파일에서 SMTPMAILFROM을 설정합니다. 이 매개변수의 형식은 다음과 같습니다.
SMTPMAILFROM="My Company <myco@company.com>"
위에 설명된 대로 새 Postgres 대기 노드 설치에 따라 새 Postgres 대기 노드를 설치했는지 확인합니다.
4.16.01에서 업데이트하는 경우 Macine 1, 2, 3에서 주키퍼를 다운그레이드합니다.
> yum 다운그레이드 apigee-zookeeper
머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
머신 4에서 다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
머신 4에서 Qpid 메시지 대기열을 확인합니다.
> qpid-stat -q

'msg' 열의 수가 0이 될 때까지 대기열을 계속 확인합니다. 모든 메시지를 처리할 때까지는 Qpid를 업그레이드할 수 없습니다.
머신 4에서 qpidd를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
머신 4에서 iptables를 플러시합니다.
> sudo iptables -F
머신 5에서 5~8단계를 반복합니다.
머신 1에서 LDAP를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
머신 1, 2, 3에서 Edge 구성요소를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
머신 1에서 UI를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
머신 4와 5를 업데이트합니다.
1. 머신 4에서 Postgres 서버와 Qpid 서버를 중지합니다.
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
2. 머신 5에서 Postgres 서버, Qpid 서버, postgresql을 중지합니다.
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. 롤백을 위해 추가한 새 대기 모드 노드에서 Postgres 서버와 postgresql을 중지합니다.
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
4. 머신 4에서 postgresql을 업데이트합니다.
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
5. 머신 4에서 Postgres 데이터베이스를 업데이트합니다 (Postgres 마스터만 해당).
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
6. 머신 5에서 postgresql을 업데이트합니다.
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
7. 머신 4 및 5에서 Postgres 서버와 Qpid 서버를 시작합니다.
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
8. 머신 5에서 다음 명령어를 실행하여 Postgres를 대기 노드로 구성합니다.
  > cd /opt/apigee/data/apigee-postgresql/pgdata
  > rm -rf *
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
9. 두 서버에서 다음 스크립트를 실행하여 복제 상태를 확인합니다. 시스템이 두 서버에서 동일한 결과를 표시해야 복제가 성공적으로 이루어집니다.
  
  머신 4(마스터 노드)에서 다음을 실행합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  마스터라고 표시되는지 확인합니다.
  
  머신 5의 대기 노드:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  대기 중이라고 표시되는지 확인합니다.
머신 4, 5에서 Edge 구성요소를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
위의 Postgres 노드 지원 중단에 나온 절차에 따라 새 대기 모드 노드를 지원 중단해야 합니다.

9개 호스트 클러스터 설치의 경우

에지 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참고하세요.

Edge에서 SMTP를 사용 설정한 경우 구성 파일에서 SMTPMAILFROM을 설정합니다. 이 매개변수의 형식은 다음과 같습니다.
SMTPMAILFROM="My Company <myco@company.com>"
위에 설명된 대로 새 Postgres 대기 노드 설치에 따라 새 Postgres 대기 노드를 설치했는지 확인합니다.
4.16.01에서 업데이트하는 경우 머신 1, 2, 3에서 Zookeeper를 다운그레이드합니다.
> yum downgrade apigee-zookeeper
머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
머신 6에서 다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
머신 6에서 Qpid 메시지 대기열을 확인합니다.
> qpid-stat -q

'msg' 열의 수가 0이 될 때까지 대기열을 계속 확인합니다. Qpid가 모든 메시지를 처리할 때까지 업그레이드할 수 없습니다.
머신 6에서 qpidd를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
머신 6에서 iptables 플러시:
> sudo iptables -F
머신 7에서 5~8단계를 반복합니다.
머신 1에서 LDAP를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6, 7, 1, 4, 5 머신의 Edge 구성요소를 이 순서대로 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
머신 1에서 UI를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
머신 8 및 9를 업데이트합니다.
1. 머신 8에서 Postgres 서버를 중지합니다.
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
2. 머신 9에서 Postgres 서버 및 postgresql을 중지합니다.
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. 머신 6 및 7에서 Qpid 서버를 중지합니다.
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
4. 롤백을 위해 추가한 새 대기 모드 노드에서 Postgres 서버와 postgresql을 중지합니다.
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. 머신 8에서 postgresql을 업데이트합니다.
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. 머신 8에서 Postgres 데이터베이스를 업데이트합니다 (Postgres 마스터만 해당).
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. 머신 9에서 postgresql 업데이트:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. 머신 8 및 9에서 Postgres 서버 서버를 시작합니다.
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
9. 머신 6 및 7에서 Qpid 서버 서버를 시작합니다.
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
10. 머신 9에서 다음 명령어를 실행하여 Postgres를 대기 노드로 구성합니다.
  > cd /opt/apigee/data/apigee-postgresql/pgdata
  > rm -rf *
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
11. 두 서버에서 다음 스크립트를 실행하여 복제 상태를 확인합니다. 시스템이 두 서버에서 동일한 결과를 표시해야 복제가 성공적으로 이루어집니다.
  마스터 노드인 머신 8에서 다음을 실행합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  마스터라고 표시되는지 확인합니다.
  
  머신 9의 대기 노드:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  대기 중이라고 표시되는지 확인합니다.
머신 8과 9에서 Edge 구성요소를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
위의 Postgres 노드 지원 중단에 나온 절차에 따라 새 대기 모드 노드를 지원 중단해야 합니다.

13개 호스트 클러스터 설치의 경우

에지 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참고하세요.

Edge에서 SMTP를 사용 설정한 경우 구성 파일에서 SMTPMAILFROM을 설정합니다. 이 매개변수의 형식은 다음과 같습니다.
SMTPMAILFROM="My Company <myco@company.com>"
위에 설명된 대로 새 Postgres 대기 노드 설치에 따라 새 Postgres 대기 노드를 설치했는지 확인합니다.
4.16.01에서 업데이트하는 경우 머신 1, 2, 3에서 Zookeeper를 다운그레이드합니다.
> yum downgrade apigee-zookeeper
머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
머신 12에서 다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
머신 12에서 Qpid 메시지 대기열을 확인합니다.
> qpid-stat -q

'msg' 열의 수가 0이 될 때까지 대기열을 계속 확인합니다. 모든 메시지를 처리할 때까지는 Qpid를 업그레이드할 수 없습니다.
머신 12에서 qpidd를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
머신 12에서 iptables 플러시:
> sudo iptables -F
13 머신에서 5~8단계를 반복합니다.
머신 4 및 5에서 LDAP를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
머신 12, 13, 6, 7, 10, 11에서 Edge 구성요소를 순서대로 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
머신 6 및 7에서 UI를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
머신 8 및 9를 업데이트합니다.
1. 머신 8에서 Postgres 서버를 중지합니다.
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
2. 머신 9에서 Postgres 서버 및 postgresql을 중지합니다.
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
3. 12 및 13 머신에서 Qpid 서버를 중지합니다.
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
4. 롤백을 위해 추가한 새 대기 모드 노드에서 Postgres 서버와 postgresql을 중지합니다.
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. 머신 8에서 postgresql을 업데이트합니다.
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. 머신 8에서 Postgres 데이터베이스를 업데이트합니다 (Postgres 마스터만 해당).
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. 머신 9에서 postgresql을 업데이트합니다.
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. 머신 8 및 9에서 Postgres 서버를 시작합니다.
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
9. 머신 12 및 13에서 Qpid 서버를 시작합니다.
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
10. 머신 9에서 다음 명령어를 실행하여 Postgres를 대기 노드로 구성합니다.
  > cd /opt/apigee/data/apigee-postgresql/pgdata
  > rm -rf *
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-configreplication-on- Standby -f

머신 8 및 9에서 Edge 구성요소를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

위의 Postgres 노드 지원 중단에 나온 절차에 따라 새 대기 모드 노드를 지원 중단해야 합니다.

12개 호스트 클러스터 설치의 경우

에지 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참고하세요.

Edge에서 SMTP를 사용 설정한 경우 구성 파일에서 SMTPMAILFROM을 설정합니다. 이 매개변수의 형식은 다음과 같습니다.
SMTPMAILFROM="My Company <myco@company.com>"

위에 설명된 대로 새 Postgres 대기 노드 설치에 따라 새 Postgres 대기 노드를 설치했는지 확인합니다.

Cassandra 및 ZooKeeper를 업데이트합니다.

4.16.01에서 업데이트하는 경우 데이터 센터 1의 macOS 1, 2, 3에서 주키퍼를 다운그레이드합니다.
> yum apigee-zookeeper를 다운그레이드합니다.

데이터 센터 1의 머신 1, 2, 3에서 다음을 실행합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

4.16.01에서 업데이트하는 경우 데이터 센터 2의 머신 7, 8, 9에서 Zookeeper를 다운그레이드합니다.
> yum downgrade apigee-zookeeper

데이터 센터 2의 머신 7, 8, 9에서
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

qpidd를 업데이트합니다.

데이터 센터 1의 머신 4, 5

머신 4에서 다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

머신 4에서 Qpid 메시지 대기열을 확인합니다.
> qpid-stat -q

'msg' 열의 수가 0이 될 때까지 대기열을 계속 확인합니다. Qpid가 모든 메시지를 처리할 때까지 업그레이드할 수 없습니다.

머신 4에서 qpidd를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

머신 4에서 iptables 플러시:
> sudo iptables -F

머신 5에서 1~4단계를 반복합니다.

데이터 센터 2의 머신 10, 11

머신 10에서 다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

머신 10에서 Qpid 메시지 큐를 확인합니다.
> qpid-stat -q

'msg' 열의 수가 0이 될 때까지 큐를 계속 확인합니다. Qpid가 모든 메시지를 처리할 때까지 업그레이드할 수 없습니다.

머신 10에서 qpidd를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

머신 10에서 iptables 플러시:
> sudo iptables -F

머신 11에서 1~4단계를 반복합니다.

LDAP 업데이트:

데이터 센터 1의 머신 1
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

데이터 센터 2의 머신 7
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Edge 구성요소를 업데이트합니다.

데이터 센터 1의 머신 4, 5, 1, 2, 3
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

데이터 센터 2의 머신 10, 11, 7, 8, 9
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

UI 업데이트:

데이터 센터 1의 머신 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

데이터 센터 2의 머신 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

데이터 센터 1의 머신 6과 데이터 센터 2의 머신 12를 업데이트합니다.

머신 6에서 Postgres 서버를 중지합니다.
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

머신 12에서 Postgres 서버 및 postgresql을 중지합니다.
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

머신 4, 5, 10, 11에서 Qpid 서버를 중지합니다.
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop

롤백을 위해 추가한 새 대기 모드 노드에서 Postgres 서버와 postgresql을 중지합니다.
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

머신 6에서 postgresql 업데이트:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

머신 6에서 Postgres 데이터베이스를 업데이트합니다 (Postgres 마스터만 해당).
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

머신 12에서 postgresql 업데이트:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

머신 6 및 12에서 Postgres 서버를 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

머신 4, 5, 10, 11에서 Qpid 서버를 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

머신 12에서 다음 명령어를 실행하여 Postgres를 대기 노드로 구성합니다.
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

두 서버에서 다음 스크립트를 실행하여 복제 상태를 확인합니다. 복제를 성공적으로 수행하려면 시스템에서 두 서버 모두에 동일한 결과가 표시되어야 합니다.
머신 6에서 마스터 노드에서 다음을 실행합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

이 항목이 마스터로 표시되는지 확인합니다.

머신 12의 대기 노드:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

대기 중이라고 표시되는지 확인합니다.

머신 6 및 12의 Edge 구성요소를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

위의 Postgres 노드 지원 중단에 나온 절차에 따라 새 대기 모드 노드를 지원 중단해야 합니다.

호스트 7개 또는 호스트 10개로 구성된 API BaaS 설치의 경우

참고: API BaaS의 4.16.01 또는 4.16.05 버전을 4.17.09로 업데이트하는 절차는 4.16.09 버전을 업데이트하는 절차와 동일합니다. Apigee Edge 4.16.09를 4.17.09로 업데이트를 참조하세요.

비표준 설치의 경우

비표준 설치인 경우 다음 순서대로 Edge 구성요소를 업데이트합니다.

ZooKeeper

Cassandra

qpidd

LDAP

Edge: 모든 노드의 '-c Edge' 프로필을 순서대로 의미합니다. Qpid 서버는 있지만 Postgres 서버, 관리 서버, 메시지 프로세서, 라우터는 없는 노드입니다.
참고: 노드에 Qpid 서버와 Postgres 서버가 모두 설치된 경우 8단계의 일부로 '-c edge' 프로필 단계를 실행합니다.

Edge UI

Postgres 마스터의 postgresql(업그레이드 포함)

Postgres 대기의 postgresql입니다.

Edge: 모든 결합된 Qpid 및 Postgres 노드 또는 모든 독립형 Postgres 노드의 '-c edge' 프로필을 의미합니다.