106 lines
3.6 KiB
Plaintext
106 lines
3.6 KiB
Plaintext
$OpenBSD: README,v 1.3 2012/04/22 11:41:55 ajacoutot Exp $
|
|
|
|
+-----------------------------------------------------------------------
|
|
| Running ${FULLPKGNAME} on OpenBSD
|
|
+-----------------------------------------------------------------------
|
|
|
|
Configuring Tomcat to support Railo
|
|
===================================
|
|
Railo 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/${FULLPKGNAME}
|
|
|
|
Then skip to the next section in this file, "Starting the service
|
|
and online configuration".
|
|
|
|
If you need to edit manually, Tomcat's ${CATALINA_BASE}/conf/web.xml file
|
|
should have these changes:
|
|
|
|
- Add lines after the first <?xml...?> line at the top of the file, so it
|
|
looks like this:
|
|
|
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
<!DOCTYPE root [
|
|
<!ENTITY railo SYSTEM "./web-railo.xml" >
|
|
]>
|
|
|
|
- Towards the bottom of web.xml, add the CFML-related file extensions
|
|
to the <welcome-file-list> section:
|
|
|
|
<welcome-file-list>
|
|
<welcome-file>index.cfm</welcome-file>
|
|
<welcome-file>index.cfml</welcome-file>
|
|
<welcome-file>index.html</welcome-file>
|
|
<welcome-file>index.htm</welcome-file>
|
|
<welcome-file>index.jsp</welcome-file>
|
|
</welcome-file-list>
|
|
|
|
- Add "&railo;" at the bottom of the </web-app> section to include the
|
|
"railo" xml entity defined above. This just includes the contents of the
|
|
web-railo.xml file containing the CF-related settings.
|
|
|
|
&railo;
|
|
</web-app>
|
|
|
|
Starting the service and online configuration
|
|
=============================================
|
|
|
|
- Start/restart tomcat:
|
|
|
|
${RCDIR}/tomcat restart
|
|
|
|
- Connect to http://localhost:8080/. If all goes well you should see the
|
|
default Railo homepage including a couple of samples and links to the
|
|
admin pages.
|
|
|
|
- Connect to the admin pages and set passwords:
|
|
|
|
http://localhost:8080/railo-context/admin/server.cfm
|
|
http://localhost:8080/railo-context/admin/web.cfm
|
|
|
|
- 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 <appBase>/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}/railo/server-config/railo-server/context/logs
|
|
${CATALINA_BASE}/railo/web-config/*/logs (various dirs, per-context)
|
|
|
|
Patch to unmodified Tomcat web.xml
|
|
==================================
|
|
|
|
--- web.xml.orig Fri Apr 20 13:16:35 2012
|
|
+++ web.xml Fri Apr 20 16:06:21 2012
|
|
@@ -1,4 +1,8 @@
|
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
+<!DOCTYPE root [
|
|
+ <!ENTITY railo SYSTEM "./web-railo.xml" >
|
|
+]>
|
|
+
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
@@ -4275,9 +4279,12 @@
|
|
<!-- to use within your application. -->
|
|
|
|
<welcome-file-list>
|
|
+ <welcome-file>index.cfml</welcome-file>
|
|
+ <welcome-file>index.cfm</welcome-file>
|
|
<welcome-file>index.html</welcome-file>
|
|
<welcome-file>index.htm</welcome-file>
|
|
<welcome-file>index.jsp</welcome-file>
|
|
</welcome-file-list>
|
|
|
|
+&railo;
|
|
</web-app>
|