Uaktualnianie portalu usług dla deweloperów

Portal Usług dla deweloperów w wersji 4.17.09

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 aktualizacji portalu zależy od bieżącej instalacji:

Określanie bieżącego typu instalacji

Jeśli nie masz pewności, jaki jest Twój obecny typ instalacji, użyj tego polecenia, aby go 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ć katalog główny witryny 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
  • Wersja starsza niż 4.17.05: /opt/apigee/apigee-drupal (Nginx) lub /var/www/html (Apache).

Jeśli portal nie został zainstalowany w katalogu domyślnym, zmień ścieżki w procedurze opisanej poniżej, aby użyć katalogu instalacyjnego.

Obsługiwane wersje uaktualnienia

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

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

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

http://your_portal.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. Wyjątkiem od tej reguły jest plik robots.txt. Jeśli istnieje on w katalogu głównym witryny, zostanie zachowany.

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 z wykorzystaniem RPM

Aby zaktualizować RPM portalu w węźle, wykonaj te czynności:

  1. Przejdź do katalogu Drupala. Na przykład: /opt/apigee/apigee-drupal/wwwroot. 

    cd /opt/apigee/apigee-drupal/wwwroot

    Domyślny katalog wersji usługi znajdziesz w sekcji Domyślny katalog instalacji.

  2. Utwórz kopię zapasową instancji bazy danych Drupal. Polecenie pg_dump tworzy kopię bazy 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 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 będziesz musiał przywrócić dane z kopii zapasowej, użyj tego polecenia:

    pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp
  3. Utwórz kopię zapasową całego katalogu głównego witryny Drupal. Domyślna lokalizacja instalacji to /opt/apigee/apigee-drupal, ale możesz ją zmienić.
    Jeśli nie masz pewności, gdzie znajduje się ten katalog, użyj polecenia drush status lub pozycji 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 w /opt/apigee/data/apigee-drupal-devportal/private.
  5. Ustaw Drupal w trybie konserwacji:
    1. W menu Drupal wybierz Konfiguracja.
    2. Na stronie Konfiguracja w sekcji Rozwój wybierz Tryb konserwacji.
    3. Zaznacz pole Umieść witrynę w trybie konserwacji.
    4. Wpisz komunikat, który użytkownicy widzą podczas konserwacji.
    5. Kliknij Zapisz konfigurację.
  6. Wyłącz SELinux zgodnie z opisem w sekcji Instalowanie narzędzia Edge apigee-setup.
  7. Przejdź do katalogu /opt: 
    cd /opt
  8. Aby uaktualnić serwer z połączeniem z internetem:
    1. Pobierz plik bootstrap_4.17.09.sh Edge 4.17.09 do folderu /tmp/bootstrap_4.17.09.sh: 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    2. Zainstaluj narzędzie Edge 4.17.09 apigee-service i odpowiednie zależności: 
      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName
  apigeepassword=pWord

      gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.

      Domyślnie instalator sprawdza, czy masz zainstalowaną wersję Java 1.8. Aby kontynuować bez instalowania Java, możesz użyć opcji „C”.

  9. Aby uaktualnić serwer bez połączenia z Internetem:
    1. Utwórz lokalne repozytorium 4.17.09 zgodnie z instrukcjami podanymi w artykule „Tworzenie lokalnego repozytorium Apigee” na stronie Instalowanie pakietu 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.17.09.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. Na przykład skopiuj go do katalogu /tmp w nowym węźle.
      3. Na nowym węźle rozpakuj plik do katalogu /tmp:
        tar -xzf apigee-4.17.09.tar.gz

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

      4. Zainstaluj narzędzie apigee-service i odpowiednie zależności z /tmp/repos: 
        sudo bash /tmp/repos/bootstrap_4.17.09.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 instrukcjami podanymi w sekcji „Install from the repo using the Nginx webserver” (Instalowanie z repozytorium za pomocą serwera WWW Nginx) w artykule Install the Edge apigee-setup utility (Instalowanie narzędzia apigee-setup na Edge).
      2. W węźle zdalnym pobierz plik Edge bootstrap_4.17.09.sh do /tmp/bootstrap_4.17.09.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh
  -o /tmp/bootstrap_4.17.09.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.17.09.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

  10. Aby zaktualizować narzędzie apigee-setup, użyj aplikacji apigee-service: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Aby zaktualizować bazę danych Postgres, uruchom na węźle narzędzie do aktualizacji:
    /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. Uruchom Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  13. Aby zaktualizować portal, uruchom na węźle narzędzie do aktualizacji: 
    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

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

  14. Uruchom skrypt update.php w Drupalu, otwierając ten adres 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) w sekcji Development (Programowanie) wybierz Maintenance mode (Tryb konserwacji).
    3. Odznacz pole Wprowadź witrynę w tryb konserwacji.
    4. Kliknij Zapisz konfigurację.

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

/opt/apigee/apigee-drupal/wwwroot

Uaktualnienie zostało zakończone.