설치 요구사항

하드웨어 요구사항

프로덕션 등급 환경에서 고가용성 인프라를 위해서는 다음 최소 하드웨어 요구사항을 충족해야 합니다.

다음 동영상에서는 설치에 관한 대략적인 크기 조정 가이드를 제공합니다.

설치 토폴로지에 설명된 모든 설치 시나리오에서 다음 표에는 설치 구성요소의 최소 하드웨어 요구사항이 나열되어 있습니다.

이 표에서 하드 디스크 요구사항은 운영체제에 필요한 하드 디스크 공간 외에 추가로 필요한 공간입니다. 애플리케이션 및 네트워크 트래픽에 따라 설치에 아래에 나열된 것보다 더 많거나 적은 리소스가 필요할 수 있습니다.

설치 구성요소 RAM CPU 최소 하드 디스크
Cassandra (독립형) 16GB 8코어 2,000 IOPS를 지원하는 SSD가 포함된 250GB 로컬 스토리지
동일한 머신에 Cassandra/Zookeeper 16GB 8코어 2,000 IOPS를 지원하는 SSD가 포함된 250GB 로컬 스토리지
동일한 머신에 있는 메시지 프로세서/라우터 16GB 8코어 100GB
메시지 프로세서 (독립형) 16GB 8코어 100GB
라우터 (독립형) 8GB 8코어 100GB
분석 - 동일한 서버의 Postgres/Qpid 16GB* 8코어* 500GB~1TB** 네트워크 스토리지***(SSD 백엔드 권장)로 1,000 IOPS 이상 지원*
분석 - Postgres 마스터 또는 스탠바이 독립형 16GB* 8코어* 500GB~1TB** 네트워크 스토리지***(SSD 백엔드 권장)로 1,000 IOPS 이상 지원*
분석 - Qpid (독립형) 8GB 4코어 SSD가 포함된 30~50GB 로컬 저장소

기본 Qpid 대기열 크기는 1GB이며 2GB로 늘릴 수 있습니다. 용량이 더 필요한 경우 Qpid 노드를 추가합니다.
SymasLDAP/UI/관리 서버 8GB 4코어 60GB
UI/관리 서버 4GB 2코어 60GB
SymasLDAP (독립형) 4GB 2코어 60GB

* 처리량을 기반으로 Postgres 시스템 요구사항을 조정합니다.

  • 250 TPS 미만: 1,000 IOPS 이상을 지원하는 관리형 네트워크 스토리지***를 사용하는 8GB, 4코어를 고려할 수 있습니다.
  • 250TPS 초과: 16GB, 8코어, 관리형 네트워크 스토리지*** (1,000IOPS 이상 지원)
  • 1,000TPS 초과: 16GB, 8코어, 관리형 네트워크 스토리지***(2,000 IOPS 이상 지원)
  • 2,000TPS 초과: 32GB, 16코어, 2,000IOPS 이상을 지원하는 관리형 네트워크 스토리지***
  • 4,000TPS 초과: 64GB, 32코어, 관리 네트워크 스토리지***(4,000 IOPS 이상 지원)

** Postgres 하드 디스크 값은 Edge에서 캡처한 기본 분석을 기반으로 합니다. 분석 데이터에 맞춤 값을 추가하는 경우 이러한 값을 적절히 늘려야 합니다. 필요한 스토리지를 추정하려면 다음 수식을 사용하세요.

bytes of storage needed =

  (# bytes of analytics data/request) *

  (requests/second) *

  (seconds/hour) *

  (hours of peak usage/day) *

  (days/month) *

  (months of data retention)

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

(2K bytes) * (100 req/sec) * (3600 secs/hr) * (18 peak hours/day) * (30 days/month) * (3 months retention)

= 1,194,393,600,000 bytes or 1194.4 GB of storage needed

*** PostgreSQL 데이터베이스에는 네트워크 스토리지가 권장됩니다.

  • 필요한 경우 스토리지 크기를 동적으로 확장할 수 있습니다.
  • 네트워크 IOPS는 오늘날 대부분의 환경/스토리지/네트워크 하위 시스템에서 즉시 조정할 수 있습니다.
  • 스토리지 수준 스냅샷은 백업 및 복구 솔루션의 일부로 사용 설정할 수 있습니다.

또한 All-in-One 설치에서는 지원되지 않는 수익 창출 서비스를 설치하려면 다음 하드웨어 요구사항을 충족해야 합니다.

수익 창출이 포함된 구성요소 RAM CPU 하드 디스크
관리 서버 (수익 창출 서비스 포함) 8GB 4코어 60GB
분석 - 동일한 서버의 Postgres/Qpid 16GB 8코어 500GB~1TB 네트워크 스토리지(SSD 백엔드 권장, 1,000 IOPS 이상 지원) 또는 위의 표에 나온 규칙을 사용합니다.
분석 - Postgres 마스터 또는 스탠바이 독립형 16GB 8코어 500GB~1TB 네트워크 스토리지(SSD 백엔드 권장, 1,000 IOPS 이상 지원) 또는 위의 표에 나온 규칙을 사용합니다.
분석 - Qpid (독립형) 8GB 4코어 SSD 또는 고속 HDD가 장착된 40GB~500GB 로컬 스토리지

TPS가 250보다 큰 설치의 경우 1, 000 IOPS를 지원하는 로컬 스토리지가 있는 HDD가 권장됩니다.

Cassandra 네트워크 대역폭 요구사항

Cassandra는 Gossip 프로토콜을 사용하여 네트워크 토폴로지에 대한 정보를 다른 노드와 교환합니다. 읽기 및 쓰기 작업을 위해 여러 노드와 통신해야 하는 Cassandra의 분산 특성과 Gossip를 함께 사용하면 네트워크를 통해 많은 데이터가 전송됩니다.

Cassandra에는 노드당 1Gbps 이상의 네트워크 대역폭이 필요합니다. 프로덕션 설치 시 더 높은 대역폭이 권장됩니다.

Cassandra의 최대 또는 99번째 백분위수 지연 시간은 100밀리초 미만이어야 합니다.

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

이 설치 안내와 제공된 설치 파일은 지원되는 소프트웨어 및 지원되는 버전에 나열된 운영체제와 서드 파티 소프트웨어에서 테스트되었습니다.

필수사항: EPEL 저장소 사용 설정

설치를 진행하기 전에 EPEL (Extra Packages for Enterprise Linux) 저장소가 사용 설정되어 있는지 확인하세요. 운영체제 버전에 따라 다음 명령어를 사용합니다.

  • Red Hat/CentOS/Oracle 8.X: 
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
     
    sudo rpm -ivh epel-release-latest-8.noarch.rpm
  • Red Hat/CentOS/Oracle 9.X: 
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
     
    sudo rpm -ivh epel-release-latest-9.noarch.rpm

자바

설치 전에 각 머신에 지원되는 Java 1.8 버전이 설치되어 있어야 합니다. 지원되는 JDK는 지원되는 소프트웨어 및 지원되는 버전에 나열되어 있습니다.

JAVA_HOME 환경 변수가 설치를 실행하는 사용자의 JDK 루트를 가리키는지 확인합니다.

SELinux

SELinux 설정에 따라 Edge 구성요소 설치 및 시작에 문제가 발생할 수 있습니다. 필요한 경우 설치 중에 SELinux를 사용 중지하거나 허용 모드로 설정한 후 설치 후 다시 사용 설정할 수 있습니다. 자세한 내용은 Edge apigee-setup 유틸리티 설치를 참고하세요.

'apigee' 사용자 만들기

설치 절차에서는 'apigee'라는 Unix 시스템 사용자를 만듭니다. 에지 디렉터리와 파일은 에지 프로세스와 마찬가지로 'apigee'가 소유합니다. 즉, Edge 구성요소는 'apigee' 사용자로 실행됩니다. 필요한 경우 다른 사용자로 구성요소를 실행할 수 있습니다.

설치 디렉터리

기본적으로 설치 프로그램은 모든 파일을 /opt/apigee 디렉터리에 씁니다. 이 디렉터리 위치는 변경할 수 없습니다. 이 디렉터리는 변경할 수 없지만 /opt/apigee에서 심볼릭 링크 만들기에 설명된 대로 심볼릭 링크를 만들어 /opt/apigee를 다른 위치에 매핑할 수 있습니다.

이 가이드의 안내에서는 설치 디렉터리가 /opt/apigee로 표시됩니다.

심볼릭 링크를 만들기 전에 먼저 'apigee'라는 사용자 및 그룹을 만들어야 합니다. 이는 Edge 설치 프로그램에서 만든 그룹 및 사용자와 동일합니다.

심볼릭 링크를 만들려면 bootstrap_4.53.01.sh 파일을 다운로드하기 전에 다음 단계를 실행하세요. 다음 단계를 모두 루트로 실행해야 합니다.

  1. 'apigee' 사용자 및 그룹을 만듭니다. 
    groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
  2. /opt/apigee에서 원하는 설치 루트로 심볼릭 링크를 만듭니다. 
    ln -Ts /srv/myInstallDir /opt/apigee

    여기서 /srv/myInstallDir은 Edge 파일의 원하는 위치입니다.

  3. 설치 루트 및 심볼릭 링크의 소유권을 'apigee' 사용자로 변경합니다. 
    chown -h apigee:apigee /srv/myInstallDir /opt/apigee

네트워크 설정

Apigee에서는 설치 전에 네트워크 설정을 확인할 것을 권장합니다. 설치 프로그램은 모든 머신에 고정 IP 주소가 있다고 가정합니다. 다음 명령어를 사용하여 설정을 확인합니다.

  • hostname는 머신 이름을 반환합니다.
  • hostname -i는 다른 머신에서 주소를 지정할 수 있는 호스트 이름의 IP 주소를 반환합니다.

운영체제 유형 및 버전에 따라 호스트 이름이 올바르게 설정되지 않은 경우 /etc/hosts 및 /etc/sysconfig/network을 수정해야 할 수 있습니다. 자세한 내용은 특정 운영체제 문서를 참고하세요.

서버에 인터페이스 카드가 여러 개 있는 경우 'hostname -i' 명령어는 공백으로 구분된 IP 주소 목록을 반환합니다. 기본적으로 Edge 설치 프로그램은 반환된 첫 번째 IP 주소를 사용하며, 이는 모든 상황에서 올바르지 않을 수 있습니다. 또는 설치 구성 파일에서 다음 속성을 설정할 수 있습니다.

ENABLE_DYNAMIC_HOSTIP=y

이 속성이 'y'로 설정되면 설치 프로그램에서 설치의 일부로 사용할 IP 주소를 선택하라는 메시지가 표시됩니다. 기본값은 'n'입니다. 자세한 내용은 Edge 구성 파일 참조를 참고하세요.

TCP 래퍼

TCP 래퍼는 일부 포트의 통신을 차단할 수 있으며 SymasLDAP, Postgres, Cassandra 설치에 영향을 줄 수 있습니다. 이러한 노드에서 /etc/hosts.allow 및 /etc/hosts.deny를 확인하여 필요한 SymasLDAP, Postgres, Cassandra 포트에 포트 제한이 없는지 확인합니다.

iptables

필수 Edge 포트에서 노드 간 연결을 방지하는 iptables 정책이 없는지 확인합니다. 필요한 경우 다음 명령어를 사용하여 설치 중에 iptables를 중지할 수 있습니다.

sudo/etc/init.d/iptables stop

디렉터리 액세스

다음 표에는 Edge 프로세스에서 특별한 요구사항이 있는 Edge 노드의 디렉터리가 나열되어 있습니다.

서비스 디렉터리 설명
라우터 /etc/rc.d/init.d/functions

Edge 라우터는 Nginx 라우터를 사용하며 /etc/rc.d/init.d/functions에 대한 읽기 액세스 권한이 필요합니다.

보안 프로세스에서 /etc/rc.d/init.d/functions에 권한을 설정해야 하는 경우 700으로 설정하지 마세요. 라우터가 시작되지 않습니다.

/etc/rc.d/init.d/functions에 대한 읽기 액세스를 허용하도록 권한을 744로 설정할 수 있습니다.
Zookeeper /dev/random Zookeeper 클라이언트 라이브러리에는 난수 생성기 /dev/random에 대한 읽기 액세스 권한이 필요합니다. 읽기에서 /dev/random가 차단되면 ZooKeeper 서비스가 시작되지 않을 수 있습니다.

Cassandra

모든 Cassandra 노드는 링에 연결되어야 합니다. Cassandra는 안정성과 내결함성을 보장하기 위해 여러 노드에 데이터 복제본을 저장합니다. 각 Edge 키스페이스의 복제 전략에 따라 복제본이 배치되는 Cassandra 노드가 결정됩니다. 자세한 내용은 Cassandra 복제 요소 및 일관성 수준 정보를 참고하세요.

Cassandra는 사용 가능한 메모리에 따라 Java 힙 크기를 자동으로 조정합니다. 성능 저하 또는 높은 메모리 소비가 발생하는 경우 자세한 내용은 Java 리소스 조정을 참고하세요.

Private Cloud용 Edge를 설치한 후 /opt/apigee/apigee-cassandra/conf/cassandra.yaml 파일을 검사하여 Cassandra가 올바르게 구성되었는지 확인할 수 있습니다. 예를 들어 Edge for Private Cloud 설치 스크립트에서 다음 속성을 설정했는지 확인합니다.

  • cluster_name
  • initial_token
  • partitioner
  • seeds
  • listen_address
  • rpc_address
  • snitch

PostgreSQL 데이터베이스

Edge를 설치한 후 시스템에서 사용할 수 있는 RAM 양에 따라 다음 PostgreSQL 데이터베이스 설정을 조정할 수 있습니다.

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 파일을 수정합니다. 
    vi /opt/apigee/customer/application/postgresql.properties

    파일이 없으면 만듭니다.

  2. 위에 나열된 속성을 설정합니다.
  3. 수정사항을 저장합니다.
  4. PostgreSQL 데이터베이스를 다시 시작합니다. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Rocky 9.X의 언어 구성

Rocky 9.X를 사용하는 경우 시스템 전체 언어 설정에서 시스템이 LANG=en_US.utf8로 구성되어 있는지 확인합니다. 이를 구성하려면 다음 명령어를 실행하세요.

dnf -y -q install langpacks-en
localectl set-locale LANG=en_US.utf8
reboot

시스템 한도

Cassandra 및 메시지 프로세서 노드에 다음 시스템 제한이 설정되어 있는지 확인합니다.

  • Cassandra 노드에서 아래와 같이 /etc/security/limits.d/90-apigee-edge-limits.conf에 설치 사용자 (기본값은 'apigee')의 소프트 및 하드 memlock, nofile, 주소 공간 (as) 제한을 설정합니다. 
    apigee soft memlock unlimited
apigee hard memlock unlimited
apigee soft nofile 32768
apigee hard nofile 65536
apigee soft as unlimited
apigee hard as unlimited
apigee soft nproc 32768
apigee hard nproc 65536
  • 메시지 프로세서 노드에서 아래와 같이 /etc/security/limits.d/90-apigee-edge-limits.conf의 열린 파일 설명자의 최대 개수를 64K로 설정합니다. 
    apigee soft nofile 32768
apigee hard nofile 65536

    필요한 경우 이 한도를 늘릴 수 있습니다. 예를 들어 한 번에 열려 있는 임시 파일이 많은 경우입니다.

  • 라우터 또는 메시지 프로세서 system.log에 다음 오류가 표시되면 파일 설명자 한도가 너무 낮게 설정되어 있을 수 있습니다.

    "java.io.IOException: Too many open files"

    다음을 실행하여 사용자 한도를 확인할 수 있습니다.

    # su - apigee
$ ulimit -n
100000

    파일 설명자 제한을 100000로 설정한 후에도 여전히 열린 파일 제한에 도달하는 경우 Apigee Edge 지원팀에 티켓을 열어 추가 문제 해결을 받으세요.

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

네트워크 보안 서비스 (NSS)는 보안 지원 클라이언트 및 서버 애플리케이션 개발을 지원하는 라이브러리 집합입니다. NSS v3.19 이상이 설치되어 있어야 합니다.

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

yum info nss

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

yum update nss

자세한 내용은 RedHat의 이 도움말을 참고하세요.

NSCD (Name Service Cache Daemon)를 사용하는 경우 IPv6에서 DNS 조회 사용 중지

NSCD (Name Service Cache Daemon)를 설치하고 사용 설정한 경우 메시지 프로세서는 IPv4용과 IPv6용으로 두 개의 DNS 조회를 실행합니다. NSCD를 사용하는 경우 IPv6에서 DNS 조회를 사용 중지해야 합니다.

IPv6에서 DNS 조회를 사용 중지하려면 다음 단계를 따르세요.

  1. 모든 메시지 프로세서 노드에서 /etc/nscd.conf를 수정합니다.
  2. 다음 속성을 설정합니다. 
    enable-cache hosts no

RHEL 8 이상에서 IPv6 사용 중지

Google Cloud Platform에서 RHEL 8 이상 버전에 Edge를 설치하는 경우 모든 Qpid 노드에서 IPv6를 사용 중지해야 합니다.

IPv6 사용 중지 방법은 OS 공급업체에서 제공하는 문서를 참고하세요. 예를 들어 Red Hat Enterprise Linux 문서에서 관련 정보를 확인할 수 있습니다.

도구

설치 프로그램은 EL5 또는 EL6에서 제공하는 표준 버전의 다음 UNIX 도구를 사용합니다.

awk

expr

libxslt

rpm

unzip

basename

grep

lua-socket

rpm2cpio

useradd

bash

 hostname

ls

sed

wc

bc

id

net-tools

sudo

wget

curl

libaio

perl (procps에서)

tar

xerces-c
cyrus-sasl libdb4 pgrep (procps에서) tr yum

날짜

 libdb-cxx

ps

uuid

chkconfig
dirname libibverbs pwd uname  
에코 librdmacm python    

시간 동기화

Apigee에서는 서버 시간이 동기화되도록 하는 것이 좋습니다. 아직 구성되지 않은 경우 ntpdate 유틸리티 또는 이와 동등한 도구를 사용하여 서버의 시간이 동기화되었는지 확인할 수 있습니다. 예를 들어 yum install ntp 또는 이에 상응하는 명령어를 사용하여 유틸리티를 설치할 수 있습니다. 이는 특히 LDAP 설정을 복제하는 데 유용합니다. 서버 시간대를 UTC로 설정해야 합니다.

방화벽 및 가상 호스트

virtual라는 용어는 IT 분야에서 흔히 과부하가 걸리며, 프라이빗 클라우드용 Apigee Edge 배포 및 가상 호스트도 마찬가지입니다. 명확히 하자면 virtual라는 용어는 두 가지 주요 용도로 사용됩니다.

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

VM의 라우터는 호스트 별칭이나 인터페이스 포트가 서로 다른 한 여러 가상 호스트를 노출할 수 있습니다.

이름 지정의 예로 단일 물리적 서버 A가 'VM1' 및 'VM2'라는 두 개의 VM을 실행할 수 있습니다. 'VM1'이 가상 이더넷 인터페이스를 노출한다고 가정합니다. 이 인터페이스는 VM 내부에서 'eth0'으로 이름이 지정되고 가상화 시스템이나 네트워크 DHCP 서버에 의해 IP 주소 111.111.111.111가 할당됩니다. 그런 다음 VM2가 'eth0'으로 이름이 지정된 가상 이더넷 인터페이스를 노출하고 IP 주소 111.111.111.222가 할당된다고 가정합니다.

각 VM에서 Apigee 라우터가 실행될 수 있습니다. 라우터는 다음과 같은 가상 예시와 같이 가상 호스트 엔드포인트를 노출합니다.

VM1의 Apigee 라우터는 특정 IP 주소가 있는 eth0 인터페이스에서 가상 호스트 api.mycompany.com:80, api.mycompany.com:443, test.mycompany.com:80를 노출합니다.

VM2의 라우터는 api.mycompany.com:80 (VM1에서 노출된 것과 이름과 포트가 동일함)를 노출합니다.

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

기본 경로는 배포했을 수 있는 여러 API 프록시로 API 호출을 라우팅하는 데 사용되는 세 번째 구성요소입니다. API 프록시 번들은 기본 경로가 다른 경우 엔드포인트를 공유할 수 있습니다. 예를 들어 하나의 기본 경로는 http://api.mycompany.com:80/로 정의하고 다른 하나는 http://api.mycompany.com:80/salesdemo로 정의할 수 있습니다.

이 경우 두 IP 주소(VM1의 111.111.111.111 및 VM2의 111.111.111.222) 간에 http://api.mycompany.com:80/ 트래픽을 분할하는 부하 분산기 또는 트래픽 디렉터가 필요합니다. 이 함수는 특정 설치에만 적용되며 로컬 네트워킹 그룹에서 구성합니다.

기본 경로는 API를 배포할 때 설정됩니다. 위의 예시에서 호스트 별칭이 api.mycompany.com이고 포트가 80로 설정된 가상 호스트를 사용하여 조직 mycompany-org에 API mycompany와 testmycompany를 배포할 수 있습니다. 배포에서 basepath를 선언하지 않으면 라우터는 수신 요청을 전송할 API를 알 수 없습니다.

하지만 /salesdemo의 기본 URL로 API testmycompany를 배포하면 사용자는 http://api.mycompany.com:80/salesdemo를 사용하여 해당 API에 액세스합니다. 기본 URL이 /인 API mycompany를 배포하면 사용자는 URL http://api.mycompany.com:80/로 API에 액세스합니다.

라이선스

Edge를 설치하려면 Apigee에서 획득한 고유한 라이선스 파일이 필요합니다. 관리 서버를 설치할 때 라이선스 파일의 경로를 제공해야 합니다(예: /tmp/license.txt).

설치 프로그램은 라이선스 파일을 /opt/apigee/customer/conf/license.txt에 복사합니다.

라이선스 파일이 유효하면 관리 서버에서 만료일과 허용된 메시지 프로세서 (MP) 수를 검증합니다. 라이선스 설정 중 하나가 만료된 경우 /opt/apigee/var/log/edge-management-server/logs 위치에서 로그를 확인할 수 있습니다. 이 경우 Apigee Edge 지원팀에 문의하여 이전 세부정보를 확인하세요.

아직 라이선스가 없다면 Apigee 영업팀에 문의하세요.