3rd_Party_Libraries

Overview

Railo ships with a set of 3rd party libraries that help Railo perform certain tasks like connecting to databases, sending emails, logging, and more. these libraries are found in [railo-install-folder]\WEB-INF\lib

due to the risk in upgrading one piece of code without thoroughly testing its implications on the whole system, Railo's policy is to update the libraries shipped with Railo only in a major version release.

sometimes, however, you need to use a newer library than the one that shipped with Railo, in order to take advantage of bug fixes and/or new functionality.

keep in mind that if you upgrade a library you risk breaking the code that uses that library as not all libraries are 100% backward compatible, so do it judiciously and only if you must. this practice is Not recommended in a production environment.

How To Update The Libraries

in order to upgrade a library you need to follow these steps:

1. download the new version and place the jar in [railo-install-folder]\WEB-INF\lib (or any folder that is in the classpath of your servlet container)
2. disable the library with the older version. I usually do it by appending .disable to the file name so it stays in the original folder and I can easily revert my changes if needed.
3. restart Railo

Partial Library List

Name	Packaged Version	Last Known Version	Project Homepage
Apache Commons Email	1.1	1.2	http://commons.apache.org/email/
Apache Lucene	2.4.1	3.5.0	http://lucene.apache.org/
H2 Database	0.9	1.3.164	http://www.h2database.com/
jTDS	1.2.2	1.2.5	http://sourceforge.net/projects/jtds/files/
SLF4J	1.5.8	1.6.4	http://www.slf4j.org/