4.19.01 프라이빗 클라우드용 Edge 출시 노트

apigee-sso 설치의 메타데이터 파일 형식

apigee-sso을 설치하고 URL 대신 metadata.xml 파일을 사용할 때 metadata.xml 파일의 끝에 새 줄 (CRLF)이 포함되어 있지 않으면 metadata.xml 파일 전체를 읽을 수 없습니다.

해결 방법:

이 문제를 해결하려면 다음 중 하나를 수행하세요.

• metadata.xml 파일 끝에 CRLF를 추가합니다.

  또는

• 메타데이터에 URL 기반 위치 사용

Amazon Linux 1에서는 apigee-monit가 지원되지 않음

해결 방법:

메시지 프로세서 백업이 올바른 파일 세트를 백업하지 않음

해결 방법:

백업을 두 번 실행하면 올바른 파일 세트가 백업됩니다.

세션 토큰이 무효화되지 않음

사용자가 Apigee Edge 로그아웃 버튼을 클릭해도 서버에서 세션 토큰이 무효화되지 않습니다.

해결 방법:

JMX 인증이 사용 설정된 경우 Cassandra 작업이 작동하지 않음

해결 방법:

Node.js 대상에 대한 HEAD 요청이 중단됨

Node.js 대상에 대한 HEAD 요청이 중단되어 연결이 대기 중인 상태로 남겨질 수 있습니다.

해결 방법:

이 문제를 해결하려면 빈 응답을 명시적으로 반환하도록 HEAD 요청의 핸들러를 정의하세요.

호스트 이름이 확인되지 않음

Private Cloud용 Edge를 설치하거나 업그레이드한 후 호스트 이름이 주소로 확인되지 않을 수 있습니다.

해결 방법:

이 문제를 해결하려면 Edge UI 구성요소를 다시 시작합니다.

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

여러 데이터 센터 구성의 DataAccessException

여러 데이터 센터 구성에서 데이터 저장소 하나를 사용할 수 없게 되면 다음과 같은 오류가 표시될 수 있습니다.

DataAccessException: Error while accessing datastore;
Please retry later

그 결과, dc-1 및 dc-2 모두에서 Cassandra 노드에 연결을 시도하여 관리 서버가 시작되지 않을 수 있습니다. Cassandra 노드가 다운되면 DataAccessExceptions이 발생합니다. 이로 인해 메시지 프로세서가 KVM 검색을 시도하는 동안 DataAccessExceptions를 보고하는 API 트래픽이 중단될 수도 있습니다.

예상되는 상태는 관리 서버가 리전 간에 Datastore 구성요소에 연결되지 않는 것입니다.

해결 방법

해결 방법은 사용할 수 없는 데이터 센터에서 다음 Cassandra 노드 유형을 등록 취소한 다음 Cassandra 노드를 다시 사용할 수 있게 되면 다시 등록하는 것입니다.

• kms-datastore
• dc-datastore
• keyvaluemap-datastore

Cassandra 노드 유형을 등록 취소하고 다시 등록하려면 다음 안내를 따르세요.

1. 다음 curl 명령어를 사용하여 Cassandra 노드의 UUID를 가져옵니다.

   curl -u ADMIN_EMAIL:ADMIN_PW \
     "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
     &type=CASSANDRA_NODE_TYPE"

   각 항목의 의미는 다음과 같습니다.

   • ADMIN_EMAIL 및 ADMIN_PW는 Apigee 계정의 사용자 인증 정보입니다.
   • MS_IP 및 MS_PORT는 관리 서버의 IP 주소와 포트 번호입니다.
   • REGION은 관리 서버가 있는 데이터 센터의 이름입니다.
   • GATEWAY_POD은 포드 이름이며 기본적으로 '게이트웨이'입니다. 이름을 다른 이름으로 변경했을 수 있으므로 구현을 확인하세요.
   • CASSANDRA_NODE_TYPE는 kms-datastore, dc-datastore, keyvaluemap-datastore 중 하나입니다.

   예를 들면 다음과 같습니다.

   curl -u nickdanger@google.com:myP@$$w0rD
     "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

   응답은

   {
     "internalIP" : "POD_IP_ADDRESS",
     "isUp" : [true|false],
     "pod" : "GATEWAY_POD",
     "reachable" : [true|false],
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
       "uUID" : "POD_UUID"
   }

   형식을 사용합니다.

   예를 들면 다음과 같습니다.

   {
     "internalIP" : "192.168.1.11",
     "isUp" : false,
     "pod" : "gateway",
     "reachable" : false,
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : "dc-datastore",
     "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
   }

   응답의 uUID 필드 값을 기록합니다. 이를 사용하여 노드를 등록 취소합니다.

2. Cassandra 노드 유형(kms-datastore, dc-datastore, keyvaluemap-datastore)마다 1단계를 반복합니다. 반환되는 UUID를 기록해 둡니다.
3. 다음 명령어를 사용하여 노드를 등록 취소합니다.

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

   여기서 UUID는 이전 명령어의 응답에서 반환된 UUID입니다.

4. 1단계와 2단계에서 수집한 각 UUID에 3단계를 반복합니다.
5. 다음 명령어를 사용하여 노드를 다시 등록합니다.

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
     "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
     Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
     region=REGION&pod=GATEWAY_POD" -H \
     'content-type: application/x-www-form-urlencoded' -X POST

이러한 작업은 Jokeeper에서 노드를 등록 및 등록 취소하며 Cassandra 클러스터에는 영향을 주지 않습니다. 이러한 명령어에 대한 자세한 내용은 Datastore 등록 업데이트를 참조하세요.

로그 메시지의 추가 정보가 포함된 MessageLogging 정책

MessageLogging 정책의 FormatMessage 요소는 로깅된 메시지의 형식을 제어합니다. FormatMessage=false인 경우 로깅된 메시지에는 Apigee에서 생성된 정보가 포함되지 않습니다. 그러나 FormatMessage=false를 설정해도 로그 메시지에는 다음 정보가 포함됩니다.

• 우선순위 점수
• 타임스탬프

해결 방법:

시스템 관리자 비밀번호 재설정 실패

특수문자가 포함된 관리 서버의 시스템 관리자 비밀번호를 재설정할 수 없습니다.

해결 방법:

데이터 파일에서 비밀번호를 정의한 후 Management API의 /users 엔드포인트에 전달합니다. 자세한 내용은 시스템 관리자 비밀번호 재설정을 참고하세요.