Update guide

Update via RPM or DEB Update via Roxy-WI Updating from 4.2.2 and earlier to later versions Updating from 4.4.1 to 4.4.2 version Updating to 5.1.4 version Updating from 5.1.4 to version 5.2.0 Updating from 5.4.3 to version 5.5 Updating from 5.5.1 to version 6.0 Updating to version 6.1.1 Updating to version 6.2.0 Updating to version 7.0.0 Updating to version 7.1.0 Updating to version 7.2.0 Updating to version 8

YUM

If you installed Roxy-WI via RPM or DEB, execute the following command:

If your Roxy-WI server uses proxy to connect to the Internet, add the proxy settings to yum.conf:

Update Roxy-WI via the Web Interface

Before updating via Web Interface you have to add the apache user tu sudoers:

Add permission for the apache user:

If your Roxy-WI server uses proxy to connect to the Internet, add the proxy settings to yum.conf:

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:

Once you have deleted the old package, you can start updating either manually or via Roxy-WI:

Updating from version 4.4.1 to 4.4.2

You can update from version 4.4.1 to 4.4.2 only manually.

You must be logged in to Roxy-WI before performing all actions or have the admin user in the group "All"

First of all update Roxy-WI, execute the following command:

This action will drop settings to the default.

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

As our project has rebranded and has been renamed to Roxy-WI, the packages will also be renamed.

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

and reinstall them under the new names:

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 have 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:

2. Update your roxy-wi.cfg file according to the exemple:

Updating to 7.0.0 version

Since 7.0.0, Roxy-WI has started using 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:

And Apache2 (httpd) config. It should be like (an example for EL):

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.

Updating to version 8

Since version 8 Roxy-WI starts to use latest versions of Python3, therefor you have to update Python3 before update Roxy-WI.

For EL it must be Python3.11:

                                rpm -e --nodeps python3-mod_wsgi ansible-collection-community-general ansible ansible-core
                                yum install python3.11-mod_wsgi

For Ubuntu Python3 must be at least 3.9

After updating Roxy-WI you have to create keys for JWT tokens:

                                ssh-keygen -t rsa -b 4096 -m pem -f /var/lib/roxy-wi/keys/roxy-wi-key -C "Roxy-WI JWT KEY. DO NOT DELETE IT!" -P ""
                                
                                For EL:
                                chown apache:apache /var/lib/roxy-wi/keys/* -R
                                systemctl reload httpd
                                
                                For Ubuntu:
                                chown www-data:www-data /var/lib/roxy-wi/keys/* -R
                                systemctl reload apache2

If you see internal error or cannot login download update file to /var/www/haproxy-wi/app and run it:

                                cd /var/www/haproxy-wi/app
                                
                                For EL:
                                python3.11 update_db_to_v8.py
                                systemctl reload httpd
                                
                                For Ubuntu:
                                python3 update_db_to_v8.py
                                
                                systemctl reload apache2

Mail to us: [email protected]

Telegram chat: roxy_wi_chat

Telegram channel: roxy_wi_channel

GitHub

Legal Notes