<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <HTML ><HEAD ><TITLE >Installing MMBase</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE=" MMBase Installation HOWTO " HREF="index.html"><LINK REL="PREVIOUS" TITLE=" Installing ImageMagick " HREF="x482.html"><LINK REL="NEXT" TITLE=" Connecting MMBase to MySQL using MySQL Connector/J " HREF="x572.html"></HEAD ><BODY CLASS="sect1" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" ><SPAN CLASS="application" >MMBase</SPAN > Installation HOWTO</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="x482.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="x572.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="sect1" ><H1 CLASS="sect1" ><A NAME="AEN502" ></A >7. Installing <SPAN CLASS="application" >MMBase</SPAN ></H1 ><P > Download the binary distribution of <SPAN CLASS="application" >MMBase</SPAN >, and the additional applications you need (i.e. <SPAN CLASS="application" >CloudContext Security</SPAN >, <SPAN CLASS="application" >Media</SPAN >, <SPAN CLASS="application" >Email</SPAN >) (see the next section), from: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="screen" > <A HREF="http://www.mmbase.org" TARGET="_top" >http://www.mmbase.org/</A > --> Download --> Releases </PRE ></FONT ></TD ></TR ></TABLE > </P ><P > <DIV CLASS="warning" ><P ></P ><TABLE CLASS="warning" WIDTH="100%" BORDER="0" ><TR ><TD WIDTH="25" ALIGN="CENTER" VALIGN="TOP" ><IMG SRC="../images/warning.gif" HSPACE="5" ALT="Warning"></TD ><TD ALIGN="LEFT" VALIGN="TOP" ><P > <SPAN CLASS="application" >MMBase</SPAN > version 1.7.2 contained a nasty bug, resulting in problems with the editwizards. The 1.7.3 release includes a bugfix for this problem. </P ></TD ></TR ></TABLE ></DIV > </P ><P > Make sure you pick out the right version for the <SPAN CLASS="application" >Java 2 <SPAN CLASS="acronym" >JDK</SPAN ></SPAN > installed on your system. You can find out the version currently installed by typing: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="programlisting" > java -version </PRE ></FONT ></TD ></TR ></TABLE > </P ><P > Extract the binary distribution of <SPAN CLASS="application" >MMBase</SPAN >, copy it into the <SPAN CLASS="application" >Tomcat</SPAN > directory, and change the ownership of the <SPAN CLASS="application" >MMBase</SPAN > directory: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="programlisting" > unzip mmbase-xxx.zip cd /usr/local/tomcat/webapps/ mkdir mmbase-webapp/ cp -R .../mmbase-x.x.x/mmbase-webapp/* ./mmbase-webapp/ chown -R tomcat:tomcat ./mmbase-webapp/ </PRE ></FONT ></TD ></TR ></TABLE > </P ><P > <DIV CLASS="warning" ><P ></P ><TABLE CLASS="warning" WIDTH="100%" BORDER="0" ><TR ><TD WIDTH="25" ALIGN="CENTER" VALIGN="TOP" ><IMG SRC="../images/warning.gif" HSPACE="5" ALT="Warning"></TD ><TD ALIGN="LEFT" VALIGN="TOP" ><P > Installing <SPAN CLASS="application" >MMBase</SPAN > version 1.7 on <SPAN CLASS="application" >Tomcat</SPAN > version 5 resulted in version incompatibilities: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="programlisting" > FATAL org.mmbase.servlet.MMBaseStartThread - Could not find the MMBase module!Class javax/servlet/http/HttpServletResponse violates loader constraints </PRE ></FONT ></TD ></TR ></TABLE > </P ><P > We had to disable the <SPAN CLASS="systemitem" >RMMCI</SPAN > library to get this installation up and running: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="programlisting" > mv /usr/local/tomcat/webapps/web-app/WEB-INF/lib/mmbase-rmmci.jar \ /usr/local/tomcat/webapps/web-app/WEB-INF/lib/mmbase-rmmci.jar.org </PRE ></FONT ></TD ></TR ></TABLE > </P ></TD ></TR ></TABLE ></DIV > </P ><P > For <SPAN CLASS="application" >MMBase</SPAN > version 1.7 running on <SPAN CLASS="application" >Tomcat</SPAN > version 5, enable the <SPAN CLASS="systemitem" >Xerces</SPAN > libraries: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="programlisting" > mv /usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/lib/xalan.renametojar \ /usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/lib/xalan.jar mv /usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/lib/xerces.renametojar \ /usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/lib/xerces.jar mv /usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/lib/xml-apis.renametojar \ /usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/lib/xml-apis.jar </PRE ></FONT ></TD ></TR ></TABLE > Or you will have fatal errors like: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="programlisting" > FATAL org.mmbase.servlet.MMBaseStartThread - Could not find the MMBase module!org/apache/xpath/XPathAPI </PRE ></FONT ></TD ></TR ></TABLE > </P ><P > For <SPAN CLASS="application" >MMBase</SPAN > version 1.6 running on <SPAN CLASS="application" >Tomcat</SPAN > version 4, replace the <SPAN CLASS="application" >Tomcat</SPAN > <SPAN CLASS="systemitem" >Xerces</SPAN > libraries by those coming with <SPAN CLASS="application" >MMBase</SPAN >: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="programlisting" > mv -i /usr/local/tomcat/common/endorsed/xercesImpl.jar ~/ mv -i /usr/local/tomcat/common/endorsed/xmlParserAPIs.jar ~/ cp /usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/lib/xalan.jar \ /usr/local/tomcat/common/endorsed/ chown tomcat:tomcat /usr/local/tomcat/common/endorsed/xalan.jar chmod 644 /usr/local/tomcat/common/endorsed/xalan.jar cp /usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/lib/xerces.jar \ /usr/local/tomcat/common/endorsed/ chown tomcat:tomcat /usr/local/tomcat/common/endorsed/xerces.jar chmod 644 /usr/local/tomcat/common/endorsed/xerces.jar cp /usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/lib/xml-apis.jar \ /usr/local/tomcat/common/endorsed/ chown tomcat:tomcat /usr/local/tomcat/common/endorsed/xml-apis.jar chmod 644 /usr/local/tomcat/common/endorsed/xml-apis.jar </PRE ></FONT ></TD ></TR ></TABLE > </P ><P > <DIV CLASS="tip" ><P ></P ><TABLE CLASS="tip" WIDTH="100%" BORDER="0" ><TR ><TD WIDTH="25" ALIGN="CENTER" VALIGN="TOP" ><IMG SRC="../images/tip.gif" HSPACE="5" ALT="Tip"></TD ><TD ALIGN="LEFT" VALIGN="TOP" ><P > If you will not be using an <SPAN CLASS="application" >Apache</SPAN > <SPAN CLASS="acronym" >JK 2</SPAN > mapping or reverse proxy (see further <A HREF="jk2.html" >below</A >) as a front-end to your <SPAN CLASS="application" >MMBase</SPAN > server, you can add to the file <TT CLASS="filename" >/usr/local/tomcat/conf/server.xml</TT >: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="programlisting" > <Context path="/mmbase" docBase="/usr/local/tomcat/webapps/mmbase-webapp" debug="0"> <!-- if you want symlinks to work: --> <Resources className="org.apache.naming.resources.FileDirContext" allowLinking="true" /> </Context> </PRE ></FONT ></TD ></TR ></TABLE > </P ><P > This will allow you to access your <SPAN CLASS="application" >MMBase</SPAN > server using (replace <TT CLASS="replaceable" ><I ><hostname></I ></TT > with your hostname): <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="programlisting" > http://<hostname>:8080/mmbase </PRE ></FONT ></TD ></TR ></TABLE > </P ><P > instead of: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="programlisting" > http://<hostname>:8080/mmbase-webapp </PRE ></FONT ></TD ></TR ></TABLE > </P ></TD ></TR ></TABLE ></DIV > </P ><P > Check if the <SPAN CLASS="application" >ImageMagick</SPAN > <B CLASS="command" >convert</B > tool is in your path: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="programlisting" > which convert </PRE ></FONT ></TD ></TR ></TABLE > </P ><P > If not, add it to <TT CLASS="filename" >/usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/config/applications/Resources/builders/images.xml</TT >. For example: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="programlisting" > <property name="ImageConvert.ConverterCommand">/usr/bin/X11/convert</property> </PRE ></FONT ></TD ></TR ></TABLE > </P ><P > Make sure that the directory <TT CLASS="filename" >/usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/config/builders/applications</TT > is writable by the servlet engine user (for auto-installing builders): <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="programlisting" > chown tomcat:tomcat /usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/config/builders/applications chmod 775 /usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/config/builders/applications </PRE ></FONT ></TD ></TR ></TABLE > </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="x482.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="x572.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Installing <SPAN CLASS="application" >ImageMagick</SPAN ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" > </TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Connecting <SPAN CLASS="application" >MMBase</SPAN > to <SPAN CLASS="application" >MySQL</SPAN > using <SPAN CLASS="systemitem" >MySQL Connector/J</SPAN ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >