Apigee Edge 4.17.01/4.17.05를 4.17.09로 업데이트합니다.

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

머신 업데이트 순서

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

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

호스트 1대의 독립형 설치

1. 4.17.01에서 업데이트하는 경우 Edge에서 SMTP를 사용 설정한 경우 구성 파일에서 SMTPMAILFROM을 설정하세요. 이 매개변수의 형식은 다음과 같습니다.
   SMTPMAILFROM="My Company <myco@company.com>"
2. Cassandra 및 ZooKeeper 업데이트:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. Qpid 및 Postgres를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. postgresql을 시작합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. LDAP 업데이트:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. 나머지 Edge 구성요소를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. Edge UI 업데이트:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

호스트 2대의 독립형 설치

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

1. 4.17.01에서 업데이트하는 경우 Edge에서 SMTP를 사용 설정한 경우 구성 파일에서 SMTPMAILFROM을 설정하세요. 이 매개변수의 형식은 다음과 같습니다.
   SMTPMAILFROM="My Company <myco@company.com>"
2. 머신 1에서 Cassandra 및 ZooKeeper를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. 머신 2에서 Qpid 및 Postgres를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. 머신 2에서 postgresql을 시작합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. 머신 1에서 LDAP를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. 머신 2 및 1에서 Edge 구성요소를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. 머신 1에서 UI를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. 4.17.01에서 업데이트하는 경우 Edge에서 SMTP를 사용 설정한 경우 구성 파일에서 SMTPMAILFROM을 설정합니다. 이 매개변수의 형식은 다음과 같습니다.
   SMTPMAILFROM="My Company <myco@company.com>"
2. 머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. 머신 4에서 Qpid 및 Postgres를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. 머신 4에서 postgresql을 시작합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. 머신 5에서 3단계와 4단계를 반복합니다.
6. 머신 1에서 LDAP를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. 머신 4, 5, 1, 2, 3에서 Edge 구성요소를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
8. 머신 1에서 UI를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. 4.17.01에서 업데이트하는 경우 Edge에서 SMTP를 사용 설정한 경우 구성 파일에서 SMTPMAILFROM을 설정하세요. 이 매개변수의 형식은 다음과 같습니다.
   SMTPMAILFROM="My Company <myco@company.com>"
2. 머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. 머신 6에서 Qpid 및 Postgres를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. 머신 6에서 postgresql을 시작합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. 머신 7에서 3단계와 4단계를 반복합니다.
6. 머신 1에서 LDAP를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. 머신 6, 7, 8, 9, 1, 4, 5에서 Edge 구성요소를 다음 순서대로 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
8. 머신 1에서 UI를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. 4.17.01에서 업데이트하는 경우 Edge에서 SMTP를 사용 설정한 경우 구성 파일에서 SMTPMAILFROM을 설정하세요. 이 매개변수의 형식은 다음과 같습니다.
   SMTPMAILFROM="My Company <myco@company.com>"
2. 머신 1, 2, 3에서 Cassandra 및 ZaKeeper를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. 12 머신에서 Qpid 및 Postgres를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. 머신 12에서 postgresql을 시작합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. 머신 13에서 3단계와 4단계를 반복합니다.
6. 머신 4 및 5에서 LDAP를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. 12, 13, 8, 9, 6, 7, 10, 11 머신에서 Edge 구성요소를 이 순서로 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
8. 머신 6 및 7에서 UI를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. 4.17.01에서 업데이트하는 경우 Edge에서 SMTP를 사용 설정한 경우 구성 파일에서 SMTPMAILFROM을 설정하세요. 이 매개변수의 형식은 다음과 같습니다.
   SMTPMAILFROM="My Company <myco@company.com>"
2. Cassandra 및 ZooKeeper를 업데이트합니다.
   1. 데이터 센터 1의 머신 1, 2, 3에서:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
   2. 데이터 센터 2의 머신 7, 8, 9에서
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. qpidd를 업데이트합니다.
   1. 데이터 센터 1의 머신 4, 5
      1. 머신 4에서 qpidd 를 업데이트합니다.
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. 머신 5에서 1단계를 반복합니다.
   2. 데이터 센터 2의 머신 10, 11
      1. 머신 10에서 qpidd 를 업데이트합니다.
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. 11 머신에서 1단계를 반복합니다.
4. postgresql을 업데이트합니다.
   1. 데이터 센터 1의 머신 6
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
   2. 데이터 센터 2의 머신 12
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. LDAP 업데이트:
   1. 데이터 센터 1의 머신 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
   2. 데이터 센터 2의 머신 7
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. Edge 구성요소를 업데이트합니다.
   1. 데이터 센터 1의 머신 4, 5, 6, 1, 2, 3
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
   2. 데이터 센터 2의 머신 10, 11, 12, 7, 8, 9
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. UI를 업데이트합니다.
   1. 데이터 센터 1의 머신 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
   2. 데이터 센터 2의 머신 7:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

7개 호스트 API BaaS 설치의 경우

1. 구성 파일에서 SMTPMAILFROM을 설정합니다. 이 매개변수의 형식은 다음과 같습니다.
   SMTPMAILFROM="My Company <myco@company.com>"
2. 머신 5, 6, 7에서 Cassandra를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

3. 머신 1, 2, 3에서 ElasticSearch 및 API BaaS 스택을 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

4. 머신 4에서 API BaaS 포털을 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

호스트 10대의 API BaaS 설치

1. 구성 파일에 SMTPMAILFROM을 설정합니다. 이 매개변수의 형식은 다음과 같습니다.
   SMTPMAILFROM="My Company <myco@company.com>"
2. 8, 9, 10 머신에서 Cassandra를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
3. 머신 1, 2, 3에서 ElasticSearch를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
4. 머신 4, 5, 6에서 API BaaS 스택을 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
5. 머신 7에서 API BaaS 포털을 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

데이터 센터 API Baas 설치 2개

이 절차를 수행하려면 두 데이터 센터의 Cassandra 노드를 업데이트해야 합니다. 이러한 Cassandra 노드를 Edge와 공유하는 경우 일반적으로 Edge 업데이트의 일환으로 이러한 노드를 업데이트합니다.

1. 구성 파일에 SMTPmailFROM을 설정합니다. 이 매개변수의 형식은 다음과 같습니다.
   SMTPMAILFROM="My Company <myco@company.com>"
2. 2개의 데이터 센터에 대해 올바른 복제 계수로 Cassandra 키스페이스를 업데이트합니다. 이 단계는 두 데이터 센터의 Cassandra 서버에서 한 번만 실행하면 됩니다.
   
   참고: 아래 명령어는 모두 복제 계수를 '3'으로 설정하여 클러스터에 Cassandra 노드가 3개 있음을 나타냅니다. 설치에 필요한 경우 이 값을 수정합니다.
   1. Cassandra cqlsh 유틸리티를 시작합니다.
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
   2. 'cqlsh>' 프롬프트에서 다음 CQL 명령어를 실행하여 Cassandra 키스페이스의 복제 수준을 설정합니다.
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH Replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH Replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. 다음 명령어를 사용하여 키스페이스를 확인합니다.
         cqlsh> select * from system.schema_keyspaces;
      7. cqlsh 종료:
         cqlsh> exit
3. (Edge 업데이트 중에 Cassandra를 업데이트하지 않은 경우에만) 데이터 센터 1의 Cassandra 노드를 한 번에 머신 한 대씩 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
4. (Edge 업데이트의 일환으로 Cassandra를 업데이트하지 않은 경우에만 해당) 데이터 센터 2의 Cassandra 노드를 한 번에 한 대씩 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
5. 데이터 센터 1의 머신에서 한 번에 하나씩 ElasticSearch를 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
6. 데이터 센터 2의 머신에서 ElasticSearch를 한 번에 하나씩 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
7. 데이터 센터 1의 머신에서 한 번에 한 대씩 API BaaS 스택을 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
8. 데이터 센터 2의 머신에서 한 번에 한 대씩 API BaaS 스택을 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
9. 데이터 센터 1의 머신에서 한 번에 1개씩 API BaaS 포털을 업데이트합니다.
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
10. 데이터 센터 2의 머신에서 한 번에 하나씩 API BaaS 포털을 업데이트합니다.
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
11. BaaS 키스페이스 값을 업데이트합니다. 이러한 키스페이스는 설치 시에는 복제하도록 설정해야 하지만 런타임에는 설정하지 않아도 됩니다. 복제를 삭제하면 Cassandra 메모리도 절약됩니다.
    
    두 데이터 센터의 Cassandra 서버에서 이 단계를 한 번만 실행하면 됩니다.
    1. Cassandra cqlsh 유틸리티를 시작합니다.
       > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. 다음 CQL 명령어를 실행하여 Cassandra 키스페이스의 복제 수준을 설정합니다.
       1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
       2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH Replication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
       3. 다음 명령어를 사용하여 키스페이스를 확인합니다.
          cqlsh> select * from system.schema_keyspaces;
       4. cqlsh 종료:
          cqlsh> exit

비표준 설치의 경우

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

1. ZooKeeper
2. Cassandra
3. qpidd, ps
4. LDAP
5. Edge: Qpid 서버가 있는 노드, Postgres 서버, 관리 서버, 메시지 프로세서, 라우터 순으로 모든 노드의 '-c edge' 프로필을 의미합니다.
   참고: 노드에 Qpid 서버와 Postgres 서버가 모두 설치된 경우 '-c edge' 프로필 단계를 실행합니다.
6. Edge UI