Instalowanie narzędzia Edge apigee

Edge for Private Cloud w wersji 4.18.01

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

Domyślny katalog instalacji: /opt/apigee

Edge instaluje wszystkie pliki w katalogu /opt/apigee. Nie możesz tego zmienić katalogu. W razie potrzeby możesz jednak utworzyć dowiązanie symboliczne do mapowania parametru /opt/apigee na inną lokalizację. Więcej informacji znajdziesz w sekcji Wymagania dotyczące instalacji.

Warunek wstępny: wyłącz SELinux

Aby zainstalować Edge, musisz wyłączyć funkcję SELinux lub ustawić ją w trybie mniej rygorystycznym narzędzie apigee-setup lub dowolne narzędzie Edge W razie potrzeby po zainstalowaniu Edge możesz ponownie włączyć SELinux.

  • Aby tymczasowo ustawić SELinux w trybie mniej rygorystycznym, wykonaj to polecenie 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ć SELinux lub ustawić tryb mniej rygorystyczny:
    1. Otwórz plik /etc/sysconfig/selinux w redaktorem.
    2. Ustaw SELINUX=disabled lub SELINUX=permissive
    3. Zapisz zmiany.
    4. Ponownie uruchom węzeł.
    5. W razie potrzeby ponownie włącz SELinux po zainstalowaniu Edge, powtarzając tę procedurę, aby ustaw SELINUX=enabled.

Wymaganie wstępne: włącz repozytorium EPEL

Musisz włączyć Dodatkowe pakiety dla Enterprise Linux (lub EPEL), aby zainstalować lub zaktualizować Edge albo utworzyć lokalne repozytorium. używane polecenie zależy od używanej wersji RedHat/CentOS:

  • 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
  • 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ź libdb4 wersja biblioteki na RedHat 7.4 i CentOS 7.4

W systemach RedHat 7.4 i CentOS 7.4 sprawdź przed instalacją wersję RPM libdb4. Krawędź wymaga wersji 4.8, a niektóre wersje RedHat 7.4 i CentOS 7.4 zawierają późniejszej wersji. Jeśli masz nowszą wersję, odinstaluj ją, a instalator Edge a następnie zainstaluj wersję 4.8.

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

> rpm -qa | grep libdb4

Jeśli zauważysz, że wersja RPM libdb4 jest nowsza od wersji 4.8, odinstaluj ją.

Zainstaluj Edge narzędzie 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 z 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 witryny Apigee, możesz jej użyć dane logowania.
  2. Zaloguj się w węźle jako root, aby zainstalować pakiety RPM Edge
    Uwaga: chociaż instalacja pakietu RPM wymaga dostępu do roota, możesz uruchomić Edge bez dostępu do roota.
  3. zainstalować 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 w sposób opisany powyżej.
  7. Jeśli instalujesz Oracle 7.x,uruchom to polecenie:
    > sudo yum-config-manager --enable ol7_optional_latest
  8. Jeśli instalujesz w AWS, uruchom te polecenia yum-configure-manager:
    > mniam aktualizację 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.18.01.sh do bootstrap_4.18.01.sh:
    curl https://software.apigee.com/shoestrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.sh
  10. Zainstaluj narzędzie Edge apigee-service i zależności:
    > Sudo Bash /tmp/shoestrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    gdzie uName:pWord to nazwa użytkownika i hasło otrzymane z adresu Apigee. Jeśli pominiesz słowo pWord, pojawi się prośba o jego wpisanie.

    Domyślnie instalator sprawdza, czy zainstalowano środowisko Java 1.8. Jeśli tego nie zrobisz, zainstaluje ją za Ciebie. Użyj opcji JAVA_FIX, aby określić sposób obsługi Instalacja Javy. JAVA_FIX przyjmuje następujące wartości:

    I = Zainstaluj OpenJDK 1.8 (domyślnie)
    C = kontynuuj bez instalowania Javy
    P = Zakończ. Aby skorzystać z tej opcji, musisz samodzielnie zainstalować Javę.

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

    Aby wyświetlić zawartość repozytorium, użyj polecenia:
    > repozytorium sudo yum -v „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 o instalowaniu komponentów Edge w węźle.

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

Jeśli węzły brzegowe są za zaporą sieciową lub z innego powodu nie mają dostępu z repozytorium Apigee przez internet, musisz utworzyć lokalne repozytorium, czyli kopię lustrzaną w repozytorium Apigee. Moduł ten musi być wtedy dostępny dla wszystkich węzłów. Po utworzeniu węzłów będzie mógł uzyskać dostęp do tego lokalnego serwera lustrzanego i zainstalować Edge.

Do utworzenia wewnętrznego repozytorium Apigee potrzebujesz węzła z zewnętrznym internetem aby pobrać RPM i zależności Edge. Po utworzeniu wewnętrznego do repozytorium, możesz je przenieść do innego węzła lub udostępnić go węzłach brzegowych do instalacji.

Uwaga: Apigee nie hostuje wszystkich zależności zewnętrznych repozytoriów. Musisz pobrać i zainstalować te zależności z publicznie dostępnych źródeł repozytoriów.

Gdy utworzysz lokalne repozytorium Edge, może być konieczne zaktualizowanie go za pomocą najnowszej wersji Pliki do wydania brzegowego. W sekcjach poniżej dowiesz się, jak utworzyć lokalne repozytorium i jak go zaktualizować.

Tworzenie lokalnego repozytorium Apigee

Aby utworzyć lokalne repozytorium Apigee:

  1. Uzyskaj z 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 witryny Apigee, możesz jej użyć dane logowania.
  2. Zaloguj się do węzła jako root, aby zainstalować RPM Edge.
    Uwaga: chociaż instalacja pakietu RPM wymaga dostępu do roota, możesz uruchomić Edge bez dostępu do roota.
  3. Wyłącz SELinux w sposób opisany powyżej.
  4. Pobierz plik Edge bootstrap_4.18.01.sh do bootstrap_4.18.01.sh:
    curl https://software.apigee.com/shoestrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.sh
  5. Zainstaluj narzędzie Edge apigee-service i zależności:
    > Sudo Bash /tmp/shoestrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    gdzie uName:pWord to nazwa użytkownika i hasło otrzymane z adresu Apigee. Jeśli pominiesz słowo pWord, pojawi się prośba o jego wpisanie.
  6. Instalowanie apigee-mirror narzędzie w węźle:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

    Uwaga: jeśli aktualizujesz istniejące repozytorium do wersji 4.18.01, musisz tylko zaktualizować apigee-mirror:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror Aktualizacja
  7. Używanie interfejsu apigee-mirror narzędzie do synchronizowania repozytorium Apigee z katalogiem /opt/apigee/data/apigee-mirror/repos/ katalogu.

    Aby zminimalizować rozmiar repozytorium, dołącz parametr --only-new-rpms, aby pobrać tylko najnowszą wersję RPM. Aby pobrać plik, 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 RPM, pomiń --only-new-rpms. Potrzebujesz około 6 GB na dysku, by pobrać pełne dane:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror synchronizacja

    Masz teraz lokalną kopię repozytorium Apigee. W następnej sekcji opisujemy, jak zainstalować Narzędzie Edge apigee-setup od z lokalnego repozytorium.
  8. (Opcjonalnie) Jeśli chcesz zainstalować Edge z lokalnego repozytorium w tym samym węzła, który hostuje lokalne repozytorium, najpierw musisz uruchomić te polecenia:
    1. Uruchom plik bootstrap_4.18.01.sh z pliku lokalnego repozytorium, żeby zainstalować narzędzie apigee-service:
      Sudo Bash /opt/apigee/data/apigee-mirror/repos/shoestrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Użyj apigee-service, aby: jak zainstalować apigee-setup narzędzie:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. Użyj parametru apigee-setup, aby: zainstalować i skonfigurować w węźle komponenty Edge. Więcej informacji znajdziesz w artykule o instalowaniu komponentów Edge w węźle.

Zainstaluj konfigurację apigee w węźle zdalnym z lokalnego repozytorium

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

  • Utwórz plik .tar repozytorium, skopiuj ten plik do węzła, a następnie zainstaluj Edge z plik .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, z którego możesz korzystać. Możesz też skorzystać z własnego serwera WWW.

Zainstaluj z pliku tar:

  1. W węźle z lokalnym repozytorium użyj następującego polecenia, aby spakować lokalne repozytorium do pojedynczy plik .tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.18.01.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 sekcji /tmp w katalogu do węzła.
  3. W nowym węźle wyłącz SELinux w sposób opisany powyżej.
  4. W nowym węźle włącz repozytorium EPEL w sposób opisany powyżej.
  5. Sprawdź, czy w nowym węźle wyłączone są wszystkie zewnętrzne repozytoria internetowe. Po uruchomieniu tego polecenia wszystkie zewnętrzne repozytoria powinny być wyświetlane jako wyłączone: ale lokalne repozytorium Apigee i wszystkie wewnętrzne repozytoria powinny być włączone:
    > sudo repozytorium yum
  6. W nowym węźle zainstaluj yum-utils i yum-plugin-priorities:
    sudo mniam zainstaluj yum-utils
    > sudo yum install yum-plugin-priorities
  7. W nowym węźle sprawdź wersję libdb4 zgodnie z opisem. powyżej.
  8. Jeśli instalujesz Oracle 7.x,uruchom to polecenie:
    > sudo yum-config-manager --enable ol7_optional_latest
  9. Jeśli instalujesz w AWS, uruchom to polecenie yum-configure-manager:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-serwer-opcjonalny
  10. W nowym węźle wyciągnij plik z katalogu /tmp:
    > tar -xzf apigee-4.18.01.tar.gz

    To polecenie tworzy nowy katalog, w katalogu zawierającym plik .tar. Przykład: /tmp/repos.
  11. Zainstaluj narzędzie Edge apigee-service oraz zależności z katalogu /tmp/repos:
    Sudo Bash /tmp/repos/shoestrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Zwróć uwagę, że w tym poleceniu umieszczasz ścieżkę do katalogu repozytoriów.
  12. Użyj apigee-service, aby: jak zainstalować apigee-setup narzędzie:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Użyj polecenia apigee-setup do instalacji i skonfigurować komponenty Edge w węźle. Więcej informacji znajdziesz w artykule o instalowaniu komponentów Edge w węźle.

Zainstaluj z repozytorium przy użyciu 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 protokół Nginx jest skonfigurowany do używania hosta lokalnego jako nazwy serwera i portu 3939. Do zmień te wartości
    1. Otwórz /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. Uruchom ponownie Nginx:
      ?> /opt/nginx/scripts/apigee-nginx restart
  3. Domyślnie repozytorium wymaga podania nazwy użytkownika i hasła w postaci admin:admin. Aby je zmienić, ustaw następujące zmienne środowiskowe:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. W nowym węźle zainstaluj yum-utils i yum-plugin-priorities:
    sudo mniam zainstaluj yum-utils
    > sudo yum install yum-plugin-priorities
  5. W nowym węźle wyłącz SELinux w sposób opisany powyżej.
  6. W nowym węźle włącz repozytorium EPEL w sposób opisany powyżej.
  7. W nowym węźle sprawdź wersję libdb4 zgodnie z opisem. powyżej.
  8. W węźle zdalnym pobierz plik Edge Bootstrap_4.18.01.sh do /tmp/shoestrap_4.18.01.sh:
    /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.sh

    gdzie uName:pWord to nazwa użytkownika i hasło ustawione powyżej dla repozytorium, a remoteRepo to adres IP lub nazwa DNS repozytorium. do węzła.
  9. W węźle zdalnym zainstaluj narzędzie Edge apigee-service i zależności:
    > Sudo Bash /tmp/shoestrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    gdzie Nazwa:pWord to nazwa użytkownika repozytorium. hasła.
  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 polecenia apigee-setup do instalacji i skonfigurować komponenty Edge w węźle zdalnym. 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 wczytywania_4.18.01.sh, a następnie wykonać nowy sysnc:

  1. Pobierz plik Edge loadstrap_4.18.01.sh do /tmp/Bootstrap_4.18.01.sh:
    curl https://software.apigee.com/shoestrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.sh
  2. Uruchom plik bootstrap_4.18.01.sh Edge:
    Sudo Bash /tmp/shoestrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    gdzie uName:pWord to nazwa użytkownika i hasło, odebrane z Apigee. Jeśli pominiesz słowo pWord, pojawi się prośba o wpisz go.
  3. Aktualizacja pliku apigee-mirror:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror Aktualizacja
  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 synchronizacja

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ć lokalne repozytorium, użyj polecenia:

> /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.18.01

Jeśli w repozytorium w wersji 4.18.01 musisz utrzymywać instalacje wersji Edge 4.16.0x lub 4.17.0x, możesz i utrzymuj repozytorium zawierające wszystkie wersje. Możesz z niego zainstalować dowolną wersję Edge.

Aby dodać 4.16.0x/4.17.0x do repozytorium 4.18.01:

  1. Upewnij się, że masz zainstalowaną wersję 4.18.01 narzędzia apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror wersja

    Wynik powinien pojawić się w formularzu poniżej, w którym xyz to kompilacja numer:
    apigee-mirror-4.18.01-0.0.xyz
  2. Używanie interfejsu apigee-mirror narzędzie do pobrania Edge 4.16.0x/4.17.0x do repozytorium. Zwróć uwagę na to, że polecenie jest poprzedzone prefiksem wybrana wersja:
    > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service synchronizacja apigee-mirror --only-new-rpms

    Za pomocą tego samego polecenia możesz później zaktualizować repozytoria 4.16.0x/4.17.0x, określając wymagane numery wersji.
  3. Sprawdź plik /opt/apigee/data/apigee-mirror/repos. katalog, aby zobaczyć strukturę pliku:
    ls /opt/apigee/data/apigee-mirror/repos

    Powinny pojawić się następujące pliki i katalogi:
    apigee apigee-repo-1.0-6.x86_64.rpm botki_trap_4.16.01.sh bootstrap_4.16.05.sh bootstrap_4.17.01.sh bootstrap_4.17.01.sh bootstrap_4.17.01.sh shoestrap_4.18.01.sh firma zewnętrzna

    Zwróć uwagę, że masz plik wczytywania dla wszystkich wersji Edge. Katalog apigee zawiera też oddzielne w 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 pakiet apigee-mirror

    To polecenie spakuje wszystkie repozytoria 4.17.0x i 4.16.0x w jednym pliku .tar. Nie można tylko część repozytorium.

Aby zainstalować Edge z lokalnego repozytorium lub pliku tar, nie zapomnij uruchomić odpowiedniego wczytywania za pomocą jednego z poniższych poleceń. Ten przykład instaluje Edge 4.17.01:

  • Jeśli instalujesz plik z pliku tar, uruchom prawidłowy plik wczytywania z repozytorium:
    > Sudo Bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Aby dokończyć instalację, wykonaj pozostałe kroki z sekcji „Instalowanie z pliku .tar”. powyżej.
  • W przypadku instalacji na serwerze internetowym Nginx pobierz i uruchom właściwy plik wczytywania 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 kroki opisane w sekcji „Instalowanie z repozytorium przy użyciu Serwer WWW Nginx powyżej.