AlterOS¶

Tip

Установка РЕД ОС тестировалась на релизах РЕД ОС 7.1 МУРОМ и 7.3 МУРОМ.

Tip

Установка AlterOS тестировалась на релизе 7.5. Дистрибутив можно найти на wiki системы:

Рекомендуется ознакомиться с разделом Общая информация.

Выполните шаги из раздела Подготовка дистрибутива TESSA.

Для CentOS 8 включите текущего пользователя в sudo:

su

/usr/sbin/visudo

Найдите строку:

root    ALL=(ALL) ALL

Нажмите [i] и ниже вставьте строку:

tessa   ALL=(ALL) ALL

Нажмите [Esc], чтобы выйти из режима вставки, затем нажмите [:x] (сначала двоеточие, потом [x]), и после нажмите [Enter].

Введите в терминале:

exit

Для CentOS / Fedora / AlterOS обновите информацию из репозиториев и обновите установленные пакеты до последних версий.

sudo yum -y upgrade

Warning

Поскольку поддержка CentOS завершена, то перед установкой пакетов для этого дистрибутива подключите резервные репозитории вызовом следующим команд:

sudo sed -i 's/^mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-*
sudo sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*

Обновить пакеты в системы после этого можно командой:

sudo yum -y upgrade

После установки может потребоваться вновь выполнить команды sed выше, если повторный вызов sudo yum upgrade приводит к ошибке.

Если вы пользуетесь сертифицированной версией AlterOS, сначала установите обновления из образа согласно инструкции. Не забудьте активировать репозитории Base и Sources после обновления, иначе у вас не получится установить необходимые для работы СЭД файлы.

Для сертифицированной AlterOS выполните команды:

mv /etc/yum.repos.d/AlterOS-Base.save /etc/yum.repos.d/AlterOS-Base.repo

mv /etc/yum.repos.d/AlterOS-Sources.save /etc/yum.repos.d/AlterOS-Sources.repo

Tip

На предложение согласиться на загрузку обновлений “Is this ok [y/d/N]?” введите [y] и нажмите [Enter]. Аналогичные действия могут потребоваться на предложение получить ключ для одного или нескольких репозиториев.

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

Tip

Для ускорения загрузки обновлений в дальнейшем на CentOS 7 и РЕД ОС 7.1 можно выполнить команду sudo yum makecache fast. Команда не будет работать на Fedora, CentOS 8 и на поздних версиях РЕД ОС.

Tip

Инструкция для установки системы на CentOS готовилась для конфигурации GNOME Desktop, выбранной при установке ОС. Если использовалась другая конфигурация, то может потребоваться выполнить дополнительные команды, такие как установка редактора nano.

Tip

В сертифицированной версии AlterOS по умолчанию нет текстового редактора для работы в терминале и браузера, установить их можно командами yum install nano и yum install firefox

Установите зависимости, которые потребуются серверу приложений TESSA.

Для CentOS (последовательно две команды):

sudo yum -y install epel-release

sudo yum -y install libgdiplus

Для Fedora:

sudo yum -y install libgdiplus openssl

Для РЕД ОС:

sudo yum -y install libgdiplus

Для AlterOS:

sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

sudo yum -y install libgdiplus

Для CentOS 7, AlterOS и РЕД ОС выполните команду:

sudo ln -s /usr/lib64/libdl.so.2 /usr/lib64/libdl.so

Установка и настройка PostgreSQL¶

Установите из репозитория и выполните первичную настройку сервера PostgreSQL.

Для CentOS 7 и AlterOS:

sudo yum -y install https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm

sudo yum -y install postgresql10-server postgresql10-contrib

sudo /usr/pgsql-10/bin/postgresql-10-setup initdb

sudo systemctl enable postgresql-10 && sudo systemctl start postgresql-10

Для CentOS 8:

sudo yum -y install postgresql-server postgresql-contrib

sudo postgresql-setup initdb

sudo systemctl enable postgresql && sudo systemctl start postgresql

Note

В некоторых версиях CentOS 8 введите второй командой

sudo postgresql-setup initdb --unit postgresql

В последних версиях CentOS 8.4 параметр считается устаревшим, поэтому в скрипте выше параметр не указан.

Для Fedora / РЕД ОС:

sudo yum -y install postgresql-server postgresql-contrib

sudo postgresql-setup initdb

sudo systemctl enable postgresql && sudo systemctl start postgresql

Создайте пользователя, от которого будут подключаться сервисы и утилиты TESSA.

sudo -u postgres psql postgres

CREATE USER tessa WITH SUPERUSER PASSWORD 'Master1234';

\q

Откройте для редактирования файл pg_hba.conf.

Для CentOS 7 и AlterOS:

sudo nano /var/lib/pgsql/10/data/pg_hba.conf

Для CentOS 8 / Fedora / РЕД ОС:

sudo nano /var/lib/pgsql/data/pg_hba.conf

Задайте в нём настройки в соответствии с разделом Настройка доступа по сети к PostgreSQL.

Откройте для редактирования файл postgresql.conf.

Для CentOS 7 и AlterOS:

sudo nano /var/lib/pgsql/10/data/postgresql.conf

Для CentOS 8 / Fedora / РЕД ОС:

sudo nano /var/lib/pgsql/data/postgresql.conf

Найдите в нём строку listen_addresses (нажмите [Ctrl]+[W] и введите искомую строку). Теперь уберите ведущий символ комментария #. И замените следующим образом:

listen_addresses = '*'

Tip

Вы можете также указать listen_addresses = 'localhost', если СУБД располагается на том же сервере, что и сервер приложений.

Tip

В случае, если одновременных пользователей больше 100, рекомендуется указать max_connections = 200 и обратиться к документации по администрированию PostgreSQL.

Закройте редактор с сохранением изменений. Перезапустите сервис PostgreSQL.

Для CentOS 7 и AlterOS:

sudo systemctl restart postgresql-10

Для CentOS 8 / Fedora / РЕД ОС:

sudo systemctl restart postgresql

Настройка веб-сервиса TESSA и создание сертификатов¶

sudo nano /etc/systemd/system/tessa.service

Вставьте этот текст (сочетание клавиш [Ctrl]+[Shift]+[V]).

Теперь настройте автозапуск сервиса и запустите его, выполнив команду:

sudo systemctl enable tessa && sudo systemctl start tessa

Далее обратитесь к раздел Создание самоподписанного сертификата, чтобы создать сертификаты. Или просто выполните команды:

sudo mkdir -p /etc/pki/tls/certs /etc/pki/tls/private

sudo openssl req -x509 -nodes -days 3650 -newkey rsa:2048 -keyout /etc/pki/tls/private/localhost.key -out /etc/pki/tls/certs/localhost.crt

Установка и настройка веб-сервера Nginx¶

Выполните команду:

sudo yum -y install nginx

Для CentOS / Fedora / РЕД ОС / AlterOS:

sudo nano /etc/nginx/nginx.conf

Найдите раздел server { и удалите его (сочетание клавиш [Ctrl]+[K] удаляет строку). Удалять строки, начинающиеся с символа комментария #, необязательно.

Вставьте на место удалённого этот текст (сочетание клавиш [Ctrl]+[Shift]+[V]).

Для всех дистрибутивов настройте автозапуск сервера и запустите его, выполнив команду:

sudo systemctl enable nginx && sudo systemctl start nginx

Для работоспособности Nginx отключите SELinux (политики безопасности для принудительного контроля доступа).

Tip

Если требуется оставить SELinux включённым, то обратитесь к документации по Nginx и по реализации SELinux в вашем дистрибутиве Linux.

sudo nano /etc/sysconfig/selinux

Найдите строку:

SELINUX=enforcing

Замените её на:

SELINUX=disabled

После изменения этой настройки перезагрузите компьютер.

Настройка LibreOffice или OpenOffice¶

Убедитесь, что установлен офисный пакет LibreOffice версии 7 или выше, или OpenOffice.

Для CentOS 8 если пакет LibreOffice не установлен (отсутствует в меню приложений в группе “Офис”), то установите его командой:

sudo yum -y group install "Office Suite and Productivity"

Для CentOS / Fedora / РЕД ОС проверьте, что установлен пакет unoconv:

sudo yum -y install unoconv

В конфигурационном файле сервиса Chronos потребуется указать приложение unoconv для использования вместо встроенного скрипта.

nano ~/tessa/chronos/app.json

Найдите строку:

"UnoconvExternalCommand": null,

Замените её на:

"UnoconvExternalCommand": "unoconv",

При конвертации для приложения unoconv требуются права на папку ~/.cache/dconf. Приложение будет запущено от того же пользователя, что и сервис Chronos (в этой инструкции подразумевается текущий пользователь).

Для установки прав выполните команду (если папка ещё не создана, то будет создана):

mkdir -p ~/.cache/dconf

sudo chown -R $USER ~/.cache/dconf

Установка системы и настройка сервиса Chronos¶

Чтобы установить систему на новую базу данных, запустите следующие команды:

cd ~/build/linux

./setup.sh

Обратитесь к разделу Установка TESSA на новую базу данных за описанием процесса установки.

Обычно достаточно нажать: [Enter]; tessa [Enter]; [Enter]; [Enter]; [Enter]; [Enter].

По завершении установки перезапустите веб-сервис:

sudo systemctl restart tessa

Теперь выполним настройку Chronos. Создайте файл для сервиса Chronos:

sudo nano /etc/systemd/system/chronos.service

Вставьте этот текст (сочетание клавиш [Ctrl]+[Shift]+[V]).

Теперь настройте автозапуск Chronos и запустите его, выполнив команду:

sudo systemctl enable chronos && sudo systemctl start chronos

Обязательно проверьте, функционирует ли unoconv. Для этого выполните команду (подождав полминуты, пока сервис Chronos инициализируется):

sudo systemctl status chronos

Найдите процессы unoconv и LibreOffice среди запущенных процессов (последние две строки):

Процессы могут отсутствовать или появиться и тут же завершиться при запуске сразу после установки. В этом случае либо перезагрузите компьютер, либо закройте, а затем сразу откройте окно терминала, в котором перезапустите сервис Chronos:

sudo systemctl restart chronos

Подождите полминуты и запросите статус для сервиса Chronos. Он должен показать информацию, аналогичную приведённой на изображении выше.

Обратитесь к разделу Проверка установленной системы TESSA, чтобы проверить работу системы.