Omówienie instalacji brzegowej

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

Proces instalacji

Instalowanie Edge na węźle to proces wieloetapowy:

1. Wyłącz SELinux na węźle lub ustaw go w trybie zezwalającym. Więcej informacji znajdziesz w artykule Instalowanie narzędzia apigee-setup Edge.
2. Zdecyduj, czy chcesz włączyć uwierzytelnianie Cassandra.
3. Zdecyduj, czy chcesz skonfigurować replikację master-standby dla Postgres.
4. Wybierz konfigurację Edge z listy rekomendowanych topologii. Możesz na przykład zainstalować Edge na jednym węźle na potrzeby testowania lub na 13 węzłach na potrzeby produkcji. Więcej informacji znajdziesz w artykule Topologie instalacji.
5. Na każdym węźle w wybranej topologii zainstaluj narzędzie apigee-setup Edge:
   • Pobierz plik Edge bootstrap_4.54.00.sh do /tmp/bootstrap_4.54.00.sh.
   • Zainstaluj narzędzie apigee-service Edge i zależności.
   • Zainstaluj narzędzie apigee-setup Edge i zależności.

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

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

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

7. Na węźle serwera zarządzania użyj narzędzia apigee-setup, aby zainstalować apigee-provision – narzędzia, których używasz do tworzenia organizacji Edge i zarządzania nimi.

   Więcej informacji znajdziesz w artykule Wdrażanie organizacji.

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

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

9. Skonfiguruj uwierzytelnianie i opcjonalne ustawienia nowego interfejsu Edge (którego nazwy komponentów to edge-management-ui i edge-management-ui-static).

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

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

Kto może przeprowadzić instalację

Pliki dystrybucyjne Apigee Edge są instalowane jako zestaw pakietów RPM i zależności. Aby zainstalować, odinstalować i zaktualizować pakiety RPM Edge, polecenia muszą być uruchamiane przez użytkownika root lub użytkownika który ma pełny dostęp do sudo. Pełny dostęp do sudo oznacza, że użytkownik ma dostęp do sudo, aby wykonywać te same operacje co root.

Każdy użytkownik, który chce uruchomić te polecenia lub skrypty, musi być użytkownikiem root lub użytkownikiem z pełnym dostępem do sudo:

• Narzędzie apigee-service:
  • Polecenia apigee-service: install, uninstall, update.
  • Polecenia apigee-all: install, uninstall, update.
• setup.sh skrypt do instalowania komponentów Edge (chyba że do zainstalowania wymaganych pakietów RPM używasz już polecenia "apigee-service install". W takim przypadku dostęp root lub pełny dostęp do sudo nie jest wymagany.
• Skrypt update.sh do aktualizowania komponentów Edge

Instalator Edge tworzy też w systemie nowego użytkownika o nazwie „apigee”. Wiele poleceń Edge wywołuje sudo, aby uruchomić je jako użytkownik „apigee”.

Każdy użytkownik, który chce uruchomić wszystkie inne polecenia niż te wymienione powyżej, musi mieć pełny dostęp do sudo dla użytkownika „apigee”. Te polecenia obejmują:

• 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 do sudo dla użytkownika „apigee”

Aby skonfigurować użytkownika tak, aby miał pełny dostęp do sudo dla 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 pracującej z Edge.

Ustawianie uprawnień do plików konfiguracyjnych

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 mieć pewność, że jest on dostępny dla poleceń Edge:

1. Utwórz plik w edytorze jako dowolny użytkownik.
2. Ustaw właściciela pliku na „apigee:apigee” za pomocą polecenia chown lub, jeśli zmienisz użytkownika uruchamiającego usługę Edge z użytkownika „apigee”, ustaw plik na użytkownika, który uruchamia usługę Edge.

Rozdzielanie zadań instalacji Edge między użytkownika root a użytkownika innego niż root

Najprościej jest przeprowadzić cały proces instalacji Edge jako użytkownik root lub użytkownik, który ma pełny dostęp do sudo, ale nie zawsze jest to możliwe. Zamiast tego możesz podzielić proces na zadania wykonywane przez użytkownika root i zadania wykonywane przez użytkownika z pełnym dostępem do sudo dla użytkownika „apigee”.

1. Zadania wykonywane przez użytkownika root:
   1. Pobierz i uruchom plik bootstrap_4.54.00.sh:

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

      Ten krok instaluje narzędzie apigee-service i tworzy użytkownika „apigee” .

   2. Skonfiguruj użytkownika tak, aby miał pełny dostęp do sudo dla użytkownika "apigee", zgodnie z opisem w sekcji Tworzenie użytkownika z pełnym dostępem do sudo dla 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ć pakiety RPM Edge na węźle:

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

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

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

      Aby na przykład dokończyć instalację 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ę typu „wszystko w jednym”, użyj tego polecenia:

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

Lokalizacja plików konfiguracyjnych instalacji

Musisz przekazać do narzędzia apigee-setup plik konfiguracyjny zawierający informacje o instalacji Edge. Jedynym wymaganiem dotyczącym instalacji cichej jest to, aby plik konfiguracyjny był dostępny lub czytelny dla użytkownika "apigee". Umieść na przykład plik w katalogu /usr/local/var lub /usr/local/share na węźle i ustaw jego właściciela na "apigee:apigee" za pomocą polecenia chown.

Wszystkie informacje w pliku konfiguracyjnym są wymagane, z wyjątkiem hasła administratora systemu Edge. Jeśli pominiesz hasło, narzędzie apigee-setup wyświetli prośbę o jego wpisanie w wierszu poleceń.

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

Obsługa nieudanej instalacji

W przypadku niepowodzenia podczas instalacji komponentu Edge możesz spróbować rozwiązać problem, a następnie ponownie uruchomić instalator. Instalator jest przeznaczony do wielokrotnego uruchamiania w przypadkach, gdy wykryje błąd lub jeśli później chcesz zmienić lub zaktualizować komponent po instalacji.

Po zainstalowaniu lub uaktualnieniu uruchom ponownie komponent Nowy interfejs Edge na każdym węźle, na którym jest on uruchomiony.

Instalacja z dostępem do internetu lub bez niego

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

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

  Węzły z zewnętrznym połączeniem z internetem mają dostęp do repozytorium Apigee, aby zainstalować pakiety RPM Edge i zależności.

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

  Węzły bez zewnętrznego połączenia z internetem mogą mieć dostęp do kopii repozytorium Apigee , którą skonfigurujesz wewnętrznie. To repozytorium zawiera wszystkie pakiety RPM Edge, ale musisz się upewnić, że wszystkie inne zależności są dostępne w repozytoriach w sieci wewnętrznej.

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

Używanie lokalnego repozytorium Edge do utrzymywania wersji Edge

Jednym z powodów używania lokalnego lub skopiowanego repozytorium jest instalowanie Edge na węzłach bez zewnętrznego połączenia z internetem, jak opisano w poprzedniej sekcji.

Rozwiązywanie problemów z zależnościami instalacji pakietów RPM

Pliki dystrybucyjne Apigee Edge są instalowane jako zestaw plików RPM, z których każdy może mieć własny łańcuch zależności instalacyjnych. Wiele z tych zależności jest definiowanych przez komponenty innych firm , które są poza kontrolą Apigee i mogą się w każdej chwili zmienić. Dlatego w dokumentacji nie podajemy dokładnego numeru wersji każdej zależności.

Jeśli instalujesz na maszynie 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 wewnętrzne repozytorium 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 skopiowanie ich do lokalnego repozytorium, aż instalacja się powiedzie.

Typowe polecenia Yum

Narzędzia instalacyjne Edge dla systemu Linux korzystają z Yum do instalowania i aktualizowania komponentów. Do zarządzania instalacją na węźle może być konieczne 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 Edge katalog główny instalacji jest oznaczony jako:

/opt/apigee

Instalacja używa tej struktury systemu plików do wdrażania Apigee Edge dla chmury prywatnej.

Pliki dziennika

Plik dziennika dla apigee-setup i skryptu setup.sh jest zapisywany w katalogu /tmp/setup-root.log.

Pliki dziennika każdego komponentu znajdują się w katalogu /opt/apigee/var/log. Każdy komponent ma własny podkatalog. Na przykład dzienniki serwera zarządzania znajdują się w katalogu:

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

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

Dane

Włączanie sprawdzania systemu podczas instalacji

Plik konfiguracji instalacji Edge obsługuje tę właściwość:

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, że sprawdzanie jest wyłączone.