Omówienie instalacji brzegowej

Typowa instalacja Edge składa się z komponentów Edge rozmieszczonych na wielu węzłach. Po zainstalowaniu w węźle Edge musisz zainstalować i skonfigurować w nim co najmniej 1 komponent Edge.

Proces instalacji

Instalowanie przeglądarki Edge na węźle to proces wieloetapowy:

1. Wyłącz SELinux w węźle lub ustaw tryb mniej rygorystyczny. Więcej informacji znajdziesz w artykule Instalowanie narzędzia apigee-setup w Edge.
2. Zdecyduj, czy chcesz włączyć uwierzytelnianie Cassandra.
3. Zdecyduj, czy chcesz skonfigurować replikację typu master-standby dla Postgresa.
4. Wybierz konfigurację urządzenia Edge z listy zalecanych topologii. Możesz na przykład zainstalować Edge w 1 węźle na potrzeby testów lub w 13 węzłach produkcyjnych. Więcej informacji znajdziesz w sekcji Topologie instalacji.
5. Na każdym węźle w wybranej topologii zainstaluj narzędzie Edge apigee-setup:
   • Pobierz plik bootstrap_4.53.00.sh Edge do folderu /tmp/bootstrap_4.53.00.sh.
   • Zainstaluj narzędzie apigee-service i zależne od niego komponenty.
   • Zainstaluj narzędzie apigee-setup i zależne od niego komponenty.

     Więcej informacji znajdziesz w artykule Instalowanie narzędzia apige-setup w Edge.

6. Użyj narzędzia apigee-setup, aby zainstalować co najmniej 1 komponent Edge na każdym węźle na podstawie wybranej topologii.

   Zapoznaj się z artykułem Instalowanie komponentów Edge w węźle.

7. Na węźle serwera zarządzania użyj narzędzia apigee-setup, aby zainstalować apigee-provision, czyli narzędzia służące do tworzenia organizacji Edge i zarządzania nimi.

   Więcej informacji znajdziesz w artykule Wprowadzanie organizacji.

8. Po zakończeniu instalacji uruchom ponownie komponent klasycznego interfejsu na każdym węźle, jak pokazano w tym przykładzie:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

9. (Zalecane) Po zakończeniu początkowej instalacji Apigee zaleca zainstalowanie nowego interfejsu Edge (którego nazwa komponentu to edge-management-ui). Jest to ulepszony interfejs użytkownika przeznaczony dla programistów i administratorów Apigee Edge for Private Cloud.

   Więcej informacji znajdziesz w artykule Instalowanie nowego interfejsu Edge.

Po zakończeniu instalacji zapoznaj się z tą listą typowych działań po zainstalowaniu.

Kto może przeprowadzić instalację

Pliki dystrybucji Apigee Edge są instalowane jako zestaw RPM-ów i zależnych komponentów. Aby zainstalować, odinstalować i zaktualizować RPM Edge, polecenia muszą być uruchamiane przez użytkownika roota lub użytkownika z pełnym dostępem do sudo. Pełny dostęp sudo oznacza, że użytkownik ma dostęp sudo i może wykonywać te same operacje co użytkownik root.

Każdy użytkownik, który chce uruchomić podane niżej polecenia lub skrypty, musi być użytkownikiem root lub mieć pełny dostęp sudo:

• Narzędzie apigee-service:
  • Polecenia apigee-service: install, uninstall, update.
  • Polecenia apigee-all: install, uninstall, update.
• skrypt setup.sh do instalowania komponentów Edge (chyba że już użyłeś/użyłaś opcji „apigee-service install” do zainstalowania wymaganych pakietów RPM); Następnie dostęp root lub pełny dostęp sudo, jeśli nie jest wymagany.
• Skrypt update.sh do aktualizowania komponentów Edge

Dodatkowo instalator Edge utworzy w systemie nowego użytkownika o nazwie „apigee”. Wiele poleceń Edge wywołuje sudo, które są uruchamiane przez użytkownika „apigee”.

Każdy użytkownik, który chce wykonywać inne polecenia niż te wymienione powyżej, musi mieć pełny dostęp sudo do użytkownika „apigee”. Do tych poleceń należą:

• polecenia narzędzia apigee-service, w tym:
  • polecenia apigee-service, takie jak start, stop, restart, configure;
  • polecenia apigee-all, takie jak start, stop, restart, configure.

Tworzenie użytkownika z pełnym dostępem sudo do użytkownika „apigee”

Aby skonfigurować użytkownika tak, aby miał pełny dostęp sudo do użytkownika „apigee”, użyj polecenia „visudo”, aby edytować plik sudoers i dodać:

installUser        ALL=(apigee)      NOPASSWD: ALL

Gdzie installUser to nazwa użytkownika osoby korzystającej z Edge.

Konfigurowanie uprawnień do plików konfiguracji

Wszystkie pliki i zasoby używane przez polecenia Edge muszą być dostępne dla użytkownika „apigee”. Obejmuje to plik licencji Edge i wszystkie pliki konfiguracyjne.

Podczas tworzenia pliku konfiguracyjnego możesz zmienić jego właściciela na „apigee:apigee”, aby był on dostępny dla poleceń Edge:

1. Utwórz plik w edytorze jako dowolny użytkownik.
2. chown właściciela pliku na „apigee:apigee” lub, jeśli zmieniłeś użytkownika obsługującego usługę Edge z „apigee”, zmień właściciela pliku na użytkownika obsługującego usługę Edge.

Oddzielenie zadań instalacji Edge między użytkownikiem root i użytkownika bez dostępu do roota

Cały proces instalacji przeglądarki Edge można przeprowadzić jako użytkownik root lub użytkownik z pełnymi uprawnieniami sudo, ale nie zawsze jest to możliwe. Zamiast tego możesz podzielić proces na zadania wykonywane przez roota i zadania wykonywane przez użytkownika z pełnym dostępem sudo do konta „apigee”.

1. Zadania wykonywane przez roota:
   1. Pobierz i uruchom plik bootstrap_4.53.00.sh:

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

      W tym kroku instalujesz narzędzie apigee-service i tworzysz użytkownika „apigee”.

   2. Skonfiguruj użytkownika, aby miał pełny dostęp sudo do użytkownika „apigee”, zgodnie z opisem w artykule Tworzenie użytkownika z pełnym dostępem sudo do użytkownika „apigee”.
   3. Zainstaluj narzędzie apigee-setup:

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

   4. Użyj narzędzia apigee-setup, aby zainstalować w węźle pakiety RPM Edge:

      /opt/apigee/apigee-service/bin/apigee-service compName install

      RPM urządzeń brzegowych, które instalujesz w węźle, zależy od topologii. Lista dostępnych komponentów obejmuje: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

2. Gdy użytkownik root zainstaluje na węźle interfejsy Edge RPM, użytkownik z pełnym dostępem do sudo do użytkownika „apigee” zakończy proces konfiguracji:
   1. Aby skonfigurować komponenty Edge na węźle, użyj narzędzia setup.sh. Forma polecenia zależy od komponentów zainstalowanych w węźle. Pełną listę znajdziesz w artykule Instalowanie komponentów Edge na węźle.

      Aby na przykład zainstalować ZooKeeper i Cassandra, użyj tego polecenia:

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      Gdzie configFile to plik konfiguracji Edge.

      Aby przeprowadzić instalację kompleksową, użyj tego polecenia:

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

Lokalizacja plików konfiguracji instalacji

Do narzędzia apigee-setup musisz przekazać plik konfiguracji zawierający informacje o instalacji Edge. Jedynym wymaganiem w przypadku instalacji dyskretnych jest to, aby plik konfiguracji był dostępny i czytelny dla użytkownika „apigee”. Na przykład umieść plik w katalogu /usr/local/var lub /usr/local/share węzła, a chown go w katalogu „apigee:apigee”.

Wymagane są wszystkie informacje w pliku konfiguracji oprócz hasła administratora systemu Edge. Jeśli pominiesz hasło, narzędzie apigee-setup wyświetli prośbę o wpisanie go w wierszu poleceń.

Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge na węźle.

Rozwiązywanie problemów z instalacją

W przypadku niepowodzenia instalacji komponentu Edge możesz spróbować rozwiązać problem, a potem ponownie uruchomić instalator. Instalator jest przeznaczony do wielokrotnego uruchamiania w przypadku wykrycia błędu lub gdy chcesz zmienić lub zaktualizować komponent po instalacji.

Po zainstalowaniu lub uaktualnieniu Edge UI należy ponownie uruchomić komponent na każdym węźle, na którym jest on uruchamiany.

Instalacja z dostępem przez internet lub bez dostępu przez internet

Aby zainstalować Edge na węźle, węzeł musi mieć dostęp do repozytorium Apigee:

• Węzły z zewnętrznym połączeniem internetowym

  Węzły z zewnętrznym połączeniem internetowym uzyskują dostęp do repozytorium Apigee w celu zainstalowania pakietów RPM i zależności Edge.

• Węzły bez zewnętrznego połączenia z internetem

  Węzły bez zewnętrznego połączenia z internetem mogą uzyskać dostęp do lustrzanej wersji repozytorium Apigee skonfigurowanego wewnętrznie. Ten repozytorium zawiera wszystkie RPM-y Edge, ale musisz mieć dostęp do wszystkich innych zależności z repozytoriów w sieci wewnętrznej.

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

Używanie lokalnego repozytorium Edge do utrzymywania wersji Edge

Jednym z powodów, dla których warto używać repozytorium lokalnego lub zwierciadła, jest instalowanie Edge na węzłach bez zewnętrznego połączenia z internetem, jak opisano w poprzedniej sekcji.

Rozwiązywanie zależności instalacji pakietu RPM

Pliki dystrybucyjne Apigee Edge są instalowane jako zbiór plików RPM, z których każdy może mieć własny łańcuch zależności instalacji. Wiele z tych zależności jest definiowanych przez komponenty firm zewnętrznych, które nie podlegają kontroli Apigee i mogą się w dowolnym momencie zmienić. Dlatego dokumentacja nie zawiera dokładnego numeru wersji każdej zależności.

Jeśli instalujesz maszynę z dostępem do internetu, węzeł może pobrać niezbędne pakiety RPM i zależności. Jeśli jednak instalujesz z węzła bez dostępu do internetu, zwykle konfigurujesz repozytorium wewnętrzne zawierające wszystkie niezbędne zależności. Jedynym sposobem na zagwarantowanie, że wszystkie zależności są uwzględnione w lokalnym repozytorium, jest próba instalacji, zidentyfikowanie brakujących zależności i ich skopiowanie do lokalnego repozytorium, aż do momentu, gdy instalacja się powiedzie.

Typowe polecenia Yum

Narzędzia do instalowania Edge na Linuksie korzystają z Yum do instalowania i aktualizowania komponentów. Aby zarządzać instalacją na węźle, konieczne może być użycie kilku poleceń Yum.

• Wyczyść wszystkie pamięci podręczne Yum:

  sudo yum clean all

• Aby zaktualizować komponent Edge:

  sudo yum update componentName

  Na przykład:

  sudo yum update apigee-setup
  sudo yum update edge-management-server

Struktura systemu plików

Edge instaluje wszystkie pliki w katalogu /opt/apigee.

W tym przewodniku i w Przewodniku po operacjach w Edge katalog główny instalacji jest oznaczony jako:

/opt/apigee

Instalacja używa tej struktury systemu plików do wdrażania Apigee Edge for Private Cloud.

Pliki dziennika

Plik logu dla apigee-setup i skrypt setup.sh jest zapisywany w folderze /tmp/setup-root.log.

Pliki dziennika dotyczące poszczególnych komponentów znajdują się w katalogu /opt/apigee/var/log. Każdy komponent ma swój podkatalog. Na przykład dzienniki serwera zarządzania znajdują się w katalogu:

/opt/apigee/var/log/edge-management-server

W tabeli poniżej znajdziesz lokalizację plików dziennika:

Dane

Włącz sprawdzanie systemu podczas instalacji

Plik konfiguracji instalacji przeglądarki Edge obsługuje te właściwości:

ENABLE_SYSTEM_CHECK=y

Jeśli ustawisz tę właściwość na „y”, instalator sprawdzi, czy system spełnia wymagania dotyczące procesora i pamięci dla instalowanego komponentu. Wartość domyślna to „n”, co oznacza wyłączenie sprawdzania.