Uaktualnianie portalu usług dla deweloperów

Developer Services Portal w wersji 4.16.09

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

Domyślny katalog instalacyjny

Proces uaktualniania zakłada, że portal dla programistów został zainstalowany w katalogu /var/www/html. Jeśli portal nie został zainstalowany w domyślnym katalogu, 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.

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 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. Domyślna lokalizacja instalacji to /var/www/html, ale mogła zostać zmieniona podczas instalacji. Po wykonaniu opisanych poniżej czynności instalacyjnych możesz przywrócić dostosowania z kopii zapasowej.

Uaktualnianie usług kanału dewelopera Apigee do nowej wersji

  1. Kopia zapasowa instancji MySQL w Drupalu.
    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, gdzie x.y.z odpowiada numerowi wersji portalu.

    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 stronę http://community.apigee.com/content/apigee-customer-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.