CentOS 8 Stream

33min
💡 Это руководство по установке не подходит для CentOS Linux 8, срок службы которого истекает 31 декабря 2021 г.
Оглавление
1. Минимальные системные требования
Пассворк не требователен к ресурсам сервера(-ов). Объемы необходимых ресурсов (RAM, CPU, HDD) и количество серверов зависят от количества активных пользователей, объема хранимых данных, а также требований к отказоустойчивости системы.
💡 Технические требования﻿﻿
💡 Если на сервере 2-4 ГБ RAM, то рекомендуется включить SWAP файл для корректной сборки всех библиотек.
﻿Создание SWAP файла на Linux﻿﻿
2. Получение прав root и создание локальной базы данных пакетов
Shell
su
cd ~
yum makecache
su
cd ~
yum makecache
﻿
Измените имя сервера на "passwork".
Shell
hostnamectl set-hostname passwork
systemctl restart NetworkManager.service
hostnamectl set-hostname passwork
systemctl restart NetworkManager.service
﻿
3. Установка Git и Apache2, настройка файрвола
Shell
yum -y install git httpd avahi
systemctl start httpd
systemctl enable httpd
firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --permanent --add-port=5353/udp
firewall-cmd --reload
systemctl restart avahi-daemon
yum -y install git httpd avahi
systemctl start httpd
systemctl enable httpd
firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --permanent --add-port=5353/udp
firewall-cmd --reload
systemctl restart avahi-daemon
﻿
4. Установка базы данных MongoDB
Скачайте и распакуйте архив с пакетами MongoDB
Shell
curl -kO https://portal.passwork.pro/mongo_el8.tar.gz
tar -xzvf mongo_el8.tar.gz
curl -kO https://portal.passwork.pro/mongo_el8.tar.gz
tar -xzvf mongo_el8.tar.gz
﻿
Установите MongoDB
Shell
cd mongo
	yum install *.rpm
cd mongo
	yum install *.rpm
﻿
Измените режим работы SELinux на disabled. Откройте файл /etc/selinux/config и измените значение параметра SELINUX на disabled.
Shell
nano /etc/selinux/config
nano /etc/selinux/config
﻿
Приведите файл к следующему виду:
Shell
SELINUX=disabled
SELINUX=disabled
﻿
Для того чтобы внесенные изменения вступили в силу, необходимо перезагрузить систему.
Запустите службу MongoDB.
Shell
su
cd ~
systemctl start mongod.service
su
cd ~
systemctl start mongod.service
﻿
Включите автозапуск службы mongod при загрузке системы.
Shell
systemctl enable mongod.service
systemctl enable mongod.service
﻿
5. Установка PHP 8.0
💡 Необходимо установить версию PHP 8.0. Более новые версии пока не поддерживаются.
Установка пакета конфигурации Remi репозитория
Shell
yum -y install epel-release yum-utils 
dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm
dnf module enable php:remi-8.0
yum -y install epel-release yum-utils 
dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm
dnf module enable php:remi-8.0
﻿
Установка PHP и дополнительных расширений
Shell
dnf install -y php php-json php-ldap php-xml php-bcmath php-mbstring php-curl
dnf install -y php php-json php-ldap php-xml php-bcmath php-mbstring php-curl
﻿
Проверка основной версии PHP
Shell
php -v
php -v
﻿
Убедитесь, что PHP 8 используется в качестве основной версии.
6. Установка PHP Mongo драйвера
Shell
dnf config-manager --set-enabled powertools
dnf -y install gcc php-pear curl-devel openssl-devel pcre-devel php-devel
pecl install mongodb
echo "extension=mongodb.so" | tee /etc/php.d/20-mongodb.ini
systemctl restart httpd
dnf config-manager --set-enabled powertools
dnf -y install gcc php-pear curl-devel openssl-devel pcre-devel php-devel
pecl install mongodb
echo "extension=mongodb.so" | tee /etc/php.d/20-mongodb.ini
systemctl restart httpd
﻿
7. Установка Phalcon PHP расширения
Shell
dnf -y install php-mysql libtool pcre-devel php-pecl-psr php-phalcon5
systemctl restart httpd
systemctl restart php-fpm
dnf -y install php-mysql libtool pcre-devel php-pecl-psr php-phalcon5
systemctl restart httpd
systemctl restart php-fpm
﻿
8. Загрузка и установка Пассворк
Клонируйте репозиторий используя ваш логин и пароль.
Shell
cd /var/www
git config --global --add safe.directory /var/www 
git init
git remote add origin https://passwork.download/passwork/passwork.git
git fetch
cd /var/www
git config --global --add safe.directory /var/www 
git init
git remote add origin https://passwork.download/passwork/passwork.git
git fetch
﻿
Shell
git checkout v6
git checkout v6
﻿
💡 Система запросит логин и пароль к репозиторию, которые вы можете найти в вашем клиентом портале Пассворка. Если у вас нет доступа к клиентскому порталу — свяжитесь с нами.
Установите права доступа на папки и файлы.
Shell
find /var/www/ -type d -exec chmod 755 {} \;
find /var/www/ -type f -exec chmod 644 {} \;
chown -R apache:apache /var/www/
find /var/www/ -type d -exec chmod 755 {} \;
find /var/www/ -type f -exec chmod 644 {} \;
chown -R apache:apache /var/www/
﻿
Конфигурация Apache2
Создайте конфигурационный файл для non-ssl соединения.
Shell
nano /etc/httpd/conf.d/non-ssl.conf
nano /etc/httpd/conf.d/non-ssl.conf
﻿
Приведите содержимое файла к следующему виду:
Shell
<VirtualHost *:8**0**>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/public
    <Directory /var/www/public>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        Allow from all
        Require all granted
    </Directory>
    ErrorLog logs/error_log
    TransferLog logs/access_log
    LogLevel warn
</VirtualHost>
<VirtualHost *:8**0**>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/public
    <Directory /var/www/public>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        Allow from all
        Require all granted
    </Directory>
    ErrorLog logs/error_log
    TransferLog logs/access_log
    LogLevel warn
</VirtualHost>
﻿
Перезапустите Apache.
Shell
systemctl reload php-fpm
systemctl restart httpd
systemctl reload php-fpm
systemctl restart httpd
﻿
Откройте http://passwork.local или http://<IP адрес сервера> для доступа к вебсайту.
9. Инсталляция
При первом открытии Пассворк вы увидите диалог инсталляции, который проверит корректность настройки сервера и позволит ввести базовые параметры.
💡 Оставьте все поля в значениях по умолчанию, если вы устанавливаете новую копию Пассворк.
💡 Обратите внимание, случайно генерируемый ключ используется для шифрования базы данных.
Зарегистрируйте администратора Пассворк
Введите логин и пароль для первого пользователя. Пользователь автоматически станет администратором и владельцем организации.
10. Создание SSL сертификата
Установите SSL модуль для Apache.
Shell
yum -y install mod_ssl
yum -y install mod_ssl
﻿
Создайте новую директорию для хранения закрытого ключа (директория /etc/ssl/certs доступна по умолчанию для хранения файла сертификата):
Shell
mkdir /etc/ssl/private
mkdir /etc/ssl/private
﻿
Установите правильные разрешения на директорию:
Shell
chmod 700 /etc/ssl/private
chmod 700 /etc/ssl/private
﻿
Создайте новый сертификат и закрытый ключ для его защиты.
Shell
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -subj '/CN=your.domain.name' -addext 'subjectAltName=DNS: your.domain.name' -keyout /etc/ssl/private/apache-selfsigned.key -out /etc/ssl/certs/apache-selfsigned.crt
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -subj '/CN=your.domain.name' -addext 'subjectAltName=DNS: your.domain.name' -keyout /etc/ssl/private/apache-selfsigned.key -out /etc/ssl/certs/apache-selfsigned.crt
﻿
Common Name(CN): Укажите IP-адрес вашего сервера или имя хоста. Это поле имеет значение, так как ваш сертификат должен соответствовать домену (или IP-адресу) для вашего веб-сайта.
subjectAltName(SAN): Альтернативные имена домена или IP-адрес.
Создайте группу Диффи-Хеллмана.
Shell
openssl dhparam -out /etc/ssl/certs/dhparam.pem 2048
openssl dhparam -out /etc/ssl/certs/dhparam.pem 2048
﻿
Добавьте содержимое сгенерированного файла в конец самоподписанного сертификата.
Shell
cat /etc/ssl/certs/dhparam.pem | tee -a /etc/ssl/certs/apache-selfsigned.crt
cat /etc/ssl/certs/dhparam.pem | tee -a /etc/ssl/certs/apache-selfsigned.crt
﻿
11. Настройка продукта для корректной работы в Chrome с SSL
При работе через SSL-соединение (HTTPS) браузер Chrome требует наличия флагов Secure и SameSite у cookie. Без этих флагов браузер не будет принимать куки, и  вы не сможете авторизоваться в Пассворке в Chrome.
Для того чтобы установить эти флаги, включите параметр session.cookie_secure в файле /etc/php.ini вручную или командой:
Shell
sed -i '/session.cookie_secure =/c session.cookie_secure = On' /etc/php.ini
sed -i '/session.cookie_secure =/c session.cookie_secure = On' /etc/php.ini
﻿
И установите параметр disableSameSiteCookie (секция [application])в файле /var/www/app/config/config.ini в значение Off вручную или командой:
Shell
sed -i '/disableSameSiteCookie =/c disableSameSiteCookie = Off' /var/www/app/config/config.ini
sed -i '/disableSameSiteCookie =/c disableSameSiteCookie = Off' /var/www/app/config/config.ini
﻿
💡 Обратите внимание, файл `config.ini` генерируется после прохождения первоначальной настройки на странице установки.
💡 Не устанавливайте эти параметры или верните их в исходное значение, если вы передумаете использовать SSL и будете работать через HTTP-протокол.
12. Настройка Apache для использования SSL-соединения
Откройте конфигурационный файл SSL в текстовом редакторе.
Shell
nano /etc/httpd/conf.d/ssl.conf
nano /etc/httpd/conf.d/ssl.conf
﻿
Найдите раздел, начинающийся с <VirtualHost _default_:443> и внесите следующие изменения.
Раскомментируйте строку DocumentRoot и измените путь в кавычках на путь к корневому каталогу вашего сайта. По умолчанию это будет /var/www/html.
Затем, раскомментируйте строку ServerName и замените www.example.com на IP-адрес или домен сервера (в зависимости от того, что вы указали в качестве Common Name в своем сертификате):
Shell
DocumentRoot /var/www/public
ServerName passwork.local:443
DocumentRoot /var/www/public
ServerName passwork.local:443
﻿
Добавьте директиву “Directory” после “ServerName”.
Shell
<Directory /var/www/public>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        Allow from all
		Require all granted
    </Directory>
<Directory /var/www/public>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        Allow from all
		Require all granted
    </Directory>
﻿
Затем найдите строки SSLProtocol и SSLCipherSuite и либо удалите их, либо закомментируйте. Новая конфигурация, которую мы добавим ниже имеет более безопасные параметры, чем настройки Apache по умолчанию в CentOS:
Shell
# SSLProtocol all -SSLv2
# SSLCipherSuite HIGH:MEDIUM:!aNULL:!MD5:!SEED:!IDEA
# SSLProtocol all -SSLv2
# SSLCipherSuite HIGH:MEDIUM:!aNULL:!MD5:!SEED:!IDEA
﻿
Найдите строки SSLCertificateFile и SSLCertificateKeyFile и приведите их к следующему виду:
Shell
SSLCertificateFile /etc/ssl/certs/apache-selfsigned.crt
SSLCertificateKeyFile /etc/ssl/private/apache-selfsigned.key
SSLCertificateFile /etc/ssl/certs/apache-selfsigned.crt
SSLCertificateKeyFile /etc/ssl/private/apache-selfsigned.key
﻿
После внесения изменений проверьте, что ваш файл конфигурации виртуального хоста соответствует примеру ниже.
Shell
<VirtualHost _default_:443>
    DocumentRoot /var/www/public
    ServerName passwork.local:443
    <Directory /var/www/public>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        Allow from all
		Require all granted
    </Directory>
    SSLCertificateFile /etc/ssl/certs/apache-selfsigned.crt
    SSLCertificateKeyFile /etc/ssl/private/apache-selfsigned.key
</VirtualHost>
<VirtualHost _default_:443>
    DocumentRoot /var/www/public
    ServerName passwork.local:443
    <Directory /var/www/public>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        Allow from all
		Require all granted
    </Directory>
    SSLCertificateFile /etc/ssl/certs/apache-selfsigned.crt
    SSLCertificateKeyFile /etc/ssl/private/apache-selfsigned.key
</VirtualHost>
﻿
Мы закончили с изменениями в блоке VirtualHost. Сохраните изменения (Ctr+O) и выйдите (Ctr+X).
Перезапустите Apache, чтобы изменения вступили в силу.
Shell
systemctl restart httpd
systemctl restart httpd
﻿
Проверьте SSL-соединение, откройте ссылку https://passwork.local.
13. Настройка фоновых задач
Фоновые задачи — это задачи, которые выполняются по планировщику в фоновом режиме. Например, синхронизация LDAP, загрузка фавиконов и другие задачи, которые требует много времени, постоянного выполнения или распределения ресурсов.
﻿Настройка фоновых задач﻿﻿