YUM
If you installed Roxy-WI via RPM or DEB, execute the following command:
Update Roxy-WI via the Web Interface
Before updating via Web Interface you have to add the apache user tu sudoers:
All information concerning RPM packages can be found here .
Updating from 4.2.2 and earlier to later versions
Because of the new version of Python there is aconflict between two packages: the newer package python36-mod_wsgi conflicts with the older python35u-mod_wsgi. For updating to version 4.2.3 you should delete the old package first:
Updating from version 4.4.1 to 4.4.2
You can update from version 4.4.1 to 4.4.2 only manually.
First of all update Roxy-WI, execute the following command:
Also you should re-create all your groups. If you re-create the groups in the same order in which they were created, it will not affect your users and servers.
Updating to 5.1.4
Delete old repository: haproxy-wi-release-7
Install a new repository:
You will have to remove all the installed services:
- haproxy-wi-checker
- haproxy-wi-smon
- haproxy-wi-metrics
- haproxy-wi-checker
- haproxy-wi-portscanner
- haproxy-wi-keep_alive
- roxy-wi-checker
- roxy-wi-smon
- roxy-wi-metrics
- roxy-wi-checker
- roxy-wi-portscanner
- roxy-wi-keep_alive
Updating from 5.1.4 to 5.2.0 version
At the next step install the new Roxy-WI packages and renaming the database and the configuration file. If you use RPM installation, perform the following commands:
If you do not use RPM, just skip the step with yum.
Updating from 5.4.3 to 5.5.0 version
In version 5.5.0 the procedures of sending notifications and alerts have been significantly improved. All notifications are sent to users by the new service named Socket. The Socket service uses RabbitMQ as a message broker. All services put notifications to RabbitMQ. the Socket service retrieves them and sends to users, To update to 5.5.0 version,you need to install RabbitMQ and the Socket service. After that update all the previously installed services and add the following lines to Apache config file:
Once you have updated to version 5.5.0, all services will use the new logging system based on Rsyslog.
Updating from 5.5 to 6.0 version
Since 6.0 Roxy-WI starts to display information about subscription. For correct work you have to logout and login after updating. This will allow Roxy-WI to update its inside information.
The group "All" has also been renamed to the "Default". You may need to update your scripts.
Updating to 6.1.1 version
Since 6.1.1 version Roxy-WI starts storing keys, lists, configs and its Sqlite database in a new folder: /var/lib/roxy-wi. This is done for several reasons: it provides more security, and it is also more convenient to update the Docker container.
Also Roxy-WI(roxy-wi.cfg) config file has been moved to the /etc/roxy-wi folder.
To move all the necessary folders to a new location, you need to follow these steps:
If you get errors after update, look at default config and add missing parameters.
Updating to 6.2.0 version
Since 6.2.0 Roxy-WI log files has been moved to the /var/log/roxy-wi folder. You should do some changes manually to continue using Roxy-WI.
1. Perform the following commands to move your log files:
Updating to 7.0.0 version
Since 7.0.0 Roxy-WI has started use Flask. If you use packages installation delete Roxy-WI tools via terminal:
- roxy-wi-metrics
- roxy-wi-checker
- roxy-wi-smon
- roxy-wi-keep_alive
- roxy-wi-socket
- roxy-wi-portscanner
- roxy-wi-prometheus-exporter
Update Roxy-WI. After update install Tools back.
Also check config /etc/roxy-wi/roxy-wi.cfg:
Updating to 7.1.0 version
Starting with version 7.1.0, Roxy-WI began working with HA clusters in a new way. If you are using Keepalived and want to manage it via Roxy-WI, you should follow these steps:
- Open the Servers page, select the "No slave" in the "Slave for"
- Open the HA cluster page
- Press the "Create HA cluster"
- Create a new HA cluster according to your configuration
- Press the "Save" button
- Add an extra VIP if any
- Add an extra Virtual server if any
- If you would like reconfigure your cluster according HA cluster settings pres "Edit" button on a cluster what you want to reconfigure, in opened window press the "Next button and press the "Apply" button.
Updating to 7.2.0 version
Since 7.2.0.0 version Roxy-WI starts crypt SSH passwords and passphrases. So, it were crypted for using it must be encrypted, because of it Roxy-WI config has a salt now. Add a new parameter to your config:
How to generate the salt:
Reload you Apache server. If you have used passwords for SSH access, please, reenter passwords, due to Roxy-WI crypt it.