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

Edge for Private Cloud 4.19.01 sürümü

Edge'i bir düğüme yüklemek için önce Edge Apigee-setup yardımcı programını yükleyin. 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 konumunu başka bir konumla eşlemek için sembolik bir bağlantı oluşturabilirsiniz. Daha fazla bilgi için Yükleme Koşulları bölümüne bakın.

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

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

  • SELinux'u geçici olarak serbest moda ayarlamak için aşağıdaki komutu çalıştırın:
    1. Linux 6.x işletim sisteminde:
      sudo echo 0 > /selinux/enforce

      Edge'i yükledikten sonra SELinux'u yeniden etkinleştirmek için:

      sudo echo 1 > /selinux/enforce
    2. Linux 7.x işletim sisteminde:
      sudo setenforce 0

      Edge'i yükledikten sonra SELinux'u yeniden etkinleştirmek için:

      sudo setenforce 1
  • SELinux'u kalıcı olarak devre dışı bırakmak veya serbest moda ayarlamak için:
    1. /etc/sysconfig/selinux dosyasını bir düzenleyicide aç.
    2. SELINUX=disabled veya SELINUX=permissive belirleyin
    3. Yaptığınız düzenlemeleri kaydedin.
    4. Düğümü yeniden başlatın.
    5. Gerekirse, Edge kurulumundan sonra SELinux'u yeniden etkinleştirmek için bu prosedürü tekrarlayarak SELINUX=enabled öğesini ayarlayın.

Ö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. Kullanacağınız komut, RedHat/CentOS sürümünüze bağlıdır:

  • RedHat/CentOS/Oracle 7.x için:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
    sudo rpm -ivh epel-release-latest-7.noarch.rpm
  • RedHat/CentOS/Oracle 6.x için:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm
    sudo rpm -ivh epel-release-latest-6.noarch.rpm

Ön koşul: RedHat 7.4 ve CentOS 7.4'teki libdb4 kitaplığı sürümünü kontrol etme

RedHat 7.4 ve CentOS 7.4'te, uygulamayı yüklemeden önce libdb4 BGBG'lerinin sürümünü kontrol edin. Edge'in 4.8 sürümü gerekir. RedHat 7.4 ve CentOS 7.4'ün bazı sürümleri daha yeni bir sürümle sunulur. Daha yeni bir sürüme sahipseniz bu sürümü kaldırın. Ardından Edge yükleyicisi 4.8 sürümünü yükler.

Sürümünüzü kontrol etmek için aşağıdaki komutu kullanabilirsiniz:

rpm -qa | grep libdb4

libdb4 BGBG sürümünün 4.8'den yeni olduğunu görürseniz kaldırı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 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 kartınız varsa bu kimlik bilgilerini kullanabilirsiniz.
  2. Edge BGBG'lerini yüklemek için düğümünüze kök olarak giriş yapın
  3. yum-utils ve yum-plugin-priorities uygulamalarını yükleyin:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. SELinux'u yukarıda açıklandığı şekilde devre dışı bırakın.
  5. EPEL deposunu yukarıda açıklandığı gibi etkinleştirin.
  6. libdb4 sürümünüzü yukarıda açıklanan şekilde kontrol edin.
  7. Oracle 7.x'e yükleme yapıyorsanız aşağıdaki komutu çalıştırın:
    sudo yum-config-manager --enable ol7_optional_latest
  8. AWS'ye yüklüyorsanız aşağıdaki yum-configure-manager komutlarını çalıştırın:
    yum update rh-amazon-rhui-client.noarch
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  9. Edge bootstrap_4.19.01.sh dosyasını /tmp/bootstrap_4.19.01.sh hedefine indirin:
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  10. Edge Apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
    sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

    Burada uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord yönergesini çıkarırsanız bunu girmeniz istenir.

    Varsayılan olarak yükleyici, Java 1.8'in yüklü olup olmadığını kontrol eder. Yüklemezseniz uygulama sizin için yüklenir. Java yüklemesinin nasıl yapılacağı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ı yüklemeden devam edin
    • S: Çık. Bu seçenek için Java'yı kendiniz yüklemeniz gerekir.

    Apigee-service yardımcı programının yüklenmesi, Apigee deposunu tanımlayan /etc/yum.repos.d/impression.repo dosyasını oluşturur. 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*'
  11. 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
  12. Düğüme Edge bileşenlerini yüklemek ve yapılandırmak için Apigee-setup seçeneğini kullanın. Daha fazla bilgi için Edge bileşenlerini bir düğüme yükleme bölümüne bakın.

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

Edge düğümleriniz güvenlik duvarı arkasında bulunuyorsa veya bir şekilde internete erişmesi yasaklanıyorsa yükleme sırasında ihtiyaç duyacağınız dosyaları içeren birkaç depo veya ayna oluşturmanız gerekir. Ardından bu aynalar tüm düğümler tarafından erişilebilir olmalıdır. Oluşturulduktan sonra düğümler, Edge'i yüklemek için bu yerel aynalara erişebilir.

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

Yerel Apigee deposu oluşturma

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

Yerel bir Apigee deposu oluşturduktan sonra, deposu en yeni Edge sürüm dosyalarıyla güncellemeniz gerekebilir. Aşağıdaki bölümlerde yerel Apigee deposu oluşturma ve güncelleme işlemi açıklanmaktadır.

Yerel 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 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.19.01.sh dosyasını /tmp/bootstrap_4.19.01.sh hedefine indirin:
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  5. Edge Apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
    sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

    Burada uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord yönergesini çıkarırsanız bunu 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/ diziniyle senkronize etmek için apigee-mirror yardımcı programını kullanın.

    Deponun boyutunu en aza indirmek için --only-new-rpms özelliğini ekleyerek yalnızca en son BGBG'leri indirin. İndirme işlemi için yaklaşık 1,6 GB disk alanına ihtiyacınız vardır:

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

    Eski BGBG'ler dahil olmak üzere deponun tamamını indirmek istiyorsanız --only-new-rpms kodunu çıkarın. Tam indirme işlemi için yaklaşık 6 GB disk alanına ihtiyacınız var:

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

    Artık Apigee deposunun yerel bir kopyasına sahipsiniz. Sonraki bölümde yerel depodan Edge apigee-setup yardımcı programının nasıl yükleneceği açıklanmaktadır.

  8. (İsteğe bağlı) Edge'i yerel depodan yerel depoyu barındıran düğüme yüklemek istiyorsanız önce şu komutları çalıştırmanız gerekir:
    1. apigee-service yardımcı programını yüklemek için yerel depodan bootstrap_4.19.01.sh komutunu çalıştırın:
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. apigee-setup yardımcı programını yüklemek için apigee-service uygulamasını 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 bölümüne bakın.

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, ardından .tar dosyasından Edge'i yükleyin.
  • Diğer düğümlerin erişebilmesi için yerel deponun bulunduğu düğüme bir web sunucusu yükleyin. Apigee, kullanmanız için Nginx web sunucusunu sağlar. Dilerseniz kendi web sunucunuzu de kullanabilirsiniz.

.tar dosyasından yükle

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

  1. Yerel deponun bulunduğu düğümde, yerel depoyu /opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz adlı tek bir .tar dosyası olarak 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, bunu yeni düğümdeki /tmp dizinine kopyalayın.
  3. Yeni düğümde SELinux'u yukarıda açıklandığı şekilde 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 (internet erişimi olmayan bir makineye yüklediğiniz için bu şekilde olması gerekir):
    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. Yeni düğümde yerel deponuzdan yum-utils ve yum-plugin-priorities eklentisini yükleyin:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities

    Yum araçlarını yükleyebilmeniz için operasyon ekibinizin veya kuruluşunuzdaki başka bir grubun yerel bir depo oluşturması gerekir.

  7. Yeni düğümde, libdb4 sürümünüzü yukarıda açıklandığı şekilde kontrol edin.
  8. Oracle 7.x'e yükleme yapıyorsanız aşağıdaki komutu çalıştırın:
    sudo yum-config-manager --enable ol7_optional_latest
  9. AWS'ye yüklüyorsanız aşağıdaki yum-configure-manager komutunu çalıştırın:
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. Yeni düğümde, dosyanın /tmp dizinindeki tarfını kaldırın:
    tar -xzf apigee-4.19.01.tar.gz

    Bu komut, .tar dosyasını içeren dizinde depo adında yeni bir dizin oluşturur. Örneğin /tmp/repos.

  11. Edge Apigee-service yardımcı programını ve bağımlılıkları /tmp/repos kaynağından yükleyin:
    sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Depo dizininin yolunu bu komuta eklediğinize dikkat edin.

  12. apigee-setup yardımcı programını yüklemek için apigee-service uygulamasını kullanın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. 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 bölümüne bakın.

Nginx web sunucusunu kullanarak depodan yükleyin

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ı ve bağlantı noktası 3939 olarak localhost'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ç. Dosyayı yoksa 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 yerine bir kullanıcı adı:şifre 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 yum-utils ve yum-plugin-priorities öğelerini yükleyin:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  5. Yeni düğümde SELinux'u yukarıda açıklandığı şekilde devre dışı bırakın.
  6. Yeni düğümde, yerel EPEL deposunun etkin olduğundan emin olun.
  7. Yeni düğümde, libdb4 sürümünüzü yukarıda açıklandığı şekilde kontrol edin.
  8. Uzak düğümde, Edge bootstrap_4.19.01.sh dosyasını /tmp/bootstrap_4.19.01.sh hedefine indirin:
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

    Burada uName:pWord, depo için yukarıda belirlediğiniz kullanıcı adı ve şifre, remoteRepo ise depo düğümünün IP adresi veya DNS adıdır.

  9. Uzak düğümde Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
    sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

  10. Uzak düğümde apigee-service kullanarak apigee-setup yardımcı programını yükleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. 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 bölümüne bakın.

Yerel Apigee deposu güncelleme

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

Depoyu güncellemek için:

  1. Edge bootstrap_4.19.01.sh dosyasını /tmp/bootstrap_4.19.01.sh hedefine indirin:
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  2. Edge bootstrap_4.19.01.sh dosyasını çalıştırın:
    sudo bash/tmp/bootstrap_4.19.01.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ı taşımak istiyorsanız:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Yerel Apigee deposunu temizleme

Yerel depoyu temizleme /opt/../..//data/become-mirror ve /var/tmp/yum-impression-*.

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

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

4.19.01 deposunda Edge 4.16.0x/4.17.0x ekleme veya güncelleme

4.19.01 deposunda Edge 4.16.0x veya 4.17.0x için yüklemeleri sürdürmeniz gerekiyorsa tüm sürümleri içeren bir depoya sahip olabilirsiniz. Bu depodan dilediğiniz Edge sürümünü yükleyebilirsiniz.

4.19.01 kod deposuna 4.16.0x/4.17.0x eklemek için:

  1. apigee-mirror yardımcı programının 4.19.01 sürümünü yüklediğinizden emin olun:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    Aşağıdaki formda bir sonuç göreceksiniz. Burada xyz, yapı numarasıdır:

    apigee-mirror-4.19.01-0.0.xyz
  2. apigee-mirror yardımcı programını kullanarak Edge 4.16.0x/4.17.0x'i deponuza indirin. Komutun önüne istenen sürümü nasıl eklediğinize dikkat edin:
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Aynı komutu daha sonra gerekli sürüm numaralarını belirterek 4.16.0x/4.17.0x depolarını güncellemek için kullanın.

  3. Dosya yapısını görmek için /opt/apigee/data/apigee-mirror/repos dizinini inceleyin:
    ls /opt/apigee/data/apigee-mirror/repos

    Şu dosyaları ve dizinleri görmeniz gerekir:

    apigee
    apigee-repo-1.0-6.x86_64.rpm
    bootstrap_4.16.01.sh
    bootstrap_4.16.05.sh
    bootstrap_4.17.01.sh
    bootstrap_4.17.05.sh
    bootstrap_4.17.09.sh
    bootstrap_4.18.01.sh
    bootstrap_4.18.05.sh
    bootstrap_4.19.01.sh
    thirdparty

    Edge'in tüm sürümleri için önyükleme dosyanıza dikkat edin. apigee dizini, Edge'in her sürümü için ayrı dizinler de içerir.

  4. Depoyu .tar dosyası olarak paketlemek için aşağıdaki komutu kullanın:
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    Bu komut tüm 4.17.0x ve 4.16.0x depolarını aynı .tar dosyasında paketler. Deponun yalnızca bir kısmını paketleyemezsiniz.

Edge'i yerel depodan veya .tar dosyasından yüklemek için aşağıdaki komutlardan birini kullanarak doğru önyükleme dosyasını çalıştırdığınızdan emin olun. Bu örnekte Edge 4.17.01 yüklenir:

  • .tar dosyasından yüklüyorsanız depodan doğru önyükleme dosyasını çalıştırın:
    sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Yüklemeyi tamamlamak için yukarıdaki ".tar dosyasından yükleme" bölümünde kalan adımları uygulayın.

  • Nginx web sunucusunu kullanarak yüklüyorsanız depodan doğru önyükleme dosyasını indirip çalıştırın:
    /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
    sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    Yüklemeyi tamamlamak için yukarıdaki "Nginx web sunucusunu kullanarak depodan yükleme" bölümünde belirtilen kalan adımları uygulayın.