Creating ‘vhosts’ when setting up a Lucee dev environment

Previously when setting up a dev environment using Adobe Coldfusion I would set up multiple development sites on the same Coldfusion install using Apache vhosts. There are other ways to do this using vms or containers, but I find keeping a local dev environment as simple as possible works best for me. If the sites are all Coldfusion, I put them together in one install. (If I’m working with a different technology, then its time to set up a separate dev environment for that, just not a new environment per-site.)

Once I moved to Lucee development, I wanted to replicate the same sort of thing using Apache Tomcat. The problem I had was that Tomcat doesn’t call them “vhosts” so it took a while to Google the correct term!

The following process is how I set up multiple dev sites under one Lucee install:

Step 1)

First, we will need to edit the server.xml file.  This file is located here for me:
But it might also be located here: /data/lucee/tomcat/conf/server.xml
The server.xml file may be in a slightly different place for you, but its always in the conf directory.

Add the following XML inside the “<Engine>” section

<Host name="YOUR_DOMAIN_NAME" appBase="webapps"
unpackWARs="true" autoDeploy="true" >
<Context path="" docBase="PATH_TO_WEBROOT" />
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="access_log" suffix=".txt"
pattern="%h %l %u %t &quot;%r&quot; %s %b" />

Step 2)

Update your hosts file with YOUR_DOMAIN_NAME so that your browser will point to your local server instead of going out to the internet.

To your hosts file, add the entry: YOUR_DOMAIN_NAME

Step 3)

restart Lucee


Go to your browser and type “http://YOUR_DOMAIN_NAME”  Lucee should respond with the content in the PATH_TO_WEBROOT directory.  You may need to add a port # if your install of Lucee is configured to run on something other than port 80. My environment is configured to use port 8888 so I would need to type “http://YOUR_DOMAIN_NAME:8888

How to Turn on Server-side AD Authentication for Lucee

Here’s the instructions I use whenever I need to remember how to set up server-side Active Directory authentication on a Lucee server. These are really instructions for Apache Tomcat, which Lucee uses as its web server.

Step 1)

Define a global “Realm” that contains the LDAP config info.

We will need to edit the server.xml file.  This file is located here for me:
But it might also be located here: /data/lucee/tomcat/conf/server.xml
The server.xml file may be in a slightly different place for you, but its always in the conf directory.

Add the following XML inside the “<Engine>” section

<Realm className="org.apache.catalina.realm.JNDIRealm"

Your own AD creds should work for testing, but for production you should set up a service account to make this connection

Step 2)

Now that we have an LDAP Realm defined we need to tell the website to turn on basic authentication

Create an WEB-INF/web.xml file below your web root and stick all of the following XML in there:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="" xmlns="" xsi:schemaLocation="" id="WebApp_ID" version="3.1">

Step 3)

Restart lucee


Now, the user will be prompted to log in to the server using their AD credentials before hitting the website. The username will be in the cgi variables if the website needs this information.

If you need to turning on LDAP logging:

Step 1)

org.apache.catalina.realm.level = ALL
org.apache.catalina.realm.useParentHandlers = true
org.apache.catalina.authenticator.level = ALL
org.apache.catalina.authenticator.useParentHandlers = true

to /data/lucee/tomcat/conf/

Step 2)

to the end of your Realm like this:

<Realm className="org.apache.catalina.realm.JNDIRealm"


Jar Aquarium – Mystery Of The Rising Water Solved

Since setting up the jar aquarium two weeks ago the water level in the jar has been rising. I removed water multiple times to lower it back but it kept overflowing which had me very befuddled last week. I even marked the neck of the bottle with the height of the water at different times of the day. The water does go up when the sun warms the bottle, but it does not return to the starting point the next morning. It slowly continues to rise.

But I think I finally figured out the cause. Can you see it in the image below?

Bubbles. There is a large amount of gas trapped beneath the mud. These bubbles are created during the process that is breaking down the decaying plant life within the muck. The process probably goes faster when the sun hits warms the muck.

In the image above you can also see the tunnels that the worms have been making in the mud. I haven’t been able to capture a good photo of them.

I gave the bottle a good jolt and tons of bubbles streamed to the surface. Releasing the built up gas lowered the water level nearly back to its starting point.

Jar Aquarium – One Week Update

After one week the water in the jar aquarium has cleared up and now you can see everything that happens with the jar. Which isn’t much. The tiny insects that were swimming around the top of the jar seemed to have died off. There is still one worm that I suspect is really a leech.

It remains to be seen if the plants will continue to grow. Some of them are starting to look a little brown.

But despite lack of life, the jar aquarium does still have something I’ve been watching daily. There’s a mystery to the jar that I’m trying to solve. The water level keeps rising.

At first I thought it was just heat expansion. The jar does get some direct sun. But the water doesn’t seem to move much during the day. After reducing the water back down to its original levels three times and then finding that the water had again risen to the top of the jar I’m not sure what is going on.

We all know about the Conservation of Mass right? Matter cannot be created or destroyed it just changes form. I expected some movement due to heat expansion, but I thought it would go up and down with the temperature. I also expected all the plants and dead stuff in the mud to create methane and other gases that would bubble up. So far, no gas bubbles, but the water keeps rising. Something within the jar is increasing in volume. Could it really be just the water heating up?

What do you think? Put your ideas in the comments!

Update: Mystery Of The Rising Water Solved?

Getting The Honey Bees Ready For Winter

I checked in on the bees today to get them ready for winter.

First removed one of the boxes that had a hole in the corner. The bees seemed to love the extra entrance during the summer, but that hole would’ve let the cold in all winter so it had to go. The bees were very upset I was moving their honey around.

I scraped off some extra comb and got a little treat for myself.

There wasn’t much brood in the hive, which is a little worrying since most of the current bees will die soon and the bees that hatch out now have to survive all winter and keep the queen warm. That’s another thing that concerns me a little: I didn’t see the queen bee. I don’t always find her but I would’ve liked to confirm that she’s still alive before the winter. The bees were already getting angry with me so I did what I had to and got out as quick as possible.

I gave them their fall mite treatment and closed the hive back up.

Last thing I did was put the reducer in the entrance way. That will also help keep the cold out.

That’s it for today. Next time I check on the hive I will put a cork in the top entrance, and change the reducer to he smallest opening, again to keep out the cold. For now the fall has been very mild so I will leave it until we stay below freezing at night.

Jar Aquarium – First Twenty-Four Hours

I filled a one gallon jug one-third full of muck from the swamp then filled the rest with the swamp water and added some aquatic plants for good measure. When I was done it looked like this:

After twenty-four hours the water had cleared up a lot and now looked like this:

There’s even a few critters swimming around the top:

I’m hoping it will clear up even more this week and the plants will start to grow to create a self-sufficient ecosystem.

Linux Mint – Min, Max, & Close Buttons Disappeared

Recently I installed LinCity, a sim-city clone, on Linux Mint. It didn’t run, so I uninstalled it.  After uninstalling the package, my minimize, maximize, and close buttons disappeared on all my windows.  It wasn’t just that. My mouse cursor became a big “X” and right-click stopped working!

I knew some setting had changed during the uninstall but I wasn’t sure what it was.  A quick Google search showed results from 2012 which didn’t seem to apply to my version of Linux Mint. I tried them anyway with no success. Another poster said they had luck re-installing some of the core packages.  I tried re-installing all of the GNOME and Cinnamon packages that were already installed. That did nothing.

Eventually under “Preferences” I found the “Desktop Settings” application.  In that app, under “Windows” I discovered that my Windows Manager setting was blank.  I set it to “Metacity” and bam! everything started working again.  I tried switching to Compiz, but then all my buttons disappeared again.  Luckily there’s a “Reset Compiz Setttings” button on the same screen. After pressing that my desktop was back to normal.

Not sure why this happened, but hopefully this post helps someone else!