Инсталляция Tariscope под Linux

Система Tariscope 4.6 обеих редакций Enterprise и Provider создана на основе программной платформы .Net 5.0 и использует Microsoft SQL Server. Поэтому выбор Linux дистрибутивов для Tariscope зависит от поддержки этих двух компонентов.

Tariscope поддерживает работу с любой редакцией Microsoft SQL Server 2022 или 2019 или 2017. Согласно документации компании Microsoft, SQL Server 2022 или 2019 могут быть установлены на:

• Red Hat 7.7 - 7.9 для SQL Server 2019 или 8.0 - 8.6 для SQL Server 2022 и 2019.
• SUSE 12 (SP3 - SP5) для SQL Server 2019 или 15 (SP1 -SP3) для SQL Server 2022 и 2019.
• Ubuntu 16.04, 18.04 для SQL Server 2019 или 20.04 для SQL Server 2022 и 2019.

Требования к системе для установки Linux для обеих версий MS SQL сервера одинаковы:

• память: 2 ГБ;
• файловая система: XFS или EXT4;
• место на диске: 6 ГБ;
• частота процессора: 2 ГГц;
• тип процессора: совместим с х64.

Tariscope нуждается в .Net 5.0, поэтому если Tariscope устанавливается только сам без Microsoft SQL сервера, а последний будет установлен где-то на другом сервере, то платформу .Net 5.0 можно установить на следующие дистрибутивы Linux:

• Alpine
• CentOS
• Debian
• Fedora
• openSUSE
• SLES Snap-пакеты
• Ubuntu.

Если же Tariscope устанавливать на одном физическом (виртуальном) сервере вместе с Microsoft SQL сервером, то дистрибутивы Linux, которые для этого подходят Ubuntu и SUSE.

Мы тестировали Tariscope под Ubuntu 20.04.

Порядок установки Microsoft SQL Server, платформы .Net 5.0 и ряда программных приложений, необходимых для работы Tariscope, можно выполнять в произвольном порядке.

1. Установка Microsoft SQL Server 2022

Установку этого SQL сервера следует выполнять согласно инструкциям, приведенным в статье - How to install Microsoft SQL Server on Ubuntu 20.04 LTS.

2. Установка программной платформы .Net 5.0

Установка должна производиться с правами root. Поэтому перед каждой командой следует указывать sudo или, чтобы не указывать это каждый раз, можно выполнить команду: sudo -i

Платформа .Net 5.0 может устанавливаться в одном из вариантов:

• .Net Runtime.
• .Net SDK, который содержит в себе и .Net Runtime.

Для проверки, какие .Net Framework уже установлены в системе, следует ввести команды:

dotnet --list-runtimes

dotnet --list-sdks

Есть разные варианты для установки платформы .Net 5.0.

Инструкции по установке .Net Runtime приведены в статье Microsoft.

Инструкции Microsoft для установки .Net SDK или .Net Runtime с помощью Snap. Например, согласно этим рекомендациям для установки .Net SDK версии 5.0 следует выполнить следующую команду:

sudo snap install dotnet-sdk --classic --channel=5.0

Далее рекомендуется зарегистрировать в системе алиас для dotnet-sdk.dotnet:

sudo snap alias dotnet-sdk.dotnet dotnet

Если установка .Net 5.0 выполнялась с помощью Snap, следует сделать symlink следующей командой:

ln -s /snap/bin/dotnet /usr/bin/dotnet

3. Установка дополнительных приложений

Для работы Tariscope необходимо установить следующие приложения:

• cpuid,
• inxi,
• libgdiplus,
• wkhtmltopdf.

Для их установки выполните следующие команды:

apt-get install cpuid

apt-get install inxi

apt-get install libgdiplus

apt-get install wkhtmltopdf

4. Установка и запуск Tariscope

Загрузите установку Tariscope и два скрипта:

http://softpiua.com/files/tariscope46.tar.gz

http://softpiua.com/files/ts-install.sh

http://softpiua.com/files/rrun.sh

Распакуйте архив tariscope46.tar.gz, например, в папке Tariscope, предварительно создав ее.

Перенесите в эту папку скрипт ts-install.sh

Предположим, что вы пользователь с именем softpi.

Надо перейти в папку Tariscope с помощью команды:

cd /home/softpi/Tariscope

и выполнить следующую команду:

sh ts-install.sh -p/home/softpi/Tariscope

Ключ ‘-p’ указывает папку, куда устанавливается Tariscope.

Подключение базы данных Tariscope к серверу Microsoft SQL.

Microsoft SQL Server требуется, чтобы на нем работала база данных Tariscope. Потому нужно ее туда установить. Если установочный пакет Tariscope устанавливался в папке Tariscope, резервная копия базы данных Tariscope будет находиться в папке …/Tariscope/www/Database/Database

Файл резервной копии Tariscope называется Tariscope_clear.bak

Для того чтобы установить на MS SQL Server базу данных Tariscope из резервной копии нужно либо подключиться к этому SQL Server-у с компьютера с ОС Windows с установленной на нем SQL Server Management Studio (SSMS), либо установить инструменты командной строки на Linux для работы с MS SQL Server.

Как установить инструменты командной строки для работы с MS SQL Server можно посмотреть в статье компании Microsoft.

Далее, подключаемся к SQL серверу, выполнив команду:

sqlcmd -s localhost -U SA -P Tariscope123

Эта команда означает, что выполняется подключение к локальному SQL Server (localhost). Подключение производится от имени системного администратора (sa). Пароль к SQL серверу: Tariscope123. Вы должны указать пароль, заданный на этапе установки Microsoft SQL Server.

При подключении к SQL server в терминале появится символ: ‘>’, что означает, что можно вводить SQL команды. Для выполнения команды SQL нужно вводить команду GO. Для проверки работы можно задать команду для получения названий баз данных на SQL сервере:

1>select name from sysdatabases

2>go

И вы должны получить такой ответ:

master

tempdb

model

msdb

Затем введите quit, чтобы выйти из режима управления SQL сервером.

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

То есть имея права root вы должны перейти в папку /var/opt/mssql, выполнив команду:

cd /var/opt/mssql/

Далее создать новую папку backup:

mkdir backup

Переместить файл резервной копии в созданную папку:

mv/home/softpi/Tariscope/www/Database/Database/Tariscope_clear.bak/var/opt/mssql/backup

В вашем случае вместо папок/softpi/Tariscope/могут быть другие в зависимости от того, какие вы создали на предыдущих шагах.

Снова подключиться к SQL серверу с помощью команды приведенной выше. Для восстановления базы данных Tariscope из резервной копии выполните команду:

RESTORE DATABASE Tariscope FROM DISK=’/var/opt/mssql/backup/Tariscope_clear.bak’

WITH MOVE ‘Tariscope’ TO ‘/var/opt/mssql/data/Tariscope.mdf’.

MOVE “Tariscope_log’ TO ‘/var/opt/mssql/data/Tariscope_log.ldf’

GO

Будет выполнена установка БД Tariscope. Убедиться, что она установлена можно, например, выполнив команду, которая уже приводилась выше:

select name from sysdatabases

В список баз данных должна быть добавлена база данных Tariscope.

Выйдите из режима управления SQL сервером.

Переместите скрипт rrun.sh в папку www, которая находится в папке Tariscope.

Перейдите к этой папке:

cd /home/softpi/Tariscope/www

Найдите файл appsettings.json. Откройте его для редактирования. Пример этого файла показан на рисунке.

Рисунок

В строке подключения (DefaultConnection) после Data Source укажите IP-адрес сервера, где установлен Microsoft SQL Server. В примере на рисунке 1.2.1 это IP адрес: 10.10.0.133. В этой же строке в качестве пользователя, от которого выполняется работа системы Tariscope, указан системный администратор 'sa' с паролем 'Tariscope123'. Вместо пользователя 'sa' вы можете использовать любое другое, имеющее все права (owner) на базу данных Tariscope.

Работа Tariscope производится на сервере Kestrel. По умолчанию сервер ведет журнал запросов к нему. Это отображается в строке:

“KestrelLogger”: true

Для отказа от ведения журнала измените true на false. Мы рекомендуем вести этот журнал.

Строка “KestrelLoggerPeriod”: 1 определяет период создания нового журнала Kestrel: 0 – ежедневно, 1 – еженедельно, 2 – ежемесячно. При необходимости измените период создания журнала.

IP порт, на котором будет работать Tariscope, задается в строке:

"Http": "8085"

То есть по умолчанию будет использоваться порт 8085. При необходимости смените его на другой.

Если вы хотите, чтобы Tariscope работал по защищенному протоколу HTTPS, вы должны иметь SSL сертификат и задать его параметры в этом файле.

В строке “SSLCertificate”: “” укажите путь, где находится файл этого сертификата.

В строке  “SSLPassword”: “” укажите пароль для этого сертификата.

IP порт для работы по протоколу HTTPS укажите в строке:

“Https”: “”

Для включения протокола HTTPS измените значение false на true в строке:

“HttpsEnabled”: false

Если вы хотите перенаправить все запросы, выполненные в Tariscope по незащищенному протоколу, на защищенный порт, то измените значение false на true в строке:

“HttpsRedirect”: false

Сохраните настройки этого файла.

Выполните запуск Tariscope:

sh rrun.sh

Проверьте, запущена ли система Tariscope с помощью команды:

systemctl status TS.MAIN.service

Если система запущена и работает, вы получите отзыв вроде следующего:

TS.MAIN.service - Tariscope daemon

  Loaded: loaded (/etc/systemd/system/TS.MAIN.service; disabled; vendor pres>

  Active: active (running) since Sat 2022-12-24 23:14:32 EET; 3min 8s ago

  Main PID: 35886 (dotnet)

 Tasks: 0 (limit: 4648)

 Memory: 732.0K

CGroup: /system.slice/TS.MAIN.service

    ‣ 35886 /snap/dotnet-sdk/167/dotnet /home/softpi/Tariscope/www/Sof>

После этого в браузере можно подключиться к системе Tariscope и начать ее настройки согласно документу “Tariscope 4.6. Руководство администратора”.