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ı 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 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 Gereksinimleri'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 geçici olarak izin verici moda ayarlamak için aşağıdaki komutu çalıştırın:
  • 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

  • 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 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ştirin

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

• Red Hat Enterprise Linux (RHEL) 8.0 için RHEL 8 için ön koşullar başlıklı makaleyi inceleyin.

• Red Hat/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

• Red Hat/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

• AWS-2 için:

  sudo amazon-linux-extras install epel -y
  sudo yum-config-manager --enable epel

Ö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'in 4.8 sürümü gerekir. Bazı RedHat 7.4 ve CentOS 7.4 sürümleri ise daha yeni bir sürümle birlikte gönderilir. Daha yeni bir sürüme sahipseniz bu sürümün yüklemesini kaldırın. Edge yükleyici 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 sonraki bir sürüm olduğunu görürseniz bu sürümü kaldırın.

RHEL 8'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 (EPEL) için Ek Paketler'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

3. Python 2'yi yükleyin ve sembolik bağlantı oluşturun:

   sudo dnf install -y python2
   sudo ln -s /usr/bin/python2 /usr/bin/python

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'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 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. yum-utils ve yum-plugin-priorities uygulamalarını yükleyin.

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. SELinux'u devre dışı bırakın.
5. EPEL deposunu etkinleştirin.
6. libdb4 sürümünüzü kontrol edin.
7. RHEL 8'e yüklüyorsanız RHEL 8 için ön koşullar başlıklı makaledeki adımları uygulayın.
8. Oracle 7.x'e yüklüyorsanız aşağıdaki komutu çalıştırın:

   sudo yum-config-manager --enable ol7_optional_latest

9. AWS'ye yükleme yapı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

10. Edge bootstrap_4.52.00.sh dosyasını /tmp/bootstrap_4.52.00.sh'a indirin:

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

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

    sudo bash /tmp/bootstrap_4.52.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: Çık. 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*'

12. apigee-setup yardımcı programını yüklemek için apigee-service 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 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:// : @ software.apigee.com//apigee-repo-version.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

Aşağıdaki tabloda bu hataların bazı olası çözümleri 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

Edge düğümleriniz bir güvenlik duvarının arkasındaysa veya herhangi bir şekilde internete erişmesi yasaklanıyorsa yükleme sırasında ihtiyaç duyacağınız dosyaları içeren birkaç depo veya yansıtma 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:

• Apigee Edge deposu: Yerel Apigee deposu oluşturma bölümünde açıklandığı şekilde.
• Yum deposu (yum-utils ve yum-plugin-priorities gibi yardımcı programlar için): Operasyon ekibiniz bunu sizin için ayarlayabilir.
• Enterprise Linux (veya EPEL) için Ek Paketler: Bu ayarı operasyon ekibiniz sizin için yapabilir.

Yerel 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üğümünüz olmalıdı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 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 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.52.00.sh dosyasını /tmp/bootstrap_4.52.00.sh'a indirin:

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

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

   sudo bash /tmp/bootstrap_4.52.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.

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 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 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.52.00.sh komutunu çalıştırın:

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.52.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.

Yerel depodan apigee-setup'u 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 bir .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, kullanabileceğiniz Nginx web sunucusunu sağlar veya kendi web sunucunuzu kullanabilirsiniz.

.tar dosyasından yükleme

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

1. Yerel deponun bulunduğu düğümde, yerel deposu /opt/apigee/data/apigee-mirror/apigee-4.52.00.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, 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 havuzlarının devre dışı bırakıldığından emin olun (bunun nedeni, internet erişimi olmayan bir makineye yükleme yapmanızdı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. Yeni düğümde, yerel deponuzda yum-utils ve yum-plugin-priorities'yi 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, yukarıda açıklandığı şekilde libdb4 sürümünüzü kontrol edin.
8. Oracle 7.x'e yüklüyorsanız aşağıdaki komutu çalıştırın:

   sudo yum-config-manager --enable ol7_optional_latest

9. AWS'ye yükleme yapıyorsanız şu 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 dizininde aç:

    tar -xzf apigee-4.52.00.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 adresinden yükleyin:

    sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Bu komuta repos dizininin yolunu eklediğinizi unutmayın.

12. apigee-setup yardımcı programını yüklemek için apigee-service'ü 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 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 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 şeklinde bir username:ş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üğüme yum-utils ve yum-plugin-priorities uygulamalarını 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 etkinleştirildiğinden emin olun.
7. Yeni düğümde, libdb4 sürümünüzü yukarıda açıklanan şekilde kontrol edin.
8. Uzak düğümde Edge bootstrap_4.52.00.sh dosyasını /tmp/bootstrap_4.52.00.sh konumuna indirin:

   curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh

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

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

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

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

10. Uzak düğümde apigee-service işlevini 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 başlıklı makaleyi inceleyin.

Yerel Apigee deposunu güncelleme

Depoyu güncellemek için en son bootstrap_4.52.00.sh dosyasını indirip yeni bir senkronizasyon yapmanız gerekir.

Repoyu güncellemek için:

1. Edge bootstrap_4.52.00.sh dosyasını /tmp/bootstrap_4.52.00.sh'e indirin:

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

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

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

   Burada uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord adımını atlarsanız 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 bir Apigee deposunu temizleme

Yerel depo temizlendiğinde /opt/apigee/data/apigee-mirror ve /var/tmp/yum-apigee-* silinir.

Yerel deposu temizlemek için:

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

4.52.00 deposunda Edge 4.16.0x/4.17.0x sürümünü ekleme veya güncelleme

4.52.00 deposunda Edge 4.16.0x veya 4.17.0x yüklemelerini korumanız gerekiyorsa tüm sürümleri içeren bir depo oluşturabilirsiniz. Bu depoda Edge'in herhangi bir sürümünü yükleyebilirsiniz.

4.16.0x/4.17.0x sürümünü 4.52.00 depoya eklemek için:

1. apigee-mirror yardımcı programının 4.52.00 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örmeniz gerekir. Burada xyz, derleme numarasıdır:

   apigee-mirror-4.52.00-0.0.xyz

2. Edge 4.16.0x/4.17.0x sürümünü reponuza indirmek için apigee-mirror yardımcı programını kullanın. Komuta nasıl istenen sürümün önekini eklediğinize dikkat edin:

   apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

   Gerekli sürüm numaralarını belirterek 4.16.0x/4.17.0x depolarını daha sonra güncellemek için de 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öreceksiniz:

   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 bir önyükleme dosyanız olduğunu unutmayın. apigee dizini, Edge'in her sürümü için ayrı dizinler de içerir.

4. Depoyu .tar dosyasına 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ına paketler. Yalnızca deponun bir bölümü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ırmanız yeterlidir. Bu örnekte Edge 4.17.01 yüklenir:

• .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ündeki 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ündeki kalan adımları uygulayın.