Uaktualnianie portalu usług dla deweloperów

Portal usług dla deweloperów w wersji 4.17.09

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 status

    Jeśli używasz Nginx/Postgres, zobaczysz te dane wyjściowe:

    + apigee-service
  apigee-drupal-devportal status
  OK: apigee-drupal-devportal is up and running
  + apigee-service apigee-lb status
  apigee-service: apigee-lb: OK
  + apigee-service apigee-postgresql status
  apigee-service: apigee-postgresql: OK
  • apachectl -S

    Jeśli używasz Apache/MySQL lub Apache/MariaDB, to polecenie powinno zwrócić adres internetowy katalogu głównym 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:

  • 4.17.05 i nowsze: /opt/apigee/apigee-drupal/wwwroot
  • Przed 4.17.05: /opt/apigee/apigee-drupal (Nginx) lub /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.

Obsługiwane wersje licencji

Ta procedura uaktualniania jest obsługiwana w tych wersjach portalu:

  • OPDK-17-01.x,
  • OPDK-17-05.x,

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

http://your_portal.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 co mogło wyświetlić się na stronie .htaccess. Możesz założyć, że wszystko, co znajduje się poza katalogiem /sites, należy do Drupala. An wyjątek od tej reguły to 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 z wykorzystaniem RPM

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

  1. Przejdź do katalogu Drupala. Na przykład: /opt/apigee/apigee-drupal/wwwroot. 

    cd /opt/apigee/apigee-drupal/wwwroot

    Domyślny katalog instalacji znajdziesz w sekcji Domyślny katalog instalacji. wersję usługi.

  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 nazwę bazy danych określoną przez Właściwość 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 zgodnie z właściwością DRUPAL_PG_USER w funkcji plik konfiguracji portalu.
    • Pojawi się prośba o podanie hasła użytkownika Postgres zgodnie z definicją Właściwość DRUPAL_PG_PASS w pliku konfiguracji instalacji portalu.

    Jeśli później zajdzie potrzeba przywrócenia 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 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 Drupal, aby określić lokalizację publicznego systemu plików i ścieżki prywatnego systemu plików (kolejne ).
  4. Utwórz kopię zapasową plików z usługi /opt/apigee/data/apigee-drupal-devportal/private.
  5. Ustaw Drupala w trybie konserwacji:
    1. W menu Drupal wybierz Konfiguracja.
    2. Na stronie Configuration (Konfiguracja) wybierz Konserwacja. trybu w sekcji Dla programistów.
    3. Zaznacz pole Umieść witrynę w trybie konserwacji.
    4. Wpisz wiadomość, którą użytkownicy zobaczą podczas konserwacji.
    5. Kliknij Zapisz konfigurację.
  6. Wyłącz SELinux w sposób opisany w Zainstaluj narzędzie Edge apigee-setup.
  7. Przejdź do katalogu /opt: 
    cd /opt
  8. Aby uaktualnić serwer z połączeniem internetowym:
    1. Pobierz plik Edge w wersji 4.17.09 bootstrap_4.17.09.sh do /tmp/bootstrap_4.17.09.sh: 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    2. Zainstaluj narzędzie i zależności Edge w wersji 4.17.09 apigee-service: 
      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName
  apigeepassword=pWord

      gdzie uName:pWord to nazwa użytkownika i hasło, z których pochodzą Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.

      Domyślnie instalator sprawdza, czy zainstalowano środowisko Java 1.8. Za pomocą „C” kontynuowania bez instalowania środowiska Java.

  9. Aby uaktualnić serwer na serwerze bez połączenia z internetem:
    1. Utwórz lokalne repozytorium 4.17.09 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” o Instalowanie 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.09.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:
        tar -xzf apigee-4.17.09.tar.gz

        To polecenie utworzy nowy katalog o nazwie „repos” w katalogu zawierającym pliki .tar . Na przykład /tmp/repos.

      4. Zainstaluj narzędzie Edge apigee-service oraz zależności z kolumny /tmp/repos: 
        sudo bash /tmp/repos/bootstrap_4.17.09.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.09.sh do /tmp/bootstrap_4.17.09.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh
  -o /tmp/bootstrap_4.17.09.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 dependencies:code 
        sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        gdzie uName:pWord to nazwa użytkownika i hasło repozytorium.

  10. Użyj narzędzia apigee-service, aby zaktualizować narzędzie apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Uruchom narzędzie do aktualizacji w swoim węźle, 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 do bazy danych Postgres. Plik konfiguracji musi zawierać tylko plik musi być dostępny lub czytelny dla „apigee” użytkownika.

  12. Uruchom Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  13. Uruchom narzędzie do aktualizacji w węźle, aby zaktualizować portal: 
    /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.

  14. Uruchom skrypt update.php Drupala, otwierając ten URL w oknie przeglądarki: 
    http://portalIP_DNS:8079/update.php
  15. Wyłącz Drupala w trybie konserwacji:
    1. W menu Drupal wybierz Konfiguracja.
    2. Na stronie Configuration (Konfiguracja) wybierz Konserwacja. trybu w sekcji Dla programistów.
    3. Odznacz pole Umieść witrynę w trybie konserwacji.
    4. Kliknij Zapisz konfigurację.

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

/opt/apigee/apigee-drupal/wwwroot

Uaktualnienie zostało zakończone.