Instalowanie narzędzia Edge apigee

Aby zainstalować Edge w węźle, najpierw zainstaluj narzędzie Edge apigee-setup. Jeśli pracujesz w środowisku, w którym węzły nie mają zewnętrznego połączenia z internetem, musisz też zainstalować lokalną kopię repozytorium Apigee.

Domyślny katalog instalacji: /opt/apigee

Edge instaluje wszystkie pliki w katalogu /opt/apigee. Nie możesz zmienić tego katalogu. Jeśli jednak chcesz, możesz utworzyć dowiązanie symboliczne, aby zmapować /opt/apigee na inną lokalizację. Więcej informacji znajdziesz w artykule Wymagania dotyczące instalacji.

Wymaganie wstępne: wyłączenie SELinux

Przed zainstalowaniem narzędzia Edge apigee-setup lub dowolnych komponentów Edge musisz wyłączyć SELinux lub ustawić go w trybie permissive. W razie potrzeby po zainstalowaniu Edge możesz ponownie włączyć SELinux.

• Aby tymczasowo ustawić SELinux w trybie permissive, uruchom to polecenie:
  1. W systemie operacyjnym Linux 6.x:

     sudo echo 0 > /selinux/enforce

     Aby ponownie włączyć SELinux po zainstalowaniu Edge:

     sudo echo 1 > /selinux/enforce

  2. W systemie operacyjnym Linux 7.x:

     sudo setenforce 0

     Aby ponownie włączyć SELinux po zainstalowaniu Edge:

     sudo setenforce 1

• Aby na stałe wyłączyć SELinux lub ustawić go w trybie permisywnym:
  1. Otwórz plik /etc/sysconfig/selinux w edytorze.
  2. Ustaw SELINUX=disabled lub SELINUX=permissive
  3. Zapisz zmiany.
  4. Uruchom ponownie węzeł.
  5. W razie potrzeby po instalacji Edge ponownie włącz SELinux, powtarzając tę procedurę, aby ustawić SELINUX=enabled.

Wymaganie wstępne: włącz repozytorium EPEL

Aby zainstalować lub zaktualizować Edge albo utworzyć repozytorium lokalne, musisz włączyć Extra Packages for Enterprise Linux (EPEL). Polecenie, którego użyjesz, zależy od wersji RedHat/CentOS:

• W przypadku RedHat/CentOS/Oracle 7.x:

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

• W przypadku RedHat/CentOS/Oracle 6.x:

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

Warunek wstępny: sprawdź wersję biblioteki libdb4 w systemach RedHat 7.4 i CentOS 7.4

W systemach RedHat 7.4 i CentOS 7.4 przed instalacją sprawdź wersję pakietów RPM libdb4. Edge wymaga wersji 4.8, a niektóre wersje RedHat 7.4 i CentOS 7.4 są dostarczane z nowszą wersją. Jeśli masz nowszą wersję, odinstaluj ją, a instalator Edge zainstaluje wersję 4.8.

Aby sprawdzić wersję, możesz użyć tego polecenia:

rpm -qa | grep libdb4

Jeśli widzisz, że wersja RPM libdb4 jest nowsza niż 4.8, odinstaluj ją.

Instalowanie narzędzia apigee-setup Edge na węźle z zewnętrznym połączeniem internetowym

Aby zainstalować Edge na węźle z zewnętrznym połączeniem internetowym:

1. Uzyskaj od Apigee nazwę użytkownika i hasło, których używasz do uzyskiwania dostępu do repozytorium Apigee. Jeśli masz już username:password do witryny FTP Apigee, możesz użyć tych danych logowania.
2. Zaloguj się w węźle jako użytkownik root, aby zainstalować pakiety RPM Edge.
   
3. Zainstaluj yum-utils i yum-plugin-priorities:

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

4. Wyłącz SELinux w sposób opisany powyżej.
5. Włącz repozytorium EPEL w sposób opisany powyżej.
6. Sprawdź wersję libdb4, jak opisano powyżej.
7. Jeśli instalujesz na Oracle 7.x,uruchom to polecenie:

   sudo yum-config-manager --enable ol7_optional_latest

8. Jeśli instalujesz na AWS, uruchom te polecenia yum-configure-manager:

   yum update rh-amazon-rhui-client.noarch
   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

9. Pobierz plik Edge bootstrap_4.19.06.sh do /tmp/bootstrap_4.19.06.sh:

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

10. Zainstaluj narzędzie Edge apigee-service i zależności:

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

    Gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.

    Domyślnie instalator sprawdza, czy masz zainstalowaną Javę 1.8. Jeśli nie, zainstaluje ją za Ciebie. Użyj opcji JAVA_FIX, aby określić sposób obsługi instalacji Javy. JAVA_FIX przyjmuje te wartości:

    • I: Zainstaluj OpenJDK 1.8 (domyślnie)
    • C: Kontynuuj bez instalowania Javy
    • P: Quit. W przypadku tej opcji musisz samodzielnie zainstalować Javę.

    Instalacja narzędzia apigee-service powoduje utworzenie pliku /etc/yum.repos.d/apigee.repo, który definiuje repozytorium Apigee. Aby wyświetlić plik definicji, użyj polecenia:

    cat /etc/yum.repos.d/apigee.repo

    Aby wyświetlić zawartość repozytorium, użyj tego polecenia:

    sudo yum -v repolist 'apigee*'

11. Użyj apigee-service, aby zainstalować narzędzie apigee-setup:
    

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

12. Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge w węźle. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge w węźle.

Rozwiązywanie problemów

Podczas próby instalacji na węźle z zewnętrznym połączeniem internetowym możesz napotkać co najmniej jeden z tych błędów:

Cannot open: https:// : @ software.apigee.com//apigee-repo-version.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

W tabeli poniżej znajdziesz kilka możliwych rozwiązań tych błędów:

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

Instalowanie narzędzia apigee-setup Edge na węźle bez zewnętrznego połączenia z internetem

Jeśli węzły brzegowe znajdują się za zaporą sieciową lub w inny sposób nie mają dostępu do internetu, musisz utworzyć kilka repozytoriów lub kopii lustrzanych zawierających pliki, które będą potrzebne podczas instalacji. Te kopie lustrzane muszą być dostępne dla wszystkich węzłów. Po utworzeniu węzły mogą uzyskiwać dostęp do tych lokalnych kopii lustrzanych, aby zainstalować Edge.

Proces instalacji Apigee Edge na węzłach bez połączenia z internetem wymaga dostępu do tych lokalnych repozytoriów:

• Repozytorium Apigee Edge: zgodnie z opisem w artykule Tworzenie lokalnego repozytorium Apigee.
• Repozytorium Yum (dla narzędzi takich jak yum-utils i yum-plugin-priorities): Twój zespół operacyjny powinien być w stanie skonfigurować to dla Ciebie.
• Extra Packages for Enterprise Linux (EPEL): Twój zespół operacyjny powinien być w stanie skonfigurować to za Ciebie.

Tworzenie lokalnego repozytorium Apigee

Aby utworzyć wewnętrzne repozytorium Apigee, musisz mieć węzeł z zewnętrznym dostępem do internetu, aby móc pobierać pakiety RPM i zależności Edge. Po utworzeniu repozytorium wewnętrznego możesz je przenieść do innego węzła lub udostępnić ten węzeł węzłom Edge na potrzeby instalacji.

Po utworzeniu lokalnego repozytorium Apigee może być konieczne zaktualizowanie go za pomocą najnowszych plików wersji Edge. W kolejnych sekcjach opisano, jak utworzyć lokalne repozytorium Apigee i jak je zaktualizować.

Aby utworzyć lokalne repozytorium Apigee:

1. Uzyskaj od Apigee nazwę użytkownika i hasło, których używasz do uzyskiwania dostępu do repozytorium Apigee. Jeśli masz już nazwę użytkownika i hasło do witryny FTP Apigee, możesz użyć tych danych logowania.
2. Zaloguj się w węźle jako użytkownik root, aby zainstalować pakiety RPM Edge.
   
3. Wyłącz SELinux w sposób opisany powyżej.
4. Pobierz plik Edge bootstrap_4.19.06.sh do /tmp/bootstrap_4.19.06.sh:

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

5. Zainstaluj narzędzie Edge apigee-service i zależności:
   

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

   Gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.

6. Zainstaluj narzędzie apigee-mirror w węźle:

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

7. Użyj narzędzia apigee-mirror, aby zsynchronizować repozytorium Apigee z katalogiem /opt/apigee/data/apigee-mirror/repos/.

   Aby zminimalizować rozmiar repozytorium, dodaj --only-new-rpms, aby pobrać tylko najnowsze pakiety RPM. Do pobrania potrzebujesz około 1,6 GB miejsca na dysku:

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

   Jeśli chcesz pobrać całe repozytorium, w tym starsze pakiety RPM, pomiń --only-new-rpms. Do pobrania wszystkich danych potrzebujesz około 6 GB miejsca na dysku:

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

   Masz teraz lokalną kopię repozytorium Apigee. Następna sekcja zawiera informacje o instalowaniu narzędzia Edge apigee-setup z lokalnego repozytorium.

8. (Opcjonalnie) Jeśli chcesz zainstalować Edge z lokalnego repozytorium w tym samym węźle, który hostuje lokalne repozytorium, musisz najpierw uruchomić te polecenia:
   1. Uruchom bootstrap_4.19.06.sh z lokalnego repozytorium, aby zainstalować narzędzie apigee-service:

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

   2. Użyj apigee-service, aby zainstalować narzędzie apigee-setup:

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

   3. Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge w węźle. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge w węźle.

Instalowanie apigee-setup na węźle zdalnym z repozytorium lokalnego

Możesz zainstalować Edge z lokalnego repozytorium na 2 sposoby. Możesz:

• Utwórz plik .tar repozytorium, skopiuj go do węzła, a następnie zainstaluj Edge z pliku .tar.
• Zainstaluj serwer WWW w węźle z lokalnym repozytorium, aby inne węzły miały do niego dostęp. Apigee udostępnia serwer WWW Nginx, ale możesz też użyć własnego serwera WWW.

Instalowanie z pliku .tar

Aby zainstalować z pliku .tar:

1. W węźle z lokalnym repozytorium użyj tego polecenia, aby spakować lokalne repozytorium do jednego pliku .tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.19.06.tar.gz:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

2. Skopiuj plik .tar do węzła, w którym chcesz zainstalować Edge. Możesz go na przykład skopiować do katalogu /tmp w nowym węźle.
3. Na nowym węźle wyłącz SELinux zgodnie z opisem powyżej.
4. Upewnij się, że na nowym węźle masz dostęp do lokalnego repozytorium narzędzia Yum i repozytorium EPEL.
5. Sprawdź, czy wszystkie zewnętrzne repozytoria internetowe są wyłączone (powinno tak być, ponieważ instalujesz na komputerze bez dostępu do internetu):

   sudo yum repolist

   Wszystkie repozytoria zewnętrzne powinny być wyłączone, ale lokalne repozytorium Apigee i repozytoria wewnętrzne powinny być włączone.

6. Na nowym węźle zainstaluj yum-utils i yum-plugin-priorities z lokalnego repozytorium:

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

   Aby można było zainstalować narzędzia Yum, zespół operacyjny lub inna grupa w organizacji musi skonfigurować lokalne repozytorium.

7. Na nowym węźle sprawdź wersję libdb4 w sposób opisany powyżej.
8. Jeśli instalujesz na Oracle 7.x,uruchom to polecenie:

   sudo yum-config-manager --enable ol7_optional_latest

9. Jeśli instalujesz na AWS, uruchom to polecenie yum-configure-manager:

   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

10. Na nowym węźle rozpakuj plik do katalogu /tmp:

    tar -xzf apigee-4.19.06.tar.gz

    To polecenie tworzy nowy katalog o nazwie repos w katalogu zawierającym plik .tar. Na przykład /tmp/repos.

11. Zainstaluj narzędzie Edge apigee-service i zależności z /tmp/repos:

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

    Zwróć uwagę, że w tym poleceniu podajesz ścieżkę do katalogu repozytoriów.

12. Użyj apigee-service, aby zainstalować narzędzie apigee-setup:

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

13. Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge w węźle. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge w węźle.

Instalowanie z repozytorium przy użyciu serwera WWW Nginx

Aby zainstalować z repozytorium za pomocą serwera WWW Nginx:

1. Zainstaluj serwer WWW Nginx w węźle repozytorium:
   

   opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig

2. Domyślnie Nginx jest skonfigurowany do używania localhost jako nazwy serwera i portu 3939. Aby zmienić te wartości:
   1. Otwórz plik /opt/apigee/customer/application/mirror.properties w edytorze. Jeśli plik nie istnieje, utwórz go.
   2. W razie potrzeby ustaw te wartości:

      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost

   3. Uruchom ponownie Nginx:

      /opt/nginx/scripts/apigee-nginx restart

3. Domyślnie repozytorium wymaga nazwy użytkownika i hasła:admin:admin. Aby zmienić te dane logowania, ustaw te zmienne środowiskowe:

   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord

4. Na nowym węźle zainstaluj yum-utils i yum-plugin-priorities:

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

5. Na nowym węźle wyłącz SELinux zgodnie z opisem powyżej.
6. Sprawdź, czy w nowym węźle jest włączone lokalne repozytorium EPEL.
7. Na nowym węźle sprawdź wersję libdb4 w sposób opisany powyżej.
8. Na węźle zdalnym pobierz plik Edge bootstrap_4.19.06.sh do /tmp/bootstrap_4.19.06.sh:

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

   Gdzie uName:pWord to nazwa użytkownika i hasło ustawione powyżej dla repozytorium, a remoteRepo to adres IP lub nazwa DNS węzła repozytorium.

9. W węźle zdalnym zainstaluj narzędzie Edge apigee-service i zależności:

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

   Gdzie uName:pWord to nazwa użytkownika i hasło do repozytorium.

10. Na węźle zdalnym użyj apigee-service, aby zainstalować narzędzie apigee-setup:

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

11. Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge w węźle zdalnym. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge w węźle.

Aktualizowanie lokalnego repozytorium Apigee

Aby zaktualizować repozytorium, musisz pobrać najnowszy plik bootstrap_4.19.06.sh, a następnie przeprowadzić nową synchronizację.

Aby zaktualizować repozytorium:

1. Pobierz plik Edge bootstrap_4.19.06.sh do /tmp/bootstrap_4.19.06.sh:

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

2. Uruchom plik Edge bootstrap_4.19.06.sh:

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

   Gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.

3. Zaktualizuj: apigee-mirror:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update

4. Przeprowadź synchronizację:

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

5. Jeśli chcesz pobrać całe repozytorium:

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

Czyszczenie lokalnego repozytorium Apigee

Czyszczenie lokalnego repozytorium powoduje usunięcie katalogów /opt/apigee/data/apigee-mirror i /var/tmp/yum-apigee-*.

Aby wyczyścić lokalne repozytorium, użyj polecenia:

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

Dodawanie lub aktualizowanie Edge 4.16.0x/4.17.0x w repozytorium 4.19.06

Jeśli musisz utrzymywać instalacje Edge 4.16.0x lub 4.17.0x w repozytorium 4.19.06, możesz utrzymywać repozytorium zawierające wszystkie wersje. Z tego repozytorium możesz zainstalować dowolną wersję Edge.

Aby dodać wersję 4.16.0x/4.17.0x do repozytorium 4.19.06:

1. Sprawdź, czy masz zainstalowaną wersję 4.19.06 narzędzia apigee-mirror:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

   Powinien pojawić się wynik w formie poniżej, gdzie xyz to numer kompilacji:

   apigee-mirror-4.19.06-0.0.xyz

2. Użyj narzędzia apigee-mirror, aby pobrać Edge 4.16.0x/4.17.0x do repozytorium. Zwróć uwagę, że przed poleceniem należy podać żądaną wersję:

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

   Użyj tego samego polecenia, aby później zaktualizować repozytoria 4.16.0x/4.17.0x, podając wymagane numery wersji.

3. Sprawdź strukturę plików w katalogu /opt/apigee/data/apigee-mirror/repos:

   ls /opt/apigee/data/apigee-mirror/repos

   Powinny wyświetlić się te pliki i katalogi:

   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

   Zwróć uwagę, że masz plik bootstrap dla wszystkich wersji Edge. Katalog apigee zawiera też osobne katalogi dla każdej wersji Edge.

4. Aby spakować repozytorium do pliku .tar, użyj tego polecenia:
   

   apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   To polecenie pakuje wszystkie repozytoria 4.17.0x i 4.16.0x do tego samego pliku .tar. Nie możesz spakować tylko części repozytorium.

Aby zainstalować Edge z lokalnego repozytorium lub pliku .tar, uruchom odpowiedni plik bootstrap za pomocą jednego z tych poleceń. Ten przykład instaluje Edge 4.17.01:

• Jeśli instalujesz z pliku .tar, uruchom odpowiedni plik bootstrap z repozytorium:
  

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

  Aby dokończyć instalację, wykonaj pozostałe czynności opisane powyżej w sekcji „Instalowanie z pliku .tar”.

• Jeśli instalujesz za pomocą serwera WWW Nginx, pobierz i uruchom odpowiedni plik bootstrap z repozytorium:

  /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://

  Aby dokończyć instalację, wykonaj pozostałe czynności opisane powyżej w sekcji „Instalowanie z repozytorium przy użyciu serwera WWW Nginx”.