Інсталяція 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. Керівництво адміністратора”.