I’ve been migrating a lot of older sites from old installs of Adobe Coldfusion to new servers and fresh installs of Lucee Coldfusion lately. The majority of these applications were migrated without much trouble. I’ve found that Lucee Coldfusion is also easy to keep secure and current as it has continual stable releases and monthly patches that can be installed from the admin area.
For the most part the migration to Lucee is a simple matter of installing Lucee Coldfusion, and adding the application codebase. After thoroughly testing that the application works locally I stand up a Test server and repeat the process. After passing UAT, the test server is cloned to create the production server and the datasource is re-pointed to the production db on the new production server. Finally the DNS entry is repointed to move the web traffic from the old existing server to the new server.
Below is the process I use when starting on a new migration
- Stand up a Lucee dev environment
- I’ve been moving to Linux servers at the same time as migrating to Lucee, but for now let’s assume we’re in Windows
- If you’re new to Lucee, just grab the express install from Lucee.org and install it.
- Checkout the site’s codebase into the Lucee ROOT directory.
- You are using version control right?
- I make a new branch to track any code changes needed. If your site is simple it most likely will just work. Otherwise check this list for ideas of what might need to be changed.
- Alternatively you can configure it to look at a directory other than ROOT. See this blog post
- If you may need to set up multiple Lucee dev sites you may want to read this
- If you need to turn on server side authentication read this
- Configure any datasource your site may need in the Lucee admin area.
- While you’re in the Lucee admin area install and activate the Log Analyzer plugin.
- This will allow you to view the server logs much like you would in Adobe’s CFAdmin. Very handy!
- At this point your site may just work.
- If your site works, congratulations! You can begin to validate that everything really does still works
- If not, usually you will get an error that explains what the issue is.
- For more ideas of what might be wrong: Common Issues when Migrating Existing Codebases to Lucee Coldfusion.