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 작업이 작동하지 않음

해결 방법:

HEAD 요청이 Node.js 타겟에서 멈춤

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

해결 방법:

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

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

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

해결 방법:

이 문제를 해결하려면 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 트래픽 중단이 발생할 수도 있습니다.

예상되는 상태는 관리 서버가 리전 간에 데이터 스토어 구성요소에 연결되지 않는 것입니다.

해결 방법

해결 방법은 사용할 수 없는 데이터 센터에서 다음 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은 포드 이름으로, 기본값은 'gateway'입니다. 하지만 다른 이름으로 이름을 바꿨을 수도 있으므로 구현을 확인하세요.
   • 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

이러한 작업은 Zookeeper에서 노드를 등록 및 등록 해제하며 Cassandra 클러스터에는 영향을 미치지 않습니다. 이러한 명령어에 대한 자세한 내용은 데이터 스토어 등록 업데이트를 참고하세요.

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

MessageLogging 정책의 FormatMessage 요소는 로깅된 메시지의 형식을 제어합니다. FormatMessage=false인 경우 로깅된 메시지에는 Apigee에서 생성된 정보가 포함되지 않아야 합니다. 하지만 FormatMessage=false를 설정하더라도 로그 메시지에는 다음 정보가 계속 포함됩니다.

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

해결 방법:

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

특수문자가 포함된 관리 서버의 시스템 관리자 비밀번호를 재설정하면 실패합니다.

해결 방법:

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