Установка на ОС Альт Сервер / Альт Рабочая станция¶
Рекомендуется ознакомиться с разделом Общая информация.
Для простоты настройки при установке укажите имя учётной записи tessa
.
Выполните шаги из раздела Подготовка дистрибутива TESSA.
Опциональный шаг: включите текущего пользователя в sudo:
su
/usr/sbin/visudo
Найдите строку:
root ALL=(ALL) ALL
Нажмите [i]
и ниже вставьте строку:
tessa ALL=(ALL) ALL
Нажмите [Esc]
, чтобы выйти из режима вставки, затем нажмите [:x]
(сначала двоеточие, потом [x]
), и после нажмите [Enter]
.
Введите в терминале:
exit
Далее предполагается, что пользователь НЕ включён в sudo, поэтому административные команды выполняются с предварительным переходом к root
:
su -
...
exit
Следующие команды выполняются от пользователя root
.
Обновите информацию из репозиториев:
apt-get update
Установите зависимости, которые потребуются серверу приложений TESSA.
Установите LibreOffice, если он не установлен:
apt-get -y install LibreOffice
Для Альт Сервер / Альт Рабочая станция 10.1, 10.0:
apt-get -y install libgdiplus
Для Альт Сервер / Альт Рабочая станция 9.1, 9.0, 8.2:
apt-get -y install libgdiplus unoconv
Для всех дистрибутивов:
ln -s /lib64/libdl.so.2 /lib64/libdl.so
Для Альт Сервер / Альт Рабочая станция 9.0:
apt-get install nano
systemctl disable httpd2 && systemctl stop httpd2
Установка и настройка PostgreSQL¶
Установите из репозитория и выполните первичную настройку сервера PostgreSQL. Установка может занять несколько минут.
Команды выполняются от пользователя root
.
Для Альт Сервер / Альт Рабочая станция 10.1, 10.0:
apt-get -y install postgresql14-server postgresql14-contrib
Для Альт Сервер / Альт Рабочая станция 9.1, 9.0, 8.2:
apt-get -y install postgresql10-server postgresql10-contrib
Для всех дистрибутивов:
/etc/init.d/postgresql initdb
systemctl enable postgresql && systemctl start postgresql
Создайте пользователя, от которого будут подключаться сервисы и утилиты TESSA.
psql -U postgres
CREATE USER tessa WITH SUPERUSER PASSWORD 'Master1234';
\q
Откройте для редактирования файл pg_hba.conf
.
nano /var/lib/pgsql/data/pg_hba.conf
Задайте в нём настройки в соответствии с разделом Настройка доступа по сети к PostgreSQL.
Откройте для редактирования файл postgresql.conf
.
nano /var/lib/pgsql/data/postgresql.conf
Найдите в нём строку listen_addresses
(нажмите [Ctrl]+[W]
и введите искомую строку). Теперь уберите ведущий символ комментария #
. И замените следующим образом:
listen_addresses = '*'
Tip
Вы можете также указать listen_addresses = 'localhost'
, если СУБД располагается на том же сервере, что и сервер приложений.
Tip
В случае, если одновременных пользователей больше 100, рекомендуется указать max_connections = 200
и обратиться к документации по администрированию PostgreSQL.
Закройте редактор с сохранением изменений. Перезапустите сервис PostgreSQL командой:
systemctl restart postgresql
Настройка веб-сервиса TESSA и создание сертификатов¶
Команды выполняются от пользователя root
.
nano /etc/systemd/system/tessa.service
Вставьте этот текст (сочетание клавиш [Shift]+[Insert]
).
Теперь настройте автозапуск сервиса и запустите его, выполнив команду:
systemctl enable tessa && systemctl start tessa
Далее обратитесь к раздел Создание самоподписанного сертификата, чтобы создать сертификаты. Или просто выполните команды:
mkdir -p /etc/pki/tls/certs /etc/pki/tls/private
openssl req -x509 -nodes -days 3650 -newkey rsa:2048 -keyout /etc/pki/tls/private/localhost.key -out /etc/pki/tls/certs/localhost.crt
Установка и настройка веб-сервера Nginx¶
Команды выполняются от пользователя root
.
Откройте окно терминала и установите Nginx:
apt-get -y install nginx
Дождитесь окончания установки. После этого откройте для редактирования файл:
nano /etc/nginx/sites-available.d/default.conf
Удалите содержимое файла (сочетание клавиш [Alt]+[T]
) и вставьте этот текст (сочетание клавиш [Shift]+[Insert]
).
Добавьте символьную ссылку, разрешающую использовать указанные настройки сайта, и перезапустите веб-сервер, выполнив команды:
ln -s /etc/nginx/sites-available.d/default.conf /etc/nginx/sites-enabled.d/
systemctl enable nginx && systemctl restart nginx
Настройка LibreOffice или OpenOffice¶
Команды выполняются от пользователя root
.
Для Альт Сервер / Альт Рабочая станция 9.1, 9.0, 8.2:
В конфигурационном файле сервиса Chronos потребуется указать приложение unoconv
для использования вместо встроенного скрипта.
nano ~/tessa/chronos/app.json
Найдите строку:
"UnoconvExternalCommand": null,
Замените её на:
"UnoconvExternalCommand": "unoconv",
Для всех дистрибутивов:
При конвертации для приложения unoconv
требуются права на папку ~/.cache/dconf
. Приложение будет запущено от того же пользователя, что и сервис Chronos
(в этой инструкции подразумевается текущий пользователь).
Для установки прав выполните команду (если папка ещё не создана, то будет создана):
mkdir -p ~/.cache/dconf
chown -R $USER ~/.cache/dconf
Установка системы и настройка сервиса Chronos¶
Чтобы установить систему на новую базу данных, запустите следующие команды:
cd ~/build/linux
./setup.sh
Обратитесь к разделу Установка TESSA на новую базу данных за описанием процесса установки.
Обычно достаточно нажать: [Enter]; tessa [Enter]; [Enter]; [Enter]; [Enter]; [Enter].
Следующие команды выполняются от пользователя root
.
По завершении установки перезапустите веб-сервис:
systemctl restart tessa
Теперь выполним настройку Chronos. Создайте файл для сервиса Chronos:
nano /etc/systemd/system/chronos.service
Вставьте этот текст (сочетание клавиш [Shift]+[Insert]
).
Для Альт Сервер / Альт Рабочая станция 10.1, 10.0:
Проверьте, по какому пути установлен пакет LibreOffice
. Выполните команду:
ls /usr/lib64/LibreOffice*
Вам отобразится содержимое папок LibreOffice
и LibreOffice-still
, или только одной из папок. Если выведено обе папки, то запросите содержимое подпапки program
(команда ls /usr/lib64/FOLDER/program
, где FOLDER
замените на LibreOffice
и LibreOffice-still
), и выберите ту папку, где присутствуют файлы с расширением .so
.
Вставьте дополнительную строку в раздел [Service]
(перед строкой [Install]
). Замените LibreOffice
на LibreOffice-still
, если выше вы определили, что файлы .so
присутствуют в папке LibreOffice-still/program
:
Environment=UNO_PATH=/usr/lib64/LibreOffice
Теперь настройте автозапуск Chronos и запустите его, выполнив команду:
systemctl enable chronos && systemctl start chronos
Обязательно проверьте, функционирует ли unoconv
. Для этого выполните команду (подождав полминуты, пока сервис Chronos инициализируется):
systemctl status chronos
Найдите процессы unoconv
и LibreOffice среди запущенных процессов (последние две строки):
Процессы могут отсутствовать или появиться и тут же завершиться при запуске сразу после установки. В этом случае либо перезагрузите компьютер, либо закройте, а затем сразу откройте окно терминала, в котором перезапустите сервис Chronos:
systemctl restart chronos
Подождите полминуты и запросите статус для сервиса Chronos. Он должен показать информацию, аналогичную приведённой на изображении выше.
Обратитесь к разделу Проверка установленной системы TESSA, чтобы проверить работу системы.