Uaktualnij portal

Ta procedura opisuje, jak uaktualnić istniejący portal usług Apigee dla programistów (lub po prostu portal) w jego środowisku lokalnym. instalacji.

.

Określ prawidłową procedurę aktualizacji

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

Określ 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 został zainstalowany pod adresem:

  • 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 portalu w wersji OPDK-17-01.x i nowszych.

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 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 katalogu głównym, zostanie dla Ciebie.

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ą pakietów RPM

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ę pliku baza danych:
    pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin
      --password --format=c > /tmp/portal.dmp

    Gdzie:

    • devportal to nazwa bazy danych określona przez Właściwość PG_NAME w pliku konfiguracji instalacji portalu.
    • host_IP_address to adres IP węzła portalu.
    • drupaladmin to nazwa użytkownika Postgres używana przez portal do uzyskiwania dostępu do baza danych zgodnie z właściwością DRUPAL_PG_USER w instalacji 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 zechcesz później przywrócić dane z kopii zapasowej, użyj tego 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 zostać zmienione przez Ciebie.

    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 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 Maintenance mode (Tryb konserwacji). 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.19.06 bootstrap_4.19.06.sh do /tmp/bootstrap_4.19.06.sh:
      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
    2. Zainstaluj narzędzie i zależności w Edge w wersji 4.19.06 apigee-service:
      sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      Gdzie uName i pWord to otrzymana nazwa użytkownika i hasło z 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 19.06 zgodnie z opisem w sekcji Utwórz lokalne repozytorium Apigee.
    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.19.06.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 wypakuj plik do katalogu /tmp:
        tar -xzf apigee-4.19.06.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 i zależności z /tmp/repos:
        sudo bash /tmp/repos/bootstrap_4.19.06.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.19.06.sh do /tmp/bootstrap_4.19.06.sh:
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.06.sh
          -o /tmp/bootstrap_4.19.06.sh

        Gdzie uName i pWord to nazwa użytkownika i hasło, które zostały ustawione powyżej dla repozytorium, a remoteRepo to adres IP lub nazwa DNS z repozytorium.

      3. W węźle zdalnym zainstaluj narzędzie Edge apigee-service oraz zależności:
        sudo bash /tmp/bootstrap_4.19.06.sh apigeerepohost=remoteRepo:3939
          apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        Gdzie uName i 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 update w węźle 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.