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

Edge for Private Cloud 4.18.01 sürümü

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ı olmayan bir ortamda bulunuyorsanı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'yi 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ükleyebilmek için SELinux'u devre dışı bırakmanız ya da izin verilenler moduna ayarlamanız gerekir. Gerekirse Edge'i yükledikten sonra SELinux'u yeniden etkinleştirebilirsiniz.

  • SELinux'u geçici olarak izin verici 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 izin verilen 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 kurulumundan sonra bu prosedürü tekrarlayarak SELinux'u yeniden etkinleştirin ve SELINUX=enabled olarak ayarlayın.

Ö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'i (veya EPEL) 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'te libdb4 kitaplık sürümünü kontrol edin

RedHat 7.4 ve CentOS 7.4'te, yüklemeden önce libdb4 RPM'lerinin sürümünü kontrol edin. Edge, 4.8 sürümünü gerektirir ve RedHat 7.4 ile CentOS 7.4'ün bazı sürümleri daha yeni bir sürümle birlikte gelir. Daha yeni bir sürümünüz varsa bu sürümü kaldırın. Edge yükleyici, 4.8 sürümünü yükleyecektir.

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

> rpm -qa | grep libdb4

libdb4 RPM sürümünün 4.8'den sonraki bir sürüm olduğunu görürseniz bu sürümü kaldırın.

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

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 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
    Not: RPM yüklemesi için root erişimi gerekir ancak Edge yapılandırmasını root erişimi olmadan gerçekleştirebilirsiniz.
  3. yum-utils ve yum-plugin-priorities paketlerini 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ığı şekilde etkinleştirin.
  6. Yukarıda açıklandığı şekilde libdb4 sürümünüzü kontrol edin.
  7. Oracle 7.x'e yüklü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.18.01.sh dosyasını /tmp/bootstrap_4.18.01.sh dizinine indirin:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  10. Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
    > sudo bash /tmp/bootstrap_4.18.01.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.

    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 kurulumunun nasıl yapılacağını belirtmek için JAVA_FIX seçeneğini kullanın. JAVA_FIX şu değerleri alır:

    I = OpenJDK 1.8'i yükle (varsayılan)
    C = Java'yı yüklemeden devam et
    Q = Çı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/apigee.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çeriklerini 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üğü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.

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 Apigee deposuna internet üzerinden erişmesi engelleniyorsa Apigee deposunun yerel bir deposunu veya yansısını oluşturmanız gerekir. Bu yansıtma tüm düğümler tarafından erişilebilir olmalıdır. Oluşturulduktan sonra düğümler, Edge'i yüklemek için bu yerel yansıya erişebilir.

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.

Not: Apigee, herkese açık depolarımızda tüm üçüncü taraf bağımlılıklarını barındırmaz. Bu bağımlılıkları, herkese açık depolardan indirip yüklemeniz gerekir.

Yerel bir Edge 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 depo oluşturma ve güncelleme işlemleri açıklanmaktadır.

Yerel bir Apigee deposu oluşturma

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 kök olarak giriş yapın.
    Not: RPM yüklemesi için kök erişimi gerekir ancak Edge yapılandırmasını kök erişimi olmadan gerçekleştirebilirsiniz.
  3. SELinux'u yukarıda açıklandığı şekilde devre dışı bırakın.
  4. Edge bootstrap_4.18.01.sh dosyasını /tmp/bootstrap_4.18.01.sh dizinine indirin:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  5. Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
    > sudo bash /tmp/bootstrap_4.18.01.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. apigee-mirror yardımcı programını düğüme yükleyin:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

    Not: Mevcut bir depoyu 4.18.01 sürümüne güncelliyorsanız yalnızca apigee-mirror'ı güncellemeniz gerekir:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  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. İ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 RPM'ler de dahil olmak üzere tüm depoyu indirmek istiyorsanız --only-new-rpms ifadesini çıkarın. Tam indirme işlemi için yaklaşık 6 GB disk alanına ihtiyacınız vardır:
    > /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 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.18.01.sh dosyasını çalıştırın:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. 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
    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:

  1. Yerel depoya sahip düğümde, yerel depoyu /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz adlı tek bir.tar dosyasında 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, SELinux'u yukarıda açıklandığı şekilde devre dışı bırakın.
  4. Yeni düğümde, EPEL deposunu yukarıda açıklandığı şekilde etkinleştirin.
  5. Yeni düğümde, tüm harici internet depolarını devre dışı bıraktığınızdan emin olun. Aşağıdaki komutu çalıştırdığınızda tüm harici depolar devre dışı olarak gösterilir ancak yerel Apigee deposu ve dahili depolarınızdan herhangi biri etkinleştirilir:
    > sudo yum repolist
  6. Yeni düğümde yum-utils ve yum-plugin-priorities'i yükleyin:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  7. Yeni düğümde, yukarıda açıklandığı şekilde libdb4 sürümünüzü 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, dosyayı /tmp dizinine açın:
    > tar -xzf apigee-4.18.01.tar.gz

    Bu komut, .tar dosyasını içeren dizinde repos adlı yeni bir dizin oluşturur. Örneğin, /tmp/repos.
  11. Edge apigee-service yardımcı programını ve bağımlılıklarını /tmp/repos dizininden yükleyin:
    > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Bu komutta repos dizininin yolunu eklediğinize dikkat edin.
  12. 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
  13. 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ükleyin:

  1. Depo düğümüne Nginx web sunucusunu yükleyin:
    > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. Varsayılan olarak Nginx, sunucu adı olarak localhost'u ve 3939 numaralı 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 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, admin:admin şeklinde bir kullanıcı adı:şifre 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 yum-utils ve yum-plugin-priorities'i 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, EPEL deposunu yukarıda açıklandığı şekilde etkinleştirin.
  7. Yeni düğümde, yukarıda açıklandığı şekilde libdb4 sürümünüzü kontrol edin.
  8. Uzak düğümde Edge bootstrap_4.18.01.sh dosyasını /tmp/bootstrap_4.18.01.sh konumuna indirin:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

    Burada uName:pWord, depo için yukarıda ayarladığınız 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.18.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-setup yardımcı programını yüklemek için apigee-service'i kullanın:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. Uzak 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 bir Apigee deposunu güncelleme

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

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

    Burada uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord parametresini atlarsanız girmeniz istenir.
  3. apigee-mirror'ı 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. Tüm depoyu senkronize etmek istiyorsanız:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Yerel bir Apigee deposunu temizleme

Yerel depoyu temizlediğinizde /opt/apigee/data/apigee-mirror ve /var/tmp/yum-apigee-* silinir.

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

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

4.18.01 deposuna Edge 4.16.0x/4.17.0x ekleme veya güncelleme

4.18.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 depoyu sürdürebilirsiniz. Bu depodan Edge'in herhangi bir sürümünü yükleyebilirsiniz.

4.16.0x/4.17.0x'i 4.18.01 deposuna eklemek için:

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

    Aşağıdaki biçimde bir sonuç görürsünüz. Burada xyz, derleme numarasıdır:
    apigee-mirror-4.18.01-0.0.xyz
  2. Edge 4.16.0x/4.17.0x'i deponuza indirmek için apigee-mirror yardımcı programını kullanın. Komutun başına istediğiniz sürümü eklediğinize dikkat edin:
    > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Daha sonra 4.16.0x/4.17.0x depolarını güncellemek için gerekli sürüm numaralarını belirterek aynı komutu 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

    Aşağıdaki dosyaları ve dizinleri görmeniz gerekir:
    apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.shbootstrap_4.17.01.sh bootstrap_4.17.05.sh bootstrap_4.17.09.sh bootstrap_4.18.01.sh thirdparty

    Edge'in tüm sürümleri için bir önyükleme dosyanızın olduğuna dikkat edin. apigee dizini, Edge'in her sürümü için ayrı dizinler de içerir.
  4. Depoyu bir .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:

  • Bir .tar dosyasından yükleme yapı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 yer alan kalan adımları uygulayın.
  • Nginx web sunucusunu kullanarak yükleme yapı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 yer alan kalan adımları uygulayın.