785 lines
12 KiB
HTML
785 lines
12 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
> Installing MMBase
|
|
additional applications
|
|
</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="
|
|
Connecting MMBase
|
|
to MySQL
|
|
using MySQL Connector/J
|
|
"
|
|
HREF="x572.html"><LINK
|
|
REL="NEXT"
|
|
TITLE="
|
|
Configuring initial
|
|
MMBase settings
|
|
"
|
|
HREF="x719.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="x572.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="center"
|
|
VALIGN="bottom"
|
|
></TD
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="right"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="x719.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"></DIV
|
|
><DIV
|
|
CLASS="sect1"
|
|
><H1
|
|
CLASS="sect1"
|
|
><A
|
|
NAME="AEN634"
|
|
></A
|
|
>9. Installing <SPAN
|
|
CLASS="application"
|
|
>MMBase</SPAN
|
|
>
|
|
additional applications</H1
|
|
><P
|
|
> With the release of version 1.7
|
|
<SPAN
|
|
CLASS="application"
|
|
>MMBase</SPAN
|
|
>
|
|
was reworked into a more modular structure.
|
|
The developers decided to take several modules
|
|
(i.e. <SPAN
|
|
CLASS="application"
|
|
>CloudContext Security</SPAN
|
|
>,
|
|
<SPAN
|
|
CLASS="application"
|
|
>Media</SPAN
|
|
>,
|
|
<SPAN
|
|
CLASS="application"
|
|
>Email</SPAN
|
|
>)
|
|
from the <SPAN
|
|
CLASS="application"
|
|
>MMBase</SPAN
|
|
> tree,
|
|
and make these available as separate entities.
|
|
However, at this moment
|
|
<SPAN
|
|
CLASS="application"
|
|
>MMBase</SPAN
|
|
>
|
|
doesn't have a module interface at all.
|
|
So, to use these additional applications,
|
|
the library and other files need to be placed into the installation tree
|
|
and the configuration needs to be added into the existing configuration files
|
|
by hand.
|
|
</P
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN644"
|
|
></A
|
|
>9.1. Installing
|
|
the <SPAN
|
|
CLASS="application"
|
|
>CloudContext Security</SPAN
|
|
> module</H2
|
|
><P
|
|
> >From the <SPAN
|
|
CLASS="application"
|
|
>MMBase</SPAN
|
|
> website
|
|
(<A
|
|
HREF="http://www.mmbase.org"
|
|
TARGET="_top"
|
|
>www.mmbase.org</A
|
|
>):
|
|
<A
|
|
NAME="AEN650"
|
|
></A
|
|
><BLOCKQUOTE
|
|
CLASS="BLOCKQUOTE"
|
|
><P
|
|
> <SPAN
|
|
CLASS="QUOTE"
|
|
>"<SPAN
|
|
CLASS="application"
|
|
>Cloud security</SPAN
|
|
>
|
|
uses the object <SPAN
|
|
CLASS="systemitem"
|
|
>mmbaseuser</SPAN
|
|
>
|
|
to store information used for authorisation and authentication of users.
|
|
The two main advantages of this security implementation are
|
|
that the user administration can be carried out by using a webbrowser
|
|
(instead of editing a file on the filesystem) and
|
|
that the users of your
|
|
<SPAN
|
|
CLASS="application"
|
|
>MMBase</SPAN
|
|
> installation
|
|
are available as objects in the cloud.
|
|
For instance, it is possible to create groups of users,
|
|
which are allowed to carry out certain tasks."</SPAN
|
|
>
|
|
</P
|
|
><P
|
|
> <SPAN
|
|
CLASS="QUOTE"
|
|
>"A context exists of a set of rights
|
|
which describe what you can do within this context
|
|
with an object of
|
|
<SPAN
|
|
CLASS="application"
|
|
>MMBase</SPAN
|
|
>.
|
|
For example you define read access to a the context
|
|
which is used by anonymous visitors of your site and
|
|
you can define a context with edit rights for registered users of your site.
|
|
"</SPAN
|
|
>
|
|
</P
|
|
></BLOCKQUOTE
|
|
>
|
|
</P
|
|
><P
|
|
> Move the library and other files of
|
|
the <SPAN
|
|
CLASS="application"
|
|
>CloudContext Security</SPAN
|
|
> module
|
|
into the <SPAN
|
|
CLASS="application"
|
|
>MMBase</SPAN
|
|
> installation tree:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>
|
|
mv -i web-app/WEB-INF/lib/* \
|
|
/usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/lib/
|
|
mv -i web-app/WEB-INF/config/applications/* \
|
|
/usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/config/applications/
|
|
mv -i web-app/WEB-INF/config/builders/* \
|
|
/usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/config/builders/
|
|
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><P
|
|
> Save the documentation files for later reference:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>
|
|
mv -i web-app/README.txt web-app/README-PACKAGE.txt web-app/documentation web-app/src \
|
|
/usr/local/tomcat/webapps/mmbase-webapp/mmdocs/security/
|
|
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><P
|
|
> Make sure all these new files are owned by
|
|
your <SPAN
|
|
CLASS="systemitem"
|
|
>tomcat</SPAN
|
|
> user as well:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>
|
|
chown -R tomcat:tomcat /usr/local/tomcat/webapps/mmbase-webapp
|
|
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><P
|
|
> Disable the existing configuration
|
|
in the security configuration file
|
|
<TT
|
|
CLASS="filename"
|
|
>/usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/config/security/security.xml</TT
|
|
>:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>
|
|
<!--
|
|
<authentication class="org.mmbase.security.implementation.context.ContextAuthentication" url="context/config.xml" />
|
|
-->
|
|
...
|
|
<!--
|
|
<authorization class="org.mmbase.security.implementation.context.ContextAuthorization" url="context/config.xml" />
|
|
-->
|
|
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><P
|
|
> And add
|
|
(from <TT
|
|
CLASS="filename"
|
|
>web-app/WEB-INF/config/security/security.xml</TT
|
|
>):
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>
|
|
<!--
|
|
Example security.xml to switch on Cloud Context Security.
|
|
No other configuration needed
|
|
(Cloud Context Security is configured in the cloud)
|
|
@version $Id: security.xml,v 1.1 2003/06/17 16:44:01 michiel Exp $
|
|
-->
|
|
<authentication class="org.mmbase.security.implementation.cloudcontext.Authenticate" url="" />
|
|
<authorization class="org.mmbase.security.implementation.cloudcontext.Verify" url="" />
|
|
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><P
|
|
> <DIV
|
|
CLASS="note"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="note"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/note.gif"
|
|
HSPACE="5"
|
|
ALT="Note"></TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> Make sure to include the configuration above before
|
|
the <TT
|
|
CLASS="classname"
|
|
><sharedsecret></TT
|
|
> statement,
|
|
or you will get an error like this:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>
|
|
ERROR org.mmbase.util.XMLErrorHandler - security.xml line:71 column:12:
|
|
The content of element type "security" must match "(authentication,authorization,sharedsecret)".
|
|
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
>
|
|
</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN679"
|
|
></A
|
|
>9.2. Installing
|
|
the <SPAN
|
|
CLASS="application"
|
|
>Media</SPAN
|
|
> module</H2
|
|
><P
|
|
> <TODO>
|
|
</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN683"
|
|
></A
|
|
>9.3. Installing
|
|
the <SPAN
|
|
CLASS="application"
|
|
>Email</SPAN
|
|
> module</H2
|
|
><P
|
|
> The <SPAN
|
|
CLASS="application"
|
|
>Email</SPAN
|
|
> module
|
|
makes it possible to send email
|
|
with <SPAN
|
|
CLASS="application"
|
|
>MMBase</SPAN
|
|
>,
|
|
using either <SPAN
|
|
CLASS="systemitem"
|
|
>SendMail</SPAN
|
|
>
|
|
or <SPAN
|
|
CLASS="systemitem"
|
|
>JMSendMail</SPAN
|
|
>.
|
|
</P
|
|
><P
|
|
> Move the library and other files of
|
|
the <SPAN
|
|
CLASS="application"
|
|
>Email</SPAN
|
|
> module
|
|
into the <SPAN
|
|
CLASS="application"
|
|
>MMBase</SPAN
|
|
> installation tree:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>
|
|
mv -i web-app/WEB-INF/lib/* \
|
|
/usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/lib/
|
|
mv -i web-app/WEB-INF/config/builders/* \
|
|
/usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/config/builders/
|
|
mkdir /usr/local/tomcat/webapps/mmbase-webapp/email-examples/
|
|
cp -iR web-app/examples/* \
|
|
/usr/local/tomcat/webapps/mmbase-webapp/email-examples/
|
|
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><P
|
|
> Save the documentation files for later reference:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>
|
|
mkdir /usr/local/tomcat/webapps/mmbase-webapp/mmdocs/email/
|
|
mv -i web-app/README.txt web-app/README-PACKAGE.txt web-app/documentation web-app/src \
|
|
/usr/local/tomcat/webapps/mmbase-webapp/mmdocs/email/
|
|
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><P
|
|
> Make sure all these new files are owned by
|
|
your <SPAN
|
|
CLASS="systemitem"
|
|
>tomcat</SPAN
|
|
> user as well:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>
|
|
chown -R tomcat:tomcat /usr/local/tomcat/webapps/mmbase-webapp
|
|
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><P
|
|
> Edit the email configuration file
|
|
<TT
|
|
CLASS="filename"
|
|
>/usr/local/tomcat/webapps/mmbase-webapp/WEB-INF/config/modules/sendmail.xml</TT
|
|
>
|
|
(from <TT
|
|
CLASS="filename"
|
|
>web-app/WEB-INF/config/modules/sendmail.xml</TT
|
|
>):
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>
|
|
...
|
|
<status>active</status>
|
|
...
|
|
<classfile>org.mmbase.applications.email.SendMail</classfile>
|
|
...
|
|
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><P
|
|
> Add to <SPAN
|
|
CLASS="application"
|
|
>Tomcat</SPAN
|
|
>'s
|
|
root <TT
|
|
CLASS="classname"
|
|
>Context</TT
|
|
>
|
|
(in /usr/local/tomcat/conf/context.xml for Tomcat version 5,
|
|
in /usr/local/tomcat/conf/server.xml for Tomcat version 4)
|
|
(replace <smtp.domain.tld> with the adres of your
|
|
<SPAN
|
|
CLASS="systemitem"
|
|
><SPAN
|
|
CLASS="acronym"
|
|
>SMTP</SPAN
|
|
> server</SPAN
|
|
>):
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>
|
|
Resource name="mail/Session" auth="Container"
|
|
type="javax.mail.Session"/>
|
|
<ResourceParams name="mail/Session">
|
|
<parameter>
|
|
<name>mail.smtp.host</name>
|
|
<value>smtp.domain.tld</value>
|
|
</parameter>
|
|
</ResourceParams>
|
|
<ResourceLink name="linkToGlobalResource"
|
|
global="simpleValue"
|
|
type="java.lang.Integer"/>
|
|
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
><P
|
|
> Failing to do this, results in a fatal error:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>
|
|
FATAL org.mmbase.module.JMSendMail -
|
|
JMSendMail failure: Name mail is not bound in this Context
|
|
|
|
</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 the <SPAN
|
|
CLASS="application"
|
|
>Email</SPAN
|
|
> module
|
|
in <SPAN
|
|
CLASS="application"
|
|
>MMBase</SPAN
|
|
> version 1.7
|
|
running on <SPAN
|
|
CLASS="application"
|
|
>Tomcat</SPAN
|
|
> version 5
|
|
resulted in a fatal error:
|
|
<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!javax/mail/Session
|
|
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
>
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
>
|
|
</P
|
|
></DIV
|
|
></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="x572.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="x719.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
>Connecting <SPAN
|
|
CLASS="application"
|
|
>MMBase</SPAN
|
|
>
|
|
to <SPAN
|
|
CLASS="application"
|
|
>MySQL</SPAN
|
|
>
|
|
using <SPAN
|
|
CLASS="systemitem"
|
|
>MySQL Connector/J</SPAN
|
|
></TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>Configuring initial
|
|
<SPAN
|
|
CLASS="application"
|
|
>MMBase</SPAN
|
|
> settings</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |