Tariscope 4.6. Посібник адміністратора

1. Інсталяція

Попередня підготовка

Tariscope може встановлюватися як на операційні системи Windows (Windows 10, Windows Server 2019 / 2016) або Linux (Alpine, CentOS, Debian, Fedora, OpenSUSE, Red Hat, SLES, Ubuntu).

Перед виконанням інсталяції Tariscope необхідно виконати наступні кроки:

• Визначити, під якими операційними системами будуть працювати окремі компоненти системи Tariscope. Є можливість встановлювати окремі компоненти на серверах (комп’ютерах) з різними операційними системами. Наприклад, Microsoft SQL Server встановлюється на ОС Windows, а система Tariscope на Linux. Можливі і інші варіанти встановлення модулів системи.
• Визначити, яка версія і редакція Microsoft SQL сервера буде використовуватися в якості ядра Tariscope. Зараз підтримуються Microsoft SQL Server 2019 або 2017.
• Визначитися з варіантом встановлення системи.
• Вибрати відповідний сервер (сервери), на який (які) буде встановлюватися Tariscope. Параметри сервера для системи Tariscope залежать від обраного варіанту установки, телефонного трафіку, активності роботи з системою Tariscope. При розміщенні системи Tariscope і MS SQL сервера на одному сервері, а також невисокому телефонному трафіку можемо рекомендувати мінімальні параметри сервера для слабо завантажених систем Tariscope:
  Процесор: AMD FX-6300 або Intel Core i5-4430 або серверний AMD Opteron 3380 або Intel Xeon E3-1505L v5;
  ОЗП: 8 ГБ або більше;
  Жорсткий диск: 512 ГБ. Рекомендуємо використовувати SSD диск для Microsoft SQL сервера та бази даних Tariscope, що може суттєво підвищити продуктивність роботи системи.

Додаткові залежності

Для ОС Windows

До складу дистрибутива Tariscope входить Microsoft SQL Server 2017 Express. Це безкоштовна редакція, але вона має декілька обмежень, в першу чергу пов’язаних з об’ємом бази даних та продуктивністю роботи. Ви можете не встановлювати цей сервер, а підключити базу даних Tariscope до Microsoft SQL серверу іншої версії і редакції, яка вже є у вас, або придбати нову. Підтримуються Microsoft SQL Server 2019 та 2017.

Для ОС Linux

Перед встановленням системи Tariscope ви повинні встановити наступні додатки:

• cupid,
• inxi,
• libgdiplus,
• wkhtmltopdf,
• .Net Core Runtime 5.0. Як встановити під конкретну систему Linux дивіться на сайті Microsoft: https://docs.microsoft.com/en-us/dotnet/core/install/linux.

Інсталяція для Linux на відміну від інсталяції для Windows не містить у собі інсталяції Microsoft SQL Server. Тому ви повинні самостійно встановити цей сервер або під Windows або під Linux. Як встановити цей сервер під Linux дивіться на сайті Microsoft: https://docs.microsoft.com/en-us/sql/linux/sql-server-linux-setup?view=sql-server-ver15.

1.1 Інсталяція під Windows

Для встановлення Tariscope ви повинні мати права адміністратора Windows.

Запустіть файл tariscope46.exe. З'явиться вікно Installer Languagе (малюнок 1.1.1), яке пропонує вибір мови системи Tariscope. Виберіть бажану мову системи.

Малюнок 1.1.1

Натисніть ОК. Вікно програми інсталяції набуде вигляду, показаний на малюнку 1.1.2.

Малюнок 1.1.2

Це інформаційне вікно. Прочитайте інформацію і натисніть Далі. З'явиться вікно ліцензійної угоди, як показано на малюнку 1.1.3.

Малюнок 1.1.3

Прочитайте угоду. Якщо ви згодні з угодою, натисніть Згоден, в іншому випадку натисніть Скасувати. Якщо ви вибрали кнопку Згоден, далі вікно установки набуде вигляду, як показано на малюнку 1.1.4.

Малюнок 1.1.4

Вікно Вибір компонентів, пропонує вам вибрати варіант установки. Є три варіанти:

• Додатки та сервер Tariscope і Microsoft SQL Server 2017 Express.

Вибір цього параметра дозволяє встановити всі програми Tariscope, базу даних Tariscope і редакцію Microsoft SQL Server 2017 Express. Якщо ви плануєте використовувати іншу редакцію Microsoft SQL Server, тоді не вибирайте цю опцію.

• Сервер і додатки Tariscope (без Microsoft SQL Server).

Вибір цієї опції дозволяє встановити всі програми Tariscope і базу даних Tariscope. Microsoft SQL Server не встановлюється під час установки. Створення резервних копій бази даних Tariscope було виконано на Microsoft SQL Server 2017, тому у вас повинна бути ця версія Microsoft SQL Server або вище, щоб приєднати базу даних Tariscope.

• Тільки додатки Tariscope або оновлення.

Виберіть цю опцію, якщо ви вже встановили сервер Tariscope і Microsoft SQL Server. Також вам слід вибрати цю опцію, якщо ви оновлюєте раніше встановлені додатки Tariscope.

Виберіть потрібний варіант і натисніть Далі. Незалежно від вашого вибору, наступне вікно установки набуде вигляду як показано на малюнку 1.1.5.

Малюнок 1.1.5

Вікно Компоненти Tariscope дозволяє вибрати програми, які ви можете встановити. Є такі програми:

Tariscope - це веб-додаток, що забезпечує настройку і роботу Tariscope. Вам потрібно встановити його на сервер, через який користувачі будуть працювати з Tariscope.

Observer сервер - це сервер віддалених служб Observer, які при необхідності встановлюються на віддаленому комп’ютері. Якщо у вас не має потреби в роботі віддалених служб Observer, то не вибирайте цій пункт.

Виберіть потрібні компоненти і натисніть Далі. З'явиться наступне вікно установки, як показано на малюнку 1.1.6.

Малюнок 1.1.6

Існує три утиліти Tariscope, для яких ви можете створювати ярлики в меню Пуск Windows.

Утиліта перенесення бази даних дозволяє переміщати базу даних Tariscope з однієї папки в іншу.

Утиліта прикріплення бази даних дозволяє вам прикріплювати файли даних (файли MDF і LDF) до потрібного сервера Microsoft SQL.

Утиліта відновлення бази даних дозволяє відновити базу даних Tariscope з резервної копії бази даних Tariscope.

Встановіть потрібні прапорці та натисніть Далі. Вікно установки буде таким, як показано на малюнку 1.1.7.

Малюнок 1.1.7

Це вікно дозволяє задати папку для установки системи. За замовчуванням пропонується встановити систему Tariscope в папку: C:\Program Files (x86)\ SoftPI\Tariscope.

При необхідності можна змінити цю папку на іншу. Після чого натисніть на кнопку Далі. Вікно програми прийме вигляд, показаний на малюнку 1.1.8

Малюнок 1.1.8

Це вікно програми дозволяє задати ім'я папки в меню Пуск операційної системи Windows. За замовчуванням пропонується папка Tariscope.

Клацніть по кнопці Встановити. Почнеться процес установки системи, що може зайняти якийсь час. З'явиться нове вікно, показане на малюнку 1.1.9.

Малюнок 1.1.9

Додатки, вибрані вами на етапі установки, показаному на малюнку 1.4, будуть встановлені. По закінченню встановлення системи Tariscope з’явиться вікно Tariscope Start, приклад якого показаний на малюнку 1.1.10.

Малюнок 1.1.10

По-перше, ви можете змінити мову цього вікна. Для цього виберіть на панелі інструментів: Settings → Language. З’явиться вікно Change language, де у списку виберіть Ukrainian, кликніть Apply. Вікно Tariscope Start буде відображено на українській мові.

Для вводу параметрів підключення системи Tariscope до Microsoft SQL Server-а клацніть по посиланню Змінити налаштування підключення. З’явиться вікно Підключення до SQL серверу, приклад якого наведений на малюнку 1.1.11.

Малюнок 1.1.11

Вкажіть ім'я сервера SQL або його IP адресу в позиції Ім’я або IP сервера. Якщо SQL Server встановлюється з інсталяційного пакету Tariscope або ви встановили іншу версію і редакцію SQL сервера на той же сервер, де встановлюєте систему Tariscope, ви можете ввести «.» (символ «крапка») в полі Ім’я або IP сервера.

Якщо ім'я сервера SQL не є ім'ям за умовчанням (MSSQLSERVER), в позиції Ім’я SQL сервера введіть назву SQL сервера.

У списку Тип аутентифікації розділу Параметри аутентифікації виберіть необхідний тип аутентифікації. Є варіанти:

• Аутентифікація Windows.
• Аутентифікація SQL Server.

Якщо ви вибираєте Аутентифікацію Windows, вам не потрібно вводити будь-які параметри.

Для другого варіанту введіть ім'я користувача і його пароль, які використовуються для оновлення бази даних на сервері SQL.

Якщо ви використовуєте SQL Server, який був встановлений з інсталяційного пакету Tariscope, ви можете використовувати як аутентифікацію Windows, так і аутентифікацію SQL Server. В останньому випадку ви повинні використовувати ім'я користувача 'sa' і пароль 'Tariscope123'.

Ми рекомендуємо обов’язково змінити цей пароль при роботі з Tariscope. Крім того ви можете створити адміністраторів з іншими іменами і паролями.

Для перевірки підключення до SQL Server-у натисніть Перевірити з’єднання. При вдалому підключенні з’явиться статус: встановлено.

Клацніть по кнопці Готово.

Ви повернитеся до вікна Tariscope Start (малюнок 1.1.10).

В полі HTTP порти ви можете вказати IP адреси, які будуть використовуватися для доступу до додатка Tariscope. Значення за замовчуванням: 8085. Ви можете змінити це значення. Якщо ви хочете відкрити додаток після його встановлення, виберіть Відкрити в веб-браузері.

Якщо ви бажаєте використовувати захищений протокол доступу до Tariscope і маєте відповідний сертифікат, то для його підключення оберіть в меню: Налаштування → HTTPS. З’явиться вікно Налаштування HTTPS, приклад якого наведений на малюнку 1.1.12.

Малюнок 1.1.12

Виберіть Ввімкнути HTTPS. Інші позиції вікна становяться активними.

В позиції HTTPS порти введіть номера одного або декількох IP портів, на яких буде працювати Tariscope.

Якщо ви бажаєте, щоб усі користувачі, які підключаються до Tariscope по незахищеному протоколу перенаправлялися на захищений сайт, виберіть Ввімкнути перенаправлення на HTTPS.

Клацніть по кнопці ліворуч позиції SSL сертифікат та виберіть файл сертифікату.

В позиції Пароль введіть пароль до сертифікату і повторить його в позиції Повторіть пароль.

Для перевірки правильності налаштування, клацніть по кнопці Перевірити.

Для завершення налаштування клацніть по кнопці Готово.

Сайт Tariscope веде журнал звернень до нього. Ви можете встановити період створення такого нового журналу. Для цього виберіть в меню програми Tariscope Start: Налаштування → Журнал Kestrel.

Kestrel – це назва серверу, на якому розміщується сайт Tariscope. З’явиться вікно Журнал Kestrel, де в списку Період виберіть необхідний та клацніть Застосувати.

У випадку, якщо ви використовували до цього Tariscope версій 4.4 або нижче, і ви бажаєте перенести раніш створені подання, виберіть в меню Інструменти → Перенести подання.

Якщо ви використовували до цього Tariscope версій 4.4 або нижче, і ви бажаєте перенести раніш додані телефонні коди, виберіть в меню Інструменти → Перенести коди.

Для запуску Tariscope натисніть на кнопку Встановити. Встановлення буде завершене (малюнок 1.1.13).

Малюнок 1.1.13

1.2 Інсталяція під 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. Відкрийте його на редагування. Приклад цього файлу показаний на малюнку.

 Малюнок 1.2.1

У рядку підключення (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. Посібник адміністратора”.

1.3 Як встановити оновлену версію Tariscope на Linux

Ця інструкція припускає, що у вас вже є встановлена версія Tariscope на Linux, але ви бажаєте встановити оновлену версію Tariscope.

1. Збереження файлів

Щоб не повторювати деякі налаштування, зробіть копії наступних файлів, наприклад, в теку Home:

• appsettings.json. Цей файл знаходиться в теці www.
• ts-install.sh. Ви можете також завжди завантажити цей файл: http://softpiua.com/files/ts-insatll.sh
• rrun.sh. Ви можете також завжди завантажити цей файл: http://softpiua.com/files/rrun.sh
• tariscope.key. Цей файл знаходиться в теці /usr/share/Tariscope.

2. Видалення служб і файлів Tariscope

Для видалення служб Tariscope завантажте скріпт remove-ts-services.sh з сайту: http://softpiua.com/files/remove-ts-services.sh

Виконайте наступну команду: sudo sh remove-ts-services.sh

Видаліть усі підтеки системи Tariscope: App, Generic

3. Розпакування архіву Tariscope

Завантажте з сайту Tariscope архів tariscope46.tar.gz та розпакуйте його.

4. Інсталяція Tariscope

Виконайте скріпт ts-install.sh з теки, де ви розпакували архів. Приклад команди для виконання інсталяції до теки Tariscope: sh ts-install.sh -p /home/softpi/Tariscope

Тут ключ '-p' вказує теку, де потрібно встановити систему Tariscope.

5. Копіювання конфігураційних файлів

Скопіюйте файл appsettings.json, який був збережений на першому кроці цієї інструкції до теки www.

Скопіюйте файл активаційного ключа ts.key до теки Generic.

Скопіюйте файл rrun.sh до теки www.

6. Запуск Tariscope

Виконайте наступну команду: sh rrun.sh

Tariscope готовий до роботи.

 Попередня сторінка    Наступна сторінка

Зміст "Tariscope 4.6. Посібник адміністратора"