Instalowanie narzędzia Edge apigee

Edge for Private Cloud wer. 4.17.09

Aby zainstalować Edge w węźle, najpierw zainstaluj narzędzie Edge apigee-setup. Jeśli jesteś w środowisku, w którym węzły nie mają zewnętrznego połączenia internetowego, 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. W razie potrzeby możesz jednak utworzyć dowiązanie symboliczne, aby zmapować obiekt /opt/apigee na inną lokalizację. Więcej informacji znajdziesz w sekcji Wymagania dotyczące instalacji.

Wymaganie wstępne: wyłącz SELinux

Przed zainstalowaniem narzędzia Edge apigee-setup lub komponentów Edge musisz wyłączyć funkcję SELinux lub ustawić w niej tryb mniej rygorystyczny. W razie potrzeby po zainstalowaniu Edge możesz ponownie włączyć SELinux.

  • Aby tymczasowo ustawić w SELinux tryb mniej rygorystyczny, wykonaj 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 trwale wyłączyć funkcję SELinux lub ustawić ją w trybie mniej rygorystyczny:
    1. Otwórz plik /etc/sysconfig/selinux w edytorze.
    2. Ustaw SELINUX=disabled lub SELINUX=permissive
    3. Zapisz zmiany.
    4. Ponownie uruchom węzeł.
    5. W razie potrzeby po instalacji Edge włącz ponownie SELinux, wykonując tę procedurę w celu ustawienia SELINUX=enabled.

Wymaganie wstępne: włącz repozytorium EPEL

Aby zainstalować lub zaktualizować Edge albo utworzyć lokalne repozytorium, musisz włączyć dodatkowe pakiety dla systemu Linux (lub EPEL). Wybór polecenia zależy od wersji RedHat/CentOS:

  • Dla 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

Wymaganie wstępne: sprawdź wersję biblioteki libdb4 w systemie RedHat 7.4 i CentOS 7.4

W przypadku RedHat 7.4 i CentOS 7.4 przed instalacją sprawdź wersję RPM libdb4. Edge wymaga wersji 4.8, a niektóre wersje RedHat 7.4 i CentOS 7.4 są dostarczane w nowszej wersji.

Wersję możesz sprawdzić za pomocą tego polecenia:

> rpm -qa | grep libdb

Jeśli zauważysz, że RPM libdb4 jest późniejszy niż 4.8, zastąp te pakiety za pomocą tego polecenia:

> rpm -Uvh --oldpackage libdb4-cxx-4.8.30-13.el7.x86_64.rpm libdb4-4.8.30-13.el7.x86_64.rpm

Jeśli musisz pobrać te pakiety RPM, możesz je pobrać z:

Zainstaluj narzędzie Edge apigee-setup w węźle z zewnętrznym połączeniem internetowym

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

  1. Uzyskaj nazwę użytkownika i hasło z Apigee, których używasz do uzyskiwania dostępu do repozytorium Apigee. Jeśli masz już nazwę użytkownika:hasło do witryny ftp Apigee, możesz użyć tych danych.
  2. Aby zainstalować Edge RPM, zaloguj się w węźle jako użytkownik root.
  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. Jeśli instalujesz w AWS, uruchom to polecenie yum-configure-manager:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. Pobierz plik Edge bootstrap_4.17.09.sh do serwera /tmp/bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  8. Zainstaluj narzędzie i zależności usługi Edge Apigee:
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

    gdzie uName:pWord to nazwa użytkownika i hasło otrzymane z Apigee. Jeśli pominiesz właściwość pWord, poprosimy Cię o jej podanie.

    Domyślnie instalator sprawdza, czy zainstalowano środowisko Java 1.8. Jeśli tego nie zrobisz, zostanie ona automatycznie zainstalowana. Aby określić sposób obsługi instalacji Java, użyj opcji JAVA_FIX. JAVA_FIX przyjmuje te wartości:

    • I = Zainstaluj OpenJDK w wersji 1.8 (domyślnie)
    • C = Kontynuuj bez instalowania Javy
    • P = Zakończ. W przypadku tej opcji 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 polecenia:

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

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

    > sudo yum -v repolist 'apigee*'
  9. Użyj apigee-service, aby zainstalować narzędzie apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  10. Aby zainstalować i skonfigurować komponenty Edge w węźle, użyj narzędzia apigee-setup. Więcej informacji znajdziesz w artykule o instalowaniu komponentów Edge w węźle.

Zainstaluj narzędzie Edge apigee-setup w węźle bez zewnętrznego połączenia z internetem

Jeśli Twoje węzły brzegowe znajdują się za zaporą sieciową lub z innego powodu nie mają dostępu do repozytorium Apigee przez internet, musisz utworzyć lokalne repozytorium (duplikat) repozytorium Apigee. Moduł lustrzany musi być wtedy dostępny dla wszystkich węzłów. Po utworzeniu węzły mogą uzyskać dostęp do tego lokalnego duplikatu w celu zainstalowania Edge.

Aby utworzyć wewnętrzne repozytorium Apigee, musisz mieć węzeł z zewnętrznym dostępem do internetu, który będzie mógł pobrać RPM i zależności brzegowe. Po utworzeniu wewnętrznego repozytorium możesz je przenieść do innego węzła lub udostępnić go węzłom brzegowym w celu instalacji.

Po utworzeniu lokalnego repozytorium Edge może być konieczne zaktualizowanie go do najnowszych plików wersji Edge. Poniższe sekcje zawierają informacje o tworzeniu i aktualizowaniu repozytorium lokalnego.

Tworzenie lokalnego repozytorium Apigee

Aby utworzyć lokalne repozytorium Apigee:

  1. Uzyskaj nazwę użytkownika i hasło z Apigee, których używasz do uzyskiwania dostępu do repozytorium Apigee. Jeśli masz już nazwę użytkownika:hasło do witryny ftp Apigee, możesz użyć tych danych.
  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. Jeśli instalujesz w AWS, uruchom to polecenie yum-configure-manager:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. Pobierz plik Edge bootstrap_4.17.09.sh do serwera /tmp/bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  8. Zainstaluj narzędzie i zależności Edge apigee-service:
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

    gdzie uName:pWord to nazwa użytkownika i hasło otrzymane z Apigee. Jeśli pominiesz właściwość pWord, poprosimy Cię o jej podanie.

  9. Zainstaluj w węźle narzędzie apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  10. 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, który umożliwi pobranie tylko najnowszych pakietów RPM. Aby rozpocząć pobieranie, 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 pliki RPM, pomiń --only-new-rpms. Aby wykonać pełne pobranie, potrzebujesz około 6 GB miejsca na dysku:

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

    Masz teraz lokalną kopię repozytorium Apigee. W następnej sekcji opisaliśmy, jak zainstalować narzędzie Edge apigee-setup z lokalnego repozytorium.

  11. (Opcjonalnie) Jeśli chcesz zainstalować Edge z lokalnego repozytorium w tym samym węźle, w którym znajduje się lokalne repozytorium, musisz najpierw uruchomić te polecenia:
    1. Uruchom bootstrap_4.17.09.sh z lokalnego repozytorium, aby zainstalować narzędzie apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.09.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. Aby zainstalować i skonfigurować komponenty Edge w węźle, użyj narzędzia apigee-setup. Więcej informacji znajdziesz w artykule o instalowaniu komponentów Edge w węźle.

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

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

  • Utwórz w repozytorium plik .tar, 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, którego możesz używać, lub możesz użyć własnego serwera.

Zainstaluj z pliku .tar:

  1. W węźle z lokalnym repozytorium użyj poniższego polecenia, aby spakować lokalne repozytorium do jednego pliku .tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.17.09.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. Na przykład skopiuj go do katalogu /tmp w nowym węźle.
  3. Zainstaluj yum-utils i yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. W nowym węźle wyłącz SELinux w sposób opisany powyżej.
  5. Włącz repozytorium EPEL w sposób opisany powyżej.
  6. W nowym węźle wyodrębnij plik do katalogu /tmp:
    > tar -xzf apigee-4.17.09.tar.gz

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

  7. Zainstaluj narzędzie Edge Apigee i zależności z /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Zwróć uwagę, że to polecenie zawiera ścieżkę do katalogu repos.

  8. Aby zainstalować narzędzie apigee-setup, użyj apigee-service:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  9. Aby zainstalować i skonfigurować komponenty Edge w węźle, użyj narzędzia apigee-setup. Więcej informacji znajdziesz w artykule o instalowaniu komponentów Edge w węźle.

Zainstaluj z repozytorium, używając 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 używa hosta lokalnego 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 nie istnieje.
    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. 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. Włącz repozytorium EPEL w sposób opisany powyżej.
  7. W węźle zdalnym pobierz plik Edge bootstrap_4.17.09.sh na serwer /tmp/bootstrap_4.17.09.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.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.

  8. W węźle zdalnym zainstaluj narzędzie Edge apigee-service i jego zależności:
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName
      apigeepassword=pWord apigeeprotocol=http://

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

  9. W węźle zdalnym za pomocą apigee-service zainstaluj narzędzie apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  10. Aby zainstalować i skonfigurować komponenty Edge w węźle zdalnym, użyj narzędzia apigee-setup. Więcej informacji znajdziesz w artykule o instalowaniu komponentów Edge w węźle.

Aktualizowanie lokalnego repozytorium Apigee

Aby zaktualizować repozytorium, musisz pobrać najnowszy plik bootstrap_4.17.09.sh, a następnie wykonać nową synchronizację:

  1. Pobierz plik Edge bootstrap_4.17.09.sh do folderu /tmp/bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  2. Uruchom plik Edge bootstrap_4.17.09.sh:
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

    gdzie uName:pWord to nazwa użytkownika i hasło otrzymane z Apigee. Jeśli pominiesz właściwość pWord, poprosimy Cię o jej 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 pobrać całe repozytorium:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Czyszczenie lokalnego repozytorium Apigee

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

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

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

Dodaj lub zaktualizuj Edge 4.16.0x/4.17.0x w repozytorium 4.17.09

Jeśli musisz utrzymywać instalacje przeglądarki Edge 4.16.0x lub 4.17.01/4.17.05 w repozytorium 4.17.09, możesz utrzymywać repozytorium zawierające wszystkie wersje. Z tego repozytorium możesz zainstalować dowolną wersję Edge.

Aby dodać rozmiar 4.16.0x/4.17.0x do repozytorium 4.17.09:

  1. Sprawdź, czy masz zainstalowaną wersję 4.17.09 narzędzia apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    Powinien wyświetlić się wynik w formularzu poniżej, gdzie xyz to numer kompilacji:

    apigee-mirror-4.17.09-0.0.xyz
  2. Użyj narzędzia apigee-mirror, aby pobrać Edge 4.16.0x/4.17.01/4.17/05 do repozytorium. Zwróć uwagę na to, jak przed poleceniem dodajesz żą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.05 przez określenie wymaganych numerów wersji.

  3. Sprawdź katalog /opt/apigee/data/apigee-mirror/repos, aby zobaczyć strukturę plików:
    > 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
    thirdparty

    Zwróć uwagę na to, że jest dostępny plik wczytywania dla wszystkich wersji Edge. Katalog apigee zawiera też oddzielne 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

    Polecenie to spakuje wszystkie repozytoria 4.17.0x i 4.16.0x do tego samego pliku .tar. Nie możesz dodać pakietu tylko do części repozytorium.

Aby zainstalować Edge z lokalnego repozytorium lub pliku .tar, upewnij się, że uruchomisz właściwy plik wczytywania za pomocą jednego z poniższych poleceń. Ten przykład instaluje Edge 4.17.01:

  • W przypadku instalacji z pliku .tar uruchom właściwy plik rozruchowy z repozytorium:
    > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  • Jeśli instalujesz produkt za pomocą serwera WWW Nginx, pobierz z repozytorium prawidłowy 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 zakończyć instalację, wykonaj pozostałe kroki opisane w sekcji „Instalowanie z repozytorium przy użyciu serwera WWW Nginx” powyżej.