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.

Proces instalacji

Instalacja 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 Edge apigee-setup.
2. Zdecyduj, czy chcesz włączyć uwierzytelnianie Cassandra.
3. Zdecyduj, czy chcesz skonfigurować replikację typu master-standby dla bazy danych Postgres.
4. Wybierz konfigurację Edge z listy zalecanych 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 sekcji Topologie instalacji.
5. Na każdym węźle w wybranej topologii zainstaluj narzędzie Edge apigee-setup:
   • Pobierz plik Edge bootstrap_4.52.02.sh do /tmp/bootstrap_4.52.02.sh.
   • Zainstaluj narzędzie Edge apigee-service i zależności.
   • Zainstaluj narzędzie Edge apigee-setup i zależności.

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

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

   Zobacz Instalowanie komponentów Edge na węźle.

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

   Więcej informacji znajdziesz w artykule Wprowadzanie organizacji.

8. Po zakończeniu instalacji na każdym węźle uruchom ponownie komponent interfejsu klasycznego, 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), który jest ulepszonym interfejsem użytkownika dla deweloperó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 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 z pełnym dostępem sudo. Pełny dostęp sudo oznacza, że użytkownik ma dostęp sudo do wykonywania tych samych operacji co root.

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

• Narzędzie apigee-service:
  • Polecenia apigee-service: install, uninstall, update
  • Polecenia apigee-all: install, uninstall, update.
• skrypt setup.sh do zainstalowania komponentów Edge (chyba że do zainstalowania wymaganych pakietów RPM użyto już polecenia „apigee-service install”). Następnie dostęp na poziomie roota lub pełny dostęp sudo (jeśli 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ć inne polecenia niż te pokazane powyżej, musi mieć pełny dostęp do polecenia sudo dla użytkownika „apigee”. Obejmują one:

• 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 do użytkownika „apigee” za pomocą polecenia sudo, użyj polecenia „visudo”, aby edytować plik sudoers i dodać:

installUser        ALL=(apigee)      NOPASSWD: ALL

gdzie installUser to nazwa użytkownika osoby pracującej w 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 zapewnić dostępność poleceń Edge:

1. Utwórz plik w edytorze jako dowolny użytkownik.
2. chown właściciela pliku na „apigee:apigee” lub, jeśli użytkownik uruchamiający usługę Edge został zmieniony z „apigee”, zmień właściciela pliku na użytkownika, który uruchamia usługę Edge.

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

Najprościej jest przeprowadzić cały proces instalacji Edge jako root lub użytkownik z pełnym dostępem 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 sudo do użytkownika „apigee”.

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

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

      W tym kroku instalowane jest narzędzie apigee-service i tworzony jest użytkownik „apigee”.

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

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

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

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

      Pakiety RPM Edge instalowane 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-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 pakiety RPM Edge, użytkownik z pełnym dostępem sudo do 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ę ZooKeepera i Cassandry, 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

Musisz przekazać do narzędzia apigee-setup plik konfiguracji zawierający informacje o instalacji Edge. Jedynym wymaganiem dotyczącym instalacji cichej jest to, że plik konfiguracyjny musi być dostępny lub czytelny dla użytkownika „apigee”. Na przykład umieść plik w katalogu /usr/local/var lub /usr/local/share na węźle i chown go do „apigee:apigee”.

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

Jeśli podczas instalacji komponentu Edge wystąpi błąd, możesz spróbować go naprawić, a potem ponownie uruchomić instalator. Instalator jest przeznaczony do wielokrotnego uruchamiania w przypadku wykrycia błędu lub jeśli później chcesz zmienić lub zaktualizować komponent po instalacji.

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

Instalacja z internetu lub bez niego

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, 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ą uzyskać dostęp do kopii repozytorium Apigee, którą skonfigurujesz wewnętrznie. To repozytorium zawiera wszystkie pakiety RPM Edge, ale musisz mieć pewność, ż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 wewnętrznego repozytorium możesz przenieść go do innego węzła lub udostępnić ten węzeł węzłom Edge w celu instalacji.

Używanie lokalnego repozytorium Edge do utrzymywania wersji Edge

Jednym z powodów korzystania z lokalnego lub zduplikowanego 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 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 ma podanego numeru wersji każdego komponentu.

Jeśli instalujesz węzeł na maszynie z dostępem do internetu, może on 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.

Często używane polecenia Yum

Narzędzia instalacyjne Edge dla systemu Linux korzystają z Yum do instalowania i aktualizowania komponentów. Aby zarządzać 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 na urządzeniach brzegowych główny katalog instalacyjny jest oznaczony jako:

/opt/apigee

Instalacja wykorzystuje do wdrażania Apigee Edge for Private Cloud następującą strukturę systemu plików.

Pliki dziennika

Plik dziennika dla apigee-setup i skryptu setup.sh jest zapisywany w lokalizacji /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 tym 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 konfiguracyjny 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 w przypadku instalowanego komponentu. Wartość domyślna to „n”, co oznacza wyłączenie sprawdzania.