Omówienie instalacji brzegowej

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

Proces instalacji

Instalowanie Edge w węźle to proces wieloetapowy:

1. Wyłącz SELinux w węźle lub ustaw go w trybie zezwalającym. 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ę master-standby dla Postgres.
4. Wybierz konfigurację Edge z listy zalecanych topologii. Możesz na przykład zainstalować Edge w jednym węźle do testowania lub w 13 węzłach do środowiska produkcyjnego. Więcej informacji znajdziesz w artykule o topologiach instalacji.
5. Na każdym węźle w wybranej topologii zainstaluj narzędzie Edge apigee-setup:
   • Pobierz plik Edge bootstrap_4.19.06.sh do /tmp/bootstrap_4.19.06.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 apigee-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.

   Zobacz 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, 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 uruchom ponownie komponent Classic UI 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 dla deweloperów i administratorów Apigee Edge dla chmury prywatnej.

   Więcej informacji znajdziesz w artykule o instalowaniu 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 instalować, odinstalowywać i aktualizować 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 użytkownikiem z pełnym dostępem sudo:

• apigee-service:
  • apigee-service commands: install, uninstall, update.
  • apigee-all commands: install, uninstall, update.
• Skrypt setup.sh do instalowania komponentów Edge (chyba że do zainstalowania wymaganych pakietów RPM użyto już polecenia „apigee-service install”). W takim przypadku dostęp na poziomie roota lub pełny dostęp 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 działać 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 sudo do użytkownika „apigee”. Te polecenia to:

• 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 zmodyfikować 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 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 konfiguracji.

Podczas tworzenia pliku konfiguracji możesz zmienić jego właściciela na „apigee:apigee”, aby zapewnić dostęp do niego poleceniom Edge:

1. Utwórz plik w edytorze jako dowolny użytkownik.
2. chown właściciela pliku na „apigee:apigee” lub, jeśli zmieniono użytkownika, który uruchamia usługę Edge, na użytkownika „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 użytkownik 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.19.06.sh:

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

      Ten krok obejmuje instalację narzędzia apigee-service i utworzenie użytkownika „apigee”.

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

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

      Pakiety RPM Edge, które instalujesz w 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 pakiety RPM Edge w węźle, użytkownik z pełnym dostępem sudo do użytkownika „apigee” kończy proces konfiguracji:
   1. Użyj narzędzia setup.sh, aby dokończyć konfigurację komponentów Edge w węźle. Forma polecenia zależy od komponentów zainstalowanych w węźle. Pełną listę znajdziesz w artykule Instalowanie komponentów Edge w 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.

      Możesz też wykonać instalację typu „wszystko w jednym”, używając 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 dotyczącym instalacji cichych jest to, że plik konfiguracji musi być dostępny lub możliwy do odczytania przez użytkownika „apigee”. Na przykład umieść plik w katalogu /usr/local/var lub /usr/local/share w węźle i zmień jego właściciela na „apigee:apigee” za pomocą polecenia chown.

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

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

Postępowanie w przypadku niepowodzenia instalacji

Jeśli podczas instalacji komponentu Edge wystąpi błąd, możesz spróbować go naprawić, a następnie 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 pamiętaj, aby ponownie uruchomić komponent interfejsu 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, węzeł musi mieć dostęp do repozytorium Apigee:

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

  Węzły z zewnętrznym połączeniem internetowym uzyskują dostęp do repozytorium Apigee, aby zainstalować pakiety 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 skonfigurowanej wewnętrznie kopii lustrzanej repozytorium Apigee. To repozytorium zawiera wszystkie pakiety RPM Edge, ale musisz upewnić się, że wszystkie inne zależności są dostępne w repozytoriach w sieci wewnętrznej.

  Aby utworzyć wewnętrzne repozytorium Apigee, musisz mieć węzeł z zewnętrznym dostępem do internetu, aby móc pobierać 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 korzystania z lokalnego lub kopii lustrzanej 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ę zmienić w dowolnym momencie. Dlatego w dokumentacji nie podano konkretnego numeru wersji każdej zależności.

Jeśli przeprowadzasz instalację na komputerze 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 skopiowanie ich do lokalnego repozytorium, aż instalacja się powiedzie.

Najczęstsze polecenia Yum

Narzędzia instalacyjne Edge dla Linuksa korzystają z Yum do instalowania i aktualizowania komponentów. Do zarządzania instalacją w 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 oraz 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 /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 lokalizacje plików dziennika:

Dane

Włącz sprawdzanie 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.