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
Инсталляция под 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.
