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 dilerseniz /opt/apigee dosyasını başka bir konumla eşlemek için simge bağlantısı oluşturabilirsiniz. Daha fazla bilgi için Yükleme Şartları bölümüne bakın.

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

Edge apigee-setup yardımcı programını veya Edge bileşenlerini yükleyebilmek için 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 olarak ayarlayın
    3. Yaptığınız düzenlemeleri kaydedin.
    4. Düğümü yeniden başlatın.
    5. Gerekirse Edge yükleme işleminden sonra SELINUX=enabled değerini ayarlamak için bu prosedürü tekrarlayarak SELinux'u yeniden etkinleştirin.
  • Ön koşul: EPEL deposunu etkinleştirme

    Edge'i yüklemek veya güncellemek ya da yerel depo oluşturmak için Enterprise Linux (veya EPEL) için Ek Paketler'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 yapmadan önce aşağıdaki adımları uygulayın:

      1. Enterprise Linux için Ek Paketler (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ırakma:
        sudo dnf module disable postgresql
        sudo dnf module disable nginx

      RHEL 9/Rocky 9/Oracle 9 ön koşulu

      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. Enterprise Linux için Ek Paketler (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ırakma:
        sudo dnf module disable postgresql
        sudo dnf module disable nginx

      PostgreSQL ve LDAP'ye yönelik kurulum öncesi değişiklikler için sırasıyla PostgreSQL veritabanı ön kurulum gereksinimleri ve OpenLDAP 2.4 ön yükleme değişiklikleri sayfalarına göz atın.

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

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

      1. Apigee deposuna erişmek için kullandığınız Apigee kullanıcı adını ve şifresini alın. Apigee ftp sitesi için mevcut bir username:password'niz 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üklü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.00.sh dosyasını /tmp/bootstrap_4.53.00.sh'e indirin:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      7. Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
        sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

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

        Yükleyici varsayılan olarak Java 1.8'in yüklü olup olmadığını kontrol eder. Yüklemezseniz uygulamayı 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 yükleyin (varsayılan)
        • C: Java yüklemeden devam et
        • S: Çıkma. Bu seçenekte Java'yı kendiniz yüklemeniz gerekir.

        apigee-service yardımcı programı yüklendiğinde 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çeriklerini 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 kullanın:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      9. Düğüme 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.

      Sorun giderme

      Harici internet bağlantısı olan bir düğüme yükleme yapmaya çalışırken aşağıdaki hatalardan bir 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ın olası çözümleri listelenmiştir:

      Hata Türü Olası Çözüm
      Şifre hatalı karakterler içeriyor Apigee şifrenizde özel karakterler kullanmayın.
      Bağlantı sorunları

      Aşağıdaki ncat komutunu yürüterek ağ bağlantınızı test edin:

      nc -v software.apigee.com 443

      Aşağıdakine benzer bir mesaj alırsınız:

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

      nc uygulaması 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.

      Bu komutlardan biri başarısız olursa ağ bağlantınız sınırlı veya hiç yoktur. Ağ yöneticinizle görüşün.

      Yanlış kimlik bilgileri

      Kullanıcı adınızın ve şifrenizin doğru olduğundan emin olun.

      Örneğin, Apigee kullanıcı adınız ve şifrenizle aşağıdaki komutu kullanmaya çalışırken 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şletmemişsiniz. 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 öğesine bir HTTP proxy yapılandırması ekleyin
      • /etc/environment bölümüne genel HTTP proxy yapılandırması ekleyin

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

      Edge düğümleriniz bir güvenlik duvarının arkasındaysa veya başka bir şekilde internete erişmeleri yasaklanmışsa yükleme sırasında ihtiyaç duyacağınız dosyaları içeren birkaç depolama alanı veya yansıtma alanı oluşturmanız gerekir. Ardından bu yansıtma noktalarına tüm düğümlerin erişebilmesi gerekir. Oluşturulan düğümler, Edge'i yüklemek için bu yerel aynalara 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:

      Yerel bir Apigee deposu oluşturma

      Dahili Apigee deposu oluşturmak istiyorsanız Edge BGBG'lerini ve bağımlılıklarını indirebilmek için harici internet erişimi olan bir düğüme ihtiyacınız vardır. Dahili deposu oluşturduktan sonra başka bir düğüme taşıyabilir veya bu düğümü yükleme için Edge düğümlerine erişilebilir hale getirebilirsiniz.

      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 güncelleneceği açıklanmaktadır.

      Yerel bir Apigee deposu oluşturmak için:

      1. Apigee'den Apigee deposuna erişmek için kullandığınız kullanıcı adını ve şifreyi alın. Apigee FTP sitesi için mevcut bir kullanıcı adı:şifreniz varsa bu kimlik bilgilerini kullanabilirsiniz.
      2. Edge BGBG'lerini yüklemek için düğümünüze kök olarak giriş yapın.
      3. SELinux'u yukarıda açıklandığı şekilde devre dışı bırakın.
      4. Edge bootstrap_4.53.00.sh dosyasını /tmp/bootstrap_4.53.00.sh'e indirin:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      5. Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
        sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

        Burada uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord öğesini 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 /opt/apigee/data/apigee-mirror/repos/ dizini ile senkronize etmek için apigee-mirror yardımcı programını kullanın.

        Deponun boyutunu en aza indirmek için --only-new-rpms ekleyerek yalnızca en son BGBG'leri indirin.

      8. (İsteğe bağlı) Edge'i yerel depodan yerel depoyu barındıran düğüme yüklemek isterseniz ö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.00.sh'ü çalıştırın:
          sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
        2. apigee-setup yardımcı programını yüklemek için apigee-service'ü kullanın:
          /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
        3. Düğüme 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.

      Apigee-setup sürümünü 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 .tar dosyasından Edge'i yükleyin.
      • Diğer düğümlerin erişebilmesi için yerel depoyu içeren düğüme bir web sunucusu yükleyin. Apigee, Nginx web sunucusunu sağlar. Dilerseniz kendi web sunucunuzu da kullanabilirsiniz.

      .tar dosyasından yükle

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

      1. Yerel deposunun bulunduğu düğümde, yerel deposu /opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz adlı tek bir .tar dosyasına 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ışı olduğundan 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

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

      6. apigee-setup yardımcı programını yüklemek için apigee-service'ü kullanın:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      7. Düğüme 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.

      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 ve 3939 bağlantı noktasını kullanacak şekilde yapılandırılmıştır. Bu değerleri değiştirmek için:
        1. /opt/apigee/customer/application/mirror.properties dosyasını bir düzenleyicide açın. Dosya mevcut değilse dosyayı oluşturun.
        2. Aşağıdaki değerleri gerektiği gibi 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 için admin:admin kullanıcı adı ve şifresi gerekir. 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.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        Burada uName:pWord, deponun 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ş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ı makaleye bakın.

      Yerel Apigee deposunu güncelleme

      Depoyu güncellemek için en son bootstrap_4.53.00.sh dosyasını indirip yeni bir senkronizasyon gerçekleştirmeniz gerekir.

      Depoyu güncellemek için:

      1. Edge bootstrap_4.53.00.sh dosyasını /tmp/bootstrap_4.53.00.sh'ye indirin:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      2. Edge bootstrap_4.53.00.sh dosyasını çalıştırın:
        sudo bash/tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

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

      3. apigee-mirror güncellemesi:
        /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ı kullanmak istiyorsanız:
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

      Yerel Apigee deposunu temizleme

      Yerel deponun temizlenmesi /opt/Apigee/data/sorumlu-mirror ve /var/tmp/yum- destek-* bilgilerini silecektir.

      Yerel deposu temizlemek için:

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