Инструкция по установке PIX BI

Инструкция по установке PIX BI на Windows
Содержание
Требования для установки
1. ОС WinServer2019;
2. NET Core 6.0 (MIT license);
3. PostgreSQL – СУБД (PostgreSQL license).
Установка модулей .Net Core
1. На сервере с ОС WinServer2018 (или WinServer2019) в панели меню Пуск в разделе
«Поиск» введите «Диспетчер серверов», откройте найденное приложение.

2. В открывшемся окне выберите пункт «2. Добавить роли и компоненты»:

3. В открывшемся окне нажимайте «Далее» 3 раза, проверяя, что на втором этапе выбран
пункт «установка ролей или компонентов»:

4. На 4-м шаге необходимо убедиться, что установлены базовые компоненты IIS:

5. На 5-м шаге (выбор Компонентов) необходимо внизу списка отметить пункт «Функции .Net
Framework 4.6» (или другую имеющуюся наиболее свежую версию):

6. Нажать «Далее», и затем «Установить». Лучше всего на этом этапе дождаться установки, и
только затем закрывать окно настроек:

Установка библиотеки .Net Hosting
Библиотеку .Net Hosting можно скачать на сайте, а можно извлечь из архива _pix_bi_apps.zip на рабочий стол (скаченный файл будет находиться в стандартной
папке «Загрузки»).
Скаченный или распакованный файл будет иметь название вида dotnet-hosting-X.Y.Zwin.exe, например dotnet-hosting-6.0.8-win.exe
1. После запуска необходимо ознакомиться и согласиться с условиями лицензии, и нажать
на кнопку «Установить».
2. В экране безопасности надо подтвердить установку и дождаться запуска установщика.

Конфигурация веб-сервера IIS
1. В панели меню Пуск в разделе «Поиск» введите «Диспетчер служб IIS», откройте
найденное приложение.

2. В открывшемся окне необходимо выбрать текущий сервер (развернуть), и в правой секции
нажать на иконку «Сертификаты сервера»:

3. В пустой области нажать правой кнопкой мыши и выбрать пункт контекстного меню
«Создать самозаверенный сертификат»:

4. Указать имя сертификата (любое, например pixBI) и нажать ОК:

Сертификат появится в списке в той области, которая на предыдущем шаге была пустой.

5. Теперь добавим новый пул приложений. Для этого в левой части окна выбрать «Пулы
приложений» и затем в правой области нажать правой кнопкой мыши на пустом поле и выбрать пункт контекстного меню «Добавить пул приложений»:

6. В открывшемся окне указать имя (например pixBI) и нажать ОК.

В расширенных настройках установить параметр "Загружать профиль пользователя" = Да.
После создания можно остановить DefaultAppPool – нажав правой кнопкой мыши на
соответствующей строчке списка и выбрав в контекстном меню опцию «Остановить».

7. После этого можем создать новый веб-сайт – перейти в правой части окна на пункт «сайты»,
и затем нажать правой кнопкой мыши на пустом поле и выбрать пункт контекстного меню
«Добавить веб-сайт»:

8. В открывшемся окне ввести имя веб-сайта, например pixBI, и выбрать ранее созданный пул
из списка (после нажатия кнопки «Выбрать» откроется маленькое окно с селектором, выбрать пул, в нашем примере это pixBI, нажать ок).

9. Далее необходимо задать путь до файлов ПО. В разделе «физический путь» необходимо
нажать на кнопку «…», откроется новое окно. Выбрать диск «C:» и нажать на кнопку «Создать папку».
Дать папке имя, например pixBI, и нажать ок.

10. Затем в секции «Привязка» выбрать Тип «https», и ниже выбрать ранее созданный SSLсертификат (в нашем примере это pixBI), после чего нажать кнопку ОК.

Установка PostgreSQL
Для установки postgresql можно воспользоваться инструкцией с официального сайта или распаковать _pix_bi_apps.zip на рабочий стол
(скаченный файл будет находиться в стандартной папке «Загрузки»).
Скаченный или распакованный файл будет иметь название вида
PostgreSQL_XY.Z_64bit_Setup.exe, например.

1. После запуска и возникновения экрана безопасности с подтверждением установки
данного ПО, необходимо ответить утвердительно, и затем дождаться работы установщика.
Выбрать удобный для установки язык (если система предложит это сделать), и далее двигаться по этапам установки, утвердительно отвечая на возникающие вопросы, если только какие-то шаги не описаны подробнее ниже.
2. Убедиться, что на этапе выбора компонентов выбраны все возможные опции:

3. Затем снова несколько раз нажимаем «Далее» до шага ввода пароля:

Необходимо будет указать базовое имя пользователя и пароль. Чтобы не изменять другие
конфигурационные файлы на дальнейших этапах установки, рекомендуем использовать имя пользователя postgres и пароль postgres.

4. На следующем шаге установки необходимо переключить галочку на использование
стандартных настроек - «Use Default Settings» и нажать «Далее»:

5. На следующем шаге ничего не менять и нажать «Установить».

6. Дождаться установки postgres и нажать «Завершить»:

7. После установки необходимо создать пустую Базу данных через консоль postgres. Для
этого в меню «Пуск» найдите папку «Postgre SQL» и в ней выберите «SQL Shell»:

8. В открывшемся окне вы увидите вопросы для параметров подключения со значениями по
умолчанию. Необходимо нажимать клавишу «Enter» до появления вопроса про пароль. Наберите пароль, заданный на этапе установки (в нашем примере это был postgres), нажмите клавишу «Enter» ещё раз. Должно появиться сообщение об успешном подключении с информацией о текущей версии postgres:

9. Необходимо ввести команду
CREATE DATABASE "pix_bi_test";
и нажать «Enter».

10. Должно отобразиться сообщение CREATE DATABASE, и если после этого ввести команду
\c
и нажать «Enter», то будет виден список БД, среди которых должна быть pix_bi_test:

Готово, можно переходить к установке PIX BI.
Установка PIX BI
PIX BI работает как веб-сервис (веб-приложение), поэтому необходимо опубликовать его на
веб-сервере.
1. Распакуйте загруженный архив «pix_bi_latest.zip» с экземпляром программного
обеспечения (с использованием пароля 3f7!qh3V). Путь к распаковке должен совпадать с тем, что был задан на этапе конфигурации веб-сайта в IIS (шаг 9): в нашем примере это «C:\PixBI».
2. Если при установки Postgres на третьем шаге вы указали имя и пароль, отличные от
рекомендованных, вам необходимо исправить файл C:\PixBI\appsettings.json , открыв его в любом текстовом редакторе. В начале файла есть строчка, начинающаяся на «PostgreSqlConnection».
В ней необходимо указать ваше имя пользователя после слов User ID и ваш пароль после
слова Password.
3. Теперь можно вернуться в диспетчер IIS и запустить пул pixBI (правая кнопка мыши на пуле, выбрать необходимый пункт контекстного меню).

4. После этого можно получить доступ к приложению. Для этого зайдите в браузер (Chrome,
Firefox или Яндекс) и перейдите по адресу: https://127.0.0.1.

5. Поскольку используется самоподписанный сертификат, браузер выдаст предупреждение
безопасности. Необходимо добавить исключение для этого сайта. Разные браузеры по-разному дают возможность сделать это, на следующей картинке приведён пример для Яндекс.Браузера:

Похожим образом можно просмотреть сайт и в других браузерах:
https://support.mozilla.org/ru/kb/chto-znachit-osh...

6. После этого вы увидите портал PIX BI. На страницу авторизации можно перейти, нажав на иконку слева:

7. По умолчанию создастся пользователь с именем admin и паролем Admin1Default@
Введите эти данные в форме логина и нажмите «Войти».

8. Поскольку это первый вход после установки, и ещё нет выписанных лицензий под этот
экземпляр ПО, вы увидите сообщение об отсутствии активных лицензий. Необходимо перейти по ссылке ниже:

9. Вы попадаете на страницу лицензирования, где вверху можете увидеть уникальный ключ
вашего экземпляра PIX BI, скопируйте этот ключ и напишите письмо на help@pixrpa.ru указав, что вам нужна лицензия для активации PIX BI, вставив в текст письма скопированный ключ.

10. На этом же экране есть кнопка загрузки лицензии. Когда вы получите ответ,
скачайте приложенный к письму файл лицензии (файл с расширением .lic или .zip) и загрузите его.

11. После этого можно вернуться на экран авторизации и войти в систему.
Инструкция по установке PIX BI на Linux
Содержание
Требования для установки
1. ОС Linux (Debian)
2. NET Core 6.0 (MIT license);
3. PostgreSQL – СУБД (PostgreSQL license).

Установка модулей .Net Core на Linux
Для установки необходимых модулей используется терминал (можно найти в поисковой строке по слову cmd).
Чтобы выполнить последующие команды, нужен доступ от пользователя root. Для этого в командной строке необходимо выполнить инструкцию "su root" и ввести пароль пользователя root, указанный при установке операционной системы.
Для установки модулей .Net Core в командной строке необходимо выполнить следующие операции:
sudo apt-get update
sudo apt-get install apt-transport-https
sudo apt-get update

Скачать и установить пакеты .Net:
wget https://packages.microsoft.com/config/debian/10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update
sudo apt-get install -y dotnet-sdk-6.0

В случае, если при установке пакетов возникает ошибка, нужно выполнить инструкции, представленные в подразделах дистрибутивов Linux на сайте.
Установка и настройка веб-сервера Apache
Установка:
sudo apt-get install apache2
Система может запросить подтверждение, надо согласиться:

Создаем SSL сертификат:
cd /etc/apache2
mkdir ssl
cd ssl
sudo openssl req -new -x509 -days 1461 -nodes -out cert.pem -keyout cert.key -subj "/C=RU/ST=Msk/L=Msk/O=YourCompany/OU=IT Department/CN=localhost/CN=pixbi"
Устанавливаем дополнительные модули Apache и перезапускаем веб-сервис:
sudo a2enmod proxy_http proxy_html proxy_wstunnel ssl
sudo a2enmod rewrite
sudo systemctl restart apache2
После этого нужно создать конфигурационный файл для установки прокси на Apache. Для этого нужно выполнить команду:
sudo nano /etc/apache2/conf-enabled/netcore.conf
Откроется текстовый редактор, в появившееся окно нужно скопировать следующий текст:
<VirtualHost *:443>
ServerName www.CurrentDomain.com
DocumentRoot /var/netcore
SSLEngine on
SSLCertificateFile ssl/cert.pem
SSLCertificateKeyFile ssl/cert.key
#SSLCertificateChainFile ssl/cert.ca-bundle
ProxyPreserveHost On
ProxyPass / http://127.0.0.1:5000/
ProxyPassReverse / http://127.0.0.1:5000/
RewriteEngine on
RewriteCond %{HTTPS} off
RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
RewriteCond %{HTTP:UPGRADE} ^WebSocket$ [NC]
RewriteCond %{HTTP:CONNECTION} Upgrade$ [NC]
RewriteRule /(.*) ws://127.0.0.1:5000/$1 [P]
ErrorLog /var/log/apache2/netcore-error.log
CustomLog /var/log/apache2/netcore-access.log common
</VirtualHost>
Записать эти изменения в файл нажатием "ctrl" + "O".

После этого нужно перезапустить сервер Apache, для чего в командной строке нужно прописать:
sudo apachectl configtest
Подтвердить имя файла:

Выйти из редактора "ctrl"+"X".
При повторном запуске команды sudo nano /etc/apache2/conf-enabled/netcore.conf вы должны увидеть в текстовом редакторе тот текст, который вы копировали. Если файл пустой – обратитесь к системному администратору или в техподдержку компании, предоставившей услуги хостинга сервера.
Убедимся в правильности синтаксиса и перезапустим сервис Apache:
sudo apachectl configtest
Должны получить Syntax Ok. Перезапускаем сервис:
sudo service apache2 restart
Проверяем статус:
sudo service apache2 status

В случае успеха получаем статус Active: active (running).
Если Stopped, Failed - необходимо перепроверить конфигурацию.

Правильность установки apache можно проверить, запустив команду:
wget http://localhost/ 
- в файл index.html скачается приветственная страница apache.
Установка Docker + Postgres под Linux
Установка Docker:
sudo apt update
sudo apt install docker.io
Далее можно работать с Docker в соответствии с руководством, запуская команды в режиме суперпользователя (sudo).

Запуск Docker:
sudo systemctl start docker
sudo systemctl enable docker
Загрузка контейнера Postgres:
sudo docker pull postgres
Для автоматического запуска контейнера Postgres используйте следующую команду:
sudo docker run -d --restart unless-stopped --name pix-postgres -e POSTGRES_PASSWORD=123456789 -d -p 5432:5432 -v $HOME/docker/volumes/postgres:/var/lib/postgresql/data postgres
В результате запустится сервис postgres, а система выведет на экран идентификатор как показано ниже:

Установка и конфигурация сервиса PIX BI
Скачайте и распакуйте архив с экземпляром программного обеспечения. Путь к распаковке в нашем примере будет «/var/netcore».
mkdir /var/netcore/ 
cd /var/netcore/
wget https://dl.pixrpa.ru/partners/pix_bi_stage.zip
Для распаковки архива c паролем нужно будет установить доп.пакет:
sudo apt-get install unzip
При установке система может запросить подтверждения – со всем соглашаемся.

Распаковываем (с использованием пароля 3f7!qh3V):
unzip pix_bi_stage.zip

Добавим конфигурацию для хранения ключей криптографии:
sudo nano /var/netcore/appsettings.json
Зайдите в папку, куда было установлено приложение, и откройте файл appsettings.json.
Перед строкой ConnectionStrings необходимо добавить:
"CryptographyKeysFolder": "Keys-dir",
# «Keys-dir» - это путь до папки, где будут храниться ключи криптографии. 

ОБЯЗАТЕЛЬНО! В ключе CryptographyKeysFolder нужно прописать путь до папки, где будут храниться ключи криптографии.
Её можно создать в любом удобном месте. В данном примере она создана в той же папке, где находятся файлы проекта:
mkdir /var/netcore/Keys-dir/
Также в некоторых дистрибутивах нужно дать доступ на запись. Самый простой способ:
sudo chmod 777 ./{Название папки с ключами}
#При указании названия папки "{}" не ставятся.
Сохраняем файл "ctrl" + "O", подтверждаем имя и выходим сочетанием клавиш "ctrl" + "X".
Создаём файл сервиса:
sudo nano /etc/systemd/system/pixbi.service
В файл записываем следующее содержимое:
[Unit]
Description=ASP .NET Web Application
[Service]
#Указываем путь к директории с установленным PIX BI
WorkingDirectory=/var/netcore
ExecStart=/usr/bin/dotnet /var/netcore/BI.dll
Restart=always
RestartSec=10
SyslogIdentifier=netcore-demo
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production
[Install]
WantedBy=multi-user.target
Сохраняем файл "ctrl" + "O", подтверждаем имя и выходим сочетанием клавиш "ctrl" + "X".
После этого нужно будет запустить сервис с помощью следующих команд:
sudo systemctl enable pixbi.service
sudo systemctl start pixbi.service
Откроем порты, чтобы можно было получить доступ к серверу извне:
sudo ufw allow 443
sudo ufw allow 5000
Теперь можно получить доступ к приложению через порт 5000.
Проверяем статус:
sudo systemctl start pixbi.service 
sudo service apache2 status
В случае успеха получаем статус Active: active (running).
Если видим статус killed:
cd /var/netcore/
dotnet PIX-BI.dll
# затем:
sudo systemctl stop pixbi.service
sudo systemctl start pixbi.service
sudo service apache2 restart
Всё готово, теперь можем зайти в приложение.
Запуск сервиса PIX BI и установка лицензии
Теперь можно получить доступ к приложению. Для этого зайдите в браузер (Chrome, Firefox или Яндекс) и перейдите по адресу https://{ip.of.your.server}/login, заменив {ip.of.your.server} на IP-адрес вашего сервера Debian.

Поскольку используется самоподписанный сертификат, браузер выдаст предупреждение безопасности. Необходимо добавить исключение для этого сайта. В разных браузерах это выглядит по-разному, на следующей картинке приведён пример для Яндекс.Браузера:

После этого вы увидите портал PIX BI. На страницу авторизации можно перейти, нажав иконку слева:

Дефолтные данные для входа в систему:
Логин: admin
Пароль: Admin1Default@
Введите эти данные в форме логина и нажмите «Войти».

Поскольку это первый вход после установки, и ещё нет выписанных лицензий под этот экземпляр ПО, вы увидите сообщение об отсутствии активных лицензий.
Необходимо перейти по ссылке ниже:

Вы попадаете на страницу лицензирования, где вверху можете увидеть уникальный ключ
вашего экземпляра PIX BI, скопируйте этот ключ и напишите письмо на help@pixrpa.ru указав, что вам нужна лицензия для активации PIX BI, вставив в текст письма скопированный ключ.

На этом же экране есть кнопка загрузки лицензии. Когда вы получите ответ,
скачайте приложенный к письму файл лицензии (файл с расширением .lic или .zip) и загрузите его.


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