Lucee

From Hostek.com Wiki
Revision as of 02:47, 30 June 2015 by Jakeh (Talk | contribs) (Added troubleshooting section and workaround for Web Admin login issue)

Jump to: navigation, search

Luceelogo.png

Lucee is an open-source CFML engine and the successor of Railo. We proudly support Lucee in our environment, and more info about its background and usage is below.

Background

The Lucee project was forked from Railo 4.2 in January 2015 and is owned by Lucee Association Switzerland. Though development on Railo has halted, Lucee will eventually inherit the enhancements planned for Railo 5. Currently Lucee operates the same as the latest available version of Railo, so you can migrate your Railo codebase to it without any surprises.

See these blogs for more info on the switch from Railo to Lucee:

Usage / Resources

For information about Lucee please reference the Lucee wiki. Specifically, the Lucee Cookbook has lots of good info about getting started.

If you're new to CFML in general, the following resources will help you get learn the basics:

How do I access my Lucee Web Administator page?

The preferred way to access your site's Lucee Web Administrator is by clicking the Web Administrator link within your control panel. Alternatively, you may access it by appending /lucee/admin/web.cfm to the end of your site's domain name or testing URL.

I'm redirected to another page on my site when accessing the Lucee Web Administrator

If your site uses rewrite rules to make your site's links search-engine-friendly, then you'll need to make a small adjustment to your rewrite rules. Add the following line to your site's .htacess file to allow your Lucee Web Administrator to load properly:

RewriteEngine On
 
RewriteCond %{REQUEST_URI} !^.*/(lucee)($|/.*$) [NC]
RewriteRule ^(.*)$ - [NC,L]

That code will tell the rewrite engine to ignore requests that contain the word lucee. If your site already has a similar RewriteCond in its .htacess file (common with CF Wheels or ColdBox), then just add lucee to the list of URIs to bypass.

How do I create a datasource within Lucee?

You may create Lucee datasources (DSNs) either withing your site's Lucee Web Administrator or within the site's Application.cfc. More info on creating Lucee datasources is in this Lucee Cookbook entry: How to define a Datasource

Troubleshooting Lucee Errors

Lucee Web Admin - The DNS for this domain is not pointed to this server

Error:
When accessing the Lucee Web Admin via the cPanel plugin, you receive this error:

   The DNS for this domain is not pointed to this server. Please check the DNS settings to make sure it is pointed to the correct IP. 

Solution:
Wait for a moment then reload the page in your browser. This error happens when your Web Admin takes longer than expected to initialize, but reloading the page will allow the Lucee Web Admin to load as expected.