Обновление.

Ручное Обновление

Важно понимать базовые компоненты, на которые разбита Pandora FMS. Pandora FMS базово состоит из сервера, базы данных и консоли.

Стандартная конструкция Pandora FMS

При установке с Open source мы быстро обновим эти три компонента, но с Enterprise процесс будет иметь еще несколько шагов, поскольку компоненты несут расширенные функции Enterprise, которые необходимо обновить отдельно.

В установках версии Open source:

  • Веб-Консоль.
  • Сервер.
  • База данных.

В установках версии Enterprise:

  • Консоль Web Open.
  • Консоль Web Enterprise (расширенные функции в консоли).
  • Сервер Open.
  • Сервер Enterprise (расширенные функции на сервере).
  • База данных (дополнительные таблицы версии Enterprise).

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

Незначительное обновление версии

Они не включают изменения в базе данных, только изменения на консоли, но могут содержать и изменения на сервере. Примерами являются обновления с 6.1 SP1 до 6.1 SP2.

Первоначальные меры предосторожности: пройдя по этой ссылке вы найдете подробную процедуру резервного копирования и восстановления Pandora FMS. Краткое изложение процедуры резервного копирования выглядит следующим образом:

1. Выполнить резервное копирование базы данных. Пример:

mysqldump -u root -p pandora> backup_pandora_X.Y.sql

2. Сделать резервную копию файлов конфигурации: pandora_server.conf, config.php, pandora_agent.conf.

3. Выполнить резервное копирование плагинов plugins Сервера и Агента, расположенных в:

 /etc/pandora/plugins
 pandora_console/attachment/plugin
 /usr/share/pandora_server/util/plugin

4. Остановить службы: pandora_server, tentacle_serverd, httpd, pandora_agent y mysqld.

5. Приступить к обновлению.

Из пакетов RPM

  • Обновление Консоли Open Source:
rpm -U pandorafms_console_package.rpm
  • Обновление Консоли Enterprise:
rpm -U pandorafms_console_enterprise_package.rpm
  • Обновление сервера Open Source:
rpm -U pandorafms_server_package.rpm
  • Обновление сервера Enterprise с помощью tar.gz:
 tar -xvzf pandorafms_server_enterprise_package.tar.gz
 cd pandora_server
 ./pandora_server_installer --install

В любое время, до и после обновления, вы сможете узнать свои установленные версии, выполнив команду:

  rpm -qa | grep -i pandora

Из Tarball / Источники

  • Обновление Консоли Open Source:
 tar xvzf pandorafms_console_package.tar.gz
 cd pandora_console
 ./pandora_console_upgrade -p /yourconsolepath
  • Обновление Консоли Enterprise:
 tar xvzf pandorafms_console_enterprise_package.tar.gz
 cd pandora_console
 ./pandora_console_upgrade -p /yourconsolepath
  • Обновление сервера Open Source:
 tar xvzf pandorafms_server_package.tar.gz
 cd pandora_server
 ./pandora_server_upgrade --upgrade
  • Обновление сервера Enterprise:
 tar xvzf pandorafms_server_enterprise_package.tar.gz
 cd pandora_server
 ./pandora_server_upgrade --upgrade
  • Обновление агента:
 tar xvzf pandorafms_agent_package.tar.gz
 cd pandora_agent
 ./pandora_agent_installer --force-install

Версия 7.0 NG ( Rolling Release )

Если вы решите вручную обновить консоль Pandora FMS до версии 7.0 NG (с помощью rpm, tarball или deb), вы можете столкнуться с необходимостью вручную применять скрипты миграции между различными версиями. Чтобы избежать такого поведения в версии 7, мы всегда рекомендуем обновлять консоль с помощью Update Manager.

Если вы обладаете устаревшей базой данных (редкая ошибка, которая не должна возникать в нормальных условиях), пользователи-администраторы смогут увидеть уведомление на вкладке уведомлений, указывающее на эту проблему:

Чтобы решить эту проблему, нужно войти через оболочку на сервер, где находится консоль Pandora FMS, и выбрать место расположения в каталоге:

/var/www/html/pandora_console/extras/mr

В этом каталоге появится другой каталог с именем updated. Там должны храниться все sql, которые уже применены, а вне него еще не примененные. Поэтому, как только мы применим sql в базе данных, мы должны переместить их в каталог updated.

Хорошим примером выполнения является MR1. В этом случае MR не применяется к базе данных, а в нижнем колонтитуле (footer) консоли Pandora FMS появится MR0. Если мы установили версию 704 вручную, нам придется применить MR1. используя sql, которые мы сможем найти в /var/www/html/pandora_console/extras/mr/ под именем 1.sql. Нужно выполнить следующее:

[root@localhost mr]# cat 1.sql | mysql -u root -p pandora

root является пользователем MySQL, а pandora - это имя базы данных.

После применения вы должны обновить значение MR в таблице MySQL tconfig, чтобы изменить значение footer на текущее. Это должно быть выполнено со следующей командой в командной строке MySQL:

 mysql> use pandora;
 mysql> update tconfig set value= XX where token='MR';

Как только это будет сделано, предупреждающее сообщение консоли Pandora FMS исчезнет, и в footer консоли вы увидите примененный MR1. Следующим шагом будет перемещение sql в updated.

[root@localhost mr]# mv 1.sql updated/

Чтобы узнать какие MR должны быть применены, пожалуйста, перейдите по следующей ссылке.

Крупное обновление версии

Крупные обновления версий всегда включают изменения в базе данных, поэтому вам нужно будет обновить схему базы данных. Например, такие обновления будет происходить начиная с версии 6.0 до 6.1 или с 6.1 до 7.0.

Обновление базы данных ("Крупные" версии)

Для обновления базы данных необходимо сначала обновить консоль Open Source и Enterprise (только для клиентов Enterprise), так как эти обновления загрузят необходимые файлы sql.

После полного обновления консоли скрипты sql обновления базы данных будут находиться в каталогах /extras и /enterprise (только для установок Enterprise) Консоли. При стандартной установке в CentOS вы сможете найти их здесь:

/var/www/html/pandora_console/extras/pandoradb_migrate_X.Y_to_Z.T.mysql.sql
/var/www/html/pandora_console/enterprise/pandoradb_migrate_vX.Y_to_vZ.T.mysql.sql

Перед обновлением рекомендуется соблюдение описанных выше первоначальных мер предосторожности, таких как: резервное копирование базы данных и резервное копирование файлов конфигурации. Также необходимо будет остановить службу сервера Pandora FMS:

service pandora_server stop
  • Обновление базы данных с Open Source:
mysql -u username -p -D databasename

Пример:

mysql -u pandora -p -D pandora

После появления командной строки MySQL выполните следующую команду:

source /yourconsolepath/extras/pandoradb_migrate_X.Y_to_Z.T.mysql.sql;

При проведении миграции версии Open Source, обновится также версия Enterprise.

Чтобы выйти из клиента MySQL, выполните команду quit. Таким образом, база данных будет обновлена до соответствующей версии.

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

 mysql -u username -p databasename> drop database databasename;
> create database newdatabasename;
> use newdatabasename;
> source backup_pandora_X.Y.sql

Пример:

 mysql -u root -p pandora> drop database pandora;
> create database pandora;
> use pandora;
> source backup_pandora_X.Y.sql;

Автоматическое обновление с помощью Update Manager

Обновления Open Source

Начиная с версии 4.0.2, Pandora FMS позволяет выполнять -с версии Open Source- полуавтоматические еженедельные обновления. Это улучшение системы происходит благодаря Update Manager, ранее была доступном только для версии Enterprise; таким образом, вы можете проверить online, существует ли обновление, и можно ли автоматически и удобно загрузить его и отправить запрос на обновление консоли.

Это обновление имеет следующие функции:

  • Вам нужно будет выходное (out) интернет соединение от Консоли Pandora FMS.
  • Update manager свяжется с нашими серверами, чтобы найти последнюю доступную версию (на Sourceforge). Отправит анонимные статистические данные об использовании (количество агентов).
  • Обновление будет загружено из Sourceforge, из каталога еженедельных обновлений.
  • Еженедельные обновления не являются инкрементными, они представляют собой полное содержимое консоли, поэтому процесс может быть длительным (пакет обычно составляет около 25 мегабайт).
  • Обновления являются автоматическими: они не проверяются компьютером, и хотя в 99% случаев это не приводит ни к каким проблемам, мы не можем дать гарантию, что в вашем случае будет именно так.
  • Обновления служат только для Консоли, а не для Агентов и/или Сервера.

Процесс для обновления Консоли

Перейдите в Update managerUpdate manager online. На главном экране вы увидите, есть ли какие-либо ожидающие обновления, доступные для установки, а также текущую версию консоли.

Если есть какие-либо обновления, нажмите Ok для их установки. После загрузки пакета появится диалоговое окно, в котором вам будет предоставлена возможность принять или отклонить обновление Консоли.

Нажмите кнопку подтверждения Ok, чтобы начать процесс обновления.

Некоторые из обновлений несут с собой изменения в базе данных. Сам процесс обновления отобразит диалоговое окно, предупреждающее об этих изменениях, как показано на следующем фото:

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

Чтобы использовать Update Manager, вам нужно, чтобы ваша Консоль имела выход в интернет. По умолчанию вы будете использовать WGET для загрузки пакетов (быстрее); вы можете использовать метод CURL (это можно изменить в настройках Pandora FMS), но это несколько медленнее.

После этого процесса отобразится главная страница помощника обновления с обновленной версией консоли. Поздравляем, версия была успешно обновлена!

Обновление Enterprise

В отличие от обновлений Open Source, здесь присутствуют некоторые дополнительные характеристики:

  • 100% протестировано и проверено командой разработчиков, чтобы вы могли наслаждаться обновлениями в день (иногда в течение нескольких часов после) открытия инцидента.
  • Специальные (добавочные) обновления, которые позволяют обновлять только то, что устарело, без загрузки тяжелых пакетов из интернета.
  • Есть возможность обновления offline, загружая пакеты со страницы поддержки, для установок Pandora FMS, которые не имеют подключения к Интернету (для безопасности).

Конфигурация

Versión

Enterprise.

Чтобы использовать Update Manager в корпоративной версии, сначала необходимо правильно настроить средство обновления, которое имеет свой собственный раздел в меню:

Онлайн-обновления

Из раздела обновления вы можете зайти в Update Manager. Если у вас установлена версия Enterprise, вы можете использовать этот интерфейс, а если нет, то появится версия Open Source.

На этой странице отображается номер версии, на котором вы находитесь в Pandora FMS, и сообщается о наличии новых обновлений.

Чтобы обновить до последней версии, нажмите на ссылку, которая показывает изображение на консоли Pandora FMS.

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

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

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

После процесса помощник обновления появится с текущей версией, установленной на Pandora FMS.

Обновления Оффлайн

Вы можете скачать offline обновления Pandora FMS, которые представляют собой файлы с расширением .OUM. Для этого перейдите на официальную страницу поддержки Pandora FMS и загрузите их.

Загрузите на консоль с помощью этого элемента управления:

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

Обновление будет применяться в том же потоке операций, что и в случае online, показывая диалоги, соответствующие обновлению консоли и базы данных, если в ней были изменения.

Также в том же режиме с OUM вы можете обновить консоль Pandora FMS с помощью zip-файлов, созданных нашими специалистами.

При обновлении установки с High Availability (HA), необходимо учитывать то, что указано в этом пункте.

Дополнительная настройка PHP-мотора для операции Update Manager

Для правильной работы Open Update Manager требуется больше памяти, чем по умолчанию. Чтобы выделить больше памяти для выполнения PHP и заставить Open Update Manager работать, вы должны отредактировать файл php.ini и установить резервную память как минимум на 800M.

Линия:

memory_limit = 800M    ; Maximum amount of memory a script may consume

Чтобы узнать расположение файла php.ini, выполните:

php -i | grep php.ini

Кроме того, в зависимости от версии Pandora FMS, которую вы установили, вы можете получить дополнительную информацию для обновления до версии PHP 7 пройдя по этой ссылке.

Переход на другую систему

Может случиться так, что вам понадобится новая версия Pandora FMS в другой или более новой системе/дистрибутиве; например, переход с CentOS 6 на 8 или с RHEL на CentOS.

1. Выполните резервное копирование базы данных предыдущей системы:

mysqldump -u root -p pandora> backup_pandora_X.Y.sql

2. Выполните резервное копирование базы данных предыдущей системы: скачайте только ISO Pandora FMS и установите.

3. Затем отправьте или скопируйте файл любым удобным для вас образом backup_pandora_X.Y.sql из старой системы в новую.

4. Закройте все процессы, запущенные в новой системе, кроме mysql; начните с Pandora FMS:

 /etc/init.d/pandora_server stop
 /etc/init.d/pandora_agent_daemon stop
 /etc/init.d/tentacle_serverd stop

5. Остановка сервера Apache будет зависеть от дистрибутива, который вы используете:

/etc/init.d/apache2 stop
/etc/init.d/httpd stop
systemctl stop httpd.service

6. Войдите в mysql с пользователем root. Получите доступ к базе данных Pandora FMS в новой системе, по умолчанию «pandora» и импортируйте базу данных.

 # mysql -u root -p
 mysql>use pandora
 Database changed
 mysql>source /home/<your_user>/backup_pandora_X.Y.sql

Этот путь будет варьироваться в зависимости от каталога, в котором у вас есть резервная копия старой системы.

7. В случае, если переход происходит к более высокой версии, это приводит к изменению структуры базы данных, поэтому в таком случае нужно выполнить скрипты scripts перехода так, как указано в процедуре обновления более высокой версии.

8. Если мы внесли изменения в дистрибутива, мы должны иметь в виду, что PATH консоли тоже было изменено, как и некоторые поля в базе данных, например tconfig attachment_store и fontpath. Чтобы изменить эти поля, мы должны ввести эти query. Пример для миграции в CentOS; в других дистрибутивах изменить path каталога Apache.

#mysql -u root -p
mysql>use pandora
Database changed
mysql>UPDATE tconfig SET value = '/var/www/html/pandora_console/attachment' WHERE token LIKE

'attachment_store'
mysql>UPDATE tconfig SET value = '/var/www/html/pandora_console/include/fonts/smallfont.ttf' WHERE token LIKE

'fontpath'

Следует также учитывать PATH в файлах конфигурации сервера и консоли (config.php и pandora_server.conf)

9. После переноса базы данных, вы должны проверить, имеют ли файлы …/pandora_console/include/config.php и /etc/pandora/pandora_server.conf предыдущий и новые одинаковые данные в полях dbname, dbuser и dbpass. В том случае, если они равны, мы больше ничего не должны делать. Если они разные, мы можем сделать две вещи:

а. Заменить новые файлы старыми или, при их отсутствии, данные старых файлов теми, которые находятся в новых.

б. Дать разрешения на базу данных с данными новой установки. Предположим, что новая установка имеет следующие данные: dbname=pandora, dbuser=pandora1 и dbpass=pandora2, тогда мы выполним следующее:

 #mysql -u root -p
 mysql>grant all privileges on pandora.* to 'pandora1'@'localhost' identified by 'pandora2';
 mysql>flush privileges;

После этого вы можете снова запустить все daemon, и вы уже сможете получить доступ к консоли Pandora FMS со всеми агентами, модулями, предупреждениями и т. д., которые у вас были настроены, и если мы изменим IP-адрес нового хоста Host на старый, все локальные агенты будут отчитываться перед этой новой системой.

В случае, если это версия Enterprise, будет выполняться тот же процесс.

Обновление до предыдущей версии

Чтобы выполнить обновление до более низкой версии, достаточно понизить версию консоли Pandora FMS. В качестве меры предосторожности рекомендуется выполнить резервное копирование базы данных и файлов конфигурации Pandora FMS, как описано в предыдущих разделах. Всегда нужно скачала выполнить установку пакета Open Source, а затем версии Enterprise.

Из пакетов RPM

  • Обновление Консоли Open Source:
rpm -i --force pandorafms_console_package.rpm
  • Обновление Консоли Enterprise:
rpm -i --force pandorafms_console__enterprise_package.rpm

Из Tarball/Источники

  • Обновление Консоли Open Source:
 tar -xvzf pandorafms_console_package.tar.gz
 mv --force ./pandora_console/* /yourconsolepath
  • Обновление Консоли Enterprise:
 tar -xvzf pandorafms_console_package.tar.gz
 mv --force ./enterprise /yourconsolepath

Назад к Указателю документации Pandora FMS