설치 요구사항

Private Cloud용 Edge v. 4.16.05

하드웨어 요구사항

고가용성을 위해 다음과 같은 최소 하드웨어 요구사항을 충족해야 합니다. Google Cloud의 인프라를 빌드할 수 있습니다 다음에 설명된 모든 설치 시나리오의 경우 설치 토폴로지에 나온 다음 표에는 최소 하드웨어 요구사양을 준수해야 합니다.

이 표에서 하드 디스크 요구사항은 시스템에 필요한 하드 디스크 공간에 더해 실행할 수도 있습니다 애플리케이션과 네트워크 트래픽에 따라 설치 프로그램이 아래에 나열된 것보다 더 많거나 적은 리소스가 필요합니다.

또한 다음은 애플리케이션을 설치하려는 경우의 하드웨어 요구사항 수익 창출 서비스:

다음은 API BaaS를 설치하려는 경우의 하드웨어 요구사항 목록입니다.

참고:

• 루트 파일 시스템이 설치하기에 충분하지 않다면 데이터를 더 큰 디스크에 배치하는 것입니다.
• Private Cloud용 Apigee Edge의 이전 버전이 머신에 설치되어 있는 경우 새로 설치하기 전에 /tmp/java 폴더를 삭제해야 합니다.
• 시스템 전체 임시 폴더 /tmp는 실행 권한이 있어야 Cassandra를 시작합니다
• 설치 전에 사용자 'apigee'를 만든 경우 '/home/apigee'는 홈 디렉터리로 존재하며 다음에서 소유합니다. 'Apigee:apigee'는

운영체제 및 서드 파티 소프트웨어 요구사항

본 설치 지침 및 제공된 설치 파일은 운영체제 및 서드 파티 소프트웨어는 https://apigee.com/docs/api-services/reference/supported-software에 나와 있습니다.

Apigee 사용자 만들기

설치 절차에서 'apigee'라는 Unix 시스템 사용자를 만듭니다. 에지 디렉터리와 파일은 Edge 프로세스와 마찬가지로 'Apigee'에서 소유합니다. 즉, Edge 구성요소는 'Apigee' 있습니다. 필요한 경우 다른 사용자로 구성 요소를 실행할 수 있습니다. "라우터 바인딩" "보호된 포트로 복사" 기기에 Edge 구성요소를 설치하여 노드를 참조하세요.

설치 디렉터리

기본적으로 설치 프로그램은 모든 파일을 /opt/apigee 디렉터리에 씁니다. 변경할 수 없습니다. 디렉터리 위치에 저장합니다

이 가이드의 안내에서 설치 디렉터리는 /<inst_root>/apigee로 지정되어 있으며, 여기서 /<inst_root>의 기본값은 /opt입니다.

자바

설치하기 전에 각 머신에 지원되는 Java1.8 버전이 설치되어 있어야 합니다. 지원되는 JDK는 다음과 같습니다.

https://apigee.com/docs/api-services/reference/supported-software

JAVA_HOME이 다음을 가리키도록 합니다. 를 설치합니다.

네트워크 설정

설치하기 전에 네트워크 설정을 확인하는 것이 좋습니다. 설치 프로그램 모든 머신에 고정 IP 주소가 있을 것으로 예상합니다 다음 명령어를 사용하여 설정:

• hostname은 이름을 반환합니다. 머신의
• hostname -i는 IP를 반환합니다. 이 주소는 다른 컴퓨터에서 주소를 지정할 수 있습니다.

운영체제 유형 및 버전에 따라 호스트 이름이 아닌 경우 /etc/hosts 및 /etc/sysconfig/network를 수정해야 할 수 있습니다. 설정해야 합니다 자세한 내용은 사용 중인 운영체제의 문서를 참조하세요.

Cassandra

모든 Cassandra 노드를 링에 연결해야 합니다.

Cassandra는 사용 가능한 메모리에 따라 Java 힙 크기를 자동으로 조정합니다. 자세한 내용은 Java 미세 조정하기 리소스를 참조하세요. 성능이 저하되거나 메모리 소비가 많은 경우

Private Cloud용 Edge를 설치한 후 Cassandra가 구성되었는지 확인할 수 있습니다. /&lt;inst_root&gt;/apigee/apigee-cassandra/conf/cassandra.yaml을 검토하여 올바르게 파일에서 참조됩니다. 예를 들어 프라이빗 클라우드용 Edge 설치 스크립트가 다음을 설정해야 합니다. 속성:

• cluster_name
• initial_token
• 파티션 나누기
• 시드
• listen_address
• rpc_address
• snitch

경고: 이 파일을 수정하지 마세요.

PostgreSQL 데이터베이스

Edge를 설치한 후 다음 조건에 따라 다음 PostgreSQL 데이터베이스 설정을 조정할 수 있습니다. 사용 가능한 RAM 용량:

conf_postgresql_shared_buffers = 35% of RAM      # min 128kB
conf_postgresql_effective_cache_size = 45% of RAM
conf_postgresql_work_mem = 512MB       # min 64kB

이 값을 설정하는 방법은 다음과 같습니다.

1. postgresql.properties 수정:
   &gt; 베트남어 /&lt;inst_root&gt;/apigee/customer/application/postgresql.properties
   
   파일이 없으면 새로 만듭니다.
2. 위에 나열된 속성을 설정합니다.
3. 수정사항을 저장합니다.
4. PostgreSQL 데이터베이스를 다시 시작합니다.
   &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-postgresql 다시 시작

jsvc

'jsvc' 은 API BaaS 사용을 위한 기본 요건입니다. 설치 시 버전 1.0.15-dev가 설치됨 설계하는 방법을 알아봅니다

네트워크 보안 서비스 (NSS)

네트워크 보안 서비스 (NSS)는 클라이언트 및 서버 응용 프로그램을 사용할 수 있습니다 NSS를 설치했는지 확인해야 합니다. v3.19 이상

현재 버전을 확인하려면 다음 단계를 따르세요.

> yum info nss

NSS를 업데이트하려면 다음 안내를 따르세요.

> yum update nss

RedHat의 이 도움말을 참조하세요. 를 참조하세요.

AWS AMI

Red Hat Enterprise Linux용 AWS Amazon 머신 이미지 (AMI)에 Edge를 설치하는 경우 먼저 다음 명령어를 실행해야 합니다.

> yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

도구

설치 프로그램은 EL5 또는 EL6.

참고:

• 'useradd' 도구의 실행 파일은 /usr/sbin에 있고 chkconfig의 실행 파일은 /sbin에 있습니다.
• sudo 액세스 권한을 사용하면 호출하는 사용자의 환경에 대한 액세스 권한을 얻을 수 있습니다. 예를 들면 다음과 같습니다. 일반적으로 “sudo <command>” 또는 'sudo PATH=$PATH:/usr/sbin:/sbin <command>'
• 서비스 팩 (패치) 전에 “패치” 툴이 설치되어 있는지 확인하십시오. 설치해야 합니다

ntpdate – 서버 시간을 동기화하는 것이 좋습니다. 만약 ‘ntpdate’ 유틸리티가 이 목적을 지원할 수 있으며, 서버 시간 동기화 여부 'yum install ntp'를 사용하여 유틸리티입니다 이는 OpenLDAP 설정을 복제하는 데 특히 유용합니다. 참고: UTC 시간대입니다.

openldap 2.4 – 온프레미스 설치에는 OpenLDAP 2.4가 필요합니다. 만약 서버가 인터넷에 연결되어 있으면 Edge 설치 스크립트가 OpenLDAP. 서버에 인터넷에 연결되어 있지 않으면 OpenLDAP가 이미 설치되어 있는지 확인합니다. RHEL/CentOS에서는 "yum install openldap-clients openldap-servers&quot; OpenLDAP를 설치합니다.

13개의 호스트 설치와 2개의 데이터 센터가 있는 12개의 호스트 설치의 경우 OpenLDAP를 호스팅하는 노드가 여러 개 있으므로 OpenLDAP 복제.

방화벽 및 가상 호스트

'가상'이라는 용어는 일반적으로 IT 분야에서 과부하가 걸리므로 프라이빗 클라우드 배포 및 가상 호스트를 위한 Apigee Edge입니다. 두 가지 주요 '가상'이라는 용어의 사용:

• 가상 머신 (VM): 필수는 아니지만 일부 배포에서는 VM 기술을 사용합니다. Apigee 구성요소에 대해 격리된 서버를 만듭니다 물리적 호스트와 마찬가지로 VM 호스트에는 네트워크 인터페이스와 방화벽이 있습니다 이 설치 안내에서는 VM 설치
• 가상 호스트: Apache 가상 호스트와 유사한 웹 엔드포인트입니다.

VM의 라우터는 여러 가상 호스트를 노출할 수 있습니다 (단, 가상 호스트가 호스트 별칭 또는 인터페이스 포트에서)를 사용할 수 있습니다.

이름 지정 예로, 단일 물리적 서버 'A'는 두 개의 VM을 실행할 수 있습니다. 이름을 'VM1'과 'VM2'로 설정합니다 VM1이 가상 이더넷을 노출한다고 가정합시다 인터페이스 - 이름은 eth0 내부 IP 주소만 포함하고, 가상화에 의해 IP 주소 111.111.111.111이 기계 또는 네트워크 DHCP 서버, VM2가 가상 이더넷 인터페이스를 노출한다고 가정하겠습니다 IP 주소 111.111.111.222가 할당됩니다.

두 VM 각각에서 Apigee 라우터를 실행할 수 있습니다. 라우터는 가상 호스트를 노출하고 엔드포인트 간 연결을 제공합니다.

VM1의 Apigee 라우터는 eth0 인터페이스 (일부 특정 IP 주소), api.mycompany.com:80, api.mycompany.com:443 및 test.mycompany.com:80도 포함됩니다.

VM2의 라우터는 api.mycompany.com:80 (동일한 이름 및 포트)을 노출합니다. VM1에 의해 노출됨).

물리적 호스트의 운영 체제에 네트워크 방화벽이 있을 수 있습니다. 연결되어 있는 경우 해당 방화벽은 가상 머신에 노출되는 포트에 대한 TCP 트래픽을 통과하도록 구성해야 함 인터페이스 (111.111.111.111:{80, 443} 및 111.111.111.222:80). 또한 각 VM의 운영체제는 eth0 인터페이스에 자체 방화벽을 제공할 수 있으며, 이 역시 포트 80 및 443 트래픽의 연결을 허용합니다.

basepath는 API 호출을 다른 API 프록시로 라우팅하는 것과 관련된 세 번째 구성요소입니다. 여러 옵션을 제공합니다 API 프록시 번들에 서로 다른 엔드포인트가 있는 경우 basepaths에 대해 설명합니다. 예를 들어 하나의 기본 경로는 http://api.mycompany.com:80/로 정의될 수 있고 다른 기본 경로는 http://api.mycompany.com:80/salesdemo로 정의합니다.

이 경우 트래픽을 분할하는 일종의 부하 분산기 또는 트래픽 디렉터가 두 IP 주소 간의 http://api.mycompany.com:80/ 트래픽 (VM1의 경우 111.111.111.111, VM2의 경우 111.111.111.222) 이 함수는 특정 설치에 따라 다르며 로컬 네트워킹 그룹에 의해 구성됩니다.

기본 경로는 API를 배포할 때 설정됩니다. 위의 예에서 두 개의 API를 배포할 수 있습니다. mycompany 및 testmycompany(조직용) mycompany-org는 호스트 별칭이 api.mycompany.com이고 포트가 80입니다. 이 속성을 선언하지 않을 경우 기본 경로인 경우 라우터는 들어오는 요청을 보낼 API를 알지 못합니다. 있습니다.

그러나 기본 URL이 포함된 testmycompany API를 /salesdemo에 추가한 경우 사용자 액세스 권한이 있습니다. http://api.mycompany.com:80/salesdemo를 사용하여 해당 API에 액세스할 수 있습니다. 만약 /로 기본 URL을 사용하여 API mycompany를 배포한 다음 사용자는 해당 URL을 통해 http://api.mycompany.com:80/.

에지 포트 요구사항

방화벽을 관리해야 하는 이유는 가상 호스트에 국한되지 않습니다. VM 및 물리적 호스트 모두 방화벽은 구성 요소가 각 구성 요소와 통신하는 데 필요한 포트에 대한 트래픽을 허용해야 함 있습니다.

다음 이미지는 각 Edge 구성요소의 포트 요구사항을 보여줍니다.

이 다이어그램에 대한 참고 사항:

• *메시지 프로세서의 포트 8082는 라우터와 메시지 프로세서 간에 TLS/SSL을 구성합니다. TLS/SSL을 구성하지 않는 경우 기본 구성인 포트 8082는 여전히 구성 요소를 관리하기 위해 메시지 프로세서에 열려 있지만 라우터는 액세스할 수 있습니다
• 'M' 접두사가 붙은 포트 구성 요소를 관리하는 데 사용되는 포트이며 구성 요소만 사용합니다.
• 다음 구성 요소는 관리 서버의 포트 8080에 액세스해야 하는 구성 요소입니다: 라우터 메시지 프로세서, UI, Postgres, Qpid
• 메시지 프로세서는 관리 포트로 포트 4528을 열어야 합니다. 여러 계정을 모든 메시지 프로세서는 포트 4528( 루프 화살표). 여러 계정을 데이터 센터에서는 모든 데이터 센터의 모든 메시지 프로세서가 포트에 액세스할 수 있어야 합니다.
• 필수는 아니지만 라우터에서 포트 4527을 열어 모든 메시지에서 액세스할 수 있습니다. 프로세서. 그렇지 않으면 메시지 프로세서 로그 파일에 오류 메시지가 표시될 수 있습니다.
• 라우터는 관리 포트로 포트 4527을 열어야 합니다. 라우터가 여러 개 있는 경우 모두 포트 4527을 통해 서로 액세스할 수 있어야 합니다( 4527번 포트를 참조해야 함).
• Edge UI를 지원하려면 API 프록시가 노출된 포트에서 라우터에 액세스할 수 있어야 합니다. 트레이스 도구의 Send 버튼 사용.
• 관리 서버가 Cassandra의 JMX 포트에 대한 액세스 권한 필요 노드라는 두 가지 리소스가 있습니다
• 사용자 이름/암호를 요구하도록 JMX 포트에 대한 액세스를 구성할 수 있습니다. 자세한 내용은 모니터링 방법을 참고하세요.
• 원하는 경우 특정 연결에 TLS/SSL 액세스를 구성하여 사용할 수 있습니다. 자세한 내용은 TLS/SSL을 참고하세요. 자세히 알아보세요.
• 마스터-대기 복제를 사용하도록 Postgres 노드 2개를 구성하는 경우 포트 22를 열어야 합니다. 각 노드에서 SSH 액세스를 위해 사용해야 합니다 원하는 경우 개별 노드에서 포트를 열어서 SSH 액세스.
• 외부 SMTP를 통해 이메일을 보내도록 관리 서버 및 에지 UI를 구성할 수 있습니다. 있습니다. 그렇게 하는 경우, 관리 서버 및 UI가 필요한 포트 500~400을 지원합니다. 비 TLS SMTP의 포트 번호는 일반적으로 25입니다. TLS를 사용하는 경우 SMTP는 보통 465이지만 SMTP 제공업체에 문의하세요.

아래 표에는 방화벽에서 Edge 구성요소별로 열어야 하는 포트가 나와 있습니다.

> curl -v http://<routerIP>:15999/v1/servers/self/reachable

다음 테이블에는 동일한 포트가 소스 및 대상과 함께 숫자로 나열되어 있습니다. 구성요소:

메시지 프로세서가 구성된 Cassandra에 대한 전용 연결 풀을 열린 상태로 유지 시간 초과가 발생하지 않습니다 방화벽이 메시지 프로세서와 Cassandra 서버 사이에 있을 때 방화벽이 연결 제한 시간을 초과할 수 있습니다 그러나 메시지 프로세서는 Cassandra에 대한 연결을 다시 설정합니다

이러한 상황을 방지하기 위해 Apigee는 Cassandra 서버, 메시지 프로세서, 모든 라우터가 동일한 서브넷에 있도록 하기 위해 구성할 수 있습니다.

방화벽이 라우터와 메시지 프로세서 사이에 있고 유휴 TCP 제한시간이 설정되어 있는 경우 권장사항:

1. net.ipv4.tcp_keepalive_time = 1800(Linux OS의 sysctl 설정의 경우 1800이 방화벽 유휴 상태보다 낮아야 함) TCP 제한 시간. 이 설정은 연결을 설정 상태로 유지해야 연결을 끊지 않습니다
2. 모든 메시지 프로세서에서 /&lt;inst_root&gt;/apigee/customer/application/message-processor.properties를 수정하세요. 다음 속성을 추가합니다. 파일이 없으면 새로 만듭니다.
   conf_system_casssandra.maxconnecttimeinmillis=-1
3. 메시지 프로세서를 다시 시작합니다.
   &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-message-processor 재시작
4. 모든 라우터에서 /&lt;inst_root&gt;/apigee/customer/application/router.properties를 수정합니다. 다음 속성을 추가합니다. 파일이 없으면 새로 만듭니다.
   conf_system_casssandra.maxconnecttimeinmillis=-1
5. 라우터를 다시 시작합니다.
   &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-router 재시작

2개의 데이터 센터가 있는 12개의 호스트 클러스터형 구성을 설치하는 경우 두 데이터 센터의 노드는 아래에 표시된 포트를 통해 통신할 수 있습니다.

API BaaS 포트 요구사항

API BaaS를 설치하려면 API BaaS 스택 및 API BaaS 포털 구성요소를 추가합니다. 이러한 구성요소는 아래 그림에 표시된 포트를 사용합니다.

이 다이어그램에 대한 참고 사항:

• Cassandra 노드를 API BaaS 전용으로 사용하거나 Edge와 공유할 수 있습니다.
• API BaaS의 프로덕션 설치는 API BaaS 포털 노드 간 부하 분산기를 사용합니다. API BaaS 스택 노드를 사용할 수 있습니다 포털을 구성할 때와 BaaS API를 호출할 때 스택 노드가 아닌 부하 분산기의 IP 주소 또는 DNS 이름을 지정해야 합니다.
• 외부 SMTP 서버를 통해 이메일을 보내려면 모든 Baas Stack 노드를 구성해야 합니다. 대상 비 TLS SMTP의 경우 포트 번호는 일반적으로 25입니다. TLS를 사용하는 SMTP의 경우 대개 465이지만 SMTP 제공업체와 연결할 수 있습니다.

아래 표에는 방화벽에서 열어야 하는 기본 포트가 구성요소별로 나와 있습니다.

라이선스

Edge를 설치할 때마다 Apigee에서 받은 고유한 라이선스 파일이 필요합니다. 사용자는 다음 작업을 수행합니다. 관리 서버를 설치할 때 라이선스 파일의 경로를 제공해야 함(예: /tmp/license.txt.

설치 프로그램이 라이선스 파일을 /&lt;inst_root&gt;/apigee/customer/conf/license.txt에 복사합니다.

라이선스 파일이 유효하면 관리 서버가 만료일 및 허용된 메시지의 유효성을 확인합니다. 프로세서 (MP) 수 라이선스 설정이 만료된 경우 위치: /&lt;inst_root&gt;/apigee/var/log/edge-management-server/logs 이 경우 Apigee 지원팀에 문의하여 마이그레이션 세부정보