Uaktualnianie portalu usług dla deweloperów

Developer Services Portal w wersji 4.17.01

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

Domyślny katalog instalacji

W procesie uaktualniania zakłada się, że Portal dla programistów został zainstalowany pod adresem /var/www/html. Jeśli portal nie został zainstalowany w katalogu domyślnym, zmodyfikuj ścieżki opisane poniżej, aby użyć katalogu instalacyjnego.

Jeśli nie znasz katalogu instalacji, możesz go znaleźć zgodnie z opisem w sekcji Najczęściej 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
  • OPDK-16-09.x

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

http://yourportal.com/buildInfo

Przed instalacją

W przypadku istniejących instalacji zmodyfikowanie kodu w rdzeni Drupal lub w niestandardowych modułach, zostaną zastąpione. Obejmuje to między innymi wszelkie zmiany wprowadzone w pliku .htaccess. Możesz zakładać, że wszystkie dane znajdujące się poza katalogiem /sites należą do platformy Drupal. Wyjątkiem od tej reguły jest plik robots.txt. Jeśli ten plik istnieje w katalogu głównym, zostanie zachowany.

Przed kontynuowaniem instalacji utwórz kopię zapasową całego katalogu głównego internetowego Drupal. Domyślna lokalizacja instalacji to /var/www/html, ale mogła zostać zmieniona podczas instalacji. Po wykonaniu opisanych poniżej kroków instalacji możesz przywrócić dostosowania z kopii zapasowej.

Uaktualnienie usług kanału dla programistów Apigee do nowej wersji

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

      Polecenie Drush sql-dump tworzy kopię bazy danych. Domyślnie w katalogu Drupal (/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żyj zrzutu MySQL
      Użyj polecenia mysqldump, aby utworzyć kopię bazy danych:
      mysqldump -u NAZWA UŻYTKOWNIKA -p'HASŁO' DATABASENAME > /path/to/backup_dir/database-backup.sql

      Między opcją a hasłem nie powinno być spacji.

      Jeśli hasło zawiera znaki specjalne, wymagane są pojedyncze cudzysłowy wokół hasła.

      Nazwy USERNAME i DATABASENAME ustawiasz podczas instalowania portalu. Domyślnie oba te typy to devportal.
  2. Utwórz kopię zapasową całego katalogu głównego internetowego Drupal. Domyślna lokalizacja instalacji to /var/www/html, ale mogła zostać zmieniona podczas instalacji.
  3. Pobierz plik developerServices_x.y.z.tar w usługach kanału dla programistów ze strony ftp.apigee.com, gdzie x.y.z odpowiada numerowi wersji portalu. Gdy pojawi się prośba, wpisz dane logowania otrzymane z Apigee.

    Plik z linku otrzymanego od Apigee możesz pobrać w przeglądarce lub przez skopiowanie go i dodanie do tego polecenia cURL:
    > curl -kOL <wklej link tutaj>

    Uwaga: jeśli portal znajduje się na serwerze bez zewnętrznego połączenia z internetem, wykonaj ten krok na serwerze, który ma do niego dostęp.

    Otwórz stronę http://community.apigee.com/content/apigee-customer-support i wybierz Zaloguj się w swoim portalu pomocy, aby poprosić o plik .tar z uaktualnieniem usług kanału dla programistów. 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 wybierz Sgodzisz się? Tutaj możesz przesłać zgłoszenie do zespołu pomocy.
  4. Aby przejść na nową wersję na serwerze z połączeniem internetowym:
    1. Wyodrębnij plik uaktualniania portalu:
      > tar -xvf <plik tar>

      To polecenie tworzy nowy katalog o nazwie DeveloperServices-4.x.y.z.
    2. Przejdź do katalogu DeveloperServices-4.x.y.z.
    3. Pobierz najnowszą wersję Drupal za pomocą tego polecenia:
      > drush dl drupal

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

      W zależności od uprawnień do pliku może być konieczne użycie narzędzia sudo do uruchomienia tego polecenia lub uruchomienie go jako administrator.
    5. Aby otrzymywać powiadomienia o aktualizacjach Drupal, musisz włączyć moduł menedżera aktualizacji Drupal. W menu Drupal wybierz Modules (Moduły) i przewiń w dół do modułu Menedżer aktualizacji. Jeśli nie jest włączony, włącz go.

      Po włączeniu tej funkcji możesz zobaczyć dostępne aktualizacje w menu Raporty > Dostępne aktualizacje.

      Użyj elementu menu Raporty > Dostępne aktualizacje > Ustawienia, aby skonfigurować wysyłanie e-maila z modułem, gdy dostępne są aktualizacje, oraz ustawić częstotliwość sprawdzania dostępności aktualizacji.
  5. Aby przejść na nową wersję na serwerze bez połączenia z internetem:
    1. Na serwerze, na który pobrano plik DeveloperServices_x.y.z.tar usług kanału programisty, wyodrębnij plik uaktualnienia portalu:
      > tar -xvf <tar file>

      To polecenie 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 do uruchomienia tego polecenia może być konieczne użycie polecenia sudo lub uruchomienie go przez administratora.

      To polecenie pobiera wszystkie niezbędne pliki aktualizacji, spakuje je do jednego pliku o nazwie devportal-update.tgz i zapisuje go w wybranej lokalizacji.
    4. Skopiuj plik devportal-update.tgz na serwer docelowy, na którym działa portal.
      Uwaga: nie kopiuj pliku devportal-update.tgz do internetowego katalogu głównego serwera docelowego.
    5. Otwórz plik devportal-update.tgz w bieżącym 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.

Uaktualnianie zostało zakończone.