Uaktualnianie portalu usług dla deweloperów

Edge for Private Cloud w wersji 4.18.01

Z tej procedury dowiesz się, jak uaktualnić istniejącą instalację usług kanału dla deweloperów Apigee w centrum danych.

Określanie prawidłowej procedury aktualizacji

Procedura aktualizowania portalu jest uzależniona od bieżącej instalacji:

Określanie 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 istnieć.

  • /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

Proces uaktualniania zakłada, że portal dla programistów został zainstalowany pod adresem:

  • 4.17.05 lub 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 uaktualnienia

Ta procedura uaktualniania jest obsługiwana w przypadku tych wersji portalu:

  • OPDK-17-01.x,
  • OPDK-17-05.x
  • OPDK-17-09.x

Aby określić wersję portalu, otwórz w przeglądarce ten adres URL:

http://yourportal.com/buildInfo

Przed aktualizacją

Jeśli w dotychczasowych instalacjach zmodyfikowano kod w jądrze Drupal lub w niestandardowych modułach, zmiany te zostaną zastąpione. Obejmuje to m.in. wszelkie zmiany wprowadzone przez Ciebie w .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 katalogu głównego witryny Drupal. Po wykonaniu opisanych poniżej czynności instalacyjnych możesz przywrócić swoje niestandardowe ustawienia z kopii zapasowej.

Uaktualnianie portalu za pomocą RPM

Aby zaktualizować RPM portalu w węźle:

  1. Zmień domyślnie katalog Drupala na /opt/apigee/apigee-drupal: 
    cd /opt/apigee/apigee-drupal
  2. Utwórz kopię zapasową instancji bazy danych Drupal. Polecenie pg_dump tworzy kopię pliku baza danych: 
    pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin
  --password --format=c > /tmp/portal.dmp

    gdzie:

    • dbname określa nazwę bazy danych zgodnie z definicją właściwości PG_NAME w pliku konfiguracji instalacji portalu.
    • host określa adres IP węzła portalu.
    • username określa nazwę użytkownika Postgres używaną przez portal do uzyskiwania dostępu do bazy danych zgodnie z wartością właściwości DRUPAL_PG_USER w pliku konfiguracji instalacji portalu.
    • Pojawi się prośba o podanie hasła użytkownika Postgres zgodnie z definicją właściwości DRUPAL_PG_PASS w pliku konfiguracji instalacji portalu.

    Jeśli później zajdzie potrzeba przywrócenia z kopii zapasowej, użyj polecenia:

    pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp
  3. 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, gdzie znajduje się ten katalog, użyj polecenia drush status lub wpisu Konfiguracja > Media > Plik w menu Drupala, aby określić lokalizację ścieżki publicznego i prywatnego systemu plików (na potrzeby następnego kroku).

  4. Utwórz kopię zapasową plików z usługi /opt/apigee/data/apigee-drupal-devportal/private.
  5. Ustaw Drupal w trybie konserwacji:
    1. W menu Drupal kliknij Konfiguracja.
    2. Na stronie Konfiguracja w sekcji Rozwój wybierz Tryb konserwacji.
    3. Zaznacz pole Wprowadź witrynę w tryb konserwacji.
    4. Wpisz wiadomość, którą użytkownicy zobaczą podczas konserwacji.
    5. Kliknij Zapisz konfigurację.
  6. Wyłącz SELinux w sposób opisany w Zainstaluj narzędzie Edge apigee-setup.
  7. Przejdź do katalogu /opt: 
    > cd /opt
  8. Aby uaktualnić serwer z połączeniem internetowym:
    1. Pobierz plik bootstrap_4.18.01.sh Edge 4.18.01 do folderu /tmp/bootstrap_4.18.01.sh: 
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
    2. Zainstaluj narzędzie Edge 4.18.01 apigee-service i zależne od niego komponenty: 
      sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

      gdzie uName:pWord to nazwa użytkownika i hasło, z których pochodzą 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.

  9. Aby uaktualnić serwer na serwerze bez połączenia z internetem:
    1. Utwórz lokalne repozytorium 4.18.01 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” o Instalowanie Edge apigee-setup.
    2. Aby zainstalować apige-service z pliku .tar:
      1. Na węźle z lokalnym repozytorium użyj tego polecenia, aby spakować lokalne repozytorium do pojedynczego pliku tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz: 
         /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. Skopiuj plik .tar do węzła, w którym chcesz zaktualizować Edge. Możesz na przykład skopiować plik do katalogu /tmp w nowym węźle.
      3. W nowym węźle wypakuj plik do katalogu /tmp: 
        tar -xzf apigee-4.18.01.tar.gz

        To polecenie utworzy nowy katalog o nazwie „repos” w katalogu zawierającym pliki .tar . Na przykład /tmp/repos.

      4. Zainstaluj narzędzie Edge apigee-service i zależności z /tmp/repos: 
        sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Zwróć uwagę, że w tym poleceniu musisz podać ścieżkę do katalogu repozytorium.

    3. Aby zainstalować apige-service przy użyciu serwera WWW Nginx:
      1. 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.
      2. Na węźle zdalnym pobierz plik Edge bootstrap_4.18.01.sh do folderu /tmp/bootstrap_4.18.01.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh
  -o /tmp/bootstrap_4.18.01.sh

        gdzie uName:pWord to nazwa użytkownika i hasło ustawione powyżej dla repozytorium, a remoteRepo to adres IP lub nazwa DNS węzła repozytorium.

      3. Na węźle zdalnym zainstaluj narzędzie apigee-service i odpowiednie zależności: 
        sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939
    apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        gdzie uName:pWord to nazwa użytkownika i hasło repozytorium.

  10. Użyj narzędzia apigee-service, aby zaktualizować narzędzie apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Uruchom narzędzie do aktualizacji na węźle Postgre: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    gdzie configFile to plik konfiguracji użyty do zainstalowania bazy danych Postgres. Jedynym wymaganiem dotyczącym pliku konfiguracji jest to, że musi on być dostępny lub czytelny dla użytkownika „apigee”.

  12. Zaktualizuj bazę danych Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  13. Uruchom narzędzie do aktualizacji w swoim węźle, aby zaktualizować portal: 
    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    gdzie configFile to plik konfiguracji użyty do zainstalowania portalu. Plik konfiguracji musi zawierać wyłącznie musi być dostępna lub czytelna dla „apigee” użytkownika.

  14. Uruchom skrypt update.php Drupala, otwierając ten URL w oknie przeglądarki: 
    http://portalIP_DNS:8079/update.php
  15. Wyłączanie Drupala w trybie konserwacji:
    1. W menu Drupal wybierz Konfiguracja.
    2. Na stronie Configuration (Konfiguracja) wybierz Konserwacja. trybu w sekcji Dla programistów.
    3. Odznacz pole Umieść witrynę w trybie konserwacji.
    4. Kliknij Zapisz konfigurację.

Pamiętaj, że po aktualizacji katalog główny to:

/opt/apigee/apigee-drupal/wwwroot

Uaktualnienie zostało zakończone.