Обновление портала служб для разработчиков

Портал услуг для разработчиков, версия 4.17.05

В этой процедуре описывается, как обновить существующую локальную установку Apigee Developer Channel Services.

Определение правильной процедуры обновления

Процедура, которую вы используете для обновления портала, основана на вашей текущей установке:

Определение текущего типа установки

Если вы не уверены в своем текущем типе установки, используйте следующую команду, чтобы определить его:

  • лс /опт
    Если вы используете Nginx/Postgres, вы увидите следующие каталоги: /opt/apigee и /opt/nginx .

    Если вы используете Apache/MySQL или Apache/MariaDB, этих каталогов не должно быть.
  • /opt/apigee/apigee-service/bin/apigee-all status
    Если вы используете Nginx/Postgres, вы увидите следующий вывод:

    + статус apigee-service apigee-drupal-devportal
    ОК: apigee-drupal-devportal запущен и работает.
    + статус apigee-service apigee-lb
    apigee-сервис: apigee-lb: ОК
    + статус apigee-service apigee-postgresql
    apigee-сервис: apigee-postgresql: ОК
  • апачектл -S
    Если вы используете Apache/MySQL или Apache/MariaDB, эта команда должна вернуть корневой веб-каталог портала в форме:

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

Каталог установки по умолчанию

Процесс обновления предполагает, что Портал разработчика был установлен по адресу:

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

Если вы не установили портал в каталог по умолчанию, измените пути в приведенной ниже процедуре, чтобы использовать ваш каталог установки.

Если вы не знаете каталог установки, вы можете определить его, как описано в разделе Часто используемые команды Drush .

Новый каталог установки по умолчанию после обновления Nginx/Postgres из новой установки 4.17.01.

После обновления новой установки 4.17.01, использующей Nginx/Postgres, корневой каталог изменился с:

/opt/apigee/apigee-drupal

к: 

/opt/apigee/apigee-drupal/wwwroot

Поддерживаемые версии обновления

Данная процедура обновления поддерживается для следующих версий портала:

  • пантеон-14.02.x
  • пантеон-14.03.x
  • пантеон-14.04.x
  • пантеон-14.07.x
  • пантеон-15-01.x
  • ОПДК-15-04.х
  • ОПДК-15-07.x
  • ОПДК-16-01.х
  • ОПДК-16-05.x
  • ОПДК-16-09.x
  • ОПДК-17-01.x

Чтобы определить версию вашего портала, откройте в браузере следующий URL:

http:// yourportal .com/buildInfo

Прежде чем обновить

В существующих установках, если вы изменили какой-либо код в ядре Drupal или в любых непользовательских модулях, ваши изменения будут перезаписаны. Сюда входят, среди прочего, любые изменения, которые вы могли внести в .htaccess . Вы должны предположить, что все, что находится за пределами каталога /sites, принадлежит Drupal. Исключением из этого правила является файл robots.txt ; если этот файл существует в корне сети, он сохранится для вас.

Прежде чем продолжить установку, сделайте резервную копию всего корневого веб-каталога Drupal. После выполнения шагов установки, описанных ниже, вы можете восстановить свои настройки из резервной копии.

Обновление портала с использованием файла .tar

  1. Сделайте резервную копию вашего экземпляра Drupal MySQL/MariaDB.
    Для получения дополнительной информации см. http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/ .
    1. Вариант 1: использовать Друш

      Команда Drush sql-dump создает копию базы данных. В каталоге Drupal (по умолчанию /var/www/html) выполните команду:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      Используйте drush help sql-dump для получения дополнительной информации.
    2. Вариант 2: использовать MySQLdump
      Используйте команду mysqldump для создания копии базы данных:
      mysqldump -u ИМЯ ПОЛЬЗОВАТЕЛЯ -p' ПАРОЛЬ ' ИМЯ БАЗЫ ДАННЫХ > /path/to/backup_dir/database-backup.sql

      Между опцией -p и паролем не должно быть пробела. Пароль необходимо заключить в одинарные кавычки, если пароль содержит специальные символы.

      Вы устанавливаете USERNAME и DATABASENAME при установке портала. По умолчанию оба являются девпорталами.
  2. Сделайте резервную копию всего корневого каталога веб-сайта Drupal. Местоположение установки по умолчанию — /var/www/html , но вы могли изменить его во время установки.
  3. Загрузите файл DeveloperServices_ x.yz .tar Developer Channel Services с ftp.apigee.com , где xyz соответствует номеру версии портала. При появлении запроса введите учетные данные, полученные от Apigee.

    Вы можете скачать файл по ссылке, отправленной вам Apigee в браузере, или скопировав его и затем добавив в следующую команду cURL:
    > curl -kOL <вставить ссылку сюда>

    Примечание . Если ваш портал находится на сервере без внешнего подключения к Интернету, выполните этот шаг на сервере с доступом.

    Перейдите на страницу поддержки Apigee Edge и выберите «Войти на портал поддержки», чтобы запросить файл .tar обновления Developer Channel Services. Если у вас нет учетной записи на портале поддержки, выберите «Войти на портал поддержки» , а затем на странице входа выберите «Спешите?» Подайте заявку в службу поддержки здесь .
  4. Для обновления на сервере с подключением к Интернету:
    1. Извлеките файл обновления портала:
      > tar -xvf <tar-файл>

      Этот фрагмент команды создает новый каталог с именем DeveloperServices-4.xyz .
    2. Перейдите в каталог DeveloperServices-4.xyz .
    3. Загрузите последнюю версию Drupal, используя следующую команду:
      > друз дл друпал

      Эта команда создает каталог с именем drupal-xy, где xy соответствует текущей версии Drupal.
    4. Запустите скрипт networked-update.sh :
      > ./networked-update.sh

      В зависимости от прав доступа к файлу вам, возможно, придется использовать sudo для запуска этой команды или запустить ее от имени администратора.
    5. Чтобы получать уведомления об обновлениях Drupal, убедитесь, что модуль менеджера обновлений Drupal включен. В меню Drupal выберите «Модули» и прокрутите вниз до модуля «Менеджер обновлений» . Если он не включен, включите его.

      После включения вы сможете просмотреть доступные обновления, используя пункт меню «Отчеты» > «Доступные обновления» .

      Используйте пункт меню «Отчеты» > «Доступные обновления» > «Настройки» , чтобы настроить модуль, чтобы он отправлял вам электронное письмо, когда обновления доступны, и установите частоту проверки обновлений.
  5. Для обновления на сервере без подключения к Интернету:
    1. На сервере, где вы загрузили файл DeveloperServices_x.yztar Developer Channel Services, извлеките файл обновления портала:
      > tar -xvf <tar-файл>

      Этот фрагмент команды создает новый каталог с именем DeveloperServices-4.xyz .
    2. Перейдите в каталог DeveloperServices-4.xyz .
    3. Запустите скрипт non-networked-update.sh :
      > ./non-networked-update.sh

      В зависимости от прав доступа к файлу вам, возможно, придется использовать sudo для запуска этой команды или запустить ее от имени администратора.

      Эта команда загружает все необходимые файлы обновлений, упаковывает их в один файл с именем devportal-update.tgz и записывает его в выбранное вами место.
    4. Скопируйте devportal-update.tgz на целевой сервер, на котором работает портал.
      Примечание . Не копируйте devportal-update.tgz в корневой каталог целевого сервера.
    5. Разархивируйте файл devportal-update.tgz в текущий каталог:
      > tar -xzf /путь/к/devportal-update.tgz
    6. Перейдите в каталог обновлений для разработчиков .
    7. Выполните следующую команду, чтобы установить обновление:
      > ./install-update.sh
    8. Ответьте на подсказки.

Обновление завершено.

Обновление портала с помощью RPM

Используйте следующую процедуру для обновления RPM портала на узле:

  1. Перейдите в каталог Drupal, /opt/apigee/apigee-drupal по умолчанию:
    > cd /opt/apigee/apigee-drupal
  2. Сделайте резервную копию экземпляра базы данных Drupal. Команда pg_dump создает копию базы данных:

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

    где:
    • dbname указывает имя базы данных, указанное в свойстве PG_NAME в файле конфигурации установки портала.
    • хост указывает IP-адрес узла портала.
    • username указывает имя пользователя Postgres, используемое порталом для доступа к базе данных, как указано в свойстве DRUPAL_PG_USER в файле конфигурации установки портала.
    • Вам будет предложено ввести пароль пользователя Postgres, определенный свойством DRUPAL_PG_PASS в файле конфигурации установки портала.

    Если позже вам придется восстановиться из резервной копии, используйте команду:
    pg_restore --clean --dbname=devportal --host=localhost --username=apigee </tmp/portal.dmp
  3. Сделайте резервную копию всего корневого каталога веб-сайта Drupal. Местоположение установки по умолчанию — /opt/apigee/apigee-drupal , но вы могли его изменить.

    Если вы не уверены в местонахождении этого каталога, используйте команду drush status или пункт Конфигурация > Носитель > Файл в меню Drupal, чтобы определить расположение общедоступной файловой системы и путь к частной файловой системе (для следующего шага).
  4. Сделайте резервную копию файлов /opt/apigee/data/apigee-drupal-devportal/private .
  5. Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup .
  6. Для обновления на сервере с подключением к Интернету:
    1. Загрузите файл Edge 4.17.05 bootstrap_4.17.05.sh в /tmp/bootstrap_4.17.05.sh :
      > завиток https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
    2. Установите утилиту apigee-service Edge 4.17.05 и зависимости:
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser= uName apigeepassword= pWord

      где uName:pWord — имя пользователя и пароль, полученные вами от Apigee. Если вы опустите pWord , вам будет предложено ввести его.

      По умолчанию программа установки проверяет, установлена ​​ли у вас Java 1.8. Вы можете использовать опцию «C», чтобы продолжить без установки Java.
  7. Для обновления на сервере без подключения к Интернету:
    1. Создайте локальный репозиторий 4.17.05, как описано в разделе «Создание локального репозитория Apigee» в разделе «Установка утилиты Edge apigee-setup» .
      Примечание . Если у вас уже есть существующий репозиторий 4.17.01, вы можете добавить к нему репозиторий 4.17.05, как описано в разделе «Обновление локального репозитория Apigee» в разделе «Установка утилиты Edge apigee-setup» .
    2. Чтобы установить сервис apigee из файла .tar :
      1. На узле с локальным репозиторием используйте следующую команду, чтобы упаковать локальный репозиторий в один файл .tar с именем /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz :
        > /opt/apigee/apigee-service/bin/apigee-service пакет apigee-mirror
      2. Скопируйте файл .tar на узел, где вы хотите обновить Edge. Например, скопируйте его в каталог /tmp на новом узле.
      3. На новом узле распакуйте файл в каталог /tmp:
        > tar -xzf apigee-4.17.05.tar.gz

        Эта команда создает новый каталог с именем repos в каталоге, содержащем файл .tar. Например /tmp/репозитории.
      4. Установите утилиту Edge apigee-service и зависимости из /tmp/repos :
        > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Обратите внимание, что в эту команду вы включаете путь к каталогу репозитория.
    3. Чтобы установить сервис apigee с помощью веб-сервера Nginx:
      1. Настройте веб-сервер Nginx, как описано в разделе «Установка из репозитория с помощью веб-сервера Nginx» в разделе «Установка утилиты Edge apigee-setup» .
      2. На удаленном узле загрузите файл Edge bootstrap_4.17.05.sh в /tmp/bootstrap_4.17.05.sh :
        > /usr/bin/curl http:// uName: pWord @ RemoteRepo :3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh

        где uName:pWord — это имя пользователя и пароль, которые вы установили выше для репозитория, а RemoteRepo — это IP-адрес или DNS-имя узла репо.
      3. На удаленном узле установите утилиту Edge apigee-service и зависимости:
        > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost= RemoteRepo :3939 apigeeuser= uName apigeepassword= pWord apigeeprotocol=http://

        где uName:pWord — имя пользователя и пароль репозитория.
  8. Используйте apigee-service для обновления утилиты apigee-setup :
    > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-setup
  9. Запустите утилиту обновления на своем узле, чтобы обновить базу данных Postgres:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    где configFile — файл конфигурации, который вы использовали для установки базы данных Postgres. Единственное требование к файлу конфигурации — файл конфигурации должен быть доступен или доступен для чтения пользователю «apigee».
  10. Запустите Постгрес:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. Запустите утилиту обновления на своем узле, чтобы обновить портал:
    > /opt/apigee/apigee-setup/bin/update.sh -c dp -f файл конфигурации

    где configFile — файл конфигурации, который вы использовали для установки портала. Единственное требование к файлу конфигурации — файл конфигурации должен быть доступен или доступен для чтения пользователю «apigee».

Обратите внимание, что корневой каталог после обновления теперь:

/opt/apigee/apigee-drupal/wwwroot

Обновление завершено.