Yükleme Koşulları

Edge for Private Cloud 4.18.01 sürümü

Donanım Gereksinimleri

Üretim düzeyindeki bir ortamda yüksek kullanılabilirlikli bir altyapı için aşağıdaki minimum donanım gereksinimlerini karşılamanız gerekir. Aşağıdaki tablolarda, Yükleme Topolojileri bölümünde açıklanan tüm yükleme senaryoları için yükleme bileşenlerinin minimum donanım gereksinimleri listelenmiştir.

Bu tablolardaki sabit disk gereksinimleri, işletim sisteminin gerektirdiği sabit disk alanına ek olarak belirtilmiştir. Uygulamalarınıza ve ağ trafiğinize bağlı olarak, kurulumunuz için aşağıda listelenenlerden daha fazla veya daha az kaynak gerekebilir.

Kurulum Bileşeni RAM CPU Minimum sabit disk
Cassandra 16 GB 8 çekirdekli 2.000 IOPS'yi destekleyen SSD veya hızlı HDD ile 250 GB yerel depolama alanı
Aynı makinede Mesaj İşleyici/Yönlendirici 16 GB 8 çekirdekli 100GB
Analytics - Postgres/Qpid aynı sunucuda (üretim için önerilmez) 16GB* 8 çekirdekli* 500 GB - 1 TB** ağ depolama alanı***, tercihen SSD arka ucuyla, 1.000 IOPS veya daha fazlasını destekleyen*
Analytics - Postgres bağımsız 16GB* 8 çekirdekli* 500 GB - 1 TB** ağ depolama alanı***, tercihen SSD arka ucuyla, 1.000 IOPS veya daha fazlasını destekleyen*
Analytics - Qpid bağımsız 8 GB 4 çekirdekli SSD veya hızlı HDD ile 30 GB - 50 GB yerel depolama alanı

250 TPS'den büyük kurulumlar için 1.000 IOPS'yi destekleyen yerel depolama alanına sahip HDD önerilir.

Varsayılan Qpid sıra boyutu 20 GB'tır. Daha fazla kapasite eklemeniz gerekiyorsa ek Qpid düğümleri ekleyin.

Diğer (OpenLDAP, kullanıcı arayüzü, yönetim sunucusu) 4 GB 2 çekirdekli 60 GB

* Postgres sistem gereksinimlerini işleme hızına göre ayarlayın:

  • 250 TPS'den az: 1.000 IOPS veya daha fazlasını destekleyen yönetilen ağ depolama alanı*** ile 8 GB, 4 çekirdekli kullanılabilir.
  • 250 TPS'den fazla: 16 GB, 8 çekirdek, 1.000 IOPS veya daha fazlasını destekleyen yönetilen ağ depolama alanı***
  • 1.000 TPS'den fazla: 16 GB, 8 çekirdek, 2.000 IOPS veya daha fazlasını destekleyen yönetilen ağ depolama alanı***
  • 2.000 TPS'den fazla: 32 GB, 16 çekirdek, 2.000 IOPS veya daha fazlasını destekleyen yönetilen ağ depolama alanı***
  • 4.000 TPS'den fazla: 64 GB, 32 çekirdek, 4.000 IOPS veya daha fazlasını destekleyen yönetilen ağ depolama alanı***

** Postgres sabit disk değeri, Edge tarafından yakalanan kullanıma hazır analizlere dayanır. Analytics verilerine özel değerler eklerseniz bu değerler de buna göre artırılmalıdır. Gerekli depolama alanını tahmin etmek için aşağıdaki formülü kullanın:

bytes of storage needed =

  (# bytes of analytics data/request) *

  (requests/second) *

  (seconds/hour) *

  (hours of peak usage/day) *

  (days/month) *

  (months of data retention)

Örneğin:

(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

*** PostgreSQL veritabanı için ağ depolama alanı önerilir. Bunun nedeni:

  • Gerektiğinde depolama alanı boyutunu dinamik olarak ölçeklendirme olanağı sunar.
  • Ağ IOPS'si, günümüzdeki ortam/depolama/ağ alt sistemlerinin çoğunda anında ayarlanabilir.
  • Depolama düzeyinde anlık görüntüler, yedekleme ve kurtarma çözümlerinin bir parçası olarak etkinleştirilebilir.

Ayrıca, Para Kazanma Hizmetleri'ni yüklemek istiyorsanız aşağıdaki donanım gereksinimleri de geçerlidir:

Para kazanma özellikli bileşen RAM CPU Sabit disk
Yönetim Sunucusu (Para Kazanma Hizmetleri ile) 8 GB 4 çekirdekli 60 GB
Analytics - Postgres/Qpid on same server 16 GB 8 çekirdekli 500 GB - 1 TB ağ depolama alanı (tercihen SSD arka uçlu, 1.000 IOPS veya daha yüksek değerleri destekleyen) ya da yukarıdaki tablodaki kuralı kullanın.
Analytics - Postgres bağımsız 16 GB 8 çekirdekli 500 GB - 1 TB ağ depolama alanı (tercihen SSD arka uçlu, 1.000 IOPS veya daha yüksek değerleri destekleyen) ya da yukarıdaki tablodaki kuralı kullanın.
Analytics - Qpid bağımsız 8 GB 4 çekirdekli SSD veya hızlı HDD ile 40 GB - 500 GB yerel depolama alanı

250 TPS'den büyük kurulumlar için 1.000 IOPS'yi destekleyen yerel depolama alanına sahip HDD önerilir.

API BaaS'yi yüklemek istiyorsanız aşağıdaki donanım gereksinimlerini karşılamanız gerekir:

API BaaS Bileşeni RAM CPU Sabit disk
ElasticSearch* 8 GB 4 çekirdekli 60-80GB
API BaaS Stack* 8 GB 4 çekirdekli 60-80GB
API BaaS Portal 1 GB 2 çekirdekli 20GB
Cassandra** 16 GB 8 çekirdekli 2.000 IOPS'yi destekleyen SSD veya hızlı HDD ile 250 GB yerel depolama alanı

* ElasticSearch ve API BaaS Stack'i aynı düğüme yükleyebilirsiniz. Kullanıyorsanız ElasticSearch'ü 4 GB bellek (varsayılan) kullanacak şekilde yapılandırın. ElasticSearch kendi düğümüne yüklüyse 6 GB bellek kullanacak şekilde yapılandırın.

** İsteğe bağlı; genellikle hem Edge hem de API BaaS Hizmetleri için aynı Cassandra kümesini kullanırsınız.

İşletim sistemi ve üçüncü taraf yazılım gereksinimleri

Bu yükleme talimatları ve sağlanan yükleme dosyaları, Desteklenen yazılımlar ve desteklenen sürümler bölümünde listelenen işletim sistemleri ve üçüncü taraf yazılımlarda test edilmiştir.

Apigee kullanıcısını oluşturma

Yükleme prosedürü, "apigee" adlı bir Unix sistem kullanıcısı oluşturur. Edge dizinleri ve dosyaları, Edge işlemleri gibi "apigee"ye aittir. Bu, Edge bileşenlerinin "apigee" kullanıcısı olarak çalıştığı anlamına gelir. Gerekirse bileşenleri farklı bir kullanıcı olarak çalıştırabilirsiniz.

Yükleme dizini

Yükleyici, varsayılan olarak tüm dosyaları /opt/apigee dizinine yazar. Bu dizin konumunu değiştiremezsiniz. Bu dizini değiştiremezsiniz ancak aşağıda açıklandığı gibi /opt/apigee dizinini başka bir konuma eşlemek için sembolik bağlantı oluşturabilirsiniz.

Bu kılavuzdaki talimatlarda, yükleme dizini /opt/apigee olarak belirtilmiştir.

/opt/apigee'den sembolik bağlantı oluşturma

Sembolik bağlantıyı oluşturmadan önce "apigee" adlı bir kullanıcı ve grup oluşturmanız gerekir. Bu, Edge yükleyicisi tarafından oluşturulan grup ve kullanıcıyla aynıdır.

Sembolik bağlantıyı oluşturmak için bootstrap_4.18.01.sh dosyasını indirmeden önce aşağıdaki adımları uygulayın. Bu adımların tümünü root olarak gerçekleştirmeniz gerekir:

  1. "apigee" kullanıcısını ve grubunu oluşturun:
    groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
  2. /opt/apigee konumundan istediğiniz yükleme köküne bir sembolik bağlantı oluşturun:
    ln -Ts /srv/myInstallDir /opt/apigee

    /srv/myInstallDir, Edge dosyalarının bulunmasını istediğiniz konumdur.

  3. Yükleme kökünün ve sembolik bağlantının sahipliğini "apigee" kullanıcısı olarak değiştirin:
    chown -h apigee:apigee /srv/myInstallDir /opt/apigee

Java

Yükleme işleminden önce her makinede Java 1.8'in desteklenen bir sürümünün yüklü olması gerekir. Desteklenen JDK'lar, Desteklenen yazılımlar ve desteklenen sürümler bölümünde listelenir.

JAVA_HOME değişkeninin, yüklemeyi gerçekleştiren kullanıcı için JDK'nin kök dizinine işaret ettiğinden emin olun.

SELinux

SELinux ayarlarınıza bağlı olarak Edge, Edge bileşenlerini yükleme ve başlatma konusunda sorunlarla karşılaşabilir. Gerekirse yükleme sırasında SELinux'u devre dışı bırakabilir veya izin verme moduna ayarlayabilir, ardından yükleme işleminden sonra yeniden etkinleştirebilirsiniz. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.

Ağ Ayarı

Yüklemeden önce ağ ayarlarını kontrol etmeniz önerilir. Yükleyici, tüm makinelerin sabit IP adreslerine sahip olmasını bekler. Ayarı doğrulamak için aşağıdaki komutları kullanın:

  • hostname, makinenin adını döndürür.
  • hostname -i, diğer makinelerden erişilebilen ana makine adının IP adresini döndürür.

İşletim sisteminizin türüne ve sürümüne bağlı olarak, ana makine adı doğru ayarlanmamışsa /etc/hosts ve /etc/sysconfig/network dosyalarını düzenlemeniz gerekebilir. Daha fazla bilgi için işletim sisteminizin belgelerine bakın.

Bir sunucuda birden fazla arayüz kartı varsa "hostname -i" komutu, IP adreslerinin boşlukla ayrılmış bir listesini döndürür. Varsayılan olarak Edge yükleyici, döndürülen ilk IP adresini kullanır. Bu adres her durumda doğru olmayabilir. Alternatif olarak, yükleme yapılandırma dosyasında aşağıdaki özelliği ayarlayabilirsiniz:

ENABLE_DYNAMIC_HOSTIP=y

Bu özellik "y" olarak ayarlandığında yükleyici, yükleme kapsamında kullanılacak IP adresini seçmenizi ister. Varsayılan değer "n"dir. Daha fazla bilgi için Edge Yapılandırma Dosyası Referansı'na bakın.

TCP sarmalayıcıları

TCP sarmalayıcılar bazı bağlantı noktalarının iletişimini engelleyebilir ve OpenLDAP, Postgres ve Cassandra kurulumunu etkileyebilir. Bu düğümlerde, gerekli OpenLDAP, Postgres ve Cassandra bağlantı noktalarında bağlantı noktası kısıtlaması olmadığından emin olmak için /etc/hosts.allow ve /etc/hosts.deny değerlerini kontrol edin.

iptables

Gerekli Edge bağlantı noktalarındaki düğümler arasında bağlantıyı engelleyen iptables politikaları olmadığını doğrulayın. Gerekirse aşağıdaki komutu kullanarak yükleme sırasında iptables'ı durdurabilirsiniz:

sudo/etc/init.d/iptables stop

CentOS 7.x'te:

systemctl stop firewalld

Edge Router'ın /etc/rc.d/init.d/functions dosyasına erişebildiğinden emin olun.

Edge Router ve BaaS Portal düğümleri, Nginx yönlendiricisini kullanır ve /etc/rc.d/init.d/functions için okuma erişimi gerektirir.

Güvenlik süreciniz /etc/rc.d/init.d/functions üzerinde izinler ayarlamanızı gerektiriyorsa bunları 700 olarak ayarlamayın. Aksi takdirde yönlendirici başlatılamaz. İzinler, /etc/rc.d/init.d/functions için okuma erişimine izin verecek şekilde 744 olarak ayarlanabilir.

Cassandra

Tüm Cassandra düğümlerinin bir halkaya bağlı olması gerekir. Cassandra, güvenilirlik ve hata toleransı sağlamak için veri replikalarını birden fazla düğümde depolar. Her bir Edge anahtar alanı için replikasyon stratejisi, replikaların yerleştirildiği Cassandra düğümlerini belirler. Daha fazla bilgi için Cassandra Çoğaltma Faktörü ve Tutarlılık Düzeyi Hakkında başlıklı makaleyi inceleyin.

Cassandra, Java yığın boyutunu kullanılabilir belleğe göre otomatik olarak ayarlar. Daha fazla bilgi için Java kaynaklarını ayarlama başlıklı makaleyi inceleyin. Performans düşüşü veya yüksek bellek tüketimi durumunda.

Edge for Private Cloud'u yükledikten sonra /opt/apigee/apigee-cassandra/conf/cassandra.yaml dosyasını inceleyerek Cassandra'nın doğru şekilde yapılandırıldığını kontrol edebilirsiniz. Örneğin, Edge for Private Cloud yükleme komut dosyasının aşağıdaki özellikleri ayarladığından emin olun:

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

PostgreSQL veritabanı

Edge'i yükledikten sonra, sisteminizdeki RAM miktarına göre aşağıdaki PostgreSQL veritabanı ayarlarını yapabilirsiniz:

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

Bu değerleri ayarlamak için:

  1. postgresql.properties dosyasını düzenleyin:
    vi /opt/apigee/customer/application/postgresql.properties

    Dosya yoksa oluşturun.

  2. Yukarıda listelenen özellikleri ayarlayın.
  3. Yaptığınız düzenlemeleri kaydedin.
  4. PostgreSQL veritabanını yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Sistem sınırları

Cassandra ve Mesaj İşleyici düğümlerinde aşağıdaki sistem sınırlarını ayarladığınızdan emin olun:

  • Cassandra düğümlerinde, /etc/security/limits.d/90-apigee-edge-limits.conf dosyasında kurulum kullanıcısı (varsayılan "apigee"dir) için yumuşak ve sert memlock, nofile ve adres alanı (as) sınırlarını aşağıdaki gibi ayarlayın:
    apigee soft memlock unlimited
    apigee hard memlock unlimited
    apigee soft nofile 32768
    apigee hard nofile 65536
    apigee soft as unlimited
    apigee hard as unlimited
  • Mesaj İşleyici düğümlerinde, /etc/security/limits.d/90-apigee-edge-limits.conf dosyasında açık dosya tanımlayıcılarının maksimum sayısını aşağıda gösterildiği gibi 64.000 olarak ayarlayın:
    apigee soft nofile 32768
    apigee hard nofile 65536

    Gerekirse bu sınırı artırabilirsiniz. Örneğin, aynı anda çok sayıda geçici dosya açtıysanız.

jsvc

"jsvc", API BaaS'ı kullanmak için bir ön koşuldur. API BaaS'yi yüklediğinizde 1.0.15-dev sürümü yüklenir.

Ağ Güvenliği Hizmetleri (NSS)

Ağ Güvenliği Hizmetleri (NSS), güvenlik özellikli istemci ve sunucu uygulamalarının geliştirilmesini destekleyen bir kitaplık grubudur. NSS 3.19 veya sonraki bir sürümü yüklediğinizden emin olmanız gerekir.

Mevcut sürümünüzü kontrol etmek için:

yum info nss

NSS'yi güncellemek için:

yum update nss

Daha fazla bilgi için RedHat'in bu makalesine bakın.

NSCD (Ad Hizmeti Önbellek Arka Plan Programı) kullanırken IPv6'da DNS aramasını devre dışı bırakın.

NSCD'yi (Ad Hizmeti Önbellek Arka Plan Programı) yükleyip etkinleştirdiyseniz Mesaj İşleyiciler iki DNS araması yapar: biri IPv4, diğeri IPv6 için. NSCD kullanırken IPv6'da DNS aramasını devre dışı bırakmanız gerekir.

IPv6'da DNS aramasını devre dışı bırakmak için:

  1. Her Mesaj İşleyici düğümünde /etc/nscd.conf dosyasını düzenleyin.
  2. Aşağıdaki özelliği ayarlayın:
    enable-cache hosts no

RedHat/CentOS 7 için Google Cloud Platform'da IPv6'yı devre dışı bırakma

Edge'i Google Cloud Platform'da RedHat 7 veya CentOS 7'ye yüklüyorsanız tüm Qpid düğümlerinde IPv6'yı devre dışı bırakmanız gerekir.

IPv6'yı devre dışı bırakma talimatları için işletim sistemi sürümünüze ait RedHat veya CentOS belgelerine bakın. Örneğin, şunları yapabilirsiniz:

  1. /etc/hosts dosyasını bir düzenleyicide açın.
  2. Aşağıdaki satırın birinci sütununa "#" karakteri ekleyerek satırı yorum haline getirin:
    #::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
  3. Dosyayı kaydedin.

AWS AMI

Edge'i Red Hat Enterprise Linux 7.x için bir AWS Amazon Makine Görüntüsü'ne (AMI) yüklüyorsanız öncelikle aşağıdaki komutu çalıştırmanız gerekir:

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

Araçlar

Yükleyici, EL5 veya EL6 tarafından sağlanan standart sürümde aşağıdaki UNIX araçlarını kullanır.

awk

expr

libxslt

devir/dk.

sıkıştırılmış dosyayı açma

basename

grep

lua-socket

rpm2cpio

useradd

bash

ana makine adı

ls

sed

wc

bc

id

net-tools

sudo

wget

curl

libaio

perl (procps'ten)

katran

xerces-c

cyrus-sasl libdb4 pgrep (procps'ten) tr leziz

tarih

libdb-cxx

ps

uuid

chkconfig

dirname libibverbs pwd uname  
echo librdmacm python    

ntpdate

Sunucuların saatlerinin senkronize edilmesi önerilir. Henüz yapılandırılmadıysa sunucuların zaman senkronizasyonunun yapılıp yapılmadığını doğrulayan ntpdate yardımcı programı bu amaçla kullanılabilir. Yardımcı programı yüklemek için yum install ntp komutunu kullanabilirsiniz. Bu, özellikle OpenLDAP kurulumlarını kopyalamak için kullanışlıdır. Sunucu saat dilimini UTC olarak ayarladığınızı unutmayın.

openldap 2.4

Şirket içi kurulum için OpenLDAP 2.4 gerekir. Sunucunuzun internet bağlantısı varsa Edge yükleme komut dosyası OpenLDAP'yi indirip yükler. Sunucunuzun internet bağlantısı yoksa Edge yükleme komut dosyasını çalıştırmadan önce OpenLDAP'nin yüklü olduğundan emin olmanız gerekir. RHEL/CentOS'ta OpenLDAP'yi yüklemek için yum install openldap-clients openldap-servers komutunu çalıştırabilirsiniz.

13 ana makine içeren kurulumlarda ve iki veri merkezi içeren 12 ana makine içeren kurulumlarda, OpenLDAP'yi barındıran birden fazla düğüm olduğundan OpenLDAP replikasyonu gerekir.

Güvenlik Duvarları ve Sanal Ana Makineler

virtual terimi, BT alanında genellikle aşırı yüklenir. Bu durum, Apigee Edge for Private Cloud dağıtımı ve sanal ana makineler için de geçerlidir. Açıklamak gerekirse virtual teriminin iki temel kullanımı vardır:

  • Sanal makineler (VM): Gerekli değildir ancak bazı dağıtımlarda Apigee bileşenleri için yalıtılmış sunucular oluşturmak amacıyla sanal makine teknolojisi kullanılır. Sanal makine ana makineleri, fiziksel ana makineler gibi ağ arayüzlerine ve güvenlik duvarlarına sahip olabilir.
  • Sanal ana makineler: Apache sanal ana makinesine benzer web uç noktaları.

Sanal makinedeki bir yönlendirici, birden fazla sanal ana makineyi gösterebilir (ana makine takma adları veya arayüz bağlantı noktaları birbirinden farklı olduğu sürece).

Adlandırma örneği olarak, tek bir fiziksel sunucu A "VM1" ve "VM2" adlı iki sanal makine çalıştırıyor olabilir. "VM1 "in, sanal makine içinde"eth0" olarak adlandırılan ve sanallaştırma makineleri veya bir ağ DHCP sunucusu tarafından 111.111.111.111 IP adresi atanan bir sanal Ethernet arayüzü sunduğunu varsayalım. VM2'nin de "eth0" olarak adlandırılan ve 111.111.111.222 IP adresi atanan bir sanal Ethernet arayüzü sunduğunu varsayalım.

İki sanal makinenin her birinde çalışan bir Apigee yönlendiricimiz olabilir. Yönlendiriciler, sanal ana makine uç noktalarını bu varsayımsal örnekte olduğu gibi gösterir:

VM1'deki Apigee yönlendiricisi, eth0 arayüzünde (belirli bir IP adresine sahip) üç sanal ana makineyi (api.mycompany.com:80, api.mycompany.com:443 ve test.mycompany.com:80) kullanıma sunar.

VM2'deki yönlendirici, api.mycompany.com:80 (VM1 tarafından sunulanla aynı ad ve bağlantı noktası) sunar.

Fiziksel ana makinenin işletim sisteminde bir ağ güvenlik duvarı olabilir. Böyle bir durumda, bu güvenlik duvarı sanallaştırılmış arayüzlerde (111.111.111.111:{80, 443} ve 111.111.111.222:80) açık olan bağlantı noktalarına bağlı TCP trafiğini geçirecek şekilde yapılandırılmalıdır. Ayrıca her sanal makinenin işletim sistemi, eth0 arayüzünde kendi güvenlik duvarını sağlayabilir ve bunların da 80 ve 443 numaralı bağlantı noktalarının trafiğinin bağlanmasına izin vermesi gerekir.

Temel yol, API çağrılarını dağıtmış olabileceğiniz farklı API proxy'lerine yönlendiren üçüncü bileşendir. API proxy paketleri, farklı temel yollara sahipse bir uç noktayı paylaşabilir. Örneğin, bir temel yol http://api.mycompany.com:80/, diğeri ise http://api.mycompany.com:80/salesdemo olarak tanımlanabilir.

Bu durumda, http://api.mycompany.com:80/ trafiğini iki IP adresi (VM1'de 111.111.111.111 ve VM2'de 111.111.111.222) arasında bölen bir yük dengeleyici veya trafik yöneticisi gerekir. Bu işlev, kurulumunuza özeldir ve yerel ağ grubunuz tarafından yapılandırılır.

Temel yol, bir API'yi dağıttığınızda ayarlanır. Yukarıdaki örnekte, ana makine takma adı api.mycompany.com ve bağlantı noktası 80 olarak ayarlanmış sanal ana makineye sahip mycompany-org kuruluşu için mycompany ve testmycompany adlı iki API dağıtabilirsiniz. Dağıtımda bir temel yol bildirmezseniz yönlendirici, gelen istekleri hangi API'ye göndereceğini bilemez.

Ancak API'yi (testmycompany) /salesdemo ana URL'siyle dağıtırsanız kullanıcılar bu API'ye http://api.mycompany.com:80/salesdemo kullanarak erişir. mycompany API'nizi / ana URL'siyle dağıtırsanız kullanıcılarınız API'ye http://api.mycompany.com:80/ URL'siyle erişir.

Uç bağlantı noktası gereksinimleri

Güvenlik duvarını yönetme ihtiyacı yalnızca sanal ana makinelerle sınırlı değildir. Hem sanal makine hem de fiziksel ana makine güvenlik duvarları, bileşenlerin birbirleriyle iletişim kurması için gereken bağlantı noktalarına yönelik trafiğe izin vermelidir.

Aşağıdaki resimde her bir Edge bileşeni için bağlantı noktası gereksinimleri gösterilmektedir:

Bu diyagramla ilgili notlar:

  • * Mesaj İşleyici'deki 8082 numaralı bağlantı noktası, yalnızca Yönlendirici ile Mesaj İşleyici arasında TLS/SSL yapılandırdığınızda Yönlendirici tarafından erişime açık olmalıdır. Yönlendirici ile Mesaj İşleyici arasında TLS/SSL yapılandırmazsanız bileşeni yönetmek için Mesaj İşleyici'de varsayılan yapılandırma olan 8082 numaralı bağlantı noktasının açık olması gerekir ancak Yönlendirici'nin bu bağlantı noktasına erişmesi gerekmez.
  • "M" ön ekine sahip bağlantı noktaları, bileşeni yönetmek için kullanılan bağlantı noktalarıdır ve bileşende açık olmalıdır. Ayrıca, Yönetim Sunucusu'nun erişebilmesi için bileşende açık olmalıdır.
  • Şu bileşenlerin Yönetim Sunucusu'ndaki 8080 numaralı bağlantı noktasına erişmesi gerekir: Yönlendirici, Mesaj İşlemcisi, Kullanıcı Arayüzü, Postgres ve Qpid.
  • Mesaj İşleyici, yönetim bağlantı noktası olarak 4528 numaralı bağlantı noktasını açmalıdır. Birden fazla Mesaj İşleyici'niz varsa bunların tümü 4528 numaralı bağlantı noktası üzerinden birbirine erişebilmelidir (Mesaj İşleyici'deki 4528 numaralı bağlantı noktası için yukarıdaki şemada döngü okuyla gösterilmiştir). Birden fazla veri merkeziniz varsa bağlantı noktasına tüm veri merkezlerindeki tüm mesaj işlemcilerden erişilebilmelidir.
  • Zorunlu olmasa da herhangi bir Mesaj İşlemci'nin erişebilmesi için yönlendiricide 4527 numaralı bağlantı noktasını açabilirsiniz. Aksi takdirde, Mesaj İşleyici günlük dosyalarında hata mesajları görebilirsiniz.
  • Yönlendirici, yönetim bağlantı noktası olarak 4527 numaralı bağlantı noktasını açmalıdır. Birden fazla yönlendiriciniz varsa bunların tümü 4527 numaralı bağlantı noktası üzerinden birbirine erişebilmelidir (yukarıdaki şemada yönlendirici üzerindeki 4527 numaralı bağlantı noktası için döngü okuyla gösterilmiştir).
  • Edge kullanıcı arayüzü, izleme aracındaki Gönder düğmesini desteklemek için API proxy'leri tarafından sunulan bağlantı noktalarında yönlendiriciye erişim gerektirir.
  • Yönetim Sunucusu'nun Cassandra düğümlerindeki JMX bağlantı noktasına erişmesi gerekir.
  • JMX bağlantı noktalarına erişim, kullanıcı adı/şifre gerektirecek şekilde yapılandırılabilir. Daha fazla bilgi için İzleme bölümüne bakın.
  • İsterseniz farklı bağlantı noktaları kullanabilen belirli bağlantılar için TLS/SSL erişimini yapılandırabilirsiniz. Daha fazla bilgi için TLS/SSL bölümünü inceleyin.
  • İki Postgres düğümünü ana-yedek replikasyon kullanacak şekilde yapılandırıyorsanız SSH erişimi için her düğümde 22 numaralı bağlantı noktasını açmanız gerekir. SSH erişimine izin vermek için isteğe bağlı olarak ayrı ayrı düğümlerde bağlantı noktaları açabilirsiniz.
  • Yönetim Sunucusu ve Edge kullanıcı arayüzünü, harici bir SMTP sunucusu üzerinden e-posta gönderecek şekilde yapılandırabilirsiniz. Bunu yaparsanız Yönetim Sunucusu ve kullanıcı arayüzünün SMTP sunucusundaki gerekli bağlantı noktasına erişebildiğinden emin olmanız gerekir. TLS olmayan SMTP için bağlantı noktası numarası genellikle 25'tir. TLS özellikli SMTP için genellikle 465'tir ancak SMTP sağlayıcınızla iletişime geçerek doğrulayın.

Aşağıdaki tabloda, Edge bileşenine göre güvenlik duvarlarında açılması gereken bağlantı noktaları gösterilmektedir:

Bileşen Bağlantı noktası Açıklama
Standart HTTP bağlantı noktaları 80, 443 HTTP ve sanal ana makineler için kullandığınız diğer bağlantı noktaları
Yönetim Sunucusu 8080 Edge Management API çağrıları için bağlantı noktası. Şu bileşenlerin, Yönetim Sunucusu'ndaki 8080 bağlantı noktasına erişmesi gerekir: Yönlendirici, Mesaj İşlemcisi, Kullanıcı Arayüzü, Postgres ve Qpid.
1099 JMX bağlantı noktası
4526 Dağıtılmış önbellek ve yönetim çağrıları için
Yönetim kullanıcı arayüzü 9000 Yönetim kullanıcı arayüzüne tarayıcı erişimi için bağlantı noktası
Mesaj İşleyici 8998 Yönlendiriciden gelen iletişimler için Mesaj İşleyici bağlantı noktası
8082

Mesaj İşleyici için varsayılan yönetim bağlantı noktasıdır ve Management Server tarafından erişilebilmesi için bileşende açık olmalıdır.

Yönlendirici ile Mesaj İşleyici arasında TLS/SSL yapılandırırsanız yönlendirici tarafından Mesaj İşleyici'de durum denetimleri yapmak için kullanılır.

1101 JMX bağlantı noktası
4528 Mesaj İşlemciler arasındaki dağıtılmış önbellek ve yönetim çağrıları ile Yönlendirici ve Yönetim Sunucusu'ndan iletişim için
Yönlendirici 8081 Yönlendirici için varsayılan yönetim bağlantı noktasıdır ve Yönetim Sunucusu tarafından erişim için bileşende açık olmalıdır.
4527 Dağıtılmış önbellek ve yönetim çağrıları için
15999

Durum denetimi bağlantı noktası. Yük dengeleyici, yönlendiricinin kullanılabilir olup olmadığını belirlemek için bu bağlantı noktasını kullanır.

Yük dengeleyici, yönlendiricinin durumunu öğrenmek için yönlendiricideki 15999 numaralı bağlantı noktasına istek gönderir:

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

Yönlendiriciye erişilebiliyorsa istek HTTP 200 döndürür.

59001 apigee-validate yardımcı programı tarafından Edge kurulumunu test etmek için kullanılan bağlantı noktası. Bu yardımcı program, yönlendiricideki 59001 numaralı bağlantı noktasına erişim gerektirir. 59001 numaralı bağlantı noktası hakkında daha fazla bilgi için Yüklemeyi test etme başlıklı makaleyi inceleyin.
ZooKeeper 2181 Yönetim Sunucusu, Yönlendirici, Mesaj İşlemcisi gibi diğer bileşenler tarafından kullanılır.
2888, 3888 ZooKeeper tarafından ZooKeeper kümesi (ZooKeeper topluluğu olarak bilinir) iletişimi için dahili olarak kullanılır.
Cassandra 7000, 9042, 9160 Cassandra düğümleri arasında iletişim ve diğer Edge bileşenleri tarafından erişim için Apache Cassandra bağlantı noktaları.
7199 JMX bağlantı noktası. Yönetim sunucusu tarafından erişime açık olmalıdır.
Qpid 5672 Yönlendirici ve Mesaj İşlemcisi'nden Qpid sunucusuna iletişim için kullanılır.
8083 Qpid sunucusundaki varsayılan yönetim bağlantı noktasıdır ve Yönetim Sunucusu'nun erişebilmesi için bileşende açık olmalıdır.
1102 JMX bağlantı noktası
4529 Dağıtılmış önbellek ve yönetim çağrıları için
Postgres 5432 Qpid/Yönetim Sunucusu'ndan Postgres'e iletişim için kullanılır.
8084 Postgres sunucusundaki varsayılan yönetim bağlantı noktasıdır ve Yönetim Sunucusu'nun erişebilmesi için bileşende açık olmalıdır.
1103 JMX bağlantı noktası
4530 Dağıtılmış önbellek ve yönetim çağrıları için
22 İki Postgres düğümünü ana-yedek replikasyon kullanacak şekilde yapılandırıyorsanız SSH erişimi için her düğümde 22 numaralı bağlantı noktasını açmanız gerekir.
LDAP 10389 OpenLDAP
SmartDocs 59002 SmartDocs sayfa isteklerinin gönderildiği Edge yönlendiricisindeki bağlantı noktası.

Aşağıdaki tabloda, kaynak ve hedef bileşenleriyle birlikte sayısal olarak listelenen aynı bağlantı noktaları gösterilmektedir:

Bağlantı Noktası Numarası Amaç Kaynak Bileşen Hedef Bileşen
virtual_host_port HTTP ve sanal ana makine API çağrısı trafiği için kullandığınız diğer bağlantı noktaları. En yaygın olarak 80 ve 443 numaralı bağlantı noktaları kullanılır. Message Router, TLS/SSL bağlantılarını sonlandırabilir. Harici istemci (veya yük dengeleyici) Mesaj yönlendiricisindeki dinleyici
1099 - 1103 JMX Yönetimi JMX istemcisi Yönetim Sunucusu (1099)
Mesaj İşlemcisi (1101)
Qpid Sunucusu (1102)
Postgres Sunucusu (1103)
2181 ZooKeeper istemci iletişimi Yönetim Sunucusu
Yönlendirici
Mesaj İşlemcisi
Qpid Sunucusu
Postgres Sunucusu
Zookeeper
2888 ve 3888 Zookeeper düğümler arası yönetimi Zookeeper Zookeeper
4526 RPC yönetim bağlantı noktası Yönetim Sunucusu Yönetim Sunucusu
4527 Dağıtılmış önbellek ve yönetim çağrıları ile yönlendiriciler arasındaki iletişim için RPC yönetim bağlantı noktası Yönetim Sunucusu
Yönlendirici
Yönlendirici
4528 Mesaj İşlemciler arasındaki dağıtılmış önbellek çağrıları ve Yönlendirici'den gelen iletişim için Yönetim Sunucusu
Yönlendirici
Mesaj İşlemcisi
Mesaj İşleyici
4529 Dağıtılmış önbellek ve yönetim çağrıları için RPC yönetim bağlantı noktası Yönetim Sunucusu Qpid Sunucusu
4530 Dağıtılmış önbellek ve yönetim çağrıları için RPC yönetim bağlantı noktası Yönetim Sunucusu Postgres Server
5432 Postgres istemcisi Qpid Sunucusu Postgres
5672

Yönlendirici ve Mesaj İşlemcisi'nden Qpid'ye analiz göndermek için kullanılır.

Yönlendirici
Mesaj İşlemcisi
Qpid Sunucusu
7000 Cassandra düğümler arası iletişimleri Cassandra Diğer Cassandra düğümü
7199 JMX yönetimi. Yönetim Sunucusu tarafından Cassandra düğümünde erişime açık olmalıdır. JMX istemcisi Cassandra
8080 Management API bağlantı noktası Management API istemcileri Yönetim Sunucusu
8081 - 8084

API isteklerini doğrudan bağımsız bileşenlere göndermek için kullanılan bileşen API bağlantı noktaları. Her bileşen farklı bir bağlantı noktası açar. Kullanılan bağlantı noktası yapılandırmaya bağlıdır ancak Yönetim Sunucusu'nun erişebilmesi için bileşende açık olması gerekir.

Management API istemcileri Yönlendirici (8081)
Mesaj İşlemcisi (8082)
Qpid Sunucusu (8083)
Postgres Sunucusu (8084)
8998 Yönlendirici ile Mesaj İşleyici arasındaki iletişim Yönlendirici Mesaj İşleyici
9000 Varsayılan Edge yönetim kullanıcı arayüzü bağlantı noktası Tarayıcı Yönetim Kullanıcı Arayüzü Sunucusu
9042 CQL yerel aktarımı Yönlendirici
Mesaj İşlemcisi
Yönetim Sunucusu
Cassandra
9160 Cassandra Thrift istemcisi Yönlendirici
Mesaj İşlemcisi
Yönetim Sunucusu
Cassandra
10389 LDAP bağlantı noktası Yönetim Sunucusu OpenLDAP
15999 Durum denetimi bağlantı noktası. Yük dengeleyici, yönlendiricinin kullanılabilir olup olmadığını belirlemek için bu bağlantı noktasını kullanır. Yük dengeleyici Yönlendirici
59001 Edge kurulumunu test etmek için apigee-validate yardımcı programı tarafından kullanılan bağlantı noktası apigee-validate Yönlendirici
59002 SmartDocs sayfa isteklerinin gönderildiği yönlendirici bağlantı noktası SmartDocs Yönlendirici

Mesaj işlemcisi, Cassandra'ya özel bir bağlantı havuzunu açık tutar. Bu havuz, zaman aşımına uğramayacak şekilde yapılandırılmıştır. Bir Mesaj İşleyici ile Cassandra sunucusu arasında güvenlik duvarı olduğunda güvenlik duvarı, bağlantının zaman aşımına uğramasına neden olabilir. Ancak mesaj işleyici, Cassandra ile bağlantıları yeniden kurmak için tasarlanmamıştır.

Apigee, bu durumu önlemek için Cassandra sunucusunun, mesaj işleyicinin ve yönlendiricilerin aynı alt ağda olmasını önerir. Böylece bu bileşenlerin dağıtımında güvenlik duvarı kullanılmaz.

Yönlendirici ile mesaj işleyiciler arasında bir güvenlik duvarı varsa ve boşta TCP zaman aşımı ayarlanmışsa önerilerimiz şunlardır:

  1. Linux işletim sistemindeki sysctl ayarlarında net.ipv4.tcp_keepalive_time = 1800 değerini ayarlayın. Burada 1.800, güvenlik duvarı boşta TCP zaman aşımından daha düşük olmalıdır. Bu ayar, güvenlik duvarının bağlantıyı kesmemesi için bağlantıyı kurulmuş durumda tutmalıdır.
  2. Tüm Mesaj İşleyicilerde aşağıdaki özelliği eklemek için /opt/apigee/customer/application/message-processor.properties dosyasını düzenleyin. Dosya yoksa oluşturun.
    conf_system_cassandra.maxconnecttimeinmillis=-1
  3. Mesaj İşleyici'yi yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  4. Tüm yönlendiricilerde, aşağıdaki özelliği eklemek için /opt/apigee/customer/application/router.properties dosyasını düzenleyin. Dosya yoksa oluşturun.
    conf_system_cassandra.maxconnecttimeinmillis=-1
  5. Yönlendiriciyi yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart

İki veri merkeziyle 12 ana makine kümelenmiş yapılandırmasını yüklerseniz iki veri merkezindeki düğümlerin aşağıda gösterilen bağlantı noktaları üzerinden iletişim kurabildiğinden emin olun:

API BaaS bağlantı noktası gereksinimleri

API BaaS'yi yüklemeyi seçerseniz API BaaS Stack ve API BaaS Portal bileşenlerini eklersiniz. Bu bileşenler, aşağıdaki şekilde gösterilen bağlantı noktalarını kullanır:

Bu diyagramla ilgili notlar:

  • API BaaS Portalı hiçbir zaman doğrudan bir BaaS Stack düğümüne istek göndermez. Geliştirici, Portal'a giriş yaptığında Portal uygulaması tarayıcıya indirilir. Tarayıcıda çalışan Portal uygulaması, BaaS Stack düğümlerine istek gönderir.
  • API BaaS'ın üretim kurulumunda, API BaaS Portal düğümü ile API BaaS Stack düğümleri arasında bir yük dengeleyici kullanılır. Portalı yapılandırırken ve BaaS API çağrıları yaparken Stack düğümlerinin değil, yük dengeleyicinin IP adresini veya DNS adını belirtirsiniz.
  • Tüm Stack düğümleri, diğer tüm Stack düğümlerinden erişim için 2551 numaralı bağlantı noktasını açmalıdır (yukarıdaki şemada Stack düğümlerindeki 2551 numaralı bağlantı noktası için döngü okuyla gösterilmiştir). Birden fazla veri merkeziniz varsa bağlantı noktasına tüm veri merkezlerindeki tüm Stack düğümlerinden erişilebilmelidir.
  • Tüm Baas Stack düğümlerini, harici bir SMTP sunucusu üzerinden e-posta gönderecek şekilde yapılandırmanız gerekir. TLS olmayan SMTP için bağlantı noktası numarası genellikle 25'tir. TLS özellikli SMTP için genellikle 465'tir ancak SMTP sağlayıcınızla iletişime geçerek doğrulayın.
  • Cassandra düğümleri API BaaS'ye ayrılabilir veya Edge ile paylaşılabilir.

Aşağıdaki tabloda, güvenlik duvarlarında açılması gereken varsayılan bağlantı noktaları bileşene göre gösterilmektedir:

Bileşen Bağlantı noktası Açıklama
API BaaS Portal 9000 API BaaS kullanıcı arayüzü için bağlantı noktası
API BaaS Stack 8080 API isteklerinin alındığı bağlantı noktası
2551

Tüm Stack düğümleri arasında iletişim için kullanılan bağlantı noktası. Veri merkezindeki diğer tüm Stack düğümleri tarafından erişilebilir olmalıdır.

Birden fazla veri merkeziniz varsa bağlantı noktasına tüm veri merkezlerindeki tüm Stack düğümlerinden erişilebilmelidir.

ElasticSearch 9.200-9.400 API BaaS Stack ile iletişim kurmak ve ElasticSearch düğümleri arasında iletişim kurmak için

Lisanslama

Her Edge kurulumu için Apigee'den alacağınız benzersiz bir lisans dosyası gerekir. Yönetim sunucusunu yüklerken lisans dosyasının yolunu (ör. /tmp/license.txt) belirtmeniz gerekir.

Yükleyici, lisans dosyasını /opt/apigee/customer/conf/license.txt konumuna kopyalar.

Lisans dosyası geçerliyse yönetim sunucusu, geçerlilik bitiş tarihini ve izin verilen Mesaj İşlemci (MP) sayısını doğrular. Lisans ayarlarından herhangi birinin süresi dolduysa günlükleri şu konumda bulabilirsiniz: /opt/apigee/var/log/edge-management-server/logs. Bu durumda, taşıma ayrıntıları için Apigee Edge Destek Ekibi ile iletişime geçebilirsiniz.

Henüz lisansınız yoksa Apigee satış ekibiyle iletişime geçin.