Short URLs / jetty / Official HowTo incomplete?

Hello,

we are using XWiki 15.10.14 on Debian 12 (using official debian packages) with Jetty.

we have configured ShortURLs for our Wiki-Farm and have worked through all the steps in these instructions: ShortURLs

But after that it didn’t work out. In addition we had to add the following snippet to /etc/xwiki/web.xml:

<servlet-mapping>
  <servlet-name>action</servlet-name>
  <url-pattern>/*</url-pattern>
</servlet-mapping>
  1. Will this be overwritten on updates?
  2. Is this correct?
  3. Do we have to remove other actions with the url-patterns /xwiki/* and /bin/*?
  4. Is it generally safe to use Short URLs or is there anything against it?

Maybe the instructions on the ShortURLs could be updated.

Thanks!

EDIT: Just noticed that this step is explained but located under the instructions for Apache. We are using nginx and so we first thought this wasn’t needed for nginx.

Hardly an expert of the short URL setup, but I can at least answer this one:

In the Debian package, web.xml is part of the files (with xwiki.cfg and xwiki.properties) which are managed by ucf. Among other things, it means that the file is automatically merged, keeping your changes. And if there is a conflict when trying to merge you are warned and asked what to do.