Uaktualnianie portalu usług dla deweloperów

Portal Usługi dla deweloperów w wersji 4.16.09

Ta procedura opisuje, jak uaktualnić istniejącą instalację lokalną usługi kanału Apigee dla programistów.

Domyślny katalog instalacji

W procesie uaktualniania przyjęto, że portal dla programistów został zainstalowany pod adresem /var/www/html. Jeśli nie zainstalowano portalu w katalogu domyślnym, zmień ścieżki w procedurze poniżej, aby użyć katalogu instalacji.

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

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

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

http://yourportal.com/buildInfo

Przed instalacją

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 w pliku .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 ten plik znajduje się w katalogu głównym, zostanie zachowany.

Przed rozpoczęciem instalacji utwórz kopię zapasową całego internetowego katalogu głównego Drupala. Domyślna lokalizacja instalacji to /var/www/html, ale możesz ją zmienić podczas instalacji. Po wykonaniu opisanych poniżej czynności instalacyjnych możesz przywrócić swoje niestandardowe ustawienia z kopii zapasowej.

Uaktualniam usługi kanału dewelopera Apigee do nowej wersji

  1. kopia zapasowa instancji MySQL Drupala;
    Więcej informacji znajdziesz na stronie http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
    1. Opcja 1. Użyj Drush

      Polecenie Drush sql-dumptworzy kopię bazy danych. W katalogu Drupal (domyślnie /var/www/html) uruchom to polecenie:
      > drush sql-dump > /ścieżka/do/katalogu_kopii_zapasowych/kopia_zapasowa_bazy_danych.sql

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

      Nie powinno być spacji między opcją -p a hasłem. Jeśli hasło zawiera znaki specjalne, wymagane są cudzysłowy wokół niego.

      Podczas instalowania portalu musisz ustawić wartości USERNAME i DATABASENAME. Domyślnie oba te parametry mają wartość devportal.
  2. Utwórz kopię zapasową całego katalogu głównego witryny Drupal. Domyślna lokalizacja instalacji to /var/www/html, ale możesz ją zmienić podczas instalacji.
  3. Pobierz plik DeveloperServices_x.y.z.tar, gdzie x.y.z odpowiada wersji portalu.

    Możesz pobrać plik z linku przesłanego przez Apigee w przeglądarce lub skopiować go, a następnie dodać do tej komendy 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 stronę http://community.apigee.com/content/apigee-customer-support i wybierz Zaloguj się w portalu pomocy, aby poprosić o plik .tar z aktualizacją usług kanału dla programistów. Jeśli nie masz konta w Portalu pomocy, kliknij Zaloguj się w Portalu pomocy, a następnie na stronie logowania kliknij W pośpiechu? Zgłoś problem tutaj.
  4. Aby uaktualnić serwer z połączeniem internetowym:
    1. 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. Pobierz najnowszą wersję Drupala, używając tego polecenia:
      > drush dl drupal

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

      W zależności od uprawnień do pliku, aby uruchomić to polecenie, może być konieczne użycie 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 Moduły i przewiń w dół do modułu Menedżer aktualizacji. Jeśli nie jest włączona, włącz ją.

      Po włączeniu tej opcji dostępne aktualizacje możesz wyświetlić w sekcji Raporty > Dostępne aktualizacje.

      Użyj menu Raporty > Dostępne aktualizacje > Ustawienia, aby skonfigurować wysyłanie e-maili z informacjami o dostępnych aktualizacjach oraz częstotliwość sprawdzania dostępności aktualizacji.
  5. Aby uaktualnić serwer bez połączenia z Internetem:
    1. Na serwerze, na którym został pobrany plik DeveloperServices_x.y.z.tar, wyodrębnij plik aktualizacji 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 pliku możesz użyć polecenia sudo, aby uruchomić to polecenie, lub uruchomić je jako administrator.

      To polecenie pobiera wszystkie niezbędne pliki aktualizacji i pakuje je w jeden plik o nazwie devportal-update.tgz, który zapisywany jest w wybranej przez Ciebie lokalizacji.
    4. Skopiuj plik devportal-update.tgz na serwer docelowy, który uruchamia portal.
      Uwaga: nie kopiuj pliku devportal-update.tgz do katalogu głównego witryny na serwerze docelowym.
    5. Rozpakuj plik devportal-update.tgz do bieżącego katalogu:
      > tar -xzf /path/to/devportal-update.tgz
    6. Przejdź do katalogu developer-update.
    7. Aby zainstalować aktualizację, uruchom to polecenie:
      > ./install-update.sh
    8. Odpowiedz na pytania.

Uaktualnienie zostało zakończone.