Upgrade 3.18 - История изменений

Uscld2 в 11:34, 8 июля 2025

2025-07-08T11:34:09Z

← Предыдущая версия		Версия от 11:34, 8 июля 2025
Строка 3:		Строка 3:
	Version: '''[[3.18_EN\|3.18]]'''		Version: '''[[3.18_EN\|3.18]]'''

	Version required: '''[[3.~~10_EN~~\|3.10]]''' and above		Version required: '''[[3.12_EN\|3.12]]''' and above

	== A few words from the author - version features ==		== A few words from the author - version features ==

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

2024-10-18T12:53:10Z

← Предыдущая версия		Версия от 12:53, 18 октября 2024
Строка 68:		Строка 68:
	* Note that when the command is invoked <code>php</code> from the command line, php8.1 will now be called, since it is the latest version installed. If you're still using php7.4 anywhere, you'll need to change the php call in those places or change the alternate php command to run the version you need.		* Note that when the command is invoked <code>php</code> from the command line, php8.1 will now be called, since it is the latest version installed. If you're still using php7.4 anywhere, you'll need to change the php call in those places or change the alternate php command to run the version you need.

	* USERSIDE 3.18 requires Python version 3.~~8 or newer~~. If your ~~version is lower than 3.8~~, you [[Python-update_EN\|~~will need to~~ install ~~the newer version~~]] ~~before continuing~~.		* USERSIDE 3.18 ''requires Python3 of any currently supported version. The status of versions can be viewed here:"[https://devguide.python.org/versions/ Status of Python versions]". It is recommended to use a version with "security" or "bugfix" status. Versions marked as "end-of-life" are not supported. Versions marked as "feature" are not recommended. If you have an unsupported version ("end-of-life") installed on your host, you should be sure to [[Python-update_EN\|install additionally]] a more recent version of Python.''

	* Stop the supervisor and all services under its control:		* Stop the supervisor and all services under its control:

N.Skrypnik в 14:06, 10 октября 2024

2024-10-10T14:06:56Z

N.Skrypnik в 14:03, 10 октября 2024

2024-10-10T14:03:12Z

N.Skrypnik в 13:55, 10 октября 2024

2024-10-10T13:55:11Z

N.Skrypnik в 13:44, 10 октября 2024

2024-10-10T13:44:04Z

Внесённые изменения

N.Skrypnik: Новая страница: «en | ru Version: '''3.18''' Version required: '''3.10''' and above == A few words from the author - version features == == Features of the upgrade == '''List of Changes:''' view '''Performing the upgrade:''' instruction»

2024-10-10T10:26:38Z

Новая страница: «en | ru Version: '''3.18''' Version required: '''3.10''' and above == A few words from the author - version features == == Features of the upgrade == '''List of Changes:''' view '''Performing the upgrade:''' instruction»

Новая страница

← Предыдущая версия		Версия от 14:06, 10 октября 2024
Строка 61:		Строка 61:
	* In NGINX, change the PHP version used for the updated copy of USERSIDE. If you followed the system installation instructions, in /etc/nginx/conf.d/default.conf or userside.conf or whatever you used to configure userside, change the line:		* In NGINX, change the PHP version used for the updated copy of USERSIDE. If you followed the system installation instructions, in /etc/nginx/conf.d/default.conf or userside.conf or whatever you used to configure userside, change the line:
	fastcgi_pass unix:/run/php/php7.4-fpm.sock;		fastcgi_pass unix:/run/php/php7.4-fpm.sock;
	~~on the~~ line		per line
	fastcgi_pass unix:/run/php/php8.1-fpm.sock;		fastcgi_pass unix:/run/php/php8.1-fpm.sock;
	and reread the nginx configuration:		and reread the nginx configuration:
Строка 76:		Строка 76:
	** In the file /etc/cron.d/userside you need to replace the line:		** In the file /etc/cron.d/userside you need to replace the line:
	* * * * * www-data /usr/bin/php /var/www/userside/userside cron > /dev/null		* * * * * www-data /usr/bin/php /var/www/userside/userside cron > /dev/null
	~~on a~~ line:		per line:
	* * * * * www-data /usr/bin/php /var/www/userside/run cron > /dev/null		* * * * * www-data /usr/bin/php /var/www/userside/run cron > /dev/null
	** In the file /etc/supervisor/conf.d/us-core-worker.conf you need to replace the line:		** In the file /etc/supervisor/conf.d/us-core-worker.conf you need to replace the line:
	command=/usr/bin/php /var/www/userside/userside queue/listen		command=/usr/bin/php /var/www/userside/userside queue/listen
	~~on a~~ line:		per line:
	command=/usr/bin/php /var/www/userside/run queue/listen		command=/usr/bin/php /var/www/userside/run queue/listen

← Предыдущая версия		Версия от 14:03, 10 октября 2024
Строка 7:		Строка 7:
	== A few words from the author - version features ==		== A few words from the author - version features ==

	* A lot of work has been done and especially we have tried to emphasise on fine-tuning all sorts of little things. Please read the [[3.18\| list of changes]] thoughtfully.		* A lot of work has been done and especially we have tried to emphasise on fine-tuning all sorts of little things. Please read the [[3.18_EN\| list of changes]] thoughtfully.

	* Please take a look at the [["~~Hotkeys~~"]] page.		* Please take a look at the [["Hot keys"]] page.

	* Version 3.18 declares obsolete sections:		* Version 3.18 declares obsolete sections:
	** "[[~~Connection~~ Application]]". In version 3.19, the section will be removed. Use the "[[API]]" section to organise receiving applications and creating tasks		** "[[Application for connection]]". In version 3.19, the section will be removed. Use the "[[API_EN\|API]]" section to organise receiving applications and creating tasks
	** "[[General ~~Switching Scheme~~]]". In version 3.19, the section will be removed. Use the "[[~~Switching Schemes~~]]" section in your work		** "[[General commutation scheme]]". In version 3.19, the section will be removed. Use the "[[Commutation schemes]]" section in your work

	* [[Upgrade]]. '''Recommended to have two instances of the system'''. A separate running one and a separate test one. On the test one you can periodically update the database from the live system and perform updates to make sure everything is working, familiarise yourself with innovations or identify things that have stopped working for you.		* [[Upgrade]]. '''Recommended to have two instances of the system'''. A separate running one and a separate test one. On the test one you can periodically update the database from the live system and perform updates to make sure everything is working, familiarise yourself with innovations or identify things that have stopped working for you.
Строка 68:		Строка 68:
	* Note that when the command is invoked <code>php</code> from the command line, php8.1 will now be called, since it is the latest version installed. If you're still using php7.4 anywhere, you'll need to change the php call in those places or change the alternate php command to run the version you need.		* Note that when the command is invoked <code>php</code> from the command line, php8.1 will now be called, since it is the latest version installed. If you're still using php7.4 anywhere, you'll need to change the php call in those places or change the alternate php command to run the version you need.

	* USERSIDE 3.18 requires Python version 3.8 or newer. If your version is lower than 3.8, you [[Python-~~update~~\|will need to install the newer version]] before continuing.		* USERSIDE 3.18 requires Python version 3.8 or newer. If your version is lower than 3.8, you [[Python-update_EN\|will need to install the newer version]] before continuing.

	* Stop the supervisor and all services under its control:		* Stop the supervisor and all services under its control:
Строка 97:		Строка 97:
	sudo -u www-data php userside_install.phar install		sudo -u www-data php userside_install.phar install

	* The following action only needs to be performed if you [[Python-~~update~~\| updated Python]]. If you haven't updated, you don't need to do it:		* The following action only needs to be performed if you [[Python-update_EN\| updated Python]]. If you haven't updated, you don't need to do it:
	sudo rm -rf /var/www/userside/microservice/poller/venv		sudo rm -rf /var/www/userside/microservice/poller/venv
	sudo python3.11 -m venv /var/www/userside/microservice/poller/venv		sudo python3.11 -m venv /var/www/userside/microservice/poller/venv
Строка 122:		Строка 122:
	* Removed JABBER interaction. Use the "Custom HTTP request" notification service or Messenger ''(Telegram)''.		* Removed JABBER interaction. Use the "Custom HTTP request" notification service or Messenger ''(Telegram)''.

	* If you have not yet reconfigured the [[~~UserSide API Key~~\| to the new system]] - do so. In version 3.18, $zapikey is removed and the API key will stop working for those who have not reconfigured.		* If you have not yet reconfigured the [[UserSide_API_Key_EN\| to the new system]] - do so. In version 3.18, $zapikey is removed and the API key will stop working for those who have not reconfigured.

	* If in version 3.17 you still haven't [[Upgrade 3.17\|configured WebSTOMP]], you need to do so or parts of the system will stop working		* If in version 3.17 you still haven't [[Upgrade 3.17\|configured WebSTOMP]], you need to do so or parts of the system will stop working

← Предыдущая версия		Версия от 13:55, 10 октября 2024
Строка 15:		Строка 15:
	** "[[General Switching Scheme]]". In version 3.19, the section will be removed. Use the "[[Switching Schemes]]" section in your work		** "[[General Switching Scheme]]". In version 3.19, the section will be removed. Use the "[[Switching Schemes]]" section in your work

	* [[~~Update~~]]. '''Recommended to have two instances of the system'''. A separate running one and a separate test one. On the test one you can periodically update the database from the live system and perform updates to make sure everything is working, familiarise yourself with innovations or identify things that have stopped working for you.		* [[Upgrade]]. '''Recommended to have two instances of the system'''. A separate running one and a separate test one. On the test one you can periodically update the database from the live system and perform updates to make sure everything is working, familiarise yourself with innovations or identify things that have stopped working for you.

	* Our group in Telegram for mutual communication between clients: https://t.me/usersideeu and a channel for news: https://t.me/userside		* Our group in Telegram for mutual communication between clients: https://t.me/usersideeu and a channel for news: https://t.me/userside
Строка 23:		Строка 23:
	When upgrading in a Docker environment, refer to [https://github.com/userside/userside-docker/tree/v3.18 instructions] in the Docker bundle repository.		When upgrading in a Docker environment, refer to [https://github.com/userside/userside-docker/tree/v3.18 instructions] in the Docker bundle repository.

	* If you are upgrading from version 3.10 - check out the page: [[~~Update~~ 3.11]]		* If you are upgrading from version 3.10 - check out the page: [[Upgrade 3.11]]

	* If you are upgrading from version 3.11 and earlier - check out the page: [[~~Update~~ 3.12]]		* If you are upgrading from version 3.11 and earlier - check out the page: [[Upgrade 3.12]]

	* If you are upgrading from version 3.12 and earlier - check out the page: [[~~Update~~ 3.13]]		* If you are upgrading from version 3.12 and earlier - check out the page: [[Upgrade 3.13]]

	* If you are upgrading from version 3.13 and earlier - check out the page: [[~~Update~~ 3.14]]		* If you are upgrading from version 3.13 and earlier - check out the page: [[Upgrade 3.14]]

	* If you are upgrading from version 3.14 and earlier - check out the page: [[~~Update~~ 3.15]]		* If you are upgrading from version 3.14 and earlier - check out the page: [[Upgrade 3.15]]

	* If you are upgrading from version 3.15 and earlier - check out the page: [[~~Update~~ 3.16]]		* If you are upgrading from version 3.15 and earlier - check out the page: [[Upgrade 3.16]]

	* If you are upgrading from version 3.16 and earlier - check out the page: [[~~Update~~ 3.17]]		* If you are upgrading from version 3.16 and earlier - check out the page: [[Upgrade 3.17]]

	* Version 3.18 requires PHP version 8.1. You can install all the necessary packages in addition to your existing different PHP version. If you are using LDAP, also install php8.1-ldap. If you are using TurboSMS, install php8.1-soap.		* Version 3.18 requires PHP version 8.1. You can install all the necessary packages in addition to your existing different PHP version. If you are using LDAP, also install php8.1-ldap. If you are using TurboSMS, install php8.1-soap.
Строка 94:		Строка 94:
	</pre>		</pre>

	* Use the automatic [[Installer\|installer]] to perform an [[~~Update~~\|~~update~~]]:		* Use the automatic [[Installer\|installer]] to perform an [[Upgrade\|upgrade]]:
	sudo -u www-data php userside_install.phar install		sudo -u www-data php userside_install.phar install

Строка 124:		Строка 124:
	* If you have not yet reconfigured the [[UserSide API Key\| to the new system]] - do so. In version 3.18, $zapikey is removed and the API key will stop working for those who have not reconfigured.		* If you have not yet reconfigured the [[UserSide API Key\| to the new system]] - do so. In version 3.18, $zapikey is removed and the API key will stop working for those who have not reconfigured.

	* If in version 3.17 you still haven't [[~~Update~~ 3.17\|configured WebSTOMP~~]] -~~ ]], you need to do so or parts of the system will stop working		* If in version 3.17 you still haven't [[Upgrade 3.17\|configured WebSTOMP]], you need to do so or parts of the system will stop working

	* Don't forget to update all modules to their latest versions		* Don't forget to update all modules to their latest versions