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
Інсталяція під Linux не містить в собі Microsoft SQL Server-а, який потрібен для роботи системи Tariscope. Ви повинні самостійно завантажити його з сайту Microsoft та встановити. Microsoft SQL Server 2019 (2017) може бути встановлений як під Linux, так і під Windows.
Розпакуйте архів tariscope46.tar.gz.
Як результат будуть створені папки App і Generic, а у корні буде знаходитися файл install-tariscope.sh.
Виконайте наступну команду з правами root користувача для встановлення системи Tariscope: sh install-tariscope.sh – p ‘назва папки для встановлення’.
В цій команді замість ‘назва папки для встановлення’ вкажіть, наприклад, ‘/home/softpi/tariscope’.
Якщо всі перелічені додатки у розділі Додаткові залежності були встановлені, то встановлення системи Tariscope повинно виконатися без помилок.
Перейдіть до папки, де ви встановлювали Tariscope. Вона повинна містити папку www. У цій папці за шляхом /www/Database/Database знаходиться база даних Tariscope. Встановіть Microsoft SQL Server 2019 (2017) на цьому або іншому сервері та приєднайте до нього вказану базу даних. Як під Linux встановити Microsoft SQL Server дивіться у статті: https://docs.microsoft.com/en-us/sql/linux/sql-server-linux-setup?view=sql-server-ver15.
Як встановити Microsoft SQL Server під Windows дивіться у статті: https://docs.microsoft.com/ru-ru/sql/database-engine/install-windows/install-sql-server?view=sql-server-ver15.
Перейдіть до папки www і знайдіть файл appsettings.json. Відкрийте його на редагування. Приклад цього файлу показаний на малюнку 1.2.1.
Малюнок 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.
Збережіть налаштування цього файлу.
У папці www знаходиться файл run.sh, який запускає сервер Tariscope.
Виконайте команду з правами root: sh run.sh.
Після цього ви можете працювати з системою Tariscope.
