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:
- "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
/opt/apigeekonumundan 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.
- 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_nameinitial_tokenpartitionerseedslisten_addressrpc_addresssnitch
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:
- postgresql.properties dosyasını düzenleyin:
vi /opt/apigee/customer/application/postgresql.properties
Dosya yoksa oluşturun.
- Yukarıda listelenen özellikleri ayarlayın.
- Yaptığınız düzenlemeleri kaydedin.
- 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.confdosyası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.confdosyası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:
- Her Mesaj İşleyici düğümünde
/etc/nscd.confdosyasını düzenleyin. - 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:
/etc/hostsdosyasını bir düzenleyicide açın.- Aşağıdaki satırın birinci sütununa "#" karakteri ekleyerek satırı yorum haline getirin:
#::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
- 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:
- Linux işletim sistemindeki sysctl ayarlarında
net.ipv4.tcp_keepalive_time = 1800değ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. - Tüm Mesaj İşleyicilerde aşağıdaki özelliği eklemek için
/opt/apigee/customer/application/message-processor.propertiesdosyasını düzenleyin. Dosya yoksa oluşturun.conf_system_cassandra.maxconnecttimeinmillis=-1
- Mesaj İşleyici'yi yeniden başlatın:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Tüm yönlendiricilerde, aşağıdaki özelliği eklemek için
/opt/apigee/customer/application/router.propertiesdosyasını düzenleyin. Dosya yoksa oluşturun.conf_system_cassandra.maxconnecttimeinmillis=-1
- 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.