Instalowanie narzędzia Edge apigee

Edge for Private Cloud, wersja 4.18.01

Aby zainstalować Edge na węźle, najpierw zainstaluj narzędzie do konfigurowania interfejsów API Edge. Jeśli jesteś 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 instalacyjny: /opt/apigee

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

Warunek wstępny: wyłącz SELinux

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

• Aby tymczasowo ustawić SELinux w trybie mniej restrykcyjnym, 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. System operacyjny Linux 7.x:
     sudo setenforce 0
     
     Aby ponownie włączyć SELinux po zainstalowaniu Edge:
     sudo setenforce 1
• Aby trwale wyłączyć SELinux lub ustawić go w trybie mniej restrykcyjnym:
  1. Otwórz plik /etc/sysconfig/selinux w edytorze.
  2. Ustaw SELINUX=disabled lub SELINUX=permisive
  3. Zapisz zmiany.
  4. Uruchom węzeł ponownie.
  5. W razie potrzeby po zainstalowaniu Edge ponownie włącz SELinux, powtarzając tę procedurę, aby ustawić SELINUX=enabled.

Warunek wstępny: włącz repozytorium EPEL

Aby zainstalować lub zaktualizować Edge albo utworzyć lokalne repozytorium, musisz włączyć Dodatkowe pakiety dla Enterprise Linux (EPEL). To polecenie zależy od wersji usługi 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
• Dla 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 RedHat 7.4 i CentOS 7.4

W przypadku RedHat 7.4 i CenOS 7.4 przed zainstalowaniem sprawdź wersję RPM libdb4. Edge wymaga wersji 4.8 i niektórych wersji RedHat 7.4 i CentOS 7.4 z nowszymi wersjami. Jeśli masz późniejszą 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 zauważysz, że wersja RPM libdb4 jest późniejsza niż wersja 4.8, odinstaluj ją.

Zainstaluj narzędzie do konfiguracji interfejsów API Edge 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 Apigee ftp, możesz skorzystać z tych danych logowania.
2. Zaloguj się na swój węzeł jako root, aby zainstalować RPM Edge
   Uwaga: instalacja RPM wymaga dostępu do roota, ale możesz przeprowadzić konfigurację Edge bez dostępu do roota.
3. Zainstaluj elementy 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 w Oracle 7.x,uruchom to polecenie:
   > sudo yum-config-manager --enable ol7_Opcjonalne_najnowsze
8. Jeśli instalujesz oprogramowanie AWS, uruchom następujące 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-opcjonalne
9. Pobierz plik Edge 4.18.01.sh z katalogu /tmp/butytrap_4.18.01.sh:
   > curl https://software.apigee.com/butytrap_4.18.01.sh -o /tmp/butytrap_4.18.01.sh
10. Zainstaluj narzędzie i interfejs zależności usługi Edge API
    
    
    Jeśli pominiesz właściwość pWord, pojawi się prośba o jej podanie.
    
    Domyślnie instalator sprawdza, czy masz zainstalowaną wersję 1.8. Jeśli go nie masz, zainstaluje go za Ciebie. Aby określić sposób obsługi instalacji Javy, użyj opcji JAVA_FIX. JAVA_FIX przyjmuje następujące wartości:
    
    = Zainstaluj OpenJDK 1.8 (domyślnie)
    C = kontynuuj bez instalowania języka Java
    Q = Zakończ. W przypadku tej opcji musisz zainstalować Javę.
    
    Instalacja narzędzia apigee-service tworzy plik /etc/yum.repos.d/apigee.repo definiujący 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 narzędzia apigee-service, aby zainstalować narzędzie apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
12. Aby zainstalować i skonfigurować komponenty Edge w węźle, użyj konfiguracji apigee. Więcej informacji znajdziesz w sekcji Instalowanie komponentów Edge w węźle.

Zainstaluj narzędzie do konfiguracji interfejsów API Edge w 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 repozytorium Apigee przez internet, musisz utworzyć lokalne repozytorium lub dublowanie repozytorium Apigee. Ten węzeł musi być dostępny dla wszystkich węzłów. Po utworzeniu węzłów węzły będą mogły uzyskać dostęp do tego lokalnego serwera lustrzanego, aby zainstalować Edge.

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

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

Po utworzeniu lokalnego repozytorium Edge może być konieczne zaktualizowanie go do najnowszych plików wersji Edge. Z sekcji poniżej dowiesz się, jak utworzyć repozytorium lokalne i jak je zaktualizować.

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 Apigee ftp, możesz skorzystać z tych danych logowania.
2. Zaloguj się do węzła głównego, aby zainstalować RPM na serwerach brzegowych.
   Uwaga: RPM instalacji wymaga dostępu do roota, ale możesz przeprowadzić konfigurację Edge bez dostępu do roota.
3. Wyłącz SELinux w sposób opisany powyżej.
4. Pobierz plik Edge 4.18.01.sh z katalogu /tmp/butytrap_4.18.01.sh:
   > curl https://software.apigee.com/butytrap_4.18.01.sh -o /tmp/butytrap_4.18.01.sh
5. Zainstaluj narzędzie i zależności usługi Edge API
   
   
   Jeśli pominiesz właściwość pWord, pojawi się prośba o jej podanie.
6. Zainstaluj narzędzie apigee-mirror 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-update/api/e/mirror:
   
7. Użyj narzędzia apigee-mirror, aby zsynchronizować repozytorium Apigee z katalogiem /opt/apigee/data/apigee-mirror/repos/.
   
   Aby zminimalizować rozmiar repozytorium, dołącz --only-new-rpms do pobrania tylko najnowsze 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 RPM, pomiń --only-new-rpms. Do pełnego pobrania 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 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ęźle, który hostuje lokalne repozytorium, musisz najpierw uruchomić te polecenia:
   1. Uruchom narzędzie bootrap_4.18.01.sh z lokalnego repozytorium, aby zainstalować narzędzie apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/butytrap_4.18.01.sh apigeeprotocol="file://" gegeerepopathpath
   2. Użyj narzędzia apigee-service, aby zainstalować narzędzie apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup instalacji
   3. Aby zainstalować i skonfigurować komponenty Edge w węźle, użyj narzędzia apigee-setup. Więcej informacji znajdziesz w sekcji Instalowanie komponentów Edge w węźle.

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

Istnieją 2 sposoby instalowania Edge z lokalnego repozytorium. Możesz:

• Utwórz plik .tar, skopiuj plik .tar do węzła i zainstaluj Edge z pliku .tar.
• Zainstaluj serwer WWW w węźle z lokalnym repozytorium, aby umożliwić dostęp do innych węzłów. Apigee oferuje serwer WWW Nginx, którego możesz użyć. Możesz też użyć własnego serwera WWW.

Zainstaluj z pliku .tar:

1. W węźle z lokalnym repozytorium możesz użyć tego polecenia, aby spakować repozytorium lokalne do jednego pliku .tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-service lub apigee
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. W nowym węźle wyłącz funkcję SELinux w sposób opisany powyżej.
4. W nowym węźle włącz repozytorium EPEL w sposób opisany powyżej.
5. W nowym węźle wyłącz wszystkie zewnętrzne repozytoria internetowe. Gdy uruchomisz to polecenie, wszystkie zewnętrzne repozytoria powinny być wyświetlane jako wyłączone, ale powinny być włączone lokalne repozytorium Apigee i wszystkie repozytoria wewnętrzne:
   > repozytorium sudo yum
6. W nowym węźle zainstaluj yum-utils i yum-plugin-priorities:
   > sudo yum-install yum-utils
   > sudo yum install yum-plugin-priorities
7. W nowym węźle sprawdź wersję libdb4, jak opisano powyżej.
8. Jeśli instalujesz w Oracle 7.x,uruchom to polecenie:
   > sudo yum-config-manager --enable ol7_Opcjonalne_najnowsze
9. Jeśli instalujesz program w AWS, uruchom to polecenie yum-configure-manager:
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-opcjonalne
10. W nowym węźle wyodrębnij plik do katalogu /tmp:
    > tar -xzf apigee-4.18.01.tar.gz
    
    To polecenie tworzy w katalogu zawierającym plik .tar nowy katalog o nazwie Repo. na przykład /tmp/repos.
11. Zainstaluj narzędzie Edge apigee i zależności od /tmp/repos:
    > sudo bash /tmp/repos/butytrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
    
    Zwróć uwagę, że w tym poleceniu znajduje się ścieżka.
12. Użyj narzędzia apigee-service, aby zainstalować narzędzie apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup instalacji
13. Aby zainstalować i skonfigurować komponenty Edge w węźle, użyj narzędzia apigee-setup. Więcej informacji znajdziesz w sekcji Instalowanie komponentów Edge w węźle.

Zainstaluj 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 pod kątem używania hosta lokalnego jako nazwy serwera i portu 3939. Aby je zmienić:
   1. Otwórz w edytorze /opt/apigee/customer/application/mirror.property. 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 ponowne uruchomienie
3. Domyślnie repozytorium wymaga nazwy użytkownika:hasło admin:admin. Aby zmienić te dane logowania, ustaw następujące zmienne środowiskowe:
   MIRROR_NAZWA_użytkownika=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 funkcję 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, jak opisano powyżej.
8. W węźle zdalnym pobierz plik Edge rozruchstrap_4.18.01.sh do folderu /tmp/bootrap_4.18.01.sh:
   > /usr/bin/curl http://nazwa_użytkownika:pWord@remoteRepo:3939/butytrap_4.18.0-t-i-ty, nazwa-t-t,-ta,kiba, te dane.
   
   
9. W węźle zdalnym zainstaluj narzędzie i interfejs zależności usługi Edge apigee:
   > sudo bash /tmp/butytrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWordpp bezpośrednio.pp
   
   
10. W węźle zdalnym użyj narzędzia 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 brzegowe w węźle zdalnym. Więcej informacji znajdziesz w sekcji Instalowanie komponentów Edge w węźle.

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