Настройка окружения

Перед установкой Idea Hub требуется выполнить настройку окружения, которая состоит из:

Установки PHP
Установки и настройки PostgreSQL
Установки и настройки Nginx
Установки максимального размера загружаемых файлов

Установка PHP

Проверьте, установлен ли на целевой машине PHP:


php --version

Пример результата выполнения команды:


PHP 8.2.5 (cli) (built: May 3 2023 05:10:17) (NTS)  
Copyright (c) The PHP Group  
Zend Engine v4.2.5, Copyright (c) Zend Technologies    
with Zend OPcache v8.2.5, Copyright (c), by Zend Technologies    
with Xdebug v3.2.1, Copyright (c) 2002-2023, by Derick Rethans

Следующие действия зависят от полученного результата:

Если результат аналогичен примеру, а также демонстрирует, что на компьютере установлен PHP версии 8.1 или выше, можно переходить к следующему этапу установки.
Если версия PHP ниже 8.1 или пакет не установлен, необходимо обновить или установить его.
Если используется ОС Астра Линукс, то требуется произвести обновление репозитория:
```
astra-ce https://dl.astralinux.ru/astra/stable/1.7_x86-64/repository-extended/
```

Установка пакета и модулей PHP

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


sudo apt install php8.1

Установите необходимые модули:

php8.1-imagick:
```
sudo apt install php8.1-imagick
```
php8.1-pgsql:
```
sudo# apt install php8.1-pgsql
```
php8.1-fpm:
```
sudo apt install php8.1-fpm
```
php8.1-gd:
```
sudo apt install php8.1-gd
```
php8.1-xml:
```
sudo apt install php8.1-xml
```
php8.1-curl:
```
sudo apt install php8.1-curl
```
php8.1-opcache самой новой версии (8.1.12-1ubuntu4.3):
```
sudo apt install php8.1-opcache
```
php-yaml (2.0.2+1.3.1-4):
```
sudo apt install php-yaml
```
php-pear (1:1.10.13+submodules+notgz+2022032202-2):
```
sudo apt install php-pear
```
php8.1-apcu:
```
sudo apt install php-apcu
```
php8.1-ldap:
```
apt install php8.1-ldap
```
php8.1-mbstring:
```
apt install php8.1-mbstring 
```

Установка PostgreSQL

Проверьте, установлен ли на целевой машине PostgreSQL:


psql –version

Если PostgreSQL установлен, и его версия >= 13, то перейдите к пункту Настройка базы данных.

В противном случае произведите установку PostgreSQL.

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

Используйте команду установки:
```
sudo apt install postgresql postgresql-contrib
```
После установки внесите изменения в следующие конфигурационные файлы:
- /etc/postgresql/14/main/postgresql.conf — этот файл меняем только в том случае, если рассматривается возможность подключения к БД Idea Hub по сети.
  
  Найдите строку:
```
listen_addresses = 'localhost'
```
  Чтобы сервер БД слушал подключения на всех локальных интерфейсах, измените значение на:
```
listen_addresses = '*'
```
  Чтобы сервер БД слушал подключения на конкретном интерфейсе, пропишите:
```
listen_addresses = 'IP-address'
```
- /etc/postgresql/14/main/pg_hba.conf
  
  Внесите изменения в соответствии с политиками безопасности предприятия:
  
  local all all md5
  
  Позволяет любому пользователю локальной системы подключаться к базе данных “postgres”, если он передает правильный пароль.
  
  host all all 192.168.12.10/24 md5
  
  Позволяет любому пользователю компьютера 192.168.12.10 подключаться к базе данных “postgres”, если он передает правильный пароль.

Перезапустите PostgreSQL:


sudo systemctl reastart postgresql


sudo systemctl status postgresql

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

Установите Nginx:
```
sudo apt install nginx
```
Скопируйте файл ./config/ideahub-nginx.conf в каталог /etc/nginx/sites-available.
Отредактируйте файл /etc/nginx/sites-available/ideahub-nginx.conf, заменив в нём значение DOMAIN_NAME на имя домена, который вы будете использовать при подключении к серверу через браузер (в нашем примере ideahub.local):
```
server_name ideahub.local;
```
Cтроку root /var/www/DOMAIN_NAME/web; замените на:
```
root /var/www/ideahub/web;
```
Найдите строки типа fastcgi_pass unix:/run/php/php8.2-fpm.sock и раскомментируйте ту, в которой указана ваша версия PHP.

Добавьте сайт в список включенных командой:


sudo ln -s /etc/nginx/sites-available/ideahub-nginx.conf /etc/nginx/sites-enabled/ideahub-nginx.conf

Перезапустите Nginx:
```
sudo systemctl restart nginx
```

Настройка доступа к порталу Idea Hub через браузер

Теперь вашей локальной машине нужно дать доступ к порталу Idea Hub.

Найдите файл hosts. В Linux он находится по адресу /etc/hosts, потребуется административный доступ.
Добавьте в конец файла строку типа:
```
192.168.1.121 ideahub.local
```
Где 192.168.1.121 — это IP-адрес тестового стенда с Idea Hub, а ideahub.local — это домен, который вы указали ранее при установке и настройке веб-сервера Nginx.

Установка максимального размера загружаемого файла

Заранее обговорите с компетентными лицами максимальный размер файлов, которые можно будет загружать.
Настройте конфиг Nginx. У nginx.conf (/etc/nginx/nginx.conf) надо поправить значение client_max_body_size. Для 100 мегабайт значением будет 100M.
Настройте конфигурацию PHP. В php.ini (/etc/php/8.1/fpm/php.ini) надо поправить значения: upload_max_filesize и post_max_size. Для 100 мегабайт значением будет 100M.
Далее настройте поля друпала. К примеру для поля Документы, контент типа процесс, надо перейти по адресу /admin/structure/types/manage/process/fields/node.process.field_docs и отредактировать значение в поле Максимальный размер закачки. Для 100 мегабайт значением будет 100MB.

Что дальше

Следующий шаг — подготовка к установке Idea Hub.