Uaktualnianie portalu usług dla deweloperów

Portal usług dla deweloperów, wersja 4.17.05

Ta procedura opisuje, jak uaktualnić istniejące usługi kanału Apigee dla programistów lokalnej instalacji.

.

Określenie właściwej procedury aktualizacji

Procedura aktualizowania portalu zależy od bieżącej instalacji:

Określanie obecny typ instalacji

Jeśli nie masz pewności co do typu bieżącej instalacji, użyj tego polecenia, aby 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ć obecnie.
  • /opt/apigee/apigee-service/bin/apigee-all stan
    Jeśli używasz Nginx/Postgres, zobaczysz te dane wyjściowe:

    + usługa Apigee Stan apigee-drupal-devportal
    OK: narzędzie apigee-drupal-devportal zostało uruchomione
    + stan apigee-service apigee-lb
    apigee-service: apigee-lb: OK
    + stan apigee-postgresql
    apigee-service: apigee-postgresql: OK
  • apachectl –S
    Jeśli używasz Apache/MySQL lub Apache/MariaDB, to polecenie powinno zwrócić adres internetowy katalog główny portalu w formacie:

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

Domyślny katalog instalacji

W procesie uaktualniania przyjęto, ż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 ramach procedury poniżej, aby użyć katalogu instalacji.

Jeśli nie znasz katalogu instalacji, możesz go określić w sposób opisany w artykule Typowe polecenia Drush.

Nowość domyślny katalog instalacyjny po zaktualizowaniu Nginx/Postgres z nowej wersji 4.17.01 instalacja

Po zaktualizowaniu nowej instalacji wersji 4.17.01 korzystającej z Nginx/Postgres, katalogu głównego zmieniono z:

/opt/apigee/apigee-drupal

do:

/opt/apigee/apigee-drupal/wwwroot

Obsługiwane wersje licencji

Ta procedura uaktualniania jest obsługiwana w tych wersjach 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 istniejących instalacjach, jeśli zmodyfikowano kod w rdzeniu Drupala lub w dowolnym moduły, wprowadzone zmiany zostaną zastąpione. Obejmuje to między innymi wszelkie zmiany które udało Ci się znaleźć w .htaccess. Możesz założyć, że wszystko, co znajduje się poza katalogiem /sites, należy do Drupala. An wyjątkiem od tej reguły jest plik robots.txt, jeśli ten plik istnieje w internecie użytkownika root, zostanie on zachowany.

Przed rozpoczęciem instalacji utwórz kopię zapasową całego internetowego katalogu głównego Drupala. katalogu. Po wykonaniu opisanych poniżej czynności instalacyjnych możesz przywrócić plik 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żyj pędzla

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

      Użyj polecenia drush help sql-dump do znajdziesz więcej informacji.
    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ą -p a hasłem nie powinno być spacji. Singiel/singielka cudzysłowy wokół hasła są wymagane, jeśli hasło zawiera znaki specjalne.

      Ustawiasz USERNAME i DATABASENAME. podczas instalowania portalu. Domyślnie oba te tryby to devportal.
  2. Utwórz kopię zapasową całego internetowego katalogu głównego Drupala. Domyślna lokalizacja instalacji to /var/www/html, ale być może Zmieniły się w momencie instalacji.
  3. Pobierz plik usług kanału dla deweloperów DeveloperServices_x.y.z.tar plik z ftp.apigee.com, gdzie x.y.z odpowiada numerowi wersji portalu. Gdy pojawi się prośba, wpisz otrzymane dane logowania. z Apigee.

    Możesz pobrać plik za pomocą linku wysłanego do Ciebie przez Apigee w przeglądarce lub skopiować go dodaj go do tego polecenia cURL:
    &gt; curl -kOL <wklej link here&gt;

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

    Otwórz stronę pomocy Apigee Edge i wybierz Login to your Support Portal (Zaloguj się w portalu pomocy technicznej), aby poprosić o dostęp do kanału dla programistów. Plik .tar uaktualnienia usług. Jeśli nie masz konta w portalu pomocy, wybierz Zaloguj się w portalu pomocy, a następnie na stronie logowania wybierz In a pośpieszyć? Prześlij zgłoszenie tutaj.
  4. Aby uaktualnić serwer z połączeniem internetowym:
    1. Rozpakuj plik uaktualnienia portalu:
      &gt; tar -xvf <tar file&gt;

      Ten fragment polecenia utworzy nowy katalog o nazwie DeveloperServices-4.x.y.z.
    2. Zmień wersję na DeveloperServices-4.x.y.z. katalogu.
    3. Pobierz najnowszą wersję Drupala za pomocą tego polecenia:
      &gt; drush dl drupal

      Polecenie to powoduje utworzenie katalogu o nazwie drupal-x.y, w którym x.y odpowiada bieżącemu katalogowi 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 sudo do uruchomienia tego polecenia lub jako administrator.
    5. Aby otrzymywać powiadomienia o aktualizacjach Drupala, upewnij się, że menedżer aktualizacji Drupala jest włączony. W menu Drupal wybierz Modules (Moduły) i przewiń w dół do w module Menedżer aktualizacji. Jeśli nie jest, włącz ją.

      Po włączeniu dostępnych aktualizacji możesz zobaczyć dostępne aktualizacje w sekcji Raporty > Dostępny(-a) Aktualizacje.

      Na stronie Raporty > Dostępne aktualizacje > Pozycja menu Ustawienia na skonfigurować moduł do wysyłania e-maili o dostępności aktualizacji oraz ustawić częstotliwość aktualizacji sprawdzanie dostępności aktualizacji.
  5. Aby uaktualnić serwer na serwerze bez połączenia z internetem:
    1. Na serwerze, z którego został pobrany plik DeveloperServices_x.y.z.tar usług kanału dla programistów, wyodrębnij plik uaktualnienia portalu:
      tar -xvf <tar file&gt;

      Ten fragment polecenia utworzy nowy katalog o nazwie DeveloperServices-4.x.y.z.
    2. Zmień wersję na DeveloperServices-4.x.y.z. katalogu.
    3. Uruchom skrypt non-networked-update.sh:
      ./non-networked-update.sh

      W zależności od uprawnień do pliku może być konieczne użycie sudo do uruchomienia tego polecenia lub jako administrator.

      To polecenie pobiera wszystkie niezbędne pliki aktualizacji i pakuje je w jeden plik. o nazwie devportal-update.tgz i zapisze plik w wybranej przez Ciebie lokalizacji.
    4. Skopiuj plik devportal-update.tgz do środowiska docelowego ten, który obsługuje portal.
      Uwaga: nie kopiuj pliku devportal-update.tgz do internetowego katalogu głównego na serwerze docelowym.
    5. Usuń plik devportal-update.tgz z bieżący katalog:
      tar -xzf /path/to/devportal-update.tgz
    6. Przejdź do katalogu developer-update.
    7. Aby zainstalować aktualizację, uruchom to polecenie:
      &gt; ./install-update.sh
    8. Odpowiedz na pytania.

Uaktualnienie zostało zakończone.

Uaktualnianie portalu z wykorzystaniem RPM

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

  1. Przejdź do katalogu Drupal, /opt/apigee/apigee-drupal przez wartość domyślna:
    &gt; cd /opt/apigee/apigee-drupal
  2. Utwórz kopię zapasową instancji bazy danych Drupal. Polecenie pg_dump tworzy kopię pliku baza danych:

    pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp

    gdzie:
      ,
    • dbname określa nazwa bazy danych określona przez właściwość PG_NAME w portalu plik konfiguracji instalacji.
    • Parametr host określa adres IP. adresu węzła portalu.
    • username określa nazwa użytkownika Postgres używana przez portal do uzyskiwania dostępu do bazy danych określonej przez DRUPAL_PG_USER w plik konfiguracji portalu.
    • Pojawi się prośba o podanie hasła użytkownika Postgres zgodnie z definicją we właściwości DRUPAL_PG_PASS w plik konfiguracji portalu.

    . Jeśli później zajdzie potrzeba przywrócenia z kopii zapasowej, użyj polecenia:
    pg_restore --clean (pg_restore --clean) --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
  3. Utwórz kopię zapasową całego internetowego katalogu głównego Drupala. Domyślna lokalizacja instalacji to /opt/apigee/apigee-drupal, ale mogło się ono zmienić.

    Jeśli nie masz pewności co do lokalizacji tego katalogu, użyj polecenia drush status lub Konfiguracja > Multimedia > Plik w menu Drupala, aby określić lokalizację publicznego systemu plików i ścieżki prywatnego systemu plików (kolejne ).
  4. Utwórz kopię zapasową plików w katalogu /opt/apigee/data/apigee-drupal-devportal/private.
  5. Wyłącz SELinux zgodnie z opisem w sekcji Instalowanie narzędzie Edge apigee-setup.
  6. Aby uaktualnić serwer z połączeniem internetowym:
    1. Pobierz plik Edge 4.17.05 bootstrap_4.17.05.sh /tmp/shoestrap_4.17.05.sh:
      curl https://software.apigee.com/shoestrap_4.17.05.sh -o /tmp/shoestrap_4.17.05.sh
    2. Zainstaluj narzędzie apigee-service w Edge 4.17.05 oraz zależności:
      Sudo Bash /tmp/shoestrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

      gdzie uName:pWord to nazwa użytkownika i hasło otrzymane z adresu Apigee. Jeśli pominiesz słowo pWord, pojawi się prośba o jego wpisanie.

      Domyślnie instalator sprawdza, czy zainstalowano środowisko Java 1.8. Za pomocą „C” kontynuowania bez instalowania środowiska Java.
  7. Aby uaktualnić serwer na serwerze bez połączenia z internetem:
    1. Utwórz lokalne repozytorium 4.17.05 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” o Instalowanie konfiguracji Edge Apigee .
      Uwaga: jeśli masz już repozytorium w wersji 4.17.01, możesz dodać do repozytorium 4.17.05 zgodnie z opisem w sekcji „Aktualizowanie lokalnego repozytorium Apigee” artykułu na temat instalacji narzędzia Edge apigee-setup.
    2. Aby zainstalować usługę apigee z pliku .tar:
      1. W węźle z lokalnym repozytorium użyj tego polecenia, aby spakować lokalne zasoby 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-mirror package
      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 wyciągnij plik z katalogu /tmp:
        &gt; tar -xzf apigee-4.17.05.tar.gz

        To polecenie utworzy nowy katalog o nazwie „repos” w katalogu zawierającym pliki .tar . Na przykład /tmp/repos.
      4. zainstalować narzędzie Edge apigee-service, zależności z katalogu /tmp/repos:
        Sudo Bash /tmp/repos/shoestrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Zwróć uwagę, że w tym poleceniu umieszczasz ścieżkę do katalogu repozytoriów.
    3. Aby zainstalować usługę apigee za pomocą serwera WWW Nginx:
      1. Skonfiguruj serwer WWW Nginx zgodnie z opisem w sekcji „Instalowanie z repozytorium przy użyciu Serwer WWW Nginx na stronie Install the Edge apigee-setup.
      2. W węźle zdalnym pobierz plik Edge bootstrap_4.17.05.sh do /tmp/shoestrap_4.17.05.sh:
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/shoestrap_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 do węzła repozytorium.
      3. W węźle zdalnym zainstaluj narzędzie Edge apigee-service oraz zależności:
        Sudo Bash /tmp/shoestrap_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: aktualizowanie pliku apigee-setup narzędzie:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja
  9. Uruchom narzędzie do aktualizacji w swoim węźle, aby zaktualizować bazę danych Postgres:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    gdzie configFile to plik konfiguracji użyty do zainstalowania do bazy danych Postgres. Plik konfiguracji musi zawierać tylko plik musi być dostępny lub czytelny dla „apigee” użytkownika.
  10. Uruchom Postgres:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. Uruchom narzędzie do aktualizacji w swoim węźle, aby zaktualizować portal:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    gdzie configFile to plik konfiguracji użyty do zainstalowania do portalu. Plik konfiguracji musi zawierać wyłącznie musi być dostępna lub czytelna dla „apigee” użytkownika.

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

/opt/apigee/apigee-drupal/wwwroot

Uaktualnienie zostało zakończone.