Instalowanie narzędzia Edge apigee

Aby zainstalować Edge w węźle, najpierw zainstaluj narzędzie Edge apigee-setup. Jeśli używasz środowiska, w którym Twoje 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 chcesz, możesz utworzyć symboliczny link do mapy /opt/apigee, aby wskazać inną lokalizację. Więcej informacji znajdziesz w wymaganiach dotyczących instalacji.

Warunek wstępny: wyłącz SELinux

Zanim zainstalujesz narzędzie apigee-setup w Edge lub dowolne komponenty Edge, musisz wyłączyć SELinux lub ustawić go w trybie dozwolonym. W razie potrzeby po zainstalowaniu przeglądarki Edge możesz ponownie włączyć SELinux.

  • Aby tymczasowo ustawić SELinux na tryb mniej rygorystyczny, uruchom to polecenie:
    • W systemie operacyjnym Linux 6.x: 
      sudo echo 0 > /selinux/enforce

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

      sudo echo 1 > /selinux/enforce
    • W systemie operacyjnym Linux 7.x: 
      sudo setenforce 0

      Aby ponownie włączyć SELinux po zainstalowaniu przeglądarki 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 ponownie włącz SELinux po instalacji Edge, powtarzając tę procedurę, aby ustawić SELINUX=enabled.

Warunek wstępny: włącz repozytorium EPEL

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

  • W przypadku Red Hat Enterprise Linux (RHEL) 8.0 zobacz wstępujące wymagania dla RHEL 8.

  • Red Hat/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 Red Hat/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
  • AWS-2: 
    sudo amazon-linux-extras install epel -y
sudo yum-config-manager --enable epel

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 późniejszą wersją. Jeśli masz nowszą wersję, odinstaluj ją, a instalator Edge zainstaluje wersję 4.8.

Wersję możesz sprawdzić przy użyciu tego polecenia:

rpm -qa | grep libdb4

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

Wymagania wstępne RHEL 8

Jeśli instalujesz Edge na serwerze z systemem Red Hat Enterprise Linux (RHEL) 8, przed przeprowadzeniem instalacji wykonaj te czynności:

  1. Włącz dodatkowe pakiety dla Enterprise Linux (EPEL): 
    sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
  2. Wyłączanie serwerów Postgres i Nginx: 
    sudo dnf module disable postgresql
sudo dnf module disable nginx
  3. Zainstaluj Pythona 2 i utwórz skrót symboliczny: 
    sudo dnf install -y python2
sudo ln -s /usr/bin/python2 /usr/bin/python

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

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

  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ż konto username:password w witrynie FTP Apigee, możesz użyć tych danych.
  2. Zaloguj się na węźle jako 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.
  5. Włącz repozytorium EPEL.
  6. Sprawdź wersję libdb4.
  7. Jeśli instalujesz na RHEL 8, wykonaj czynności opisane w wymaganiach wstępnych dla RHEL 8.
  8. Jeśli instalujesz na Oracle 7.x, uruchom to polecenie: 
    sudo yum-config-manager --enable ol7_optional_latest
  9. Jeśli instalujesz w 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
  10. Pobierz plik bootstrap_4.52.00.sh z Edge do folderu /tmp/bootstrap_4.52.00.sh: 
    curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
  11. Zainstaluj narzędzie apigee-service i zależne od niego komponenty: 
    sudo bash /tmp/bootstrap_4.52.00.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ą wersję Java 1.8. Jeśli tego nie zrobisz, zostanie ona zainstalowana automatycznie. Aby określić sposób obsługi instalacji Java, użyj opcji JAVA_FIX. JAVA_FIXprzyjmuje te wartości:

    • I: zainstaluj OpenJDK 1.8 (domyślnie)
    • C: kontynuuj bez instalowania Java
    • Pytanie: Zakończ. W tym przypadku musisz samodzielnie zainstalować Javę.

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

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

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

    sudo yum -v repolist 'apigee*'
  12. Użyj polecenia 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 na węźle.

Rozwiązywanie problemów

Podczas próby instalacji na węźle z zewnętrznym połączeniem z internetem może wystąpić jeden lub więcej 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 możliwe rozwiązania tych problemów:

Typ błędu Możliwe rozwiązanie
Hasło zawiera nieprawidłowe znaki Nie używaj znaków specjalnych w hasłach Apigee.
Problemy z łącznością

Aby sprawdzić połączenie z siecią, uruchom to polecenie ncat:

nc -v software.apigee.com 443

Powinien pojawić się komunikat podobny do tego:

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

Jeśli nie masz zainstalowanej wersji nc, możesz uruchomić to polecenie telnet:

telnet software.apigee.com 443

Jeśli polecenia się powiedzie, możesz przerwać otwarte połączenie, naciskając CTRL+C.

Jeśli któreś z tych poleceń się nie powiedzie, masz ograniczone połączenie z internetem lub nie masz go wcale. Skontaktuj się z administratorem sieci.
Nieprawidłowe dane logowania

Sprawdź, czy nazwa użytkownika i hasło są prawidłowe.

Sprawdź na przykład, czy pojawia się błąd, gdy próbujesz użyć tego polecenia z nazwą użytkownika i hasłem Apigee:

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
Problemy z serwerem proxy Twoja konfiguracja lokalna używa serwera proxy HTTP wychodzącego i nie została rozszerzona o tę samą konfigurację do menedżera pakietów yum. Sprawdź zmienne środowiskowe: 
echo $http_proxy
echo $https_proxy

W przypadku serwera proxy HTTP wychodzącego użyj jednej z tych opcji:

  • Dodawanie konfiguracji serwera proxy HTTP w /etc/yum.conf
  • Dodawanie globalnej konfiguracji serwera proxy HTTP w /etc/environment

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

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

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

Tworzenie lokalnego repozytorium Apigee

Aby utworzyć wewnętrzne repozytorium Apigee, potrzebujesz węzła z dostępem do zewnętrznego internetu, aby móc pobrać 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ł do instalacji węzłów Edge.

Po utworzeniu lokalnego repozytorium Apigee możesz później zaktualizować je za pomocą najnowszych plików wydania Edge. W następnych sekcjach dowiesz się, jak utworzyć lokalny repozytorium Apigee i jak je zaktualizować.

Aby utworzyć lokalny 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 ich użyć.
  2. Zaloguj się do węzła jako root, aby zainstalować RPM Edge.
  3. Wyłącz SELinux w sposób opisany powyżej.
  4. Pobierz plik bootstrap_4.52.00.sh z Edge do folderu /tmp/bootstrap_4.52.00.sh: 
    curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
  5. Zainstaluj narzędzie apige-service i zależne od niego komponenty: 
    sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

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

  6. Zainstaluj na węźle narzędzie apigee-mirror: 
    /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 parametr --only-new-rpms, aby pobrać tylko najnowsze RPM.

  8. (Opcjonalnie) Jeśli chcesz zainstalować Edge z repozytorium lokalnego na tym samym węźle, na którym znajduje się repozytorium lokalne, musisz najpierw uruchomić te polecenia:
    1. Uruchom bootstrap_4.52.00.sh z lokalnego repozytorium, aby zainstalować narzędzie apigee-service: 
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Aby zainstalować narzędzie apigee-setup, użyj narzędzia apigee-service: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. Aby zainstalować i skonfigurować komponenty Edge na węźle, użyj polecenia apigee-setup. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge na węźle.

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

Masz 2 opcje instalacji Edge z repozytorium lokalnego. Możesz:

  • Utwórz plik .tar repozytorium, skopiuj plik .tar do węzła, a potem 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. Na węźle z lokalnym repozytorium użyj tego polecenia, aby spakować lokalne repozytorium do pojedynczego pliku tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.52.00.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 na przykład skopiować go do katalogu /tmp w nowym węźle.
  3. W nowym węźle wyłącz SELinux w sposób opisany powyżej.
  4. Na nowym węźle sprawdź, czy masz dostęp do lokalnego repozytorium 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 repozytorium lokalne Apigee i repozytoria wewnętrzne powinny być włączone.

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

    Aby móc zainstalować narzędzia Yum, musisz mieć skonfigurowane lokalne repozytorium. Może to zrobić zespół operacyjny lub inna grupa w Twojej organizacji.

  7. W nowym węźle sprawdź wersję libdb4, jak opisano powyżej.
  8. Jeśli instalujesz 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. W nowym węźle wyciągnij plik z katalogu /tmp: 
    tar -xzf apigee-4.52.00.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 witryny /tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Zwróć uwagę, że w tym poleceniu musisz podać ścieżkę do katalogu repozytorium.

  12. Aby zainstalować narzędzie apigee-setup, użyj narzędzia apigee-service: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Aby zainstalować i skonfigurować komponenty Edge na węźle, użyj polecenia apigee-setup. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge na węźle.

Instalowanie z repozytorium za pomocą 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 tak, aby używać localhost jako nazwy serwera i portu 3939. Aby zmienić te wartości:
    1. Otwórz plik /opt/apigee/customer/application/mirror.properties w edytorze. Utwórz plik, jeśli go nie ma.
    2. W razie potrzeby ustaw te wartości: 
      conf_apigee_mirror_listen_port=3939
conf_apigee_mirror_server_name=localhost
    3. Ponownie uruchom Nginx: 
      /opt/nginx/scripts/apigee-nginx restart
  3. Domyślnie repozytorium wymaga nazwy użytkownika:hasło admin:admin. Aby zmienić te dane logowania, ustaw te zmienne środowiskowe: 
    MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
  4. W nowym węźle zainstaluj yum-utils i yum-plugin-priorities. 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. W nowym węźle wyłącz SELinux w sposób opisany powyżej.
  6. Na nowym węźle sprawdź, czy lokalne repozytorium EPEL jest włączone.
  7. W nowym węźle sprawdź wersję instancji libdb4 w sposób opisany powyżej.
  8. Na węźle zdalnym pobierz plik bootstrap_4.52.00.sh Edge do folderu /tmp/bootstrap_4.52.00.sh: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.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. Na węźle zdalnym zainstaluj narzędzie apigee-service i zależne od niego komponenty: 
    sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    Gdzie uName:pWord to nazwa użytkownika i hasło 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 na węźle zdalnym. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge na węźle.

Aktualizowanie lokalnego repozytorium Apigee

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

Aby zaktualizować repozytorium:

  1. Pobierz plik bootstrap_4.52.00.sh z Edge do folderu /tmp/bootstrap_4.52.00.sh: 
    curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
  2. Uruchom plik bootstrap_4.52.00.sh w Edge: 
    sudo bash/tmp/bootstrap_4.52.00.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. Aktualizacja 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 utworzyć całe repozytorium: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Czyszczenie lokalnego repozytorium Apigee

Wyczyszczenie lokalnego repozytorium spowoduje usunięcie plików /opt/apigee/data/apigee-mirror i /var/tmp/yum-apigee-*.

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

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

Dodaj lub zaktualizuj Edge 4.16.0x/4.17.0x w repozytorium w wersji 4.52.00

Jeśli musisz obsługiwać instalacje przeglądarki Edge w wersji 4.16.0x lub 4.17.0x w repozytorium 4.52.00, możesz obsługiwać repozytorium, które zawiera wszystkie wersje. Z tego repozytorium możesz zainstalować dowolną wersję przeglądarki Edge.

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

  1. Upewnij się, że masz zainstalowaną wersję 4.52.00 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.52.00-0.0.xyz
  2. Pobierz Edge 4.16.0x/4.17.0x do repozytorium za pomocą narzędzia apigee-mirror. Zwróć uwagę, że polecenie musi być poprzedzone nazwą wersji: 
    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ź katalog /opt/apigee/data/apigee-mirror/repos, aby zobaczyć strukturę plików: 
    ls /opt/apigee/data/apigee-mirror/repos

    Powinny się wyświetlić 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 tworzy pakiet wszystkich repozytoriów 4.17.0x i 4.16.0x w tym samym pliku tar. Nie można skompilować tylko części repozytorium.

Aby zainstalować Edge z lokalnego repozytorium lub pliku tar, uruchom odpowiedni plik bootstrap, używając jednego z tych poleceń. W tym przykładzie instalowana jest wersja 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 kroki opisane w sekcji „Instalowanie z pliku .tar” powyżej.

  • Jeśli instalujesz z użyciem serwera WWW Nginx, pobierz z repozytorium odpowiedni plik wczytywania i uruchom go: 
    /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”.