Edge Apigee-setup yardımcı programını yükleyin

Edge'i bir düğüme yüklemek için önce Edge apigee-setup yardımcı programını yüklemeniz gerekir. Düğümlerinizin harici internet bağlantısının olmadığı bir ortamdaysanız Apigee deposunun yerel bir kopyasını da yüklemeniz gerekir.

Varsayılan yükleme dizini: /opt/apigee

Edge, tüm dosyaları /opt/apigee dizinine yükler. Bu dizini değiştiremezsiniz. Ancak isterseniz /opt/apigee öğesini başka bir konuma eşlemek için sembolik bağlantı oluşturabilirsiniz. Daha fazla bilgi için Yükleme Koşulları'na bakın.

Ön koşul: SELinux'u devre dışı bırakma

Edge apigee-setup yardımcı programını veya herhangi bir Edge bileşenini yükleyebilmeniz için önce SELinux'u devre dışı bırakmanız ya da izin verici moda ayarlamanız gerekir. Gerekirse Edge'i yükledikten sonra SELinux'u yeniden etkinleştirebilirsiniz.

Ön koşul: EPEL deposunu etkinleştirme

Edge'i yüklemek veya güncellemek ya da yerel bir depo oluşturmak için Enterprise Linux için Ekstra Paketler (veya EPEL)'i etkinleştirmeniz gerekir. Red Hat Enterprise Linux (RHEL) 9.x, Rocky Linux 9.x veya Oracle Linux 9.x için aşağıdaki komutları çalıştırın:

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

RHEL 9/Rocky 9/Oracle 9 için ön koşul

Edge'i Red Hat Enterprise Linux (RHEL) 9, Rocky 9 veya Oracle 9 çalıştıran bir sunucuya yüklüyorsanız yükleme işlemini gerçekleştirmeden önce aşağıdaki adımları tamamlayın:

1. Extra Packages for Enterprise Linux (EPEL)'i etkinleştirin:

   sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

2. Postgres ve Nginx'i devre dışı bırakın:

   sudo dnf module disable postgresql
   sudo dnf module disable nginx

PostgreSQL ve LDAP için ön kurulum değişiklikleri hakkında bilgi edinmek üzere sırasıyla PostgreSQL veritabanı ön kurulum koşulları ve SymasLDAP 2.6.10 ön kurulum değişiklikleri başlıklı bölümleri inceleyin.

Edge apigee-setup yardımcı programını harici internet bağlantısı olan bir düğüme yükleyin.

Edge'i harici internet bağlantısı olan bir düğüme yüklemek için:

1. Apigee deposuna erişmek için kullandığınız kullanıcı adını ve şifreyi Apigee'den alın. Apigee ftp sitesi için mevcut bir username:password hesabınız varsa bu kimlik bilgilerini kullanabilirsiniz.
2. Edge RPM'lerini yüklemek için düğümünüze root olarak giriş yapın
   
3. SELinux'u devre dışı bırakın.
4. EPEL deposunu etkinleştirin.
5. RHEL 9/Rocky 9/Oracle 9'a yükleme yapıyorsanız RHEL 9/Rocky 9/Oracle 9 için ön koşullar bölümündeki adımları uygulayın.
6. Edge bootstrap_4.54.00.sh dosyasını /tmp/bootstrap_4.54.00.sh dizinine indirin:

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

7. Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:

   sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

   Burada uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord parametresini atlarsanız bu parametreyi girmeniz istenir.

   Apigee Edge for Private Cloud 4.54.00, düğüme hem Java 17 hem de Java 21'in yüklendiği çift Java desteği gerektirir. Bootstrap komut dosyasını çalıştırmadan önce hem Java 17'yi hem de Java 21'i yüklemeniz gerekir. Yükleyici yalnızca her iki JDK sürümünün de yüklü olduğunu doğrular; Java'yı otomatik olarak yüklemez.

   apigee-service yardımcı programının yüklenmesi, Apigee deposunu tanımlayan /etc/yum.repos.d/apigee.repo dosyasını oluşturur. Tanım dosyasını görüntülemek için aşağıdaki komutu kullanın:

   cat /etc/yum.repos.d/apigee.repo

   Depo içeriğini görüntülemek için şu komutu kullanın:

   sudo yum -v repolist 'apigee*'

8. apigee-setup yardımcı programını yüklemek için apigee-service'i kullanın:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

9. Düğümde Edge bileşenlerini yüklemek ve yapılandırmak için apigee-setup'ı kullanın. Daha fazla bilgi için Bir düğüme Edge bileşenlerini yükleme başlıklı makaleyi inceleyin.

Sorun giderme

Harici internet bağlantısı olan bir düğüme yüklemeye çalışırken aşağıdaki hatalardan biri veya daha fazlasıyla karşılaşabilirsiniz:

Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

Aşağıdaki tabloda, bu hatalar için olası bazı çözümler listelenmiştir:

nc -v software.apigee.com 443

Connection to software.apigee.com 443 port [tcp/https] succeeded!

telnet software.apigee.com 443

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm

echo $http_proxy
echo $https_proxy

Edge apigee-setup yardımcı programını harici internet bağlantısı olmayan bir düğüme yükleme

Uç düğümleriniz bir güvenlik duvarının arkasındaysa veya başka bir şekilde internete erişmeleri engelleniyorsa yükleme sırasında ihtiyaç duyacağınız dosyaları içeren birkaç depo ya da yansıma oluşturmanız gerekir. Bu yansıların tüm düğümler tarafından erişilebilir olması gerekir. Oluşturulduktan sonra düğümler, Edge'i yüklemek için bu yerel yansılara erişebilir.

İnternet bağlantısı olmayan düğümler için Apigee Edge yükleme işlemi, aşağıdaki yerel depoların erişimini gerektirir:

• Apigee Edge deposu: Yerel Apigee deposu oluşturma bölümünde açıklandığı gibi.
• Extra Packages for Enterprise Linux (veya EPEL): Operasyon ekibiniz bunu sizin için ayarlayabilir.

Yerel bir Apigee deposu oluşturma

Dahili Apigee deposunu oluşturmak için Edge RPM'lerini ve bağımlılıklarını indirebilmek amacıyla harici internet erişimi olan bir düğüme ihtiyacınız vardır. Dahili depoyu oluşturduktan sonra başka bir düğüme taşıyabilir veya bu düğümü yükleme için Edge düğümlerinin erişimine açabilirsiniz.

Yerel bir Apigee deposu oluşturduktan sonra, daha sonra en son Edge sürüm dosyalarıyla güncellemeniz gerekebilir. Aşağıdaki bölümlerde, yerel bir Apigee deposunun nasıl oluşturulacağı ve nasıl güncelleneceği açıklanmaktadır.

Yerel bir Apigee deposu oluşturmak için:

1. Apigee deposuna erişmek için kullandığınız kullanıcı adını ve şifreyi Apigee'den alın. Apigee FTP sitesi için mevcut bir kullanıcı adı ve şifreniz varsa bu kimlik bilgilerini kullanabilirsiniz.
2. Edge RPM'lerini yüklemek için düğümünüze root olarak giriş yapın.
   
3. SELinux'u yukarıda açıklandığı şekilde devre dışı bırakın.
4. Edge bootstrap_4.54.00.sh dosyasını /tmp/bootstrap_4.54.00.sh dizinine indirin:

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

5. Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
   

   sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

   Burada uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord parametresini atlarsanız bu parametreyi girmeniz istenir.

6. Düğüme apigee-mirror yardımcı programını yükleyin:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

7. Apigee deposunu /opt/apigee/data/apigee-mirror/repos/ diziniyle senkronize etmek için apigee-mirror yardımcı programını kullanın.

   Deponun boyutunu en aza indirmek için yalnızca en son RPM'leri indirmek üzere --only-new-rpms seçeneğini ekleyin.

8. (İsteğe bağlı) Edge'i yerel depodan yerel depoyu barındıran aynı düğüme yüklemek istiyorsanız önce aşağıdaki komutları çalıştırmanız gerekir:
   1. bootstrap_4.54.00.sh yardımcı programını yüklemek için yerel depoda apigee-service komutunu çalıştırın:

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos

   2. apigee-setup yardımcı programını yüklemek için apigee-service komutunu kullanın:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   3. Düğümde Edge bileşenlerini yüklemek ve yapılandırmak için apigee-setup komutunu kullanın. Daha fazla bilgi için Edge bileşenlerini bir düğüme yükleme başlıklı makaleyi inceleyin.

Yerel depodan uzak bir düğüme apigee-setup yükleme

Edge'i yerel depodan yüklemek için iki seçeneğiniz vardır. Aşağıdaki yöntemlerden birini uygulayabilirsiniz:

• Deponun .tar dosyasını oluşturun, .tar dosyasını bir düğüme kopyalayın ve ardından Edge'i .tar dosyasından yükleyin.
• Diğer düğümlerin erişebilmesi için yerel depoya sahip düğüme bir web sunucusu yükleyin. Apigee, kullanmanız için Nginx web sunucusunu sağlar veya kendi web sunucunuzu kullanabilirsiniz.

.tar dosyasından yükleme

.tar dosyasından yüklemek için:

1. Yerel depoya sahip düğümde, yerel depoyu /opt/apigee/data/apigee-mirror/apigee-4.54.00.tar.gz adlı tek bir .tar dosyası halinde paketlemek için aşağıdaki komutu kullanın:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

2. .tar dosyasını Edge'i yüklemek istediğiniz düğüme kopyalayın. Örneğin, yeni düğümdeki /tmp dizinine kopyalayın.
3. Yeni düğümde, yukarıda açıklandığı şekilde SELinux'u devre dışı bırakın.
4. Yeni düğümde, yerel Yum yardımcı programı deposuna ve EPEL deposuna erişebildiğinizden emin olun.
5. Tüm harici internet depolarının devre dışı bırakıldığından emin olun (İnternet erişimi olmayan bir makineye yükleme yaptığınız için bu durum geçerli olmalıdır):

   sudo yum repolist

   Yerel Apigee deposu ve dahili depolarınız dışındaki tüm harici depolar devre dışı bırakılmalıdır.

6. apigee-setup yardımcı programını yüklemek için apigee-service aracını kullanın:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

7. Düğümde Edge bileşenlerini yüklemek ve yapılandırmak için apigee-setup komutunu kullanın. Daha fazla bilgi için Edge bileşenlerini bir düğüme yükleme başlıklı makaleyi inceleyin.

Nginx web sunucusunu kullanarak depodan yükleme

Nginx web sunucusunu kullanarak depodan yüklemek için:

1. Nginx web sunucusunu depo düğümüne yükleyin:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig

2. Varsayılan olarak Nginx, sunucu adı olarak localhost'u ve bağlantı noktası olarak 3939'u kullanacak şekilde yapılandırılır. Bu değerleri değiştirmek için:
   1. /opt/apigee/customer/application/mirror.properties dosyasını bir düzenleyicide açın. Dosya yoksa oluşturun.
   2. Gerekirse aşağıdaki değerleri ayarlayın:

      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost

   3. Nginx'i yeniden başlatın:

      /opt/nginx/scripts/apigee-nginx restart

3. Varsayılan olarak depo, admin:admin kullanıcı adı ve şifresini gerektirir. Bu kimlik bilgilerini değiştirmek için aşağıdaki ortam değişkenlerini ayarlayın:

   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord

4. Yeni düğümde, EPEL deposunun yerel olarak etkinleştirildiğinden emin olun.
5. Yeni düğümde, yukarıda açıklandığı şekilde libdb4 sürümünüzü kontrol edin.
6. Uzak düğümde Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:

   sudo bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

   uName:pWord, depo kullanıcı adı ve şifresidir.

7. Uzak düğümde, apigee-setup yardımcı programını yüklemek için apigee-service komutunu kullanın:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

8. Uzak düğümde Edge bileşenlerini yüklemek ve yapılandırmak için apigee-setup'ı kullanın. Daha fazla bilgi için Edge bileşenlerini bir düğüme yükleme başlıklı makaleyi inceleyin.

Yerel bir Apigee deposunu güncelleme

Depoyu güncellemek için en son bootstrap_4.54.00.sh dosyasını indirmeniz ve ardından yeni bir senkronizasyon gerçekleştirmeniz gerekir.

Depoyu güncellemek için:

1. Edge bootstrap_4.54.00.sh dosyasını /tmp/bootstrap_4.54.00.sh dizinine indirin:

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

2. Edge bootstrap_4.54.00.sh dosyasını çalıştırın:

   sudo bash/tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

   Burada uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord parametresini atlarsanız bu parametreyi girmeniz istenir.

3. apigee-mirror uygulamasını güncelleyin:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update

4. Senkronizasyonu gerçekleştirin:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

5. Deponun tamamını silmek istiyorsanız:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Yerel bir Apigee deposunu temizleme

Yerel depoyu temizlemek /opt/apigee/data/apigee-mirror ve /var/tmp/yum-apigee-* dosyalarını siler.

Yerel depoyu temizlemek için şunu kullanın:

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean