Портал сервисов для разработчиков версии 4.17.01
В этой процедуре описывается, как обновить существующую локальную установку 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
- OPDK-16-09.x
Чтобы определить версию портала, откройте в браузере следующий URL:
http://yourportal.com/buildInfo
Подготовка к установке
Если вы изменили код в ядре Drupal или в любых нестандартных модулях, ваши изменения будут перезаписаны. В частности, это касается изменений, внесенных в файл .htaccess. Все, что находится за пределами каталога /sites, принадлежит Drupal. Исключением является файл robots.txt. Если он находится в корневом каталоге, то будет сохранен.
Прежде чем приступать к установке, создайте резервную копию всего корневого каталога Drupal. По умолчанию это /var/www/html, но вы могли изменить его при установке. После выполнения описанных ниже шагов по установке вы сможете восстановить свои настройки из резервной копии.
Обновление сервисов портала для разработчиков Apigee до новой версии
- Резервная копия экземпляра MySQL Drupal.
Дополнительную информацию можно найти на странице http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/.- Вариант 1. Использование Drush
Команда sql-dump в Drush создает копию базы данных. В каталоге 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 с сайта ftp.apigee.com, где x.y.z – номер версии портала. При появлении запроса введите учетные данные, полученные от Apigee.
Вы можете скачать файл по ссылке, отправленной вам Apigee, в браузере или скопировав ее и добавив в следующую команду cURL:
> curl -kOL <вставьте ссылку сюда>
Примечание. Если ваш портал находится на сервере без внешнего подключения к интернету, выполните этот шаг на сервере с доступом.
Перейдите на страницу http://community.apigee.com/content/apigee-customer-support и выберите Login to your Support Portal (Войти на портал поддержки), чтобы запросить TAR-файл обновления Developer Channel Services. Если у вас нет аккаунта на портале поддержки, выберите Login to your Support Portal (Войти на портал поддержки), а затем на странице входа нажмите In a hurry? отправьте запрос в службу поддержки. -
Для обновления на сервере с подключением к интернету:
- Распакуйте файл обновления портала:
> 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 (Менеджер обновлений). Если он не включен, включите его.
После этого вы сможете просматривать доступные обновления, выбрав Отчеты > Доступные обновления.
Чтобы настроить модуль так, чтобы он отправлял вам электронные письма о доступных обновлениях, и задать частоту проверки обновлений, выберите пункт меню Reports (Отчеты) > Available Updates (Доступные обновления) > Settings (Настройки).
- Распакуйте файл обновления портала:
-
Для обновления на сервере без подключения к интернету:
- На сервере, на который вы скачали файл 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, извлеките файл обновления портала:
Обновление завершено.