Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Bir düğüme Edge bileşenleri yükleme

Edge for Private Cloud 4.16.09 sürümü

Edge apigee-setup yardımcı programını bir düğüme yükledikten sonra, düğüme bir veya daha fazla Edge bileşeni yüklemek için apigee-setup yardımcı programını kullanın.

apigee-setup yardımcı programı şu biçimde bir komut kullanır:

> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

Burada component, yüklenecek Edge bileşenidir ve configFile, yükleme bilgilerini içeren sessiz yapılandırma dosyasıdır. Yapılandırma dosyası, "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmalıdır. Örneğin, dosyalar için yeni bir dizin oluşturabilir, bunları /usr/local veya /usr/local/share dizinine ya da düğümde "apigee" kullanıcısı tarafından erişilebilen başka bir yere yerleştirebilirsiniz.

Örneğin, Edge Management Server'ı yüklemek için:

> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig

Yükleme ile ilgili dikkat edilmesi gereken noktalar

Yapılandırma dosyanızı yazarken aşağıdaki seçenekleri göz önünde bulundurun.

Postgres ana-yedek replikasyonunu ayarlama

Varsayılan olarak Edge, tüm Postgres düğümlerini ana modda yükler. Ancak birden fazla Postgres düğümü içeren üretim sistemlerinde, ana düğümün başarısız olması durumunda bekleme düğümünün trafiğe hizmet vermeye devam edebilmesi için bunları ana-bekleme replikasyonunu kullanacak şekilde yapılandırmanız gerekir.

Yükleme sırasında, sessiz yapılandırma dosyasındaki özellikleri kullanarak ana-yedek replikasyonunu etkinleştirebilir ve yapılandırabilirsiniz. Alternatif olarak, yükleme işleminden sonra ana-yedek replikasyonunu etkinleştirebilirsiniz. Daha fazla bilgi için Postgres için ana-bekleme replikasyonu ayarlama başlıklı makaleyi inceleyin.

Cassandra kimlik doğrulamasını etkinleştirme

Cassandra, varsayılan olarak kimlik doğrulama etkinleştirilmeden yüklenir. Bu, Cassandra'ya herkesin erişebileceği anlamına gelir. Kimlik doğrulamayı Edge'i yükledikten sonra veya yükleme işleminin bir parçası olarak etkinleştirebilirsiniz.

Sessiz yapılandırma dosyasındaki özellikleri kullanarak Cassandra kimlik doğrulamasını yükleme sırasında etkinleştirebilirsiniz. Dilerseniz yükleme işleminden sonra da etkinleştirebilirsiniz.

Daha fazla bilgi için Cassandra kimlik doğrulamasını etkinleştirme başlıklı makaleyi inceleyin.

Yönlendiriciyi korumalı bir bağlantı noktasına bağlama

Yönlendirici'yi korumalı bir bağlantı noktasına (ör. 1024'ten küçük bağlantı noktası numaraları) bağlamak istiyorsanız Yönlendirici'yi bu bağlantı noktalarına erişimi olan bir kullanıcı olarak çalışacak şekilde yapılandırmanız gerekir. Varsayılan olarak, Yönlendirici, ayrıcalıklı bağlantı noktalarına erişimi olmayan "apigee" kullanıcısı olarak çalışır.

Yönlendirici'yi farklı bir kullanıcı olarak çalıştırmak için:

Kök olarak /opt/apigee/etc/edge-router.d/RUN_USER.sh dosyasını oluşturun.
Dosyaya aşağıdaki girişi ekleyin:
RUN_USER=root
Yönlendirici'yi kök olarak çalıştırmak istemiyorsanız bağlantı noktasına erişimi olan bir kullanıcı belirtin.
Dosyayı kaydedin.
Kök dışında bir kullanıcı belirttiyseniz dosyanın sahibini bu kullanıcı olarak değiştirin:
> chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
Yönlendiriciyi yeniden başlatın:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Yüklenecek bileşenleri belirtme

Aşağıdaki tabloda, düğüme hangi bileşenlerin yükleneceğini belirtmek için apigee-service yardımcı programının -p seçeneğine ilettiğiniz seçenekler listelenmiştir:

Bileşen	Açıklama
c	Yalnızca Cassandra'yı yükleyin.
zk	Yalnızca ZooKeeper'ı yükleyin.
ds	ZooKeeper ve Cassandra'yı yükleyin.
ld	Yalnızca OpenLDAP'yi yükleyin.
ms	Edge Management Server'ı yükleyin. Bu işlem, Edge kullanıcı arayüzünü ve OpenLDAP'yi de yükler. Yapılandırma dosyasında USE_LDAP_REMOTE_HOST=y değerini ayarlarsanız OpenLDAP yüklemesi atlanır ve yönetim sunucusu, farklı bir düğüme yüklenen OpenLDAP'yi kullanır.
r	Yalnızca Edge Router'ı yükleyin.
mp	Yalnızca Edge Mesaj İşleyici'yi yükleyin.
rmp	Edge Router ve Mesaj İşleyici'yi yükleyin.
ui	Edge kullanıcı arayüzünü yükleyin.
qs	Yalnızca Qpid Server'ı yükleyin.
ps	Yalnızca Postgres Server'ı yükleyin.
sax	Qpid ve Postgres gibi analiz bileşenlerini yükleyin. Bu seçeneği yalnızca geliştirme ve test için kullanın, üretim için kullanmayın.
mo	Para kazanma özelliğini yükleyin.
sa	Edge'i bağımsız olarak yükleyin (Cassandra, ZooKeeper, Yönetim Sunucusu, OpenLDAP, Edge kullanıcı arayüzü, Yönlendirici ve Mesaj İşlemci). Bu seçenek, Edge analiz bileşenlerini (Qpid ve Postgres) atlar. Bu seçeneği yalnızca geliştirme ve test için kullanın, üretim için kullanmayın.
aio	Tüm bileşenleri tek bir düğüme yükleyin. Bu seçeneği yalnızca geliştirme ve test için kullanın, üretim için kullanmayın.

Yapılandırma dosyası oluşturma

Yapılandırma dosyası, Edge'i yüklemek için gereken tüm bilgileri içerir. Genellikle bir Edge kurulumundaki tüm bileşenleri yüklemek için aynı yapılandırma dosyasını kullanabilirsiniz.

Ancak aşağıdaki durumlarda farklı yapılandırma dosyaları kullanmanız veya yapılandırma dosyanızı değiştirmeniz gerekir:

Birden fazla OpenLDAP sunucusu yüklüyorsunuz ve 13 düğümlü bir kurulumun parçası olarak replikasyonu yapılandırmanız gerekiyor. Her dosya için LDAP_SID ve LDAP_PEER değerleri farklı olmalıdır.
12 düğümlü bir kurulum kapsamında birden fazla veri merkezi oluşturuyorsunuz. Her veri merkezi, ZK_CLIENT_HOSTS ve CASS_HOSTS gibi özellikler için farklı ayarlar gerektirir.

Örnek yapılandırma dosyası

Aşağıda, 9 düğümlü bir Edge kurulumu için eksiksiz bir sessiz yapılandırma dosyası örneği gösterilmektedir. Bu dosyayı yapılandırmanız için gerektiği şekilde düzenleyin. Bu dosyayı eklemek için setup.sh komutunda -f seçeneğini kullanın. Ayrıca, her Edge topolojisi için örnek yapılandırma dosyaları da aşağıda gösterilmiştir.

# IP address or DNS name of nodes.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra
IP2=192.168.1.2  # ZooKeeper, Cassandra
IP3=192.168.1.3  # ZooKeeper, Cassandra
IP4=192.168.1.4  # Router, Message Processor
IP5=192.168.1.5  # Router, Message Processor
IP6=192.168.1.6  # Qpid
IP7=192.168.1.7  # Qpid
IP8=192.168.1.8  # Postgres
IP9=192.168.1.9  # Postgres

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Set Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.

# Location of Edge license file.
LICENSE_FILE=/tmp/license.txt

# Management Server information.
MSIP=$IP1    # IP or DNS name of Management Server node. 
# Specify the port the Management Server listens on for API calls.
# APIGEE_PORT_HTTP_MS=8080    # Default is 8080.

#
# OpenLDAP information.
#
# Set to y if you are connecting to a remote LDAP server. 
# If n, Edge installs OpenLDAP when it installs the Management Server.
USE_LDAP_REMOTE_HOST=n 

# If connecting to remote OpenLDAP server, specify the IP/DNS name and port.
# LDAP_HOST=$IP1    # IP or DNS name of OpenLDAP node.
# LDAP_PORT=10389   # Default is 10389.
APIGEE_LDAPPW=yourLdapPassword

# Specify OpenLDAP without replication, 1, or with replication, 2.
LDAP_TYPE=1 

# Set only if using replication.
# LDAP_SID=1    # Unique ID for this LDAP server. 
# LDAP_PEER=    # IP or DNS name of LDAP peer.

BIND_ON_ALL_INTERFACES=y 

# The Message Processor and Router pod.
MP_POD=gateway 

# The name of the region, corresponding to the data center name.
REGION=dc-1 # Use dc-1 unless installing in a 
            # multi-data center environment. 

# ZooKeeper information.
# See table below if installing in a multi-data center environment.
ZK_HOSTS="$IP1 $IP2 $IP3"         # IP/DNS names of all ZooKeeper nodes. 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"  # IP/DNS names of all ZooKeeper nodes.

# Cassandra information.
CASS_CLUSTERNAME=Apigee    # Default name is Apigee.

# IP addresses of the Cassandra hosts separated by spaces.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Set to enable Cassandra authentication.
# CASS_AUTH=y    # The default value is n.
# Cassandra uname/pword required if you enabled Cassandra authentication.
# CASS_USERNAME=
# CASS_PASSWORD=

# Use to enable Postgres master-standby replication
# when you have multiple Postgres nodes. 
# PG_MASTER=IPorDNSofNewMaster
# PG_STANDBY=IPorDNSofOldMaster

# SMTP information.
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.

Aşağıdaki tabloda bu özellikler hakkında ek bilgiler yer almaktadır:

Özellik	Not
IP/DNS adları	Bir düğümün IP adresini belirtirken 127.0.0.1 ile eşlenen bir ana makine adı veya 127.0.0.1 IP adresi kullanmayın.
ADMIN_EMAIL APIGEE_ADMINPW	Sistem yöneticisinin şifresi en az 8 karakter uzunluğunda olmalı ve bir büyük harf, bir küçük harf, bir rakam veya bir özel karakter içermelidir. Şifreyi atlarsanız şifre girmeniz istenir.
LICENSE_FILE	Lisans dosyasının konumu. Bu konuma "apigee" kullanıcısı tarafından erişilebilmelidir. Örneğin, dosyayı /tmp dizininde depolayın ve dosyada chmod 777 komutunu çalıştırın. Dosya, Edge kurulum dizinine kopyalanır.
USE_LDAP_REMOTE_HOST LDAP_HOST LDAP_PORT	USE_LDAP_REMOTE_HOST n ise Edge, Yönetim Sunucusu'nu yüklediğinde OpenLDAP'yi otomatik olarak yükler. Uzak bir LDAP sunucusuna bağlanıyorsanız USE_LDAP_REMOTE_HOST değerini y olarak ayarlayın. OpenLDAP, Yönetim Sunucusu ile birlikte yüklenmez. Uzak bir OpenLDAP sunucusuna bağlanıyorsanız ana makinenin IP adresini veya DNS adını ve bağlantı noktası numarasını belirtmek için LDAP_HOST ve LDAP_PORT'u kullanın.
LDAP_TYPE LDAP_SID LDAP_PEER	Replikasyon olmadan OpenLDAP için LDAP_TYPE=1 değerini ayarlayın. LDAP_TYPE=2, replikasyonlu OpenLDAP'ye karşılık gelir. Edge topolojiniz tek bir OpenLDAP sunucusu kullanıyorsa 1 değerini belirtin. Edge kurulumunuzda birden fazla OpenLDAP düğümü kullanılıyorsa (ör. 13 düğümlü bir üretim kurulumunda) 2 değerini belirtin. Kopyalamayı etkinleştirirseniz aşağıdaki özellikleri ayarlayın: LDAP_SID=1 - Bu LDAP sunucusunun benzersiz kimliği. Her LDAP düğümü farklı bir kimlik kullanır. Örneğin, LDAP eşi için 2 olarak ayarlayın. LDAP_PEER=10.0.0.1 - LDAP eşinin IP veya DNS adı.
BIND_ON_ALL_INTERFACES	"y" olarak ayarlanırsa yönlendirici/mesaj işleyici tüm arayüzlere (IP'ler) bağlanır (dinler). "n" olarak ayarlanırsa yönlendirici/mesaj işleyici belirli bir arayüze bağlanır (dinler) ve "hostname -i" komutu tarafından döndürülen IP'yi kullanır.
MP_POD	Mesaj İşleyici ve Yönlendirici kapsülünün adını belirtin. Varsayılan olarak ad, gateway'dir.
REGION	Bölge adı. Kural olarak, adlar genellikle dc-# biçimindedir. Burada #, bir tam sayı değerine karşılık gelir. Örneğin, dc-1, dc-2 vb. Çoklu veri merkezi ortamına yükleme yapmıyorsanız dc-1'i kullanabilirsiniz. Birden fazla veri merkezi kurulumunda değer, hangi veri merkezini kurduğunuza bağlı olarak dc-1 veya dc-2 vb. olur. Ancak yalnızca dc-# biçimindeki adları kullanmak zorunda değilsiniz. Bölge için istediğiniz adı kullanabilirsiniz.
ZK_HOSTS	ZooKeeper düğümlerinin IP adresleri veya DNS adları. IP adresleri veya DNS adları, tüm ZooKeeper düğümlerinde aynı sırada listelenmelidir. Çoklu veri merkezi ortamında, her iki veri merkezindeki tüm ZooKeeper düğümlerini listeleyin. ":observer" değiştiricisini ZooKeeper düğümlerinde yalnızca 12 ana makine kurulumunda açıklandığı gibi birden fazla veri merkezi oluştururken belirtin. Tek bir veri merkezi kurulumunda bu değiştiriciyi atlayın. Daha fazla bilgi için 12 ana makine kümelenmiş yükleme bölümüne bakın.
ZK_CLIENT_HOSTS	Bu veri merkezi tarafından kullanılan ZooKeeper düğümlerinin IP adresleri veya DNS adları. IP adresleri veya DNS adları, tüm ZooKeeper düğümlerinde aynı sırada listelenmelidir. Tek bir veri merkezi kurulumunda bunlar, ZK_HOSTS tarafından belirtilen düğümlerle aynıdır. Çoklu veri merkezi ortamında, yalnızca bu veri merkezindeki ZooKeeper düğümlerini listeleyin. Daha fazla bilgi için 12 ana makine kümelenmiş yükleme bölümüne bakın.
CASS_HOSTS	Cassandra düğümlerinin IP adresleri (DNS adları değil). İlk iki düğüm, temel sunucu olarak kullanılır. IP adresleri, tüm Cassandra düğümlerinde aynı sırada listelenmelidir. Cassandra düğümleri, Cassandra düğümünün veri merkezini ve rafını belirten isteğe bağlı bir ":dc,ra" son ekine sahip olabilir. Bu değiştiriciyi yalnızca 12 ana makine kurulumunda açıklandığı gibi birden fazla veri merkezi oluştururken belirtin. Tek bir veri merkezi kurulumunda bu değiştiriciyi atlayın. Örneğin, "192.168.124.201:1, 1 = veri merkezi 1 ve raf/kullanılabilirlik bölgesi 1 ve "192.168.124.204:2,1 = veri merkezi 2 ve raf/kullanılabilirlik bölgesi 1. Çoklu veri merkezi ortamında, güvenlik duvarı sorunlarını aşmak için CASS_HOSTS, mevcut veri merkezinin düğümleri en başta yer alacak şekilde sıralanmalıdır (yukarıdaki örnekte gösterildiği gibi). Daha fazla bilgi için 12 ana makine kümelenmiş yükleme bölümüne bakın.
CASS_AUTH CASS_USERNAME CASS_PASSWORD	Cassandra kimlik doğrulamasını (CASS_AUTH=y) etkinleştirirseniz bu özellikleri kullanarak Cassandra kullanıcı adını ve şifresini iletebilirsiniz.
PG_MASTER PG_STANDBY	Postgres ana-yedek replikasyonunu etkinleştirmek için şu biçimde ayarlayın: *IPorDNSofNewMaster=PG_MASTER PG_STANDBY=IPorDNSofOldMaster*
SKIP_SMTP SMTPHOST SMTPUSER SMTPPASSWORD SMTPSSL SMTPPORT	Edge'in kayıp şifreler ve diğer bildirimler için e-posta gönderebilmesi amacıyla SMTP'yi yapılandırın. SMTP kullanıcı kimlik bilgileri gerekli değilse SMTPUSER ve SMTPPASSWORD'ü atlayın.

Bileşen yükleme sırası

Bileşenlerin yüklenme sırası, istediğiniz topolojiye göre değişir.

Aşağıda gösterilen tüm yükleme örneklerinde, şunları yüklediğiniz varsayılır:

Cassandra kimlik doğrulaması devre dışıyken (varsayılan). Daha fazla bilgi için Cassandra kimlik doğrulamasını etkinleştirme başlıklı makaleyi inceleyin.
Postgres ana-yedek replikasyonu devre dışı bırakılmış olarak (varsayılan). Daha fazla bilgi için Postgres için ana-yedek replikasyonunu ayarlama başlıklı makaleyi inceleyin.
Aynı düğümde Mesaj İşleyici ve Yönlendirici. Mesaj İşleyicileri ve Yönlendiricileri farklı düğümlere yüklerseniz önce tüm Mesaj İşleyicileri, ardından tüm Yönlendiricileri yükleyin.

Yükleme günlüğü dosyaları

Varsayılan olarak setup.sh yardımcı programı, yüklemeyle ilgili günlük bilgilerini şuraya yazar:

/opt/apigee/var/log/apigee-setup/setup.log

setup.sh yardımcı programını çalıştıran kullanıcının bu dizine erişimi yoksa günlüğü /tmp dizinine setup_kullanıcıadı.log adlı bir dosya olarak yazar.

Kullanıcının /tmp dizinine erişimi yoksa setup.sh yardımcı programı başarısız olur.