Detour with Znuny 7

Change is constant, and with a software rebranding it is obvious change must happen. After upgrading to Znuny 7, one issue might be unsolved: how to deal with links for customer users and agents generated before the upgrade.

The solution to this is pretty simple. We use a feature that comes with the Apache httpd web server. We will redirect every request that goes to /otrs/ and send the client to /znuny/:

RedirectMatch "/otrs/(.*)" "/znuny/$1"

Since it is not recommended to change the configuration apache2-httpd.include.conf that comes with Znuny 7, we use a more convenient approach: our own custom configuration file.

For systems running with an Enterprise Linux distribution, like Red Hat, Rocky Linux, Alma Linux, etc., create the new file /etc/httpd/conf.d/znuny_extra.conf with the line above. After checking the configuration and reloading, it's done.

[root@znuny-host]# apachectl configtest && systemctl reload httpd.service

Debian and Ubuntu users have the file in another location and enable it differently. Place the line into the file /etc/apache2/conf-available/znuny_extra.conf
Then you have to enable the configuration and reload the web server.

[root@znuny-host]# a2enconf znuny_extra
[root@znuny-host]# apache2ctl configtest && systemctl reload apache2.service

Tip

If you have any other web server configuration changes related to Znuny, you could also have them in this file. This prevents you from adopting your changes after every update, and you won't miss it when something changes in the original configuration.

In-Depth

For those who like to learn a bit more about this. We use a directive from the module mod_alias, and reading the manual never hurts.