Портал сервисов для разработчиков версии 4.16.09
В этой статье рассказывается, как обновить существующую локальную установку Apigee Developer Channel Services.
Каталог установки по умолчанию
В процессе обновления предполагается, что портал разработчика был установлен в каталог /var/www/html. Если вы не установили портал в каталог по умолчанию, измените пути в приведенной ниже процедуре, чтобы использовать каталог установки.
Если вы не знаете, где находится каталог установки, его можно определить, как описано в разделе Часто используемые команды Drush.
Поддерживаемые версии для обновления
Процедура обновления поддерживается для следующих версий портала:
- 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
Чтобы узнать версию портала, откройте в браузере следующий URL:
http://yourportal.com/buildInfo
Перед установкой
Если вы изменили код в ядре Drupal или в любом другом модуле, кроме пользовательского, то при обновлении эти изменения будут перезаписаны. В частности, это относится к любым изменениям, которые вы могли внести в файл .htaccess. Все, что находится за пределами каталога /sites, принадлежит Drupal. Исключение из этого правила – файл robots.txt. Если он существует в корневом каталоге сайта, мы его сохраним.
Перед установкой создайте резервную копию всего корневого каталога Drupal. По умолчанию файлы устанавливаются в каталог /var/www/html, но вы могли изменить его при установке. После того как вы выполните описанные ниже действия по установке, вы сможете восстановить настройки из резервной копии.
Как обновить сервисы канала разработчика Apigee до новой версии
- Резервная копия экземпляра Drupal MySQL.
Дополнительную информацию можно найти на странице http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/.- Вариант 1. Использование Drush
Команда Drush sql-dump создает копию базы данных. В каталоге Drupal (по умолчанию /var/www/html) выполните команду:
> drush sql-dump > /path/to/backup_dir/database-backup.sql
Чтобы получить дополнительную информацию, введите drush help sql-dump. - Вариант 2. Использование MySQLdump
Чтобы создать копию базы данных, используйте команду mysqldump:
mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql
Между параметром -p и паролем не должно быть пробела. Если пароль содержит специальные символы, его нужно заключить в одинарные кавычки.
Вы задали значения USERNAME и DATABASENAME при установке портала. По умолчанию оба значения – devportal.
- Вариант 1. Использование Drush
- Создайте резервную копию всего корневого каталога Drupal. По умолчанию файлы устанавливаются в каталог /var/www/html, но вы могли изменить его при установке.
- Скачайте файл Developer Channel Services DeveloperServices_x.y.z.tar, где x.y.z – номер версии портала.
Вы можете скачать файл по ссылке, отправленной вам Apigee, в браузере или скопировать ее и добавить в следующую команду cURL:
> curl -kOL <paste link here>
Примечание. Если ваш портал размещен на сервере без внешнего подключения к интернету, выполните этот шаг на сервере с доступом.
Перейдите на страницу http://community.apigee.com/content/apigee-customer-support и выберите Login to your Support Portal (Войти на портал поддержки), чтобы запросить файл .tar для обновления сервисов канала разработчиков. Если у вас нет аккаунта на портале поддержки, выберите Войти на портал поддержки, а затем на странице входа нажмите Срочно? Отправьте запрос в службу поддержки. -
Чтобы обновить сервер с подключением к интернету:
- Извлеките файл обновления портала:
> tar -xvf <tar file>
Эта команда создает новый каталог DeveloperServices-4.x.y.z. - Перейдите в каталог DeveloperServices-4.x.y.z.
- Чтобы скачать последнюю версию Drupal, используйте следующую команду:
> drush dl drupal
Эта команда создает каталог с названием drupal-x.y, где x.y – текущая версия Drupal. - Запустите скрипт networked-update.sh:
> ./networked-update.sh
В зависимости от разрешений на файл вам может потребоваться использовать команду sudo или запустить скрипт от имени администратора. - Чтобы получать уведомления об обновлениях Drupal, убедитесь, что модуль Drupal Update manager включен. В меню Drupal выберите Modules (Модули) и прокрутите страницу вниз до модуля Update manager (Менеджер обновлений). Если она отключена, включите ее.
После включения этой функции доступные обновления можно посмотреть в меню Отчеты > Доступные обновления.
Чтобы настроить модуль так, чтобы он отправлял вам электронные письма, когда становятся доступны обновления, и задать частоту проверки обновлений, выберите пункт меню Отчеты > Доступные обновления > Настройки.
- Извлеките файл обновления портала:
-
Если на сервере нет подключения к интернету:
- На сервере, на который вы скачали файл Developer Channel Services DeveloperServices_x.y.z.tar, извлеките файл обновления портала:
> tar -xvf <tar file>
Эта команда создаст новый каталог DeveloperServices-4.x.y.z. - Перейдите в каталог DeveloperServices-4.x.y.z.
- Запустите скрипт non-networked-update.sh:
> ./non-networked-update.sh
В зависимости от разрешений на доступ к файлам вам может потребоваться использовать команду sudo или запустить ее от имени администратора.
Эта команда скачивает все необходимые файлы обновлений и упаковывает их в один файл devportal-update.tgz, который сохраняется в выбранном вами месте. - Скопируйте файл devportal-update.tgz на целевой сервер, на котором работает портал.
Примечание. Не копируйте файл devportal-update.tgz в корневой каталог сайта целевого сервера. - Распакуйте файл devportal-update.tgz в текущий каталог:
> tar -xzf /path/to/devportal-update.tgz - Перейдите в каталог developer-update.
- Чтобы установить обновление, выполните следующую команду:
> ./install-update.sh - Следуйте инструкциям на экране.
- На сервере, на который вы скачали файл Developer Channel Services DeveloperServices_x.y.z.tar, извлеките файл обновления портала:
Обновление завершено.