Tipik bir Edge kurulumu, birden fazla düğüme dağılmış Edge bileşenlerinden oluşur. Edge'i bir düğüme yükledikten sonra düğüme bir veya daha fazla Edge bileşeni yükleyip yapılandırırsınız.
Yükleme işlemi
Edge'i bir düğüme yüklemek çok adımlı bir işlemdir:
- Düğümde SELinux'u devre dışı bırakın veya izin verilen moda ayarlayın. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme bölümüne göz atın.
- Cassandra kimlik doğrulamasını etkinleştirmek isteyip istemediğinize karar verin.
- Postgres için ana bekleme bekleme replikası oluşturmak isteyip istemediğinize karar verin.
- Önerilen topoloji listesinden Edge yapılandırmanızı seçin. Örneğin, Edge'i test için tek bir düğüme veya üretim için 13 düğüme yükleyebilirsiniz. Daha fazla bilgi için Yükleme Topolojileri bölümüne bakın.
- Seçtiğiniz topolojideki her düğüme Edge
apigee-setup
yardımcı programını yükleyin:- Edge
bootstrap_4.50.00.sh
dosyasını/tmp/bootstrap_4.50.00.sh
adresine indirin. - Edge
apigee-service
yardımcı programını ve bağımlılıklarını yükleyin. - Edge
apigee-setup
yardımcı programını ve bağımlılıklarını yükleyin.Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme sayfasına göz atın.
- Edge
- Seçtiğiniz topolojiye göre her düğüme bir veya daha fazla Edge bileşeni yüklemek için
apigee-setup
yardımcı programını kullanın.Düğüm bileşenlerini bir düğüme yükleme başlıklı makaleye bakın.
- Yönetim Sunucusu düğümünde,
apigee-setup
yardımcı programını kullanarakapigee-provision
uygulamalarını (Uç kuruluşlarını oluşturmak ve yönetmek için kullandığınız yardımcı programlar) yükleyin.Daha fazla bilgi için Kuruluşa kaydolma başlıklı makaleye bakın.
- Yükleme işlemi tamamlandıktan sonra, aşağıdaki örnekte gösterildiği gibi Klasik kullanıcı arayüzü bileşenini her düğümde yeniden başlatın:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
(Önerilir) İlk kurulumu tamamladıktan sonra Apigee, Özel Bulut için Apigee Edge'in geliştiricileri ve yöneticileri için gelişmiş bir kullanıcı arayüzü olan yeni Edge kullanıcı arayüzünü (bileşen adı
edge-management-ui
olan) yüklemenizi önerir.Daha fazla bilgi için Yeni Edge kullanıcı arayüzünü yükleme başlıklı makaleye bakın.
Yükleme tamamlandığında sık karşılaşılan yükleme sonrası işlemlerin listesine göz atın.
Yüklemeyi kim gerçekleştirebilir?
Apigee Edge dağıtım dosyaları, bir BGBG ve bağımlılık grubu olarak yüklenir. Edge RPM'lerini yüklemek, kaldırmak ve güncellemek için komutların kök kullanıcı veya tam sudo erişimi olan bir kullanıcı tarafından çalıştırılması gerekir. Tam sudo erişimi için kullanıcının kök ile aynı işlemleri gerçekleştirmek üzere sudo erişimi olması gerekir.
Aşağıdaki komutları veya komut dosyalarını çalıştırmak isteyen kullanıcıların kök olması ya da tam sudo erişimi olan bir kullanıcı olması gerekir:
- Apigee-service yardımcı programı:
- Apigee-service komutları:
install, uninstall, update
. - Apigee-all komutları:
install, uninstall, update
.
- Apigee-service komutları:
- Edge bileşenlerini yüklemek için setup.sh komut dosyasını kullanın (Gerekli BGBG'leri yüklemek için "
apigee-service install
" yöntemini zaten kullanmadığınız sürece. Daha sonra gerekli değilse kök veya tam sudo erişimi.) - Edge bileşenlerini güncellemek için update.sh komut dosyası
Ayrıca, Edge yükleyici, sisteminizde "Apigee" adlı yeni bir kullanıcı da oluşturur. Birçok Edge komutu, "Apigee" kullanıcısı olarak çalıştırmak için sudo'yu çağırır.
Yukarıda gösterilenler dışındaki tüm komutları çalıştırmak isteyen kullanıcılar, "Apigee" kullanıcısına tam sudo erişimi olan kullanıcılar olmalıdır. Bu komutlar şunları içerir:
-
Aşağıdaki gibi Apigee-service yardımcı program komutları:
start, stop, restart, configure
gibi Apigee-service komutlarını kullanmayın.start, stop, restart, configure
gibi Apigee-all komutları.
"Apigee" kullanıcısına tam sudo erişimi olan kullanıcı oluşturma
Bir kullanıcıyı "Apigee" kullanıcısına tam sudo erişimi olacak şekilde yapılandırmak için sudoers dosyasını eklemek üzere "visudo" komutunu kullanın:
installUser ALL=(apigee) NOPASSWD: ALL
Burada installUser, Edge ile çalışan kişinin kullanıcı adıdır.
Yapılandırma dosyaları için izinleri belirleme
Edge komutlarının kullandığı tüm dosya veya kaynaklara "Apigee" kullanıcısı tarafından erişilebilir olmalıdır. Buna Edge lisans dosyası ve yapılandırma dosyaları da dahildir.
Bir yapılandırma dosyası oluştururken, dosyanın Edge komutları tarafından erişilebilir olmasını sağlamak için sahibini "Apigee:Apigee" olarak değiştirebilirsiniz:
- Dosyayı bir düzenleyicide herhangi bir kullanıcı olarak oluşturun.
chown
Dosyanın sahibini "Apigee:Apigee" olarak değiştirin veya Edge hizmetini çalıştıran kullanıcıyı "Apigee" kullanıcısından değiştirdiyseniz dosyayı Edge hizmetini çalıştıran kullanıcıya ekleyin.
Edge yükleme görevlerini kök ve kök olmayan kullanıcı arasında ayırma
Edge yükleme işleminin tamamını kök olarak veya tam sudo erişimi olan bir kullanıcı tarafından gerçekleştirmek en basit yöntem olsa da bu her zaman mümkün değildir. Bunun yerine, işlemi kök dizin tarafından gerçekleştirilen görevler ve "Apigee" kullanıcısına tam sudo erişimi olan kullanıcı tarafından gerçekleştirilen görevler olarak ayırabilirsiniz.
- Kök tarafından gerçekleştirilen görevler:
bootstrap_4.50.00.sh
dosyasını indirip çalıştırın:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
Bu adım,
apigee-service
yardımcı programını yükler ve "Apigee" kullanıcısını oluşturur.- Bir kullanıcıyı "Apigee" kullanıcısına tam sudo erişimi olan kullanıcı oluşturma bölümünde açıklandığı şekilde "Apigee" kullanıcısına tam sudo erişimi olacak şekilde yapılandırın.
apigee-setup
yardımcı programını yükleyin:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Düğüme Edge BGBG'leri yüklemek için
apigee-setup
yardımcı programını kullanın:/opt/apigee/apigee-service/bin/apigee-service compName install
Düğüme yüklediğiniz Edge BGBG'leri topolojinize bağlıdır. Kullanılabilir bileşenlerin listesi şunları içerir:
apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server
.
- Kök kullanıcı, düğümde Edge BGBG'lerini yükledikten sonra "Apigee" kullanıcısına tam sudo erişimi olan kullanıcı yapılandırma işlemini tamamlar:
- Düğümdeki Edge bileşenlerinin yapılandırmasını tamamlamak için
setup.sh
yardımcı programını kullanın. Komutun biçimi, düğüme yüklediğiniz bileşenlere bağlıdır. Tam liste için Düğüm bileşenlerini bir düğüme yükleme başlıklı makaleye bakın.Örneğin, ZooKeeper ve Cassandra'nın kurulumunu tamamlamak için aşağıdaki komutu kullanın:
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
Burada configFile, Edge yapılandırma dosyasıdır.
Alternatif olarak, hepsi bir arada yükleme yapmak için aşağıdaki komutu kullanın:
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
- Düğümdeki Edge bileşenlerinin yapılandırmasını tamamlamak için
Yükleme yapılandırma dosyalarının konumu
Edge kurulumuyla ilgili bilgileri içeren apigee-setup
yardımcı programına bir yapılandırma dosyası iletmeniz gerekir. Sessiz yüklemelerde tek şart, yapılandırma dosyasının "Apigee" kullanıcısı tarafından erişilebilir veya okunabilmesidir. Örneğin, dosyayı düğümdeki /usr/local/var
veya /usr/local/share
dizinine ve chown
"Apigee:Apigee" dizinine yerleştirin.
Edge sistem yöneticisinin şifresi dışında yapılandırma dosyasındaki tüm bilgiler gerekir. Şifreyi çıkarırsanız apigee-setup
yardımcı programı, şifreyi komut satırına girmenizi ister.
Daha fazla bilgi için Düğüm bileşenlerini düğüme yükleme başlıklı makaleye göz atın.
Yükleme hatası işleme
Bir Edge bileşeninin yüklenmesi sırasında bir hata meydana gelirse, sorunu gidermeyi ve ardından yükleyiciyi tekrar çalıştırmayı deneyebilirsiniz. Yükleyici, bir hata tespit ettiğinde veya bileşen yüklendikten sonra daha sonra değiştirmek ya da güncellemek istediğinizde, tekrar tekrar çalışacak şekilde tasarlanmıştır.
Yükledikten veya yükselttikten sonra Edge kullanıcı arayüzü bileşenini çalıştırdığı her düğümde yeniden başlatın.
İnternet üzerinden veya internet dışından yükleme
Bir düğüme Edge yüklemek için, düğümün Apigee deposuna erişebilmesi gerekir:
- Harici internet bağlantısı olan düğümler
Harici internet bağlantısı olan düğümler, Edge BGBG'lerini ve bağımlılıklarını yüklemek için Apigee deposuna erişir.
- Harici internet bağlantısı olmayan düğümler
Harici internet bağlantısı olmayan düğümler, Apigee kod deposunun dahili olarak ayarladığınız yansıtılmış bir sürümüne erişebilir. Bu veri havuzu, tüm Edge BGBG'lerini içerir ancak dahili ağda depolardan diğer tüm bağımlıların mevcut olduğundan emin olmanız gerekir.
Dahili Apigee deposu oluşturmak için harici internet erişimi olan bir düğümün Edge BGBG'lerini ve bağımlılıkları indirebilmesi gerekir. Dahili depoyu oluşturduktan sonra başka bir düğüme taşıyabilir veya yükleme için Edge düğümlerinin erişimine açabilirsiniz.
Edge sürümünüzün bakımını yapmak için yerel bir Edge deposu kullanma
Yerel veya yansıtılmış bir depoyu kullanma nedenlerinden biri, önceki bölümde açıklandığı gibi Edge'i harici internet bağlantısı olmayan düğümlere yüklemektir.
BGBG yükleme bağımlılıklarını çözme
Apigee Edge dağıtım dosyaları, her biri kendi yükleme bağımlılarına sahip olabilecek bir BGBG dosyası grubu olarak yüklenir. Bu bağımlılıkların çoğu, Apigee'nin kontrolü dışındaki üçüncü taraf bileşenler tarafından tanımlanır ve herhangi bir zamanda değiştirilebilir. Bu nedenle dokümanlarda her bağımlının açık sürüm numarası listelenmez.
İnternet erişimi olan bir makinede yükleme işlemi yapıyorsanız düğüm, gerekli BGBG'leri ve bağımlılıkları indirebilir. Ancak internet erişimi olmayan bir düğümden yükleme yapıyorsanız genellikle gerekli tüm bağımlıları içeren dahili bir depo oluşturursunuz. Tüm bağımlıların yerel deponuza dahil edildiğinden emin olmanın tek yolu, yüklemeyi denemek, eksik bağımlılıkları belirlemek ve kurulum başarılı olana kadar bunları yerel depoya kopyalamaktır.
Sık kullanılan Yum komutları
Linux için Edge yükleme araçları, bileşenlerin yüklenmesi ve güncellenmesi için Yum'a ihtiyaç duyar. Bir düğümdeki kurulumu yönetmek için birkaç Yum komutu kullanmanız gerekebilir.
- Tüm Yum önbelleklerini temizleyin:
sudo yum clean all
- Bir Edge bileşenini güncellemek için:
sudo yum update componentName
Örneğin:
sudo yum update apigee-setup
sudo yum update edge-management-server
Dosya Sistemi Yapısı
Edge, tüm dosyaları /opt/apigee
dizinine yükler.
Bu kılavuzda ve Edge İşlem Kılavuzu'nda kök yükleme dizini şu şekilde belirtilmiştir:
/opt/apigee
Yüklemede, Apigee Edge'i Private Cloud'a dağıtmak için aşağıdaki dosya sistemi yapısı kullanılır.
Günlük Dosyaları
apigee-setup
ve setup.sh
komut dosyasının günlük dosyası /tmp/setup-root.log
dosyasına yazılır.
Her bileşenin günlük dosyaları /opt/apigee/var/log
dizininde bulunur. Her bileşenin kendi alt dizini vardır. Örneğin, Yönetim Sunucusu günlükleri dizindedir:
/opt/apigee/var/log/edge-management-server
Aşağıdaki tablolarda, günlük dosyalarının konumu listelenmiştir:
Bileşen | Konum |
---|---|
Yönetim Sunucusu |
/opt/apigee/var/log/edge-management-server
|
Yönlendirici |
/opt/apigee/var/log/edge-router
Uç Yönlendirici, Nginx kullanılarak uygulanır. Diğer günlükler için şuraya göz atın:
|
Mesaj İşleyici |
/opt/apigee/var/log/edge-message-processor
|
Apigee Qpid Sunucusu |
/opt/apigee/var/log/edge-qpid-server
|
Apigee Postgres Sunucusu | /opt/apigee/var/log/edge-postgres-server |
Klasik kullanıcı arayüzü (bileşen adı edge-management-ui olan yeni Edge kullanıcı arayüzü değil) |
/opt/apigee/var/log/edge-ui |
ZooKeeper | /opt/apigee/var/log/apigee-zookeeper |
OpenLDAP | /opt/apigee/var/log/apigee-openldap |
Cassandra | /opt/apigee/var/log/apigee-cassandra/system.log |
Qpidd | /opt/apigee/var/log/apigee-qpidd |
PostgreSQL veritabanı | /opt/apigee/var/log/apigee-postgresql |
apigee-monit |
/opt/apigee/var/log/apigee-monit |
Veriler
Bileşen | Konum |
---|---|
Yönetim Sunucusu | /opt/apigee/data/edge-management-server |
Yönlendirici | /opt/apigee/data/edge-router |
Mesaj İşleyici | /opt/apigee/data/edge-message-processor |
Apigee Qpid aracısı | /opt/apigee/data/edge-qpid-server |
Apigee Postgres aracısı | /opt/apigee/data/edge-postgres-server |
ZooKeeper | /opt/apigee/data/apigee-zookeeper |
OpenLDAP | /opt/apigee/data/apigee-openldap |
Cassandra | /opt/apigee/data/apigee-cassandra/data |
Qpidd | /opt/apigee/data/apigee-qpid/data |
PostgreSQL veritabanı | /opt/apigee/data/apigee-postgres/pgdata |
apigee-monit |
/opt/apigee/data/apigee-monit |
Yükleme sırasında sistem kontrolünü etkinleştirin
Edge yükleme yapılandırma dosyası, aşağıdaki özelliği destekler:
ENABLE_SYSTEM_CHECK=y
Bu özelliği "y" olarak ayarlarsanız yükleyici, sistemin yüklenen bileşen için CPU ve bellek gereksinimlerini karşılayıp karşılamadığını kontrol eder. Kontrolü devre dışı bırakmak için varsayılan değer "n"dir.