25.04.2024 публикации

Как быстро установить FineBI 6.0 c PostgreSQL в Docker контейнере

FineBI – флагманская self-service платформа для бизнес-аналитики от китайского разработчика FanRuan, которая предлагает функциональность, удобство использования, широкие возможности масштабирования и легкую интеграцию с различными источниками данных. Платформу используют лидеры ритейла, финансового сектора, промышленности.

В прошлой статье подробно рассказали о возможностях и преимуществах платформы, а также описали реальный опыт быстрой миграции с Qlik на FineBI.

Реальный опыт Qlever Solutions в миграции с Qlik на FineBI

Узнайте, как наш эксперт перенес дашборды из Qlik Sense в FineBI всего за 16 часов
Последнее время мы часто сталкиваемся с вопросами клиентов по установке FineBI 6.0 с внешней СУБД PostgreSQL.

Чтобы ускорить и упростить процесс установки, мы подготовили файл Docker Compose, который позволит развернуть FineBI 6.0 c PostgreSQL в Docker контейнере.

Docker - платформа для разработки, доставки и запуска контейнерных приложений, одна из рекомендуемых производителем сред для развертывания FineBI. Docker Compose — инструмент для одновременного управления несколькими контейнерами, упрощающий развёртывание проектов.

Для использования PostgreSQL в FineBI требуется загрузить плагин для внешней БД и произвести переподключение СУБД после регистрации и входа. Эти шаги уже учтены при создании Docker контейнера, что значительно упрощает настройку.
    В статье подготовили инструкцию по развертыванию FineBI 6.0 c PostgreSQL на сервер с ОС Linux Ubuntu 22.04.


    Минимальные системные требования Linux:
        Итак, поехали!

          Инструкция по развертыванию FineBI 6.0 c PostgreSQL на сервер с ОС Linux Ubuntu 22.04

          1. Получите ссылки на дистрибутив FineBI и архив c файлами Docker для быстрого развертывания FineBI с PostgreSQL

          Для получения ссылок на дистрибутив, ключа для активации тестовой версии FineBI и правил работы с ключом свяжитесь с нами. Так вы будете уверены, что установите самую свежую версию FineBI.
            Получить дистрибутив FineBI
            Получить
            Получить архив с файлами Docker
            Получить

            2. Распакуйте архив c файлами Docker в нужном месте на сервере

            Архив состоит из директории docker/finebi и файла docker-compose.yml, в котором прописано, что внешней СУБД для FineBI будет Postgres 13.0.

            При этом создается база данных finedb и пользователь для настройки подключения к внешней БД - fb_admin.
            Именно этого пользователя и пароль для него мы будем использовать для настройки подключения FineBI к внешней БД.

            При желании вы можете создать нового пользователя и собственный пароль.

            Порт для подключения остается стандартный для Postgres.

            FineBI будет установлен из dockerfile, расположенного в директории docker/finebi.
              Настройки Docker в FineBI

              3. Скачайте в директорию docker/finebi дистрибутив для Linux

              Для этого необходимо:

              • Перейти в директорию cd ./finebi-docker/docker/finebi

              • Скачать файл сразу на сервер, используя команду wget
              https://fineoverseas-server.obs.myhuaweicloud.com/FineBI/EN/6.0.16_2024.01.08/linux_unix_FineBI6_0-EN.sh

              Убедитесь, что ссылка в команде wget соответствует ссылке на дистрибутив из письма!


              В файле dockerfile описано, что в Docker контейнере будет развернута ОС Linux 22.04, на нее установится FineBI из дистрибутива linux_unix_FineBI6_0-EN.sh, расположенного в директории docker/finebi. Также установится плагин, необходимый для работы с PostgreSQL.

              Если название скачанного вами дистрибутива отличается, переименуйте его в linux_unix_FineBI6_0-EN.sh и разместите в нужной директории docker/finebi
                  Проверка названия дистрибутива linux_unix_FineBI6_0-EN.sh

                  4. Установите на сервере Docker Engine и Docker Compose

                  Рекомендуем установить инструменты, используя инструкцию для вашей системы на официальном сайте: https://docs.docker.com/engine/install/ubuntu/

                  Перед началом развертывания необходимо убедиться, что Docker Compose установлен, проверив его версию. Для этого необходимо:

                  • Перейти в директорию cd ./finebi-pg-docker/

                  • Выполнить команду sudo docker compose version

                  • Получить ответ:
                        Выполнение команды sudo docker compose version
                        В директории finebi-pg-docker/ должен располагаться файл docker-compose.yml, из нее же необходимо запускать последующие команды.

                              5. Разверните FineBI и PostgreSQL

                              Для этого необходимо выполнить команду sudo docker compose up -d –build

                              И получить ответ
                                      Ответ в терминале для команды sudo docker compose up -d –build
                                      С помощью команды sudo docker compose ps следует убедиться, что контейнеры развернуты.
                                            Использование команды sudo docker compose ps

                                            6. Продолжайте настройку в FineBI

                                            Если вы развернули FineBI на локальном компьютере, откройте в браузере ссылку: http://localhost:37799/webroot/decision/
                                            Если вы развернули FineBI на сервере, подставьте в ссылку host вашего сервера.

                                            Вы попадете на страницу установки учетной записи администратора FineBI, где необходимо ввести логин и пароль:
                                                    Вход в учетную запись FineBI
                                                    Кликнуть по кнопке «Next» и на следующей странице получить подтверждение об успешном создании учетной записи.
                                                            Успешное создание учетной записи FineBI

                                                            7. Настройте внешнюю базу данных PostgreSQL

                                                            Так как PostgreSQL будет настраиваться уже в самой FineBI, выберете Built-in Database и нажмите Direct Login.
                                                                    Настройка внешней базы PostgreSQL
                                                                    Зайдите в систему под созданной ранее учетной записью администратора.
                                                                            Вход в учетную запись FineBI
                                                                            Перейдите в System Management →System Setting →General →To Be Configured
                                                                                    Шаги к подключению FineBI
                                                                                    Вы попадете на страницу настройки внешней СУБД, где необходимо настроить подключение к PostgreSQL:

                                                                                    • Данные берутся из docker-compose.yml

                                                                                    • Введите информацию:

                                                                                    • Host: finebi-db
                                                                                    • Username: fb_admin
                                                                                    • Password: fb_admin_password

                                                                                    • Нажмите Enable New Database
                                                                                            Подключение PostgreSQL к FineBI
                                                                                            При успешном выполнении вы получите уведомление
                                                                                                    Уведомление при успешном запуске

                                                                                                    8. Зарегистрируйте свой продукт

                                                                                                    Для этого перейдите в System Manager → Registration Manager и нажмите Register Now
                                                                                                        Окно регистрации продукта
                                                                                                        Выберете Local Machine Info, нажмите Upload License и выберете переименованный файл лицензии FanRuan.lic
                                                                                                                Выбор файла лицензии FanRuan.lic
                                                                                                                Готово! Лицензия установлена, вы можете начинать работу в FineBI.
                                                                                                                        Проверка установленной лицензии
                                                                                                                        Дашборд в FineBI
                                                                                                                        Запишитесь на показ демо-дашбордов Qlever
                                                                                                                        Команды Docker Compose, которые могут пригодиться

                                                                                                                        Все команды необходимо выполнять из директории /finebi-pg-docker

                                                                                                                        • остановить работу сервисов контейнера
                                                                                                                        docker compose stop


                                                                                                                        • запустить работу сервисов контейнера
                                                                                                                        docker compose start


                                                                                                                        • перезагрузить работу сервисов контейнера
                                                                                                                        docker compose restart


                                                                                                                        Внимание! Опасная команда, удаляет все данные, в том числе и из СУБД!
                                                                                                                        Использовать только при переустановке FineBi c "чистого листа".

                                                                                                                        • остановить работу контейнеров и удалить контейнеры, сети, тома и образы, созданные командой up
                                                                                                                        docker compose down –volumes


                                                                                                                        • очистить от неиспользуемых контейнеров, сетей, образов и, при необходимости, томов
                                                                                                                        docker system prune --volumes
                                                                                                                                Надеемся, что наша инструкция и подготовленный нами файл Docker Compose помогут вам легко и быстро развернуть FineBI 6.0 c PostgreSQL в Docker контейнере.

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

                                                                                                                                Компания Qlever - золотой партнер компании FanRuan, разработчика платформы бизнес-аналитики FineBI.
                                                                                                                                У нас вы можете приобрести бессрочную лицензию FineBI или лицензию по подписке сроком на год с возможностью продления.

                                                                                                                                    Остались вопросы по настройке Fine BI?

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