Быстрая установка¶
Быстрая установка на DEB-based ОС¶
Рассмотрим быструю установку PGHS на примере ОС Debian. Подробное описание шагов установки можно посмотреть в разделе «Расширенная установка».
Все команды следует выполнять с правами суперпользователя (root)
1. Создаем каталог для дистрибутива PGHS
mkdir /root/xsquare
переходим в каталог
cd /root/xsquare
2. Скачиваем/получаем дистрибутив в созданный каталог
wget https://lcdp.xsquare.ru/files/pghs/xsquare.lcdp.v5/xsquare.lcdp.5.0_latest_release.zip
3. Распаковываем дистрибутив
apt -y install unzip
unzip xsquare.lcdp.5.0.0.0.0.0_release.zip
4. Переходим в каталог с файлами дистрибутива PGHS
cd xsquare.lcdp.5.0.0.0.0.0_release
5. Настраиваем часовой пояс и локализацию ОС
echo "Europe/Moscow" > /etc/timezone && \
dpkg-reconfigure -f noninteractive tzdata && \
sed -i -e 's/# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/' /etc/locale.gen && \
sed -i -e 's/# ru_RU.UTF-8 UTF-8/ru_RU.UTF-8 UTF-8/' /etc/locale.gen && \
echo 'LANG="ru_RU.UTF-8"'>/etc/default/locale && \
dpkg-reconfigure --frontend=noninteractive locales && \export LANG=ru_RU.UTF-8
6. Устанавливаем PostgreSQL
apt -y install postgresql
Подготавливаем PostgreSQL
переключаемся на пользователя postgres su - postgres
создаем пользователей БД xrad_user и app_user
psql -c "create user xrad_user with encrypted password 'xrad_user';"
psql -c "create user app_user with encrypted password 'app_user';"
создаем базы appdb и xraddb
psql -c "CREATE DATABASE \"appdb\" WITH OWNER \"app_user\" ENCODING 'UTF8' LC_COLLATE = 'ru_RU.UTF-8' LC_CTYPE = 'ru_RU.UTF-8';"
psql -c "CREATE DATABASE \"xraddb\" WITH OWNER \"xrad_user\" ENCODING 'UTF8' LC_COLLATE = 'ru_RU.UTF-8' LC_CTYPE = 'ru_RU.UTF-8';"
назначаем пользователям xrad_user и app_user максимальные привилегии
psql -c "ALTER USER xrad_user WITH SUPERUSER;"
psql -c "ALTER USER app_user WITH SUPERUSER;"
выходим из сеанса учетной записи postgres
exit
8. Импортируем базы данных
export PGPASSWORD='xrad_user';
psql -U xrad_user -h 127.0.0.1 xraddb < db/xraddb.xsquare.pgsql
export PGPASSWORD='app_user';
psql -U app_user -h 127.0.0.1 appdb < db/appdb.xsquare.pgsql
9. Устанавливаем nginx
apt -y install nginx
отключаем сайт по умолчанию
rm -f /etc/nginx/sites-enabled/default
копируем из дистрибутива файлы веб-контроллера PGHS
cp -R ./var/www/pghs.xsquare* /var/www/
копируем из дистрибутива конфигурационные файлы nginx
cp -R ./etc/nginx /etc/
10. Перезапускаем nginx
systemctl restart nginx
проверяем его состояние
systemctl status nginx
systemctl enable nginx
11. Копируем исполняемые и конфигурационные файлы PGHS
cp -R ./etc/systemd /etc/
cp -R ./usr /
12. Запускаем PGHS как службу и проверяем статус
systemctl start xsquare.pghs.service
systemctl enable xsquare.pghs.service
systemctl status xsquare.pghs.service
Проверяем доступность дефолтного веб-приложения в браузере
Примечание: в случаем проблем с доступом по http необходимо проверить настройки nginx и разрешения в брандмауэре.
Быстрая установка на RPM-based ОС¶
Рассмотрим быструю установку PGHS на примере ОС Fedora. Подробное описание шагов установки можно посмотреть в разделе «Расширенная установка». Все команды следует выполнять с правами суперпользователя (root).
1. Создаем каталог для дистрибутива PGHS
mkdir /root/xsquare
переходим в каталог
cd /root/xsquare
2. Скачиваем дистрибутив в созданный каталог
wget https://lcdp.xsquare.ru/files/pghs/xsquare.lcdp.v5/xsquare.lcdp.5.0.0.0.0.0_release.zip
3. Распаковываем дистрибутив
dnf install -y unzip
unzip xsquare.lcdp.5.0.0.0.0.0_release.zip
4. Переходим в каталог с файлами дистрибутива PGHS
cd xsquare.lcdp.5.0.0.0.0.0_release
5. Настраиваем часовой пояс и локализацию ОС
timedatectl set-timezone Europe/Moscow
localectl set-locale LANG=ru_RU.UTF-8
export LANG=ru_RU.UTF-8
6. Устанавливаем и запускаем PostgreSQL
dnf install -y postgresql
postgresql-setup --initdb
systemctl start postgresql
systemctl enable postgresql
Подготавливаем PostgreSQL
переключаемся на пользователя postgres
su - postgres
создаем пользователей БД xrad_user и app_user
psql -c "create user xrad_user with encrypted password 'xrad_user';"
psql -c "create user app_user with encrypted password 'app_user';"
создаем базы appdb и xraddb
psql -c "CREATE DATABASE \"appdb\" WITH OWNER \"app_user\" ENCODING 'UTF8' LC_COLLATE = 'ru_RU.UTF-8' LC_CTYPE = 'ru_RU.UTF-8';"
psql -c "CREATE DATABASE \"xraddb\" WITH OWNER \"xrad_user\" ENCODING 'UTF8' LC_COLLATE = 'ru_RU.UTF-8' LC_CTYPE = 'ru_RU.UTF-8';"
назначаем пользователям xrad_user и app_user максимальные привилегии
psql -c "ALTER USER xrad_user WITH SUPERUSER;"
psql -c "ALTER USER app_user WITH SUPERUSER;"
выходим из сеанса учетной записи postgres
exit
8. Импортируем базы данных
export PGPASSWORD='xrad_user';
psql -U xrad_user -h 127.0.0.1 xraddb < db/xraddb.xsquare.pgsql
export PGPASSWORD='app_user';
psql -U app_user -h 127.0.0.1 appdb < db/appdb.xsquare.pgsql
9. Устанавливаем nginx
dnf install -y nginx
отключаем сайт по умолчанию
rm -f /etc/nginx/sites-enabled/default
копируем из дистрибутива файлы веб-контроллера PGHS
cp -R ./var/www/pghs.xsquare* /var/www/
копируем из дистрибутива конфигурационные файлы nginx
cp -R ./etc/nginx /etc/
10. Отключаем Security-Enhanced Linux для HTTP запросов
setsebool -P httpd_can_network_connect 1
11. Перезапускаем nginx
systemctl restart nginx
проверяем его состояние
systemctl --no-pager status nginx
12. Копируем исполняемые и конфигурационные файлы PGHS
cp -R ./etc/systemd /etc/
cp -R ./usr /
13. Запускаем PGHS как службу и проверяем статус
systemctl start xsquare.pghs.service
systemctl enable xsquare.pghs.service
systemctl --no-pager status xsquare.pghs.service
Проверяем доступность дефолтного веб-приложения в браузере
Примечание: в случаем проблем с доступом по http необходимо проверить настройки nginx и разрешения в брандмауэре.