Uaktualnianie portalu usług dla deweloperów

Developer Services Portal w wersji 4.17.05

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:

  • /opt/apigee/apigee-drupal (Nginx)
  • /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.

Jeśli nie znasz katalogu instalacyjnego, możesz go określić w sposób opisany w sekcji Często używane polecenia Drush.

Nowy domyślny katalog instalacji po aktualizacji Nginx/Postgres z nowej instalacji 4.17.01

Po zaktualizowaniu nowej instalacji wersji 4.17.01, która używa Nginx/Postgres, katalog główny zmienił się z:

/opt/apigee/apigee-drupal

do:

/opt/apigee/apigee-drupal/wwwroot

Obsługiwane wersje uaktualnienia

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

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x
  • OPDK-16-09.x
  • OPDK-17-01.x

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

http://yourportal.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 pliku .htaccess. Należy założyć, że wszystko poza katalogiem /sites należy do platformy Drupal. Wyjątkiem od tej reguły jest plik robots.txt. Jeśli ten plik znajduje się w katalogu głównym 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ą pliku .tar

  1. Utwórz kopię zapasową instancji Drupal MySQL/MariaDB.
    Więcej informacji znajdziesz na stronie http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/.
    1. Opcja 1. Użycie Drush

      Polecenie Drush sql-dump tworzy kopię bazy danych. W katalogu Drupal (domyślnie /var/www/html) uruchom polecenie:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      Aby uzyskać więcej informacji, użyj polecenia drush help sql-dump.
    2. Opcja 2. Użycie MySQLdump
      Użyj polecenia mysqldump, aby utworzyć kopię bazy danych:
      mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql

      Między opcją -p a hasłem nie powinno być spacji. Jeśli hasło zawiera znaki specjalne, należy je ująć w pojedynczy cudzysłów.

      Wartości USERNAME i DATABASENAME zostały ustawione podczas instalacji portalu. Domyślnie obie wartości to devportal.
  2. Utwórz kopię zapasową całego katalogu głównego witryny Drupal. Domyślna lokalizacja instalacji to /var/www/html, ale mogła zostać zmieniona podczas instalacji.
  3. Pobierz plik Developer Channel Services DeveloperServices_x.y.z.tar z ftp.apigee.com, gdzie x.y.z odpowiada numerowi wersji portalu. Gdy pojawi się prośba, wpisz dane logowania otrzymane od Apigee.

    Możesz pobrać plik z linku wysłanego przez Apigee w przeglądarce lub skopiować go i dodać do tego polecenia cURL:
    > curl -kOL <paste link here>

    Uwaga: jeśli Twój portal znajduje się na serwerze bez zewnętrznego połączenia z internetem, wykonaj ten krok na serwerze z dostępem.

    Otwórz Apigee Edge Support i wybierz Login to your Support Portal (Zaloguj się w portalu pomocy), aby poprosić o plik .tar uaktualnienia usług kanału dewelopera. Jeśli nie masz konta w Portalu pomocy, wybierz Login to your Support Portal (Zaloguj się w Portalu pomocy), a następnie na stronie logowania kliknij In a hurry? Zgłoś zgłoszenie do zespołu pomocy.
  4. W przypadku uaktualnienia na serwerze z połączeniem internetowym:
    1. Wyodrębnij plik uaktualnienia portalu:
      > tar -xvf <plik tar>

      To polecenie wyodrębniania tworzy nowy katalog o nazwie DeveloperServices-4.x.y.z.
    2. Przejdź do katalogu DeveloperServices-4.x.y.z.
    3. Pobierz najnowszą wersję platformy Drupal, używając tego polecenia:
      > drush dl drupal

      To polecenie tworzy katalog o nazwie drupal-x.y, gdzie x.y odpowiada bieżącej wersji platformy Drupal.
    4. Uruchom skrypt networked-update.sh:
      > ./networked-update.sh

      W zależności od uprawnień do plików może być konieczne użycie polecenia sudo lub uruchomienie go jako administrator.
    5. Aby otrzymywać powiadomienia o aktualizacjach Drupala, upewnij się, że moduł Drupal Update manager jest włączony. W menu Drupal wybierz Modules (Moduły) i przewiń w dół do modułu Update manager (Menedżer aktualizacji). Jeśli nie jest włączony, włącz go.

      Po włączeniu tej opcji możesz wyświetlić dostępne aktualizacje, klikając pozycję menu Raporty > Dostępne aktualizacje.

      Użyj opcji menu Raporty > Dostępne aktualizacje > Ustawienia, aby skonfigurować moduł tak, aby wysyłał Ci e-maile, gdy dostępne są aktualizacje, i ustawić częstotliwość sprawdzania dostępności aktualizacji.
  5. W przypadku uaktualnienia na serwerze bez połączenia z internetem:
    1. Na serwerze, na którym został pobrany plik DeveloperServices_x.y.z.tar usług kanału dewelopera, wyodrębnij plik uaktualnienia portalu:
      > tar -xvf <tar file>

      To polecenie wyodrębniania tworzy nowy katalog o nazwie DeveloperServices-4.x.y.z.
    2. Przejdź do katalogu DeveloperServices-4.x.y.z.
    3. Uruchom skrypt non-networked-update.sh:
      > ./non-networked-update.sh

      W zależności od uprawnień do plików może być konieczne użycie polecenia sudo lub uruchomienie go jako administrator.

      To polecenie pobiera wszystkie niezbędne pliki aktualizacji i pakuje je w jeden plik o nazwie devportal-update.tgz, a następnie zapisuje go w wybranej przez Ciebie lokalizacji.
    4. Skopiuj plik devportal-update.tgz na serwer docelowy, na którym działa portal.
      Uwaga: nie kopiuj pliku devportal-update.tgz do katalogu głównego serwera docelowego.
    5. Rozpakuj plik devportal-update.tgz do bieżącego katalogu:
      > tar -xzf /path/to/devportal-update.tgz
    6. Przejdź do katalogu developer-update.
    7. Uruchom to polecenie, aby zainstalować aktualizację:
      > ./install-update.sh
    8. Odpowiedz na pytania.

Uaktualnienie zostało zakończone.

Uaktualnianie portalu za pomocą RPM

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

  1. Przejdź do katalogu Drupal, domyślnie /opt/apigee/apigee-drupal:
    > cd /opt/apigee/apigee-drupal
  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 podaną we 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 zdefiniowanego przez właściwość DRUPAL_PG_PASS w pliku konfiguracji instalacji portalu.

    Jeśli później musisz 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 > Media > 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 katalogu /opt/apigee/data/apigee-drupal-devportal/private.
  5. Wyłącz SELinux zgodnie z opisem w artykule Instalowanie narzędzia Edge apigee-setup.
  6. W przypadku uaktualnienia na serwerze z połączeniem internetowym:
    1. Pobierz plik Edge 4.17.05 bootstrap_4.17.05.sh do /tmp/bootstrap_4.17.05.sh:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
    2. Zainstaluj narzędzie apigee-service Edge 4.17.05 i zależności:
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

      gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz parametr 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.
  7. W przypadku uaktualnienia na serwerze bez połączenia z internetem:
    1. Utwórz lokalne repozytorium 4.17.05 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia apigee-setup w Edge.
      Uwaga: jeśli masz już repozytorium 4.17.01, możesz dodać do niego repozytorium 4.17.05 zgodnie z opisem w sekcji „Aktualizowanie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia apigee-setup w Edge.
    2. Aby zainstalować apigee-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.05.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.05.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.05.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.05.sh do /tmp/bootstrap_4.17.05.sh:
        > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.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 Edge apigee-service i zależności:
        > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        gdzie uName:pWord to nazwa użytkownika i hasło do repozytorium.
  8. Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. Uruchom narzędzie do aktualizacji w 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”.
  10. Uruchom Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. 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”.

Zwróć uwagę, że po aktualizacji katalog główny to:

/opt/apigee/apigee-drupal/wwwroot

Uaktualnienie zostało zakończone.