Aby zainstalować Edge w węźle, najpierw zainstaluj narzędzie Edge apigee-setup. Jeśli pracujesz 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 instalacji: /opt/apigee
Edge instaluje wszystkie pliki z katalogu /opt/apigee
. Nie możesz zmienić tego katalogu. W razie potrzeby możesz jednak utworzyć dowiązanie symboliczne, aby zmapować /opt/apigee
na inną lokalizację. Więcej informacji znajdziesz w sekcji Wymagania dotyczące instalacji.
Warunek wstępny: wyłącz SELinux
Zanim zainstalujesz narzędzie Edge apigee-setup
lub jakiekolwiek komponenty Edge, musisz wyłączyć funkcję SELinux lub ustawić ją w trybie mniej rygorystycznym. W razie potrzeby po zainstalowaniu Edge możesz ponownie włączyć SELinux.
- Aby tymczasowo ustawić SELinux na tryb mniej rygorystyczny, uruchom to polecenie:
- W systemie operacyjnym Linux 6.x:
sudo echo 0 > /selinux/enforce
Aby ponownie włączyć SELinux po zainstalowaniu Edge:
sudo echo 1 > /selinux/enforce
- W systemie operacyjnym Linux 7.x:
sudo setenforce 0
Aby ponownie włączyć SELinux po zainstalowaniu Edge:
sudo setenforce 1
- W systemie operacyjnym Linux 6.x:
- Aby trwale wyłączyć SELinux lub ustawić tryb mniej rygorystyczny:
- Otwórz plik
/etc/sysconfig/selinux
w edytorze. - Ustaw
SELINUX=disabled
lubSELINUX=permissive
- Zapisz zmiany.
- Ponownie uruchom węzeł.
- W razie potrzeby ponownie włącz SELinux po instalacji Edge, powtarzając tę procedurę, aby ustawić
SELINUX=enabled
.
- Otwórz plik
Wymaganie wstępne: włącz repozytorium EPEL
Aby zainstalować lub zaktualizować Edge albo utworzyć lokalne repozytorium, musisz włączyć Dodatkowe pakiety dla Enterprise Linux (lub EPEL). Sposób użycia polecenia zależy od używanej wersji RedHat/CentOS:
W przypadku Red Hat Enterprise Linux (RHEL) 8.0 zobacz Wymagania wstępne dla RHEL 8.
- Red Hat/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
- Red Hat/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
- W przypadku AWS-2:
sudo amazon-linux-extras install epel -y
sudo yum-config-manager --enable epel
Warunek wstępny: sprawdź wersję biblioteki libdb4 w RedHat 7.4 i CentOS 7.4
Na urządzeniach RedHat 7.4 i CentOS 7.4 sprawdź przed instalacją wersję libdb4
RPM. Edge wymaga wersji 4.8, a niektóre wersje RedHat 7.4 i CentOS 7.4 są wysyłane z nowszą wersją. Jeśli masz nowszą wersję, odinstaluj ją, a instalator Edge zainstaluje wersję 4.8.
Wersję możesz sprawdzić przy użyciu tego polecenia:
rpm -qa | grep libdb4
Jeśli zauważysz, że wersja libdb4
RPM jest nowsza niż wersja 4.8, odinstaluj ją.
Wymagania wstępne RHEL 8
Jeśli instalujesz Edge na serwerze z systemem Red Hat Enterprise Linux (RHEL) 8, przed przeprowadzeniem instalacji wykonaj te czynności:
- Włącz Dodatkowe pakiety dla Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
- Wyłącz Postgres i Nginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- Zainstaluj Pythona 2:
sudo dnf install -y python2
Zainstaluj narzędzie Edge apigee-setup w węźle z zewnętrznym połączeniem internetowym
Aby zainstalować Edge w węźle z zewnętrznym połączeniem internetowym:
- Uzyskaj z Apigee nazwę użytkownika i hasło, których używasz do uzyskiwania dostępu do repozytorium Apigee. Jeśli masz zasób username:password dla witryny ftp witryny Apigee, możesz użyć tych danych.
- Aby zainstalować pakiety RPM Edge, zaloguj się w węźle jako root.
- Zainstaluj
yum-utils
iyum-plugin-priorities
.sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Wyłącz SELinux.
- Włącz repozytorium EPEL.
- Sprawdź swoją wersję systemu
libdb4
. - Jeśli instalujesz na RHEL 8, wykonaj czynności opisane w artykule Wymagania wstępne dla RHEL 8.
- Jeśli instalujesz w Oracle 7.x, uruchom to polecenie:
sudo yum-config-manager --enable ol7_optional_latest
- Jeśli instalujesz w AWS, uruchom te 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-optional
- Pobierz plik Edge
bootstrap_4.52.02.sh
na serwer/tmp/bootstrap_4.52.02.sh
:curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
- Zainstaluj narzędzie Edge apigee-service i zależności:
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
Gdzie uName:pWord to nazwa użytkownika i hasło otrzymane z Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.
Domyślnie instalator sprawdza, czy zainstalowano środowisko Java 1.8. Jeśli tego nie zrobisz, aplikacja zainstaluje ją za Ciebie. Użyj opcji
JAVA_FIX
, aby określić sposób obsługi instalacji Javy.JAVA_FIX
przyjmuje następujące wartości:- I: zainstaluj OpenJDK 1.8 (domyślnie)
- C: kontynuuj bez instalowania Javy
- P: Zakończ. Aby skorzystać z tej opcji, musisz samodzielnie zainstalować Javę.
Instalacja narzędzia apigee-service tworzy plik /etc/yum.repos.d/apigee.repo, który definiuje 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*'
- Użyj apigee-service, aby zainstalować narzędzie apigee-setup:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge w węźle. Więcej informacji znajdziesz w artykule o instalowaniu komponentów Edge w węźle.
Rozwiązywanie problemów
Podczas próby instalacji w węźle z zewnętrznym połączeniem internetowym może wystąpić co najmniej jeden z tych błędów:
Cannot open: https:// : @ software.apigee.com//apigee-repo-version.rpm bootstrap.sh: Error: Repo configuration failed error: package package_name is not installed
W poniższej tabeli znajdziesz przykładowe rozwiązania tych błędów:
Typ błędu | Możliwe rozwiązanie |
---|---|
Hasło zawiera nieprawidłowe znaki | Nie używaj znaków specjalnych w haśle Apigee. |
Problemy z łącznością | Sprawdź połączenie sieciowe, wykonując to polecenie nc -v software.apigee.com 443 Powinien wyświetlić się komunikat podobny do tego: Connection to software.apigee.com 443 port [tcp/https] succeeded! Jeśli nie masz zainstalowanej aplikacji telnet software.apigee.com 443 Jeśli polecenie zadziała, możesz nacisnąć CTRL+C, aby przerwać otwarte połączenie. Jeśli któreś z tych poleceń nie powiedzie się, masz ograniczoną łączność sieciową lub nie masz jej wcale. Skontaktuj się z administratorem sieci. |
Nieprawidłowe dane logowania | Upewnij się, że nazwa użytkownika i hasło są poprawne. Sprawdź na przykład, czy pojawia się błąd, gdy próbujesz użyć tego polecenia z nazwą użytkownika i hasłem Apigee: curl -i -u username:password https://software.apigee.com/apigee-repo.rpm |
Problemy z serwerem proxy | Twoja konfiguracja lokalna używa serwera proxy HTTP ruchu wychodzącego, ale nie rozszerzono tej konfiguracji na menedżera pakietów yum . Sprawdź zmienne środowiskowe: echo $http_proxy
W przypadku serwera proxy HTTP dla ruchu wychodzącego należy użyć jednej z tych opcji:
|
Zainstaluj narzędzie Edge apigee-setup w węźle bez zewnętrznego połączenia z internetem
Jeśli węzły brzegowe są za zaporą sieciową lub w inny sposób nie mają dostępu do internetu, musisz utworzyć kilka repozytoriów (tzw. powielań), które zawierają pliki potrzebne podczas instalacji. Takie moduły muszą być wtedy dostępne dla wszystkich węzłów. Po utworzeniu węzły będą miały dostęp do tych lokalnych lustrzanych, aby zainstalować Edge.
Proces instalacji Apigee Edge dla węzłów bez połączenia z internetem wymaga dostępu do tych lokalnych repozytoriów:
- Repozytorium Apigee Edge: zgodnie z opisem w sekcji Tworzenie lokalnego repozytorium Apigee.
- Repozytorium Yu (dla narzędzi takich jak
yum-utils
iyum-plugin-priorities
): Twój zespół operacyjny powinien być w stanie to dla Ciebie skonfigurować. - Dodatkowe pakiety dla Enterprise Linux (lub EPEL): Twój zespół operacyjny powinien być w stanie to skonfigurować.
Tworzenie lokalnego repozytorium Apigee
Do utworzenia wewnętrznego repozytorium Apigee potrzebujesz węzła z zewnętrznym dostępem do internetu, który będzie mógł pobrać RPM i zależności brzegowe. Po utworzeniu wewnętrznego repozytorium możesz przenieść je do innego węzła lub udostępnić je węzłach brzegowych do instalacji.
Po utworzeniu lokalnego repozytorium Apigee może być konieczne zaktualizowanie go za pomocą najnowszych plików wersji Edge. W poniższych sekcjach opisano, jak utworzyć lokalne repozytorium Apigee i jak je zaktualizować.
Aby utworzyć lokalne repozytorium Apigee:
- Uzyskaj z Apigee nazwę użytkownika i hasło, których używasz do uzyskiwania dostępu do repozytorium Apigee. Jeśli masz już nazwę użytkownika i hasło do witryny ftp witryny Apigee, możesz jej użyć.
- Zaloguj się do węzła jako root, aby zainstalować RPM Edge.
- Wyłącz SELinux w sposób opisany powyżej.
- Pobierz plik Edge
bootstrap_4.52.02.sh
na serwer/tmp/bootstrap_4.52.02.sh
:curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
- Zainstaluj narzędzie Edge apigee-service i zależności:
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
Gdzie uName:pWord to nazwa użytkownika i hasło otrzymane z Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.
- Zainstaluj narzędzie
apigee-mirror
w węźle:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
- Aby zsynchronizować repozytorium Apigee z katalogiem
/opt/apigee/data/apigee-mirror/repos/
, użyj narzędziaapigee-mirror
.Aby zminimalizować rozmiar repozytorium, dołącz
--only-new-rpms
, co pozwoli pobrać tylko najnowsze obroty RPM. -
(Opcjonalnie) Jeśli chcesz zainstalować Edge z lokalnego repozytorium w tym samym węźle, który hostuje repozytorium lokalne, najpierw uruchom te polecenia:
- Uruchom
bootstrap_4.52.02.sh
z lokalnego repozytorium, aby zainstalować narzędzieapigee-service
:sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
- Użyj
apigee-service
, aby zainstalować narzędzieapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Użyj narzędzia
apigee-setup
, aby zainstalować i skonfigurować w węźle komponenty Edge. Więcej informacji znajdziesz w artykule o instalowaniu komponentów Edge w węźle.
- Uruchom
Zainstaluj konfigurację apigee w węźle zdalnym z lokalnego repozytorium
Edge możesz zainstalować z lokalnego repozytorium na 2 sposoby. Możesz:
- Utwórz plik .tar repozytorium, skopiuj plik .tar do węzła, a potem zainstaluj Edge z pliku tar.
- Zainstaluj serwer WWW w węźle z lokalnym repozytorium, aby inne węzły miały do niego dostęp. Apigee udostępnia serwer WWW Nginx, z którego możesz korzystać. Możesz też użyć własnego serwera WWW.
Zainstaluj z pliku .tar
Aby zainstalować plik z pliku tar:
- W węźle z lokalnym repozytorium użyj tego polecenia, aby spakować lokalne repozytorium do jednego pliku .tar o nazwie
/opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- 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. - W nowym węźle wyłącz SELinux w sposób opisany powyżej.
- Sprawdź, czy w nowym węźle masz dostęp do lokalnego repozytorium narzędzia Yum oraz do repozytorium EPEL.
- Dokładnie sprawdź, czy wszystkie zewnętrzne repozytoria internetowe są wyłączone (powinno tak być, ponieważ instalujesz urządzenie na komputerze bez dostępu do internetu):
sudo yum repolist
Wszystkie zewnętrzne repozytoria powinny być wyłączone, ale lokalne repozytorium Apigee i wewnętrzne repozytoria powinny być włączone.
- W nowym węźle zainstaluj
yum-utils
iyum-plugin-priorities
z lokalnego repozytorium.sudo yum install yum-utils
sudo yum install yum-plugin-priorities
Twój zespół operacyjny lub inna grupa w organizacji musi skonfigurować lokalne repozytorium, aby umożliwić Ci zainstalowanie narzędzi Yum.
- W nowym węźle sprawdź wersję instancji
libdb4
w sposób opisany powyżej. - Jeśli instalujesz Oracle 7.x,uruchom to polecenie:
sudo yum-config-manager --enable ol7_optional_latest
- Jeśli instalujesz w AWS, uruchom to polecenie
yum-configure-manager
:sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- W nowym węźle wyciągnij plik z katalogu /tmp:
tar -xzf apigee-4.52.02.tar.gz
To polecenie utworzy nowy katalog o nazwie „repos” w katalogu zawierającym plik .tar. Przykład:
/tmp/repos.
- Zainstaluj narzędzie Edge apigee-service i zależności z witryny
/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Zwróć uwagę, że w tym poleceniu umieszczasz ścieżkę do katalogu repozytoriów.
- Użyj
apigee-service
, aby zainstalować narzędzieapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Użyj narzędzia
apigee-setup
, aby zainstalować i skonfigurować w węźle komponenty Edge. Więcej informacji znajdziesz w artykule o instalowaniu komponentów Edge w węźle.
Zainstaluj z repozytorium za pomocą serwera WWW Nginx
Aby przeprowadzić instalację z repozytorium przy użyciu serwera WWW Nginx:
- Zainstaluj serwer WWW Nginx w węźle repozytorium:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
- Domyślnie protokół Nginx jest skonfigurowany do używania hosta lokalnego jako nazwy serwera i portu 3939. Aby zmienić te wartości:
- Otwórz plik
/opt/apigee/customer/application/mirror.properties
w edytorze. Utwórz plik, jeśli nie istnieje. - W razie potrzeby ustaw te wartości:
conf_apigee_mirror_listen_port=3939 conf_apigee_mirror_server_name=localhost
- Uruchom ponownie Nginx:
/opt/nginx/scripts/apigee-nginx restart
- Otwórz plik
- Domyślnie repozytorium wymaga podania wartości nazwa użytkownika:hasło
admin:admin
. Aby zmienić te dane logowania, ustaw te zmienne środowiskowe:MIRROR_USERNAME=uName MIRROR_PASSWORD=pWord
- W nowym węźle zainstaluj
yum-utils
iyum-plugin-priorities
.sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- W nowym węźle wyłącz SELinux w sposób opisany powyżej.
- Sprawdź, czy lokalne repozytorium EPEL jest włączone w nowym węźle.
- W nowym węźle sprawdź wersję instancji
libdb4
w sposób opisany powyżej. - W węźle zdalnym pobierz plik Edge Bootstrap_4.52.02.sh do serwera
/tmp/bootstrap_4.52.02.sh
:curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
Gdzie uName:pWord to nazwa użytkownika i hasło ustawione powyżej, a remoteRepo to adres IP lub nazwa DNS węzła repozytorium.
- Na węźle zdalnym zainstaluj narzędzie Edge
apigee-service
i zależności:sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Gdzie uName:pWord to nazwa użytkownika i hasło repozytorium.
- Na węźle zdalnym użyj
apigee-service
, aby zainstalować narzędzieapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Użyj narzędzia
apigee-setup
, aby zainstalować i skonfigurować komponenty Edge w węźle zdalnym. Więcej informacji znajdziesz w artykule o instalowaniu komponentów Edge w węźle.
Aktualizowanie lokalnego repozytorium Apigee
Aby zaktualizować repozytorium, musisz pobrać najnowszy plik Bostrap_4.52.02.sh i przeprowadzić nową synchronizację.
Aby zaktualizować repozytorium:
- Pobierz plik Edge loadstrap_4.52.02.sh do serwera
/tmp/bootstrap_4.52.02.sh
:curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
- Uruchom plik Edge
bootstrap_4.52.02.sh
:sudo bash/tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
Gdzie uName:pWord to nazwa użytkownika i hasło otrzymane z Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.
- Zaktualizuj
apigee-mirror
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- Przeprowadź synchronizację:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- Jeśli chcesz utworzyć całe repozytorium:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
Czyszczenie lokalnego repozytorium Apigee
Wyczyszczenie lokalnego repozytorium spowoduje usunięcie plików /opt/apigee/data/apigee-mirror i /var/tmp/yum-apigee-*.
Aby wyczyścić lokalne repozytorium, użyj polecenia:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean
Dodaj lub zaktualizuj Edge 4.16.0x/4.17.0x w repozytorium 4.52.02
Jeśli musisz utrzymywać instalacje wersji Edge 4.16.0x lub 4.17.0x w repozytorium 4.52.02, możesz zachować repozytorium zawierające wszystkie wersje. Możesz z niego zainstalować dowolną wersję Edge.
Aby dodać 4.16.0x/4.17.0x do repozytorium 4.52.02:
- Sprawdź, czy masz zainstalowaną wersję narzędzia
apigee-mirror
4.52.02:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
Wynik powinien pojawić się w formularzu poniżej, w którym xyz to numer kompilacji:
apigee-mirror-4.52.02-0.0.xyz
- Pobierz Edge 4.16.0x/4.17.0x do repozytorium za pomocą narzędzia
apigee-mirror
. Zwróć uwagę na to, że do polecenia dodajesz odpowiednią wersję:apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Za pomocą tego samego polecenia możesz później zaktualizować repozytoria 4.16.0x/4.17.0x, podając wymagane numery wersji.
- Sprawdź katalog
/opt/apigee/data/apigee-mirror/repos
, aby zobaczyć strukturę plików:ls /opt/apigee/data/apigee-mirror/repos
Powinny wyświetlić się następujące pliki i katalogi:
apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh bootstrap_4.17.01.sh bootstrap_4.17.05.sh bootstrap_4.17.09.sh bootstrap_4.18.01.sh bootstrap_4.18.05.sh bootstrap_4.19.01.sh thirdparty
Zwróć uwagę, że masz plik wczytywania dla wszystkich wersji Edge. Katalog
apigee
zawiera też osobne katalogi dla każdej wersji Edge. - Aby spakować repozytorium do pliku .tar, użyj tego polecenia:
apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
To polecenie spakuje wszystkie repozytoria 4.17.0x i 4.16.0x w jednym pliku .tar. Nie możesz wpakować tylko części repozytorium.
Jeśli chcesz zainstalować Edge z lokalnego repozytorium lub pliku tar, uruchom właściwy plik wczytywania, korzystając z jednego z tych poleceń. Ten przykład instaluje Edge 4.17.01:
- Jeśli instalujesz plik z pliku tar, uruchom prawidłowy plik wczytywania z repozytorium:
sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Aby dokończyć instalację, wykonaj pozostałe kroki opisane w sekcji „Instalowanie z pliku .tar” powyżej.
- Jeśli instalujesz z użyciem serwera WWW Nginx, pobierz z repozytorium odpowiedni plik wczytywania i uruchom go:
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Aby dokończyć instalację, wykonaj pozostałe czynności opisane powyżej w sekcji „Instalowanie z repozytorium przy użyciu serwera WWW Nginx”.