4.19.06 Private Cloud용 Edge 출시 노트

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

이 섹션에서는 Edge for Private Cloud 기능 출시의 버전 4.19.06을 설명합니다.

버전 요약

다음 표에는 이번 출시 버전의 변경사항이 요약되어 있습니다.

새로운 기능

이번 출시 버전에는 다음과 같은 새로운 기능이 포함됩니다.

○ SSO를 위한 LDAP 지원
○ HTTP 배포 지원
○ 플러그인 가능한 분석
○ Cassandra 랙 지원
○ IPv6 지원
○ 간소화된 New Edge 환경 설치
○ 거래 INVALID_TSC 제외 (수익 창출)

이러한 새로운 기능 각각에 관한 자세한 내용은 새로운 기능을 참고하세요.

이전 버전과의 호환성

이 프라이빗 클라우드용 Apigee Edge 버전에서는 이전 버전과의 호환성에 영향을 미치는 다음과 같은 문제가 도입되었습니다.

     
  • 19.03.01 퍼블릭 클라우드 출시 노트에 설명된 대로 문제 132443137의 수정사항으로 인해 이제 메시지 프로세서가 X-Apigee-*로 시작하는 헤더를 무시합니다. 따라서 X-Apigee-* 헤더를 사용하는 모든 코드를 리팩터링하고 이러한 헤더를 지원되는 헤더로 교체해야 합니다.

  • Cassandra 로그 파일의 이름이 변경되었습니다. 현재 상태는 다음과 같습니다.

    /opt/apigee/var/log/apigee-cassandra/system.log
포함된 출시 버전

이전 Edge for Private Cloud 기능 출시 이후 다음 출시 버전이 발생했으며 이 출시 버전에 포함되었습니다.

○ Edge:
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
   18{/18.01.23
{11.18{/18.01.18{/18.18.18{/18{/18

18.12.0418.08.3118.07.31
○ 포털:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.2719.02.2119.02.0419.01.16
퇴직 없음
지원 중단

4.19.06 출시에서는 다음 항목이 지원 중단됩니다.

  • 4.18.01: Private Cloud용 Apigee Edge 버전 4.18.01이 지원 중단되었습니다.

자세한 내용은 Apigee 지원 중단, 지원 중단, CPS 변경사항을 참조하세요.

버그 수정

이 릴리스에는 다음과 같은 버그 수정이 포함되어 있습니다.

○ UseStringDe 중복 삭제가 설정되지 않음 - 140270474(140270474)
○ MP 오류(111445518)
○ JMX를 사용한 Cassandra 실패(113342838)
○ 13-노드 업그레이드(138931337)
○ 13 13 - 노드 업그레이드(138931337) 138931337 - 동일한 이름의 프록시






HEAD

이러한 각 수정사항에 대한 자세한 내용은 버그 수정을 참고하세요.

알려진 문제

이 릴리스에는 다음과 같은 알려진 문제가 있습니다.

○ Mint에서 처음에 트랜잭션을 평가하지 않음(141628497) 7 Mint가 트랜잭션을 평가하지 않음 메시지(141628497)
○ Mint 평점 서버 메모리 누수(137865184)
○ apigee-sso 설치를 위한 메타데이터 파일 형식(135616498)
apigee-monit 프로세서 백업 1에서 지원되지 않음 12237 지원 안 됨.



해결 방법을 비롯한 각 알려진 문제에 관한 자세한 내용은 알려진 문제를 참조하세요.

업그레이드 경로

다음 표에는 이 버전의 업그레이드 경로가 나와 있습니다.

From 4.19.01 4.19.01 → 4.19.06에서 직접 업그레이드
2005년 4월 18일부터 4.18.05 → 4.19.06에서 직접 업그레이드
4.18.01부터 4.18.01 → 4.19.06에서 직접 업그레이드

새로운 기능

이 섹션에는 이번 출시의 새로운 기능이 나와 있습니다. 또한 이 출시 버전에는 포함된 출시 버전에 나열된 Edge UI, 에지 관리, 포털 출시의 모든 기능이 포함되어 있습니다.

다음과 같은 개선사항 외에도 이 출시에는 여러 사용성, 성능, 보안 및 안정성 개선사항이 포함되어 있습니다.

HTTP 배포 지원

기본적으로 Edge는 RPC를 사용하여 API 프록시를 배포합니다. 이 모드는 대부분의 설치에서 매우 잘 작동하지만 MP가 많은 대규모 토폴로지에서는 RPC를 통해 동시 호출 수가 많아지면 시간 초과가 발생할 수 있습니다.

따라서 Apigee에서는 대규모 배포에서 RPC 대신 HTTP를 사용하도록 권장합니다. 이제 HTTP 배포 사용 설정이 지원됩니다.

자세한 내용은 HTTP 배포 사용 설정을 참조하세요.

Cassandra 랙 지원

이제 Apigee가 프라이빗 클라우드용 Apigee Edge의 Cassandra가 랙을 인식하도록 하여 Cassandra의 확장 작업에 대한 일반적인 지침을 제공합니다.

자세한 내용은 Cassandra 랙 지원을 참조하세요.

플러그인 가능한 분석

기본적으로 메시지 프로세서에서 수집한 분석 데이터는 처리를 위해 Qpid 및 Postgres에 업로드됩니다. 그런 다음 Edge UI에서 분석 데이터를 볼 수 있습니다.

이 기능 출시에서는 메시지 프로세서가 분석 데이터를 디스크에 쓰도록 구성하거나 두 옵션을 모두 사용하도록 선택할 수 있습니다.

자세한 내용은 파일에 분석 데이터 쓰기를 참조하세요.

간소화된 New Edge 환경 설치

새 스크립트로 New Edge 환경의 설치를 간소화했습니다.

자세한 내용은 새로운 Edge 환경 설치하기를 참고하세요.

LDAP IDP 지원

이제 Edge UI 및 Edge 관리 API 호출로 사용자 인증에서 SAML 외에도 LDAP를 지원합니다. LDAP 지원에는 직접 바인딩과 간접 바인딩 방법이 모두 포함됩니다.

자세한 내용은 외부 IDP 인증 개요를 참조하세요.

IPv6 지원

기본적으로 프라이빗 클라우드용 Apigee Edge에 대한 모든 런타임 API 호출은 IPv4를 사용합니다. 새 속성을 사용하여 IPv6 지원을 라우터에 추가할 수 있습니다.

자세한 내용은 라우터에서 IPv6 사용을 참조하세요.

거래 INVALID_TSC개 제외 (수익 창출)

이제 수익 창출을 사용할 때 INVALID_TSC 트랜잭션이 Postgres 데이터베이스에 추가되지 않도록 제외할 수 있습니다.

자세한 내용은 수익 창출 서버 속성을 참고하세요.

지원되는 소프트웨어

이 릴리스에서는 지원되는 소프트웨어에 대해 다음과 같은 변경사항이 있습니다.

지원 추가됨 지원 중단

이 릴리스에서는 다음 플랫폼에 대한 지원을 추가합니다.

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

다음 플랫폼은 이 출시에서 더 이상 지원되지 않습니다.

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

지원되는 플랫폼의 전체 목록은 지원되는 소프트웨어 및 지원되는 버전을 참조하세요.

버그 수정

이 섹션에는 이번 출시 버전에서 수정된 Private Cloud 버그가 나열되어 있습니다. 또한 이 출시 버전에는 포함된 출시에 표시된 Edge UI, 에지 관리 및 포털 출시의 모든 버그 수정이 포함되어 있습니다.

문제 ID 설명
140270474

UseStringDe 재정의가 설정되지 않음

프로덕션 환경의 edge-message-processor 구성요소에 UseStringDeduplication이(가) 설정되지 않았습니다.
111445518

MP 오류

메시지 프로세서가 5분마다 다음 오류 메시지를 지속적으로 기록합니다.
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

JMX를 사용한 Cassandra 실패

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

노드 13개 업그레이드

17.09, 18.01, 18.05 버전에서 13노드 설치를 업그레이드할 수 없었습니다.
119802562

이름이 동일한 프록시

같은 조직의 두 사용자가 이름이 같은 프록시를 만든 경우 두 번째로 생성된 프록시가 첫 번째 프록시를 덮어씁니다. 이 오류는 여러 사용자가 다른 프록시를 볼 수 없는 경우에만 발생했습니다.
118851790

키 저장소가 로드되지 않음

조직/환경의 키 저장소가 100개를 초과하는 경우 Edge UI의 키 저장소 및 참조 섹션이 로드되지 않았습니다. 대신 UI에 Internal Error (Error Fetching Keystores) 오류가 표시되었습니다.
110988191

분석 실패

Micro게이트가 미래의 날짜로 설정된 데이터를 제공했을 때 환경에 대한 애널리틱스가 실패했습니다.
110785400

백업 실패

JoKeeper, Cassandra, OpenLDAP에서 File changed as we read it. 오류로 인해 간헐적으로 데이터를 제대로 백업하지 못했습니다.
79993247

Node.js에 대한 HEAD 요청

Node.js 대상에 대한 HEAD 요청이 중단되어 연결이 대기 중일 수 있습니다.
70291825

apigee-postgres 백업/복원

이제 apigee-postgres 백업/복원을 실행하면 모든 구성요소의 데이터가 백업됩니다.
65737520

sysadmin 비밀번호 재설정

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

알려진 문제

다음 표에는 이번 버전의 알려진 문제가 나와 있습니다.

문제 ID 설명
141628497

처음에 거래를 평가하지 않음

조직에 수익 창출을 처음 사용 설정할 때는 처음에는 프라이빗 클라우드용 Edge에서 트랜잭션을 평가하지 않습니다. 이는 신규 및 기존 조직에 적용됩니다.

수익 창출 사용 설정 API는 작업 ID로 응답하며, 완료되면 작업 상태가 성공을 나타냅니다. 그러나 처음에 수익 창출이 이루어진 API 호출은 수익 창출에 의해 처리되지 않으며 평가되지 않습니다. 이러한 거래는 일반 분석에만 표시됩니다.

해결 방법:

다음 단계에 따라 MP (메시지 프로세서)를 다시 시작합니다.
apigee-service edge-message-processor restart

수익 창출이 사용 설정된 후 MP를 다시 시작하면 Edge가 시작 시 주Keeper에서 구성을 로드합니다. 다시 시작할 때마다 이 문제가 발생합니다. 즉, 이 문제는 처음에만 적용됩니다.

137865184

Mint 평가 서버 메모리 누수

새 Qpid 인스턴스가 mxgroup에 등록되면 소비자 없이 큐가 빌드되므로 사용 가능한 모든 리소스를 사용할 때까지 큐 깊이가 늘어납니다.

해결 방법:

없음
135616498

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

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

해결 방법:

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

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

    또는

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

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

해결 방법:

없음
121095148

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

해결 방법:

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

76087166

여러 데이터 센터 구성의 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_EMAILADMIN_PW는 Apigee 계정의 사용자 인증 정보입니다.
    • MS_IPMS_PORT는 관리 서버의 IP 주소와 포트 번호입니다.
    • REGION은 관리 서버가 있는 데이터 센터의 이름입니다.
    • GATEWAY_POD은 포드 이름이며 기본적으로 '게이트웨이'입니다. 이름을 다른 이름으로 변경했을 수 있으므로 구현을 확인하세요.
    • CASSANDRA_NODE_TYPEkms-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 등록 업데이트를 참조하세요.

68722102

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

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

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

해결 방법:

없음

다음 단계

Edge for Private Cloud 4.19.06을 시작하려면 다음 링크를 사용하세요.

신규 설치 수:
새 설치 개요
기존 설치:
업그레이드 경로