Установка - История изменений

Uscld2 в 10:06, 20 июня 2025

2025-06-20T10:06:39Z

← Предыдущая версия		Версия от 10:06, 20 июня 2025
Строка 166:		Строка 166:
	sudo tee /etc/rabbitmq/rabbitmq.conf << EOF		sudo tee /etc/rabbitmq/rabbitmq.conf << EOF
	listeners.tcp.default = 5672		listeners.tcp.default = 5672

			consumer_timeout = 2400000

	web_stomp.port = 15674		web_stomp.port = 15674

Uscld2: /* Основные договорённости */

2025-05-20T13:16:27Z

Основные договорённости

← Предыдущая версия		Версия от 13:16, 20 мая 2025
Строка 33:		Строка 33:
	Каталог, в который устанавливается ERP USERSIDE - <code>/var/www/userside</code>. Внутри этого каталога должен быть подкаталог public, который является корневым каталогом для WEB-сервера. Если вы хотите использовать другой каталог для ERP USERSIDE, не забывайте вносить соответствующие исправления во все примеры из данной инструкции.		Каталог, в который устанавливается ERP USERSIDE - <code>/var/www/userside</code>. Внутри этого каталога должен быть подкаталог public, который является корневым каталогом для WEB-сервера. Если вы хотите использовать другой каталог для ERP USERSIDE, не забывайте вносить соответствующие исправления во все примеры из данной инструкции.

	Создайте ~~каталог~~:		Создайте каталоги:
	sudo mkdir -p /var/www/userside/public		sudo mkdir -p /var/www/userside/public /var/log/usm_poller
	sudo chown -R www-data:www-data /var/www/userside		sudo chown -R www-data:www-data /var/www/userside /var/log/usm_poller

	Вам необходимо выделить доменное имя для ERP USERSIDE. В примерах ниже используется userside.mycompany.com, но вам необходимо будет заменить его на свое. Пропишите это доменное имя в /etc/hosts, если оно отличается от имени хоста, на котором производистя установка.		Вам необходимо выделить доменное имя для ERP USERSIDE. В примерах ниже используется userside.mycompany.com, но вам необходимо будет заменить его на свое. Пропишите это доменное имя в /etc/hosts, если оно отличается от имени хоста, на котором производистя установка.

Uscld2: /* Настройка */

2025-05-01T14:55:02Z

Настройка

← Предыдущая версия		Версия от 14:55, 1 мая 2025
Строка 298:		Строка 298:
	}		}

	location ~* ^.+\.(css~~\|js~~\|ogg\|ogv\|svg\|svgz\|eot\|otf\|woff\|mp4\|ttf\|rss\|atom\|jpg\|jpeg\|gif\|png\|ico\|zip\|tgz\|gz\|rar\|bz2\|doc\|xls\|exe\|ppt\|tar\|mid\|midi\|wav\|bmp\|rtf)$ {		location ~* ^.+\.(css\|ogg\|ogv\|svg\|svgz\|eot\|otf\|woff\|mp4\|ttf\|rss\|atom\|jpg\|jpeg\|gif\|png\|ico\|zip\|tgz\|gz\|rar\|bz2\|doc\|xls\|exe\|ppt\|tar\|mid\|midi\|wav\|bmp\|rtf)$ {
	access_log off;		access_log off;
	log_not_found off;		log_not_found off;

Uscld2: /* Восстановление из резервной копии */

2025-03-06T13:40:17Z

Восстановление из резервной копии

← Предыдущая версия		Версия от 13:40, 6 марта 2025
Строка 465:		Строка 465:

	Перед восстановлением базы данных из резервной копии нужно обязательно остановить работу USERSIDE.		Перед восстановлением базы данных из резервной копии нужно обязательно остановить работу USERSIDE.

	1. Остановить cron userside и всех модулей		1. Остановить cron userside и всех модулей
	<pre>		<pre>

Uscld2: /* Восстановление из резервной копии */

2025-03-06T13:39:12Z

Восстановление из резервной копии

← Предыдущая версия		Версия от 13:39, 6 марта 2025
Строка 463:		Строка 463:
	=== Восстановление из резервной копии ===		=== Восстановление из резервной копии ===
	Для восстановления из дампа используется команда pg_restore. [https://postgrespro.ru/docs/postgresql/13/app-pgrestore Документация по использованию pg_restore]. Для восстановления из SQL-скрипта используется утилита psql. [https://www.postgresql.org/docs/current/app-psql.html Документация по использованию psql].		Для восстановления из дампа используется команда pg_restore. [https://postgrespro.ru/docs/postgresql/13/app-pgrestore Документация по использованию pg_restore]. Для восстановления из SQL-скрипта используется утилита psql. [https://www.postgresql.org/docs/current/app-psql.html Документация по использованию psql].

			Перед восстановлением базы данных из резервной копии нужно обязательно остановить работу USERSIDE.
			1. Остановить cron userside и всех модулей
			<pre>
			mkdir -p ~/cron
			sudo mv /etc/cron.d/userside ~/cron
			sudo mv /etc/cron.d/userside-modules ~/cron
			</pre>
			2. Остановить работу фоновых служб
			<pre>
			sudo supervisorctl stop all
			</pre>
			3. Остановить работу php-fpm
			<pre>
			sudo systemctl stop php8.3-fpm
			</pre>
			Только после этого можно приступать к восстановлению базы данных из резервной копии.

	==== SQL-script ====		==== SQL-script ====
Строка 486:		Строка 503:

	==== После восстановления базы данных ====		==== После восстановления базы данных ====
	После восстановления базы данных любым способом, необходимо очистить кэш ERP USERSIDE, т.к. в кэше теперь находятся данные, отличные от данных в базе. Перейтите в каталог /var/www/userside и выполните команду очистки кэша:		После восстановления базы данных любым способом, необходимо очистить кэш ERP USERSIDE, т.к. в кэше теперь находятся данные, отличные от данных в базе. Перейтите в каталог /var/www/userside и выполните команду очистки кэша (первую, если используется пароль или вторую, если не используется):
	<pre>		<pre>
	cd /var/www/userside		source /var/www/userside/.env && redis-cli -h $US_REDIS_HOST -p $US_REDIS_PORT -a $US_REDIS_PASSWORD -n $US_REDIS_DB FLUSHDB
	~~php run cache~~/~~flush~~-all		source /var/www/userside/.env && redis-cli -h $US_REDIS_HOST -p $US_REDIS_PORT -n $US_REDIS_DB FLUSHDB
			</pre>
			Восстановите работу служб, которые были остановлены перед выполнением резервной копии:
			<pre>
			sudo mv ~/cron/* /etc/cron.d
			sudo supervisorctl start all
			sudo systemctl start php8.3-fpm
	</pre>		</pre>
	~~И выполните~~ команду восстановления, ~~которая в том числе проверит~~ систему на целостность.		Выполните команду восстановления, чтобы файлы системы соответствовали версии базы данных и проверить систему на целостность файлов.
	<pre>		<pre>
			cd /var/www/userside
	sudo -u www-data php userside_install.phar repair		sudo -u www-data php userside_install.phar repair
	</pre>		</pre>

N.Skrypnik в 11:28, 18 октября 2024

2024-10-18T11:28:52Z

← Предыдущая версия		Версия от 11:28, 18 октября 2024
Строка 338:		Строка 338:
	''Необходим Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''		''Необходим Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''

	Debian 12 в стандартном репозитории содержит Python 3.11 - этого вполне достаточно, поэтому никакие альтернативные репозитории не нужны. Но если у вас на хосте версия ~~ниже 3.9~~, то нужно обязательно [[Python-update\|установить дополнительно]] более свежую версию Python.		Если у вас на хосте неподдерживаемая версия ("end-of-life"), то нужно обязательно [[Python-update\|установить дополнительно]] более свежую версию Python.

	==== Установка необходимых пакетов ====		==== Установка необходимых пакетов ====

N.Skrypnik в 11:24, 18 октября 2024

2024-10-18T11:24:09Z

← Предыдущая версия		Версия от 11:24, 18 октября 2024
Строка 23:		Строка 23:
	* Расширения PHP: ctype, gd, json, libxml, mbstring, openssl, pdo, pdo_pgsql, posix, simplexml, snmp, sockets, zlib, pcntl		* Расширения PHP: ctype, gd, json, libxml, mbstring, openssl, pdo, pdo_pgsql, posix, simplexml, snmp, sockets, zlib, pcntl
	* Дополнительные расширения PHP: ldap, soap		* Дополнительные расширения PHP: ldap, soap
	* Python: ''~~Для работы модуля необходим~~ Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''		* Python: ''Необходим Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''
	* Модули Python: pip, venv		* Модули Python: pip, venv
	* PostgreSQL: 12+ (желательно 16)		* PostgreSQL: 12+ (желательно 16)
Строка 336:		Строка 336:

	=== Python ===		=== Python ===
	''~~Для работы модуля необходим~~ Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''		''Необходим Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''

	Debian 12 в стандартном репозитории содержит Python 3.11 - этого вполне достаточно, поэтому никакие альтернативные репозитории не нужны. Но если у вас на хосте версия ниже 3.9, то нужно обязательно [[Python-update\|установить дополнительно]] более свежую версию Python.		Debian 12 в стандартном репозитории содержит Python 3.11 - этого вполне достаточно, поэтому никакие альтернативные репозитории не нужны. Но если у вас на хосте версия ниже 3.9, то нужно обязательно [[Python-update\|установить дополнительно]] более свежую версию Python.

N.Skrypnik в 11:22, 18 октября 2024

2024-10-18T11:22:32Z

← Предыдущая версия		Версия от 11:22, 18 октября 2024
Строка 336:		Строка 336:

	=== Python ===		=== Python ===
			''Для работы модуля необходим Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''

	Debian 12 в стандартном репозитории содержит Python 3.11 - этого вполне достаточно, поэтому никакие альтернативные репозитории не нужны. Но если у вас на хосте версия ниже 3.9, то нужно обязательно [[Python-update\|установить дополнительно]] более свежую версию Python.		Debian 12 в стандартном репозитории содержит Python 3.11 - этого вполне достаточно, поэтому никакие альтернативные репозитории не нужны. Но если у вас на хосте версия ниже 3.9, то нужно обязательно [[Python-update\|установить дополнительно]] более свежую версию Python.

N.Skrypnik в 11:18, 18 октября 2024

2024-10-18T11:18:58Z

← Предыдущая версия		Версия от 11:18, 18 октября 2024
Строка 23:		Строка 23:
	* Расширения PHP: ctype, gd, json, libxml, mbstring, openssl, pdo, pdo_pgsql, posix, simplexml, snmp, sockets, zlib, pcntl		* Расширения PHP: ctype, gd, json, libxml, mbstring, openssl, pdo, pdo_pgsql, posix, simplexml, snmp, sockets, zlib, pcntl
	* Дополнительные расширения PHP: ldap, soap		* Дополнительные расширения PHP: ldap, soap
	* Python: 3.~~9+ (желательно 3~~.~~11)~~		* Python: ''Для работы модуля необходим Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''
	* Модули Python: pip, venv		* Модули Python: pip, venv
	* PostgreSQL: 12+ (желательно 16)		* PostgreSQL: 12+ (желательно 16)

N.Skrypnik в 08:26, 4 июня 2024

2024-06-04T08:26:34Z

← Предыдущая версия		Версия от 08:26, 4 июня 2024
Строка 406:		Строка 406:
	* Настройте взаимодействие с [[Поддерживаемые биллинги\|биллингом]] в соответствии с [[Настройка взаимодействия с биллингом\|инструкциями]].		* Настройте взаимодействие с [[Поддерживаемые биллинги\|биллингом]] в соответствии с [[Настройка взаимодействия с биллингом\|инструкциями]].
	* Ознакомьтесь с инструкциями на странице: [[С чего начать?]].		* Ознакомьтесь с инструкциями на странице: [[С чего начать?]].
	* Настройте [[API-ключ~~\|UserSide_API_Key~~]].		* Настройте [[UserSide API Key\|API-ключ]].

	== Обновление системы ==		== Обновление системы ==