Uaktualnianie portalu usług dla deweloperów

Developer Services Portal w wersji 4.17.05

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

Ustalenie prawidłowej procedury aktualizacji

Procedura aktualizacji portalu jest zależna od bieżącej instalacji:

Określanie bieżącego typu instalacji

Jeśli nie masz pewności, jaki jest obecny typ instalacji, użyj tego polecenia, aby go sprawdzić:

  • ls /opt
    Jeśli używasz Nginx/Postgres, zobaczysz te katalogi: /opt/apigee i /opt/nginx.

    Jeśli korzystasz z Apache/MySQL lub Apache/MariaDB, te katalogi nie powinny być dostępne.
  • /opt/apigee/apigee-service/bin/apigee-all stan: apigee-drupal-dev







  • apachectl -S
    Jeśli korzystasz z Apache/MySQL lub Apache/MariaDB, to polecenie powinno zwrócić główny katalog internetowy portalu w formacie:

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

Domyślny katalog instalacji

W procesie uaktualniania zakłada się, że Portal dla programistów został zainstalowany:

  • /opt/apigee/apigee-drupal (Nginx)
  • /var/www/html (Apache)

Jeśli portal nie został zainstalowany w katalogu domyślnym, zmodyfikuj ścieżki w ramach poniższej procedury, aby użyć katalogu instalacji.

Jeśli nie znasz katalogu instalacji, możesz go znaleźć zgodnie z opisem w sekcji Najczęściej używane polecenia Drush.

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

Po zaktualizowaniu nowej instalacji 4.17.01 korzystającej z Nginx/Postgres zmieniono katalog główny z:

/opt/apigee/apigee-drupal

z:

/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ą

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. Po wykonaniu opisanych poniżej kroków instalacji możesz przywrócić dostosowania z kopii zapasowej.

Uaktualnianie portalu przy użyciu 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ż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 Pomoc Apigee Edge i wybierz Zaloguj się w swoim portalu pomocy, aby poprosić o uaktualnienie usług kanału dla programistów w pliku .tar. 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.

Uaktualnianie portalu za pomocą RPM

Wykonaj poniższe czynności, aby zaktualizować RPM portalu w węźle:

  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.
    • Zobaczysz prośbę o podanie hasła użytkownika Postgres zgodnie z definicją we właściwości DRUPAL_PG_PASS w pliku konfiguracji instalacji portalu.

    Jeśli później konieczne będzie przywrócenie danych 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 internetowego Drupal. Domyślna lokalizacja instalacji to /opt/apigee/apigee-drupal, ale mogła ona zostać przez Ciebie zmieniona.

    Jeśli nie masz pewności co do lokalizacji tego katalogu, użyj polecenia drush status lub wpisu Configuration > Media > File (Konfiguracja > Media > Plik) w menu Drupal, aby określić lokalizację publicznego systemu plików i ścieżki prywatnego systemu plików (w następnym kroku).
  4. W pliku /opt/apigee/data/apigee-drupal-devportal/private utwórz kopię zapasową plików.
  5. Wyłącz SELinux zgodnie z opisem w sekcji Instalowanie narzędzia Edge apigee-setup.
  6. Aby przejść na nową wersję na serwerze z połączeniem internetowym:
    1. Pobierz plik bootstrap_4.17.05.sh Edge w wersji /tmp/bootstrap_4.17.05.sh:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/17.05.05.
    2. Zainstaluj narzędzie Edge 4.17.05 apigee-service i jego zależności:
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

      , gdzie uName:pWord pochodzi z nazwy użytkownika i hasła uName:pWord. Jeśli pominiesz parametr pWord, pojawi się prośba o jego podanie.

      Domyślnie instalator sprawdza, czy masz zainstalowaną środowisko Java 1.8. Możesz użyć opcji „C”, aby kontynuować bez instalowania języka Java.
  7. Aby przejść na nową wersję na serwerze bez połączenia z internetem:
    1. Utwórz lokalne repozytorium w wersji 4.17.05 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” artykułu Instalowanie narzędzia Edge apigee-setup.
      Uwaga: jeśli masz już repozytorium w wersji 4.17.01, możesz dodać do niego repozytorium 4.17.05 zgodnie z opisem w sekcji „Aktualizowanie lokalnego repozytorium Apigee” artykułu Instalowanie narzędzia Edge apigee-setup.
    2. Aby zainstalować usługę apigee-service z pliku .tar:
      1. W węźle z lokalnym repozytorium za pomocą tego polecenia spakuj je do jednego pliku .tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
        > /opt/apigee/apigee-service/bin/apigee-service apigee
      2. Skopiuj plik .tar do węzła, w którym chcesz zaktualizować Edge. Na przykład skopiuj go do katalogu /tmp w nowym węźle.
      3. W nowym węźle cofnij 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 jego zależności z /tmp/repos:
        > sudo bash/tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Pamiętaj, że w tym poleceniu umieszczasz ścieżkę do katalogu.
    3. Aby zainstalować usługę 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” artykułu Instalowanie narzędzia Edge apigee-setup.
      2. W węźle zdalnym pobierz plik Edge bootstrap_4.17.05.sh jako adres /tmp/bootstrap_4.17.05.sh na potrzeby adresu /tmp/bootstrap_4.17.05.sh:
        > /usr/bin/curl http://uName:pWord@remoteRepo. nazwa_serwera.nazwa_użytkownika.adresu_zdalnego.1. oraz adres
        — nazwa_użytkownika_7.słupa_1        :3939/bootstrap_4 mają następujące adresy,
      3. W węźle zdalnym zainstaluj usługę Edge apigee-service i jej zależności:
        > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName gdzie to
        nazwa_użytkownika i hasło to
        apigeepassword=pWord apigeepassword=        pWord
  8. Zaktualizuj narzędzie apigee-setup za pomocą usługi apigee-service:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja
  9. Uruchom w węźle narzędzie aktualizacji, 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, aby plik konfiguracji był dostępny i czytelny dla użytkownika „apigee”.
  10. Uruchom Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. Uruchom w węźle narzędzie aktualizacji, 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, aby plik konfiguracji był dostępny i czytelny dla użytkownika „apigee”.

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

/opt/apigee/apigee-drupal/wwwroot

Uaktualnianie zostało zakończone.