Home

The lang/lucee/v6 port

lucee-6.0.3.1 – JVM-based scripting language for web apps (open-source CFML) (cvsweb github mirror)

Description

Lucee is a light-weight dynamic scripting language for the JVM that
enables the rapid development of simple to highly sophisticated web
applications. Lucee is fully compatible with the CFML Script and Tag
Language.

Lucee is a JVM language and runs on the JVM as a servlet and will work
with any servlet container (e.g. Apache Tomcat, Eclipse Jetty) or
application server (e.g. JBoss AS, GlassFish). This package is setup
to run Lucee under Tomcat.
WWW: https://lucee.org/

Readme

+-----------------------------------------------------------------------
| Running ${PKGSTEM} on OpenBSD
+-----------------------------------------------------------------------

Configuring Tomcat to support Lucee
===================================
Lucee is a Java-based CFML engine. It runs as a servlet in a container;
this package is designed to work with the Apache Tomcat servlet container,
you will need to make a few configuration changes to tomcat to use it.
If you have not yet modified Tomcat's configuration, this readme includes
a patch which can be used:

	# patch -d ${CATALINA_BASE}/conf < \
	    ${LOCALBASE}/share/doc/pkg-readmes/${PKGSTEM}

Then skip to the next section in this file, "Starting the service
and online configuration".

If you have already modified Tomcat's configuration and need to edit
manually, there are two possible ways to proceed.

1. Insert the contents of ${PREFIX}/conf/web-lucee.xml in Tomcat's
${CATALINA_BASE}/conf/web.xml file. This will need to be kept up-to-date
with future Lucee releases.

 -or-

2. Modify Tomcat configuration to include web-lucee.xml itself; this is
the method used by the patch below, initial setup is slightly more complex
but ongoing maintenance is reduced.

   a) Change the  line in ${CATALINA_BASE}/conf/context.xml to read
      .

   b) Add lines after the first  line at the top of
      ${CATALINA_BASE}/conf/web.xml, so it looks like this:

   
   
   ]>

   c) Towards the bottom of web.xml, add the CFML-related file extensions
      to the  section:

	
	    index.cfm
	    index.html
	    index.htm
	    index.jsp
	

   d) Add "&lucee;" at the bottom of the  section to include
      the "lucee" xml entity defined above. This tells Tomcat to include
      the contents of the web-lucee.xml file containing the Lucee-related
      settings.

	&lucee;
	

Starting the service and online configuration
=============================================

# rcctl enable tomcat

- If you need to set JVM options you can do so like this:
# rcctl set tomcat flags -Xms256m -Xmx1024m -XX:MaxPermSize=128m

# rcctl restart tomcat

- Connect to the administration pages. At first run of a successful new
installation, you will need to set a password by writing a file
(${CATALINA_BASE}/lucee/config/server/lucee-server/context/password.txt)
and importing it.

	http://localhost:8080/lucee/admin/

- The package places the default "welcome" pages in a separate directory,
${CATALINA_BASE}/webapps/lucee-default; copy them to ${CATALINA_BASE}/webapps/ROOT
if you want to see them when you connect to http://localhost:8080/.

- Reference documentation is available at http://localhost:8080/lucee/doc/.

- You can add pages to /var/tomcat/webapps/ROOT to be used for "localhost".
Additional host configurations can be added to ${CATALINA_BASE}/conf/server.xml.
Use the localhost configuration as a template; the _tomcat user will need to be
able to write to /ROOT/WEB-INF, so set ownership and permissions
accordingly.

- Log files are kept in several locations. Consult them if things don't work
as expected, and don't forget to rotate/archive them as appropriate.

	${CATALINA_BASE}/logs
	${CATALINA_BASE}/lucee/config/server/lucee-server/context/logs
	${CATALINA_BASE}/lucee/config/web/*/logs (various dirs, per-context)

Patch to unmodified Tomcat sample configuration
===============================================

--- context.xml.orig	Sat Jun 29 13:13:37 2019
+++ context.xml	Sat Jun 29 13:13:37 2019
@@ -16,7 +16,7 @@
   limitations under the License.
 -->
 
-
+
 
     
     
--- web.xml.orig	Sat Jun 29 13:13:37 2019
+++ web.xml	Sat Jun 29 13:13:37 2019
@@ -1,4 +1,8 @@
 
+
+]>
+
 
 
     
+        index.cfm
         index.html
         index.htm
         index.jsp
     
 
+&lucee;
 

Maintainer

Stuart Henderson

Categories

lang www

Build dependencies

Run dependencies

Files

Search