Обновление Grafana на Linux
Опубликовано:
В данной инструкции мы обновим графану сервер с версии 5 до версии 6. Посмотреть текущую версия Grafana можно командой:
grafana-cli -v
В ходе обновления будет выполнено:
Подготовка системы
Обновление плагинов
Резервные копии базы данных
Копирование конфигурационных файлов
Обновление Grafana
На Debian / Ubuntu
На Red Hat / CentOS
Действия после обновления
Аутентификация через LDAP
Подготовка к обновлению
Перед обновление необходимо выполнить несколько важных шагов — обновление плагинов, создание дампа базы данных, копирование конфигурационных файлов.
Обновление плагинов
Обновить плагины рекомендуется до обновления и после. Выполняется командой:
grafana-cli plugins update-all
Дамп базы данных
Мы будем резервировать данные в каталог /backup — создаем его командой:
mkdir /backup
Далее наши действия будут отличаться в зависимости от используемой СУБД. Проверить, какая база используется можно в конфигурационном файле графаны:
vi /etc/grafana/grafana.ini
В разделе [database] мы найдем настройку для конкретной СУБД. Если же, все настройки закомментированы, то используется SQLite.
а) Если SQLite
Просто копируем файл /var/lib/grafana/grafana.db:
cp /var/lib/grafana/grafana.db /backup
б) Если MySQL/MariaDB
Делаем дамп командой:
mysqldump -u root -p grafana > /backup/grafana_mysql.sql
* где root — пользователь, под которым мы подключимся к серверу баз данных; grafana — название базы (необходимо заменить на ту, что используется в вашей системе). Подробнее про создание резервных копий mysql в инструкции Как сделать дамп базы MySQL / MariaDB.
в) Если PostgreSQL
Делаем дамп командой:
pg_dump grafana > /backup/grafana_backup
* подробнее о резервном копировании PostgreSQL в инструкции Резервное копирование PostgreSQL.
Копирование конфигов
Завершаем подготовительный этап копирование конфигурационных файлов в созданную ранее папку /backup. Для этого выполняем команды:
cp -R /etc/grafana /backup/etc_conf
cp -R /usr/share/grafana/conf /backup/usr_conf
* данной командой мы скопируем все содержимое каталога /etc/grafana в /backup/etc_conf, а /usr/share/grafana/conf — в /backup/usr_conf.
Обновление Grafana
Для обновления графаны на Linux переходим на страницу загрузки и выбираем нужную нам версию Grafana:
* на момент написания инструкции последняя версия была 6.6.2.
Ниже следуем инструкции для соответствующей системы. Например, в моем случае необходимо было выполнить следующее.
а) Для систем на базе deb (Debian / Ubuntu)
1. Устанавливаем утилиту adduser и библиотеку для настройки шрифтов:
apt-get install adduser libfontconfig1
* скорее всего, в системе уже есть данные пакеты и установщик вернет сообщение, что ничего устанавливать не нужно.
2. Загружаем установочный пакет для Grafana:
wget https://dl.grafana.com/oss/release/grafana_6.6.2_amd64.deb
* в моем случае версия была 6.6.2.
3. Устанавливаем новый пакет графаны:
dpkg -i grafana_6.6.2_amd64.deb
Система обновится и автоматически будет перезапущена служба grafana-server.
б) Для систем на базе RPM (Red Hat / CentOS)
1. Устанавливаем утилиту для загрузки wget:
yum install wget
2. Загружаем RPM-пакет для установки Grafana:
wget https://dl.grafana.com/oss/release/grafana-6.6.2-1.x86_64.rpm
* в моем случае версия была 6.6.2.
3. Устанавливаем скачанный пакет:
yum install grafana-6.6.2-1.x86_64.rpm
Система обновится и автоматически будет перезапущена служба grafana-server.
После обновления
После обновления Grafana снова обновляем плагины командой:
grafana-cli plugins update-all
... и перезапускаем сервис графаны:
systemctl restart grafana-server
Проверяем версию графаны:
grafana-cli -v
Открываем веб-браузер и пробуем зайти на интерфейс по адресу http://<IP-адрес Grafana>:3000 (с учетом, что в вашем случае может использоваться протокол https и/или другой порт) — вводим логин и пароль для подключения (если его не меняли, по умолчанию используется admin / admin).
Аутентификация через LDAP
В моем случае использовалась проверка пользователей через сервер LDAP. После обновления она перестала работать, так как была сброшена настройка auth.ldap в конфигурационном файле. И так, открываем последний:
vi /usr/share/grafana/conf/defaults.ini
И правим секцию auth.ldap:
[auth.ldap]
enabled = true
...
* в моем случае достаточно было выставить enabled в true.
После перезапускаем графану:
systemctl restart grafana-server
Подробнее про LDAP в статье Настройка Grafana для аутентификации через Active Directory.
