Changing URL of iceScrum

[Kagilum]

Hello!

I would like to change how to change URL of iceScrum from its default:

http://:8080/icescrum

to

http://:8080//icescrum

I tried changing the config file but iceScrum won’t startup.

Any help is appreciated. Thank you very much!

[Nicolas Noullet]

Hello,

To change the iceScrum URL, you must update the configuration in two places:
– iceScrum config.groovy: update (or define) the grails.serverUrl setting
– Tomcat configuration

In think there are several ways to configure Tomcat to do what you want. You can do so in server.xml. Please note that this require a basic understanding of how tomcat works (I recommend reading the official documentation https://tomcat.apache.org/tomcat-7.0-doc/config/context.html).

Here is an example of Host config in server.xml to use http://localhost:8080/foobar/icescrum:

unpackWARs="true" autoDeploy="false" deployOnStartup="false">



...

If you want to achieve more complicated things then you will have to dive into the Tomcat configuration or use a reverse proxy.

[Kagilum]

Thank you very much for the reply.

I tried changing the following:

config.groovy: http://:8080//icescrum
server.xml: added (does not exist by default)

When I restarted iceScrum, Start/Stop and Restart buttons were disabled.

[Nicolas Noullet]

Changing the context manually breaks the conventions enforced in the iceScrum Server configuration so unfortunately this change will not work.

If you want to keep using iceScrum Server, I recommend that you revert your changes (both config.groovy and server.xml) and restart iceScrum Server. If iceScrum doesn’t start properly then check the content of C:UsersyourUserNameAppDataLocalKagilumiceScrum Servertomcatwebapps and if there are other files than icescrum.war and other folders than icescrum then you can remove them.

The only URL customization that will work in iceScrum Server is changing the application name from icescrum to another, e.g. scrum. To do so, you will only have to change the URL in iceScrum Server, (e.g. http://:8080/scrum) and the application takes care of changing the appropriate settings. Don’t change it manually in the config.groovy file.

The point of iceScrum Server is to allow using iceScrum without needing to install everything manually. This can be useful to evaluate iceScrum if you don’t have the time or the knowledge required to set up a proper Tomcat environment. However for actual enterprise / production needs, custom settings are required rather than enforced ones. In this case, as indicated in the documentation: https://www.icescrum.com/documentation/icescrum-server/#advanced-usage_1, a custom Tomcat installation will do a far better job than iceScrum Server.

Finally, please note that even in a regular Tomcat install, adding the Context like you did is not sufficient. Indeed, if the docBase refers to a .war in the Host appBase then you need to set autoDeploy=”false” deployOnStartup=”false” on the Host to prevent double deployment, as indicated in the Tomcat documentation.

[Author]

Posts