Uaktualnianie portalu usług dla deweloperów

Developer Services Portal w wersji 4.17.09

Ta procedura opisuje, jak uaktualnić istniejącą lokalną instalację usług kanału dewelopera Apigee.

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 bieżący 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 być obecne.

  • /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 portalu w postaci:

    *:80
  192.168.56.102
  (/etc/httpd/conf/vhosts/devportal.conf:1)

Domyślny katalog instalacyjny

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

  • 4.17.05 i nowsze: /opt/apigee/apigee-drupal/wwwroot
  • Przed wersją 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 poniższej procedurze, 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 przypadku istniejących instalacji zmodyfikowano kod w rdzeniu Drupala lub w dowolnych modułach niestandardowych, modyfikacje zostaną zastąpione. Obejmuje to m.in. wszelkie zmiany wprowadzone w .htaccess. Możesz założyć, że wszystko poza katalogiem /sites należy do Drupal. Wyjątkiem od tej reguły jest plik robots.txt. Jeśli znajduje się on w głównym katalogu witryny, zostanie zachowany.

Zanim przejdziesz do instalacji, utwórz kopię zapasową całego katalogu głównego witryny Drupal. Po wykonaniu opisanych poniżej czynności instalacyjnych możesz przywrócić dostosowania z kopii zapasowej.

Uaktualnianie portalu za pomocą RPM

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

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

    cd /opt/apigee/apigee-drupal/wwwroot

    Domyślny katalog dla Twojej wersji usługi znajdziesz w artykule Domyślny katalog instalacyjny.

  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 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 określonego przez właściwość DRUPAL_PG_PASS w pliku konfiguracji instalacji portalu.

    Jeśli później będziesz potrzebować przywrócić dane 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 katalogu głównego witryny Drupal. Domyślna lokalizacja instalacji to /opt/apigee/apigee-drupal, ale mogła zostać zmieniona.
    Jeśli nie masz pewności, gdzie znajduje się ten katalog, użyj polecenia drush status lub wpisu Konfiguracja > Multimedia > Plik w menu Drupal, aby określić lokalizację publicznego systemu plików i ścieżkę prywatnego systemu plików (na potrzeby następnego kroku).
  4. Utwórz kopię zapasową plików w folderze /opt/apigee/data/apigee-drupal-devportal/private.
  5. Ustaw Drupal w tryb konserwacji:
    1. W menu Drupal wybierz Configuration (Konfiguracja).
    2. Na stronie Konfiguracja w sekcji Programowanie wybierz Tryb konserwacji.
    3. Zaznacz pole Put site into maintenance mode (Przełącz witrynę w tryb konserwacji).
    4. Wpisz komunikat, który użytkownicy zobaczą podczas konserwacji.
    5. Kliknij Zapisz konfigurację.
  6. Wyłącz SELinux zgodnie z opisem w artykule Instalowanie narzędzia Edge apigee-setup.
  7. Przejdź do katalogu /opt: 
    cd /opt
  8. W przypadku uaktualnienia na serwerze z połączeniem internetowym:
    1. Pobierz plik bootstrap_4.17.09.sh Edge 4.17.09 do /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 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ą Javę 1.8. Możesz użyć opcji „C”, aby kontynuować bez instalowania Javy.

  9. W przypadku uaktualnienia na serwerze bez połączenia z internetem:
    1. Utwórz lokalne repozytorium 4.17.09 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia apigee-setup w Edge.
    2. Aby zainstalować apigee-service z pliku .tar:
      1. W 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. Możesz go na przykład skopiować 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 tworzy nowy katalog o nazwie repos w katalogu zawierającym plik .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.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Zwróć uwagę, że w tym poleceniu podajesz ścieżkę do katalogu repozytoriów.

    3. Aby zainstalować apigee-service przy użyciu serwera WWW Nginx:
      1. Skonfiguruj serwer WWW Nginx zgodnie z opisem w sekcji „Instalowanie z repozytorium przy użyciu serwera WWW Nginx” w artykule Instalowanie narzędzia apigee-setup w Edge.
      2. Na 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. W węźle zdalnym zainstaluj narzędzie Edge apigee-service i zależności:code 
        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 do repozytorium.

  10. Użyj 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, aby zaktualizować bazę danych Postgres:
    /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 możliwy do odczytu przez użytkownika „apigee”.

  12. Uruchom Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  13. Uruchom narzędzie do aktualizacji w 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. Jedynym wymaganiem dotyczącym pliku konfiguracji jest to, że musi on być dostępny lub możliwy do odczytu przez użytkownika „apigee”.

  14. Uruchom skrypt update.php systemu Drupal, otwierając ten adres URL w oknie przeglądarki: 
    http://portalIP_DNS:8079/update.php
  15. Przełącz Drupal w tryb konserwacji:
    1. W menu Drupal wybierz Configuration (Konfiguracja).
    2. Na stronie Configuration (Konfiguracja) w sekcji Development (Programowanie) wybierz Maintenance mode (Tryb konserwacji).
    3. Odznacz pole Przełącz witrynę w tryb konserwacji.
    4. Kliknij Zapisz konfigurację.

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

/opt/apigee/apigee-drupal/wwwroot

Uaktualnienie zostało zakończone.