Instalowanie narzędzia Edge apigee

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 z katalogu /opt/apigee. Nie możesz tego zmienić katalogu. W razie potrzeby możesz jednak utworzyć dowiązanie symboliczne, aby zmapować /opt/apigee na do innej lokalizacji. 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 apigee-setup lub dowolna platforma 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 edytorze.
  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

Na urządzeniach RedHat 7.4 i CentOS 7.4 sprawdź przed instalacją wersję libdb4 RPM. 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 niż 4.8, odinstaluj .

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

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 zasób username:password dla witryny ftp witryny Apigee, możesz go użyć dane logowania.
2. Zaloguj się w 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 w sposób opisany powyżej.
5. Włącz repozytorium EPEL w sposób opisany powyżej.
6. Sprawdź wersję aplikacji 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 to polecenie 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

    Skąd uName:pWord to nazwa użytkownika i hasło, z których pochodzą informacje Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.

    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:

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

    Aby wyświetlić zawartość repozytorium, użyj 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 o instalowaniu 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

Poniższa tabela zawiera 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

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 internetem, musisz utworzyć kilka repozytoriów (lub replik), zawierających pliki potrzebne podczas instalacji. Takie moduły muszą być wtedy dostępne dla wszystkich węzłów. Po utworzeniu węzłów mogą następnie uzyskać dostęp do lokalnych lustrzanek i zainstalować Edge.

Proces instalacji Apigee Edge w przypadku węzłów bez połączeń z internetem wymaga dostępu do: następujące lokalne repozytoria:

• Repozytorium Apigee Edge: zgodnie z opisem w sekcji Utwórz lokalne repozytorium Apigee.
• Repozytorium Yum (na potrzeby narzędzi takich jak yum-utils czy yum-plugin-priorities): Twój zespół operacyjny powinien być w stanie to dla Ciebie skonfigurować.
• Dodatkowe pakiety dla Enterprise Linux (lub EPEL): zespół operacyjny powinien mieć możliwość skonfigurowania tych ustawień do Ciebie.

Tworzenie lokalnego repozytorium Apigee

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.

Po utworzeniu lokalnego repozytorium Apigee może być konieczne zaktualizowanie go za pomocą najnowszej Pliki do wydania brzegowego. W sekcjach poniżej opisano, jak utworzyć lokalne repozytorium Apigee. jak to zrobić.

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

   Skąd uName:pWord to nazwa użytkownika i hasło, z których pochodzą informacje 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 /opt/apigee/data/apigee-mirror/repos/.

   Aby zminimalizować rozmiar repozytorium, dołącz --only-new-rpms, aby pobrać tylko o najnowszy 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 wskaźniki RPM, pomiń --only-new-rpms. Pełne pobranie danych wymaga 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 opisujemy, jak zainstalować Narzędzie Edge apigee-setup 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 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 programu apigee-service, aby zainstalować narzędzie apigee-setup:

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

   3. Użyj narzędzia apigee-setup, aby zainstalować i skonfigurować w węźle komponenty Edge. Zobacz Zainstaluj w węźle komponenty Edge, aby uzyskać więcej informacji.

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

Aby zainstalować plik 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.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. Na przykład skopiuj go do sekcji /tmp w nowym węźle.
3. W nowym węźle wyłącz SELinux w sposób opisany powyżej.
4. W nowym węźle sprawdź, czy masz dostęp do lokalnego repozytorium narzędzia Yum oraz pliku EPEL repozytorium.
5. Dokładnie sprawdź, czy wszystkie zewnętrzne repozytoria internetowe są wyłączone (powinno to być przyczyną na komputerze bez dostępu do internetu):

   sudo yum repolist

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

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

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

   Twój zespół operacyjny lub inna grupa w organizacji musi skonfigurować lokalne repozytorium, aby umożliwić Ci zainstalować narzędzia Yum.

7. W nowym węźle sprawdź wersję instancji libdb4 w sposób opisany 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 Polecenie yum-configure-manager:

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

10. W nowym węźle wypakuj plik do katalogu /tmp:

    tar -xzf apigee-4.19.06.tar.gz

    To polecenie utworzy nowy katalog o nazwie „repos” w katalogu zawierającym pliki .tar . Przykład: /tmp/repos.

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

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

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

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

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

13. Użyj narzędzia apigee-setup, aby zainstalować i skonfigurować w węźle komponenty Edge. Zobacz Zainstaluj w węźle komponenty Edge, aby uzyskać więcej informacji.

Zainstaluj z repozytorium za pomocą serwera WWW Nginx

Aby przeprowadzić instalację 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 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. Uruchom ponownie Nginx:

      /opt/nginx/scripts/apigee-nginx restart

3. Domyślnie repozytorium wymaga podania wartości nazwa użytkownika:hasło admin:admin. Aby zmienić te dane logowania 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 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. Sprawdź, czy lokalne repozytorium EPEL jest włączone w nowym węźle.
7. W nowym węźle sprawdź wersję instancji libdb4 w sposób opisany powyżej.
8. W 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. remoteRepo to adres IP lub nazwa DNS węzła repozytorium.

9. Na 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 repozytorium.

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

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

11. Użyj narzędzia apigee-setup, aby zainstalować 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.19.06.sh, a następnie i przeprowadź nową synchronizację.

Aby zaktualizować repozytorium:

1. Pobierz plik Edge Boostp_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 z Apigee. Jeśli pomiń 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ć 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.19.06

Jeśli musisz utrzymywać instalacje wersji Edge 4.16.0x lub 4.17.0x w repozytorium w wersji 4.19.06, 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.19.06:

1. Upewnij się, że masz zainstalowaną wersję apigee-mirror 4.19.06 narzędzie:

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

   Wynik powinien pojawić się w formularzu poniżej, w którym xyz to numer kompilacji:

   apigee-mirror-4.19.06-0.0.xyz

2. Użyj funkcji apigee-mirror narzędzie do pobrania Edge 4.16.0x/4.17.0x do repozytorium. Zwróć uwagę na to, że polecenie jest poprzedzone prefiksem żądaną wersję:

   apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --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ź katalog /opt/apigee/data/apigee-mirror/repos, aby zobaczyć plik struktura:

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

   Powinny wyświetlić się następujące 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 wczytywania dla wszystkich wersji Edge. apigee katalog 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

   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 z sekcji „Instalowanie z repozytorium przy użyciu na serwerze internetowym Nginx”. powyżej.