Ta procedura opisuje, jak uaktualnić istniejący portal usług Apigee dla programistów (lub po prostu portal) w jego środowisku lokalnym. instalacji.
.Określ prawidłową procedurę aktualizacji
Procedura aktualizowania portalu zależy od bieżącej instalacji:
- Jeśli Twoja instalacja korzysta z Nginx/Postgres, użyj Uaktualnianie portalu za pomocą pakietów RPM poniżej.
- Jeśli Twoja instalacja korzysta z Apache/MySQL lub Apache/MariaDB, Konwertuj do portalu opartego na RPM.
Określ obecny typ instalacji
Jeśli nie masz pewności co do typu bieżącej instalacji, użyj tego polecenia, aby określić :
ls /opt
Jeśli używasz Nginx/Postgres, zobaczysz te katalogi:
/opt/apigee
i/opt/nginx
.Jeśli używasz Apache/MySQL lub Apache/MariaDB, te katalogi nie powinny być obecnie.
/opt/apigee/apigee-service/bin/apigee-all status
Jeśli używasz Nginx/Postgres, zobaczysz te dane wyjściowe:
+ apigee-service apigee-drupal-devportal status OK: apigee-drupal-devportal is up and running + apigee-service apigee-lb status apigee-service: apigee-lb: OK + apigee-service apigee-postgresql status apigee-service: apigee-postgresql: OK
apachectl -S
Jeśli używasz Apache/MySQL lub Apache/MariaDB, to polecenie powinno zwrócić adres internetowy katalogu głównym portalu w formacie:
*:80 192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)
Domyślny katalog instalacji
W procesie uaktualniania przyjęto, że portal został zainstalowany pod adresem:
- 4.17.05 i nowsze:
/opt/apigee/apigee-drupal/wwwroot
- Przed 4.17.05:
/opt/apigee/apigee-drupal
(Nginx) lub/var/www/html
(Apache)
Jeśli portal nie został zainstalowany w katalogu domyślnym, zmodyfikuj ścieżki w ramach procedury poniżej, aby użyć katalogu instalacji.
Obsługiwane wersje licencji
Ta procedura uaktualniania jest obsługiwana w portalu w wersji OPDK-17-01.x i nowszych.
Aby określić wersję portalu, otwórz w przeglądarce ten adres URL:
http://yourportal.com/buildInfo
Przed aktualizacją
w istniejących instalacjach, jeśli zmodyfikowano kod w rdzeniu Drupala lub w dowolnym
moduły, wprowadzone zmiany zostaną zastąpione. Obejmuje to między innymi wszelkie zmiany
co mogło wyświetlić się na stronie .htaccess
.
Możesz założyć, że wszystko, co znajduje się poza katalogiem /sites
, należy do Drupala. An
wyjątek od tej reguły to robots.txt
; jeśli ten plik istnieje w katalogu głównym, zostanie
dla Ciebie.
Przed rozpoczęciem instalacji utwórz kopię zapasową całego internetowego katalogu głównego Drupala. katalogu. Po wykonaniu opisanych poniżej czynności instalacyjnych możesz przywrócić plik dostosowania z kopii zapasowej.
Uaktualnianie portalu za pomocą pakietów RPM
Aby zaktualizować RPM portalu w węźle:
- Przejdź do katalogu Drupal, domyślnie
/opt/apigee/apigee-drupal
:cd /opt/apigee/apigee-drupal
- Utwórz kopię zapasową instancji bazy danych Drupal. Polecenie
pg_dump
tworzy kopię pliku baza danych:pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin --password --format=c > /tmp/portal.dmp
Gdzie:
- devportal to nazwa bazy danych określona przez
Właściwość
PG_NAME
w pliku konfiguracji instalacji portalu. - host_IP_address to adres IP węzła portalu.
- drupaladmin to nazwa użytkownika Postgres używana przez portal do uzyskiwania dostępu do
baza danych zgodnie z właściwością
DRUPAL_PG_USER
w instalacji portalu .
Pojawi się prośba o podanie hasła użytkownika Postgres zgodnie z definicją Właściwość
DRUPAL_PG_PASS
w pliku konfiguracji instalacji portalu.Jeśli zechcesz później przywrócić dane z kopii zapasowej, użyj tego polecenia:
pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
- devportal to nazwa bazy danych określona przez
Właściwość
- Utwórz kopię zapasową całego internetowego katalogu głównego Drupala. Domyślna lokalizacja instalacji
to
/opt/apigee/apigee-drupal
, ale mogło zostać zmienione przez Ciebie.Jeśli nie masz pewności co do lokalizacji tego katalogu, użyj polecenia
drush status
lub Konfiguracja > Multimedia > Plik w menu Drupala, aby określić lokalizację publicznego systemu plików i ścieżki prywatnego systemu plików (kolejne ). - Utwórz kopię zapasową plików z usługi
/opt/apigee/data/apigee-drupal-devportal/private
. - Ustaw Drupala w trybie konserwacji:
- W menu Drupal wybierz Konfiguracja.
- Na stronie Configuration (Konfiguracja) wybierz Maintenance mode (Tryb konserwacji). w sekcji Dla programistów.
- Zaznacz pole Umieść witrynę w trybie konserwacji.
- Wpisz wiadomość, którą użytkownicy zobaczą podczas konserwacji.
- Kliknij Zapisz konfigurację.
- Wyłącz SELinux w sposób opisany w Zainstaluj narzędzie Edge apigee-setup.
- Przejdź do katalogu
/opt
:cd /opt
- Aby uaktualnić serwer z połączeniem internetowym:
- Pobierz plik Edge w wersji 4.19.06
bootstrap_4.19.06.sh
do/tmp/bootstrap_4.19.06.sh
:curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
- Zainstaluj narzędzie i zależności w Edge w wersji 4.19.06
apigee-service
:sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
Gdzie uName i pWord to otrzymana nazwa użytkownika i hasło z Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.
Domyślnie instalator sprawdza, czy zainstalowano środowisko Java 1.8. Za pomocą „C” kontynuowania bez instalowania środowiska Java.
- Pobierz plik Edge w wersji 4.19.06
- Aby uaktualnić serwer na serwerze bez połączenia z internetem:
- Utwórz lokalne repozytorium 19.06 zgodnie z opisem w sekcji Utwórz lokalne repozytorium Apigee.
- Aby zainstalować usługę apigee z pliku .tar:
- W węźle z lokalnym repozytorium użyj tego polecenia, aby spakować lokalne zasoby
do jednego pliku .tar o nazwie
/opt/apigee/data/apigee-mirror/apigee-4.19.06.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Skopiuj plik .tar do węzła, w którym chcesz zaktualizować Edge. Na przykład skopiuj go
do katalogu
/tmp
w nowym węźle. - W nowym węźle wypakuj plik do katalogu /tmp:
tar -xzf apigee-4.19.06.tar.gz
To polecenie utworzy nowy katalog o nazwie „repos” w katalogu zawierającym pliki .tar . Na przykład /tmp/repos.
- Zainstaluj narzędzie Edge
apigee-service
i zależności z/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.19.06.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Zwróć uwagę, że w tym poleceniu umieszczasz ścieżkę do katalogu repozytoriów.
- W węźle z lokalnym repozytorium użyj tego polecenia, aby spakować lokalne zasoby
do jednego pliku .tar o nazwie
- Aby zainstalować usługę apigee za pomocą serwera WWW Nginx:
- Skonfiguruj serwer WWW Nginx zgodnie z opisem w sekcji „Instalowanie z repozytorium przy użyciu Serwer WWW Nginx na stronie Install the Edge apigee-setup.
- W węźle zdalnym pobierz plik Edge
bootstrap_4.19.06.sh
do/tmp/bootstrap_4.19.06.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
Gdzie uName i pWord to nazwa użytkownika i hasło, które zostały ustawione powyżej dla repozytorium, a remoteRepo to adres IP lub nazwa DNS z repozytorium.
- W węźle zdalnym zainstaluj narzędzie Edge
apigee-service
oraz zależności:sudo bash /tmp/bootstrap_4.19.06.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Gdzie uName i pWord to nazwa użytkownika i hasło repozytorium.
- Użyj narzędzia
apigee-service
, aby zaktualizować narzędzieapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Uruchom narzędzie
update
w węźle Postgres:/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Gdzie configFile to plik konfiguracji użyty do zainstalowania do bazy danych Postgres. Plik konfiguracji musi zawierać tylko plik musi być dostępny lub czytelny dla „apigee” użytkownika.