Upgrading Railo

This section describes how you can install a patch from the Railo Preview environment into an existing Railo installation. Please note that the patches available from the preview environment always contain pre releases.

Approach

Navigate to the Railo Administrator by entering the URL „/railocontext/admin.cfm“ into any browser.

Click on the Server administrator and log in.

 

Please select the option „Service/update“.

In order to update to a preview release, you can change the URL in the right part of the window to http://preview.getrailo.org (do not forget to change this URL at the end of the update back to http://www.getrailo.org) and confirm the change by hitting the ‘update’ button.

If a patch from the set URL is available, Railo will display an edit field containing the changes and fixes made in this patch and all patches inbetween. You may now use the 'execute update' button in order to patch your current version.

After the update has been executed and imported, the login screen reappears (it might be possible, that a blank page will be displayed. In this case just hit the refresh button of your browser. Since Railo needs to be restarted your current session will be killed and the login mask appears).

If you want to remove any updates then just click on the corresponding button 'Remove updates'.

 

Technical description

When you hit the 'execute update' button Railo downloads a file named i.e.: 3.1.0.012.rc. This file will be placed in the Railo server's patches folder. Railo then will restart the engine which implies that Railo loads the latest version of the existing .rc files. Normally the pathces folder is located in the lib folder and there inside the railo-server/patches directory.

So you might have something like /opt/soft/resin/lib/railo-server/patches.

Or under Windows: C:\Program Files\Resin\lib\railo-server\patches\.

Manual update/downgrade

If your server is behind a firewall or you do not have access to the internet for any kind of reasons, here is a guideline on how to upgrade your server to the latest release:

  • download the patch from www.getrailo.org/railo/remote/download/versionNumber/versionNumber.rc. Here some examples (they might actually not work, just check on a local server with internet access what version is currently active):
    http://www.getrailo.org/railo/remote/download/3.1.0.012/3.1.0.012.rc
    http://preview.getrailo.org/railo/remote/download/3.1.0.012/3.1.0.015.rc
  • Take the downloaded file and move it into the patches folder as described above
  • Restart either the Railo deamon or the Railo service (Windows)

If you want to downgrade an existing version of Railo just stop the deamon or service and delete the corresponding .rc file from the patches folder. After the restart, the server is downgraded.