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

Bir düğüme Edge'i yüklemek için önce Edge apigee-setup yardımcı programını yüklersiniz. 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, /opt/apigee dizinindeki tüm dosyaları 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ı başlıklı makaleyi inceleyin.

Ö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.

SELinux'u kalıcı olarak devre dışı bırakmak veya izin verici moda ayarlamak için:

1. /etc/sysconfig/selinux dosyasını bir düzenleyicide açın.
2. SELINUX=disabled veya SELINUX=permissive öğesini ayarlayın
3. Yaptığınız düzenlemeleri kaydedin.
4. Düğümü yeniden başlatın.
5. Gerekirse SELINUX=enabled değerini ayarlamak için bu prosedürü tekrarlayarak Edge kurulumundan sonra SELinux'u yeniden etkinleştirin.

Ön koşul: EPEL deposunu etkinleştirme

Edge'i yüklemek veya güncellemek ya da yerel bir depo oluşturmak için Extra Packages for Enterprise Linux (veya EPEL)'i etkinleştirmeniz gerekir. Kullandığınız komut, RedHat/CentOS sürümünüze bağlıdır:

• Red Hat/CentOS/Oracle 8.x için:

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

• Red Hat/CentOS/Oracle 9.x için:

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

RHEL 8/Rocky 8/Oracle 8 için ön koşullar

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

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

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

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

   sudo dnf module disable postgresql
   sudo dnf module disable nginx

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şlemine başlamadan ö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 gereksinimleri ve SymasLDAP 2.6.7 ön kurulum değişiklikleri başlıklı makaleleri inceleyin.

Harici internet bağlantısı olan bir düğüme Edge apigee-setup yardımcı programını 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 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.53.01.sh dosyasını /tmp/bootstrap_4.53.01.sh konumuna indirin:

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

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

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

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

   Yükleyici, varsayılan olarak Java 1.8'in yüklü olup olmadığını kontrol eder. Yüklü değilse sizin için yükler. Java yüklemesinin nasıl ele alınacağını belirtmek için JAVA_FIX seçeneğini kullanın. JAVA_FIX aşağıdaki değerleri alır:

   • I: OpenJDK 1.8'i (varsayılan) yükleyin
   • C: Java'yı yüklemeden devam et
   • S: Çık'ı tıklayın. Bu seçeneği kullanmak için Java'yı kendiniz yüklemeniz gerekir.

   apigee-service yardımcı programının yüklenmesiyle Apigee deposunu tanımlayan /etc/yum.repos.d/apigee.repo dosyası oluşturulur. Tanım dosyasını görüntülemek için şu 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şenleri 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 birkaçı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 hatalara ilişkin olası çözümler listelenmiştir:

Hata Türü	Olası Çözüm
Şifre geçersiz karakterler içeriyor	Apigee şifrenizde özel karakterler kullanmayın.
Bağlantı sorunları	Aşağıdaki ncat komutunu çalıştırarak ağ bağlantınızı test edin: nc -v software.apigee.com 443 Şuna benzer bir mesaj alırsınız: Connection to software.apigee.com 443 port [tcp/https] succeeded! nc yüklü değilse aşağıdaki telnet komutunu çalıştırabilirsiniz: telnet software.apigee.com 443 Komutlar başarılı olursa açık bağlantıyı iptal etmek için CTRL+C tuşlarına basabilirsiniz. Komutlardan biri başarısız olursa ağ bağlantınız sınırlı veya hiç yoktur. Ağ yöneticinize danışın.
Kimlik bilgileri yanlış	Kullanıcı adınızın ve şifrenizin doğru olduğundan emin olun. Örneğin, aşağıdaki komutu Apigee kullanıcı adınız ve şifrenizle kullanmaya çalıştığınızda hata alıp almadığınızı kontrol edin: curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
Proxy sorunları	Yerel yapılandırmanızda çıkış HTTP proxy'si kullanılıyor ve aynı yapılandırmayı yum paket yöneticisine genişletmediniz. Ortam değişkenlerinizi kontrol edin: echo $http_proxy echo $https_proxy Çıkış HTTP proxy'si için aşağıdaki seçeneklerden birini kullanmanız gerekir: /etc/yum.conf bölgesinde HTTP proxy yapılandırması ekleme /etc/environment bölgesinde genel HTTP proxy yapılandırması ekleme

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

Edge düğümleriniz bir güvenlik duvarının arkasındaysa veya internete erişmeleri başka bir şekilde yasaklanmışsa yükleme sırasında ihtiyacınız olacak dosyaları içeren birkaç depo ya da yansıtma oluşturmanız gerekir. Bu yansıtmalara tüm düğümler erişebilmelidir. Oluşturulduktan sonra düğümler, Edge'i yüklemek için bu yerel yansıtmalara erişebilir.

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

• Apigee Edge deposu: Yerel bir Apigee deposu oluşturma başlıklı makalede açıklandığı gibi.
• Enterprise Linux için Ek Paketler (veya EPEL): Operasyon ekibiniz bu paketi 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 üzere harici internet erişimi olan bir düğüm gerekir. Dahili depoyu oluşturduktan sonra başka bir düğüme taşıyabilir veya bu düğümü Edge düğümlerine erişilebilir hâle getirebilirsiniz.

Yerel bir Apigee deposu oluşturduktan sonra, bu depoyu 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ı:şifre çiftiniz 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.53.01.sh dosyasını /tmp/bootstrap_4.53.01.sh konumuna indirin:

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

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

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

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

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

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

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

   Deponun boyutunu en aza indirmek için yalnızca en son RPM'leri indirmek üzere --only-new-rpms komutunu 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. apigee-service yardımcı programını yüklemek için yerel depodan bootstrap_4.53.01.sh komutunu çalıştırın:

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

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

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

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

apigee-setup'ı yerel depodan uzak bir düğüme 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 depolu 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.53.01.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ığını tekrar kontrol edin (İnternet erişimi olmayan bir makineye yükleme yaptığınız için bu depolar devre dışı bırakılmış olmalıdır):

   sudo yum repolist

   Tüm harici depolar devre dışı bırakılmalı, ancak yerel Apigee deposu ve dahili depolarınız etkinleştirilmelidir.

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

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

7. Düğüme Edge bileşenleri yüklemek ve yapılandırmak için apigee-setup seçeneğini kullanın. Daha fazla bilgi için Bir düğüme Edge bileşenleri 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. Nginx, varsayılan olarak 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. Depo, varsayılan olarak admin:admin kullanıcı adı:şifre bilgisi 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.53.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

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

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

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

Yerel bir Apigee deposunu güncelleme

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

Depoyu güncellemek için:

1. Edge bootstrap_4.53.01.sh dosyasını /tmp/bootstrap_4.53.01.sh konumuna indirin:

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

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

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

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

3. apigee-mirror adresini 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 için /opt/apigee/data/apigee-mirror ve /var/tmp/yum-apigee-* dosyaları silinir.

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

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