Yükleme gereksinimleri

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 videoda, kurulumunuz için üst düzey boyutlandırma kılavuzu sunulmaktadır:

Yükleme topolojileri bölümünde açıklanan tüm yükleme senaryoları için aşağıdaki tablolarda 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.

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

Ayrıca, Para Kazanma Hizmetleri'ni yüklemek istiyorsanız aşağıdaki donanım gereksinimleri geçerlidir (Hepsi Bir Arada yüklemede desteklenmez):

Cassandra ağ bant genişliği gereksinimleri

Cassandra, ağ topolojisi hakkında diğer düğümlerle bilgi alışverişinde bulunmak için Gossip protokolünü kullanır. Gossip'in kullanımı, Cassandra'nın dağıtılmış yapısıyla (okuma ve yazma işlemleri için birden fazla düğümle iletişim kurmayı içerir) birleştiğinde ağ üzerinden önemli miktarda veri aktarımına neden olur.

Cassandra için minimum ağ bant genişliği düğüm başına 1 Gb/sn'dir. Üretim kurulumları için daha yüksek bir bant genişliği önerilir.

Cassandra için maksimum veya 99. yüzdelik dilim gecikmesi 100 milisaniyenin altında olmalıdır.

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

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.

Ön koşul: EPEL deposunu etkinleştirme

Yükleme işlemine devam etmeden önce EPEL (Extra Packages for Enterprise Linux) deposunun etkinleştirildiğinden emin olun. Red Hat, CentOS veya Oracle Linux 9.x için aşağıdaki komutları kullanın:

wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

sudo rpm -ivh epel-release-latest-9.noarch.rpm

Java

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

Yüklemeyi gerçekleştiren kullanıcı için JAVA_HOME ortam değişkeninin JDK'nin kökünü 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 kurulum sırasında SELinux'u devre dışı bırakabilir veya izin verme moduna ayarlayabilir, kurulumdan sonra yeniden etkinleştirebilirsiniz. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.

"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 /opt/apigee'den sembolik bağlantı oluşturma bölümünde açıklandığı gibi, /opt/apigee öğesini 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.54.00.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

   Buradaki /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

Ağ ayarı

Apigee, yüklemeden önce ağ ayarını kontrol etmenizi önerir. 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, boşlukla ayrılmış bir IP adresi listesi 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

Dizin erişimi

Aşağıdaki tabloda, Edge düğümlerinde Edge işlemlerinden özel gereksinimleri olan dizinler listelenmiştir:

Cassandra

Tüm Cassandra düğümleri bir halkaya bağlı olmalıdır. 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 replikasyon 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. Performans düşüşü veya yüksek bellek tüketimi durumunda daha fazla bilgi için Java kaynaklarını ayarlama başlıklı makaleyi inceleyin.

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

Rocky 9.X için yerel ayar yapılandırması

Rocky 9.X kullanıyorsanız sisteminizin, sistem genelindeki yerel ayarlarında LANG=en_US.utf8 ile yapılandırıldığından emin olun. Bunu yapılandırmak için aşağıdaki komutları çalıştırın:

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

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 içinde yükleme 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ğıda gösterildiği 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
  apigee soft nproc 32768
  apigee hard nproc 65536

• Mesaj İşleyici düğümlerinde, açık dosya tanımlayıcılarının maksimum sayısını /etc/security/limits.d/90-apigee-edge-limits.conf içinde 64.000 olarak ayarlayın. Aşağıda gösterildiği gibi:

  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.

• Yönlendirici veya Mesaj İşleyici'de system.log hatasını görürseniz dosya tanımlayıcı sınırlarınız çok düşük ayarlanmış olabilir:

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

  Kullanıcı sınırlarınızı kontrol etmek için şu komutu çalıştırabilirsiniz:

  # su - apigee
  $ ulimit -n
  100000
  

  Dosya tanımlayıcı sınırlarını 100000 olarak ayarladıktan sonra hâlâ açık dosya sınırlarına ulaşıyorsanız daha fazla sorun giderme için Apigee Edge Destek Ekibi ile iletişime geçin.

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

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

RHEL 8 ve sonraki sürümlerde IPv6'yı devre dışı bırakma

Edge'i Google Cloud Platform'da RHEL 8 veya sonraki sürümlere 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 lütfen işletim sistemi tedarikçiniz tarafından sağlanan belgelere bakın. Örneğin, Red Hat Enterprise Linux belgelerinde ilgili bilgileri bulabilirsiniz.

Amazon Linux için ön koşullar

Amazon Linux 2023.9/2023.10/2023.11'de yeni bir yükleme yapmadan veya 4.53.01'den 4.54.00'a yükseltmeden önce (Amazon Linux 2023.9/2023.10/2023.11'de) /etc/yum.repos.d/amazonlinux.repo dosyasını düzenleyin. [amazonlinux] içeren bölüm, paketlerin Amazon'dan değil apigee-thirdparty üzerinden indirilmesini sağlamak için şunları içermelidir:exclude=postgresql18,luajit*.

Araçlar

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

Zaman senkronizasyonu

Apigee, sunucularınızın saatlerinin senkronize edilmesini önerir. Henüz yapılandırılmadıysa ntpdate yardımcı programı veya eşdeğer bir araç, sunucuların zaman senkronizasyonunun yapılıp yapılmadığını doğrulayarak bu amaca hizmet edebilir. Örneğin, yardımcı programı yüklemek için yum install ntp veya eşdeğer bir komut kullanabilirsiniz. Bu, özellikle LDAP kurulumlarını kopyalamak için kullanışlıdır. Sunucu saat dilimini UTC olarak ayarlamanız gerektiğini lütfen unutmayın.

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 bağlantı noktasını kullanıma sunar (VM1 tarafından kullanıma sunulanla aynı ad ve bağlantı noktası).

Fiziksel ana makinenin işletim sisteminde bir ağ güvenlik duvarı olabilir. Böyle bir durumda, güvenlik duvarı, sanallaştırılmış arayüzlerde (111.111.111.111:{80, 443} ve 111.111.111.222:80) gösterilen 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ı noktası 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.

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.