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 сервера на одном сервере, а также невысоком телефонном трафике можем рекомендовать минимальные параметры сервера:
Процессор: AMD FX-6300 или Intel Core i5-4430 или серверный AMD Opteron 3380 или Intel Xeon E3-1505L v5;
ОЗУ: 8 ГБ;
Жесткий диск: 512 ГБ.
Дополнительные зависимости
Для ОС 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 Language (рисунок 1.1.1), которое предлагает выбор языка инсталляции. Выберите желаемый язык.
Рисунок 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 и его компоненты с базой.
Эта функция позволяет установить все приложения Tariscope и базу данных Tariscope. Microsoft SQL Server не устанавливается. Входящая в инсталляцию базы данных Tariscope была создана на Microsoft SQL Server 2017, поэтому у вас должна быть эта версия Microsoft SQL Server или выше. В противном случае вам не удастся установить базу данных Tariscope.
- Только приложения Tariscope или обновление.
Выберите эту опцию, если вы хотите установить только приложения Tariscope без Microsoft SQL Server и базы данных Tariscope. Также вам следует выбрать эту опцию, если вы обновляете ранее установленные приложения Tariscope.
Выберите вариант и нажмите Далее. Независимо от вашего выбора, следующее окно установки примет вид как показано на рисунке 1.1.5.
Рисунок 1.1.5
Окно Компоненты Tariscope позволяет выбрать приложения системы Tariscope, которые вы можете установить:
Tariscope - основное Web приложение системы, обеспечивающее ее настройку и работу с ней.
Observer сервер - сервер удаленных служб Tariscope Observer. Его следует устанавливать на компьютере удаленном от Tariscope, который имеет доступ к данным о вызовах телефонной системы.
Выберите нужные компоненты и нажмите Далее. Появится следующее окно установки, как показано на рисунке 1.1.6.
Рисунок 1.1.6
Существует три утилиты Tariscope, для которых вы можете создавать ярлыки в меню Пуск Windows.
Утилита переноса базы данных позволяет перемещать базу данных Tariscope из одной папки в другую.
Утилита прикрепления базы данных позволяет установить файлы данных (файлы MDF и LDF) на Microsoft SQL сервере.
Утилита восстановления базы данных позволяет восстановить базу данных Tariscope из резервной копии базы данных Tariscope.
Выберите необходимые утилиты и нажмите Далее. Окно установки будет таким, как показано на рисунке 1.1.7.
Рисунок 1.1.7
Это окно позволяет задать папку для установки системы. По умолчанию предлагается установить систему Tariscope в папку: \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, где в списке выберите Russian, щелкните 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 серверу. Используйте именно этот тип аутентификации, если SQL сервер находится на другом компьютере.
Если вы используете SQL Server, который был установлен с установочного пакета Tariscope, и 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 нажмите на кнопку Запустить. Установка 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. Cохранение файлов
Чтобы не повторять некоторые настройки, сделайте копии следующих файлов, например, в папке 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 готов к работе.
