1:14 a.m.
Author: mmcallis
Date: 2008-07-09 02:14:53 -0400 (Wed, 09 Jul 2008)
New Revision: 11359
Added:
docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/modules/extras/email_mbean.xmlt
Modified:
docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/modules/configuration.xml
Log:
- code highlighting
- adding email_mbean.xmlt configuration to allow
correct highlighting for the "3.4. Configuring the Email Service"
example
Modified:
docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/modules/configuration.xml
===================================================================
---
docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/modules/configuration.xml 2008-07-09
05:25:45 UTC (rev 11358)
+++
docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/modules/configuration.xml 2008-07-09
06:14:53 UTC (rev 11359)
@@ -53,7 +53,7 @@
<orderedlist>
<listitem>
<para>Open the
<emphasis>$JBOSS_HOME/server/default/deploy/jboss-portal.sar/portal-server.war/WEB-INF/jboss-web.xml</emphasis>
file. If this file does not exist, copy and save the following example:
-<programlisting role="XML"><![CDATA[
+<programlisting><![CDATA[
<?xml version="1.0"?>
<jboss-web>
<security-domain>java:jaas/portal</security-domain>
@@ -73,9 +73,9 @@
<computeroutput><context-root></computeroutput> element with the
desired context path:
</para>
<para>
-<screen>
+<programlisting>
<![CDATA[<context-root>/testing</context-root>]]>
-</screen>
+</programlisting>
</para>
<para>
Using this example, the main JBoss Portal page would be reached by navigating to
<emphasis>http://localhost:8080/testing</emphasis>.
@@ -98,10 +98,10 @@
Open the <filename>build/local.properties</filename> file and edit the
<computeroutput>portal.web.context-root</computeroutput> option with the
desired context path:
</para>
<para>
-<screen>
+<programlisting>
# Context root for the portal main servlet
portal.web.context-root=/testing
-</screen>
+</programlisting>
</para>
<para>
Using this example, the main JBoss Portal page would be reached by navigating to
<emphasis>http://localhost:8080/testing</emphasis>.
@@ -128,11 +128,11 @@
context-root other than <emphasis>/</emphasis>, under the
<filename>$JBOSS_HOME/server/default/deploy/jboss-web.deployer/ROOT.war/WEB-INF/</filename>
directory, for the above changes to take affect. The following is an example
<filename>jboss-web.xml</filename> file, which changes the Apache Tomcat
context path to <computeroutput>/tomcat-root</computeroutput>:
</para>
<para>
-<screen><![CDATA[
+<programlisting><![CDATA[
<?xml version="1.0"?>
<jboss-web>
<context-root>/tomcat-root</context-root>
-</jboss-web>]]></screen>
+</jboss-web>]]></programlisting>
</para>
</sect2>
</sect1>
@@ -150,10 +150,10 @@
To modify these files to force the DB dialect, un-comment the following line from each
<filename>hibernate.cfg.xml</filename> file in each JBoss Portal module you
intend to use, so that it looks like the following:
</para>
<para>
-<screen><![CDATA[
+<programlisting><![CDATA[
<!-- Force the dialect instead of using autodetection -->
<property
name="dialect">org.hibernate.dialect.PostgreSQLDialect</property>
-]]></screen>
+]]></programlisting>
</para>
<para>
Note: this example is for a PostgreSQL database. If you use another database, you need
to modify
<computeroutput>org.hibernate.dialect.PostgreSQLDialect</computeroutput> to
reflect the correct database. For a list of supported dialects, refer to the <ulink
url="http://www.hibernate.org/hib_docs/v3/reference/en/html/session-...
list on the Hibernate website</ulink>.
@@ -176,10 +176,10 @@
Un-comment the following line, so that it looks like the following:
</para>
<para>
-<screen><![CDATA[
+<programlisting><![CDATA[
<!-- Force the dialect instead of using autodetection -->
<property
name="dialect">org.hibernate.dialect.PostgreSQLDialect</property>
-]]></screen>
+]]></programlisting>
</para>
</listitem>
</orderedlist>
@@ -190,15 +190,15 @@
</sect2>
</sect1>
<sect1 id="emailConfiguration">
- <title>Setting up the Email Service</title>
+ <title>Configuring the Email Service</title>
<para>
If you have a standard setup and a mail server installed, the email service should
work without any extra configuration. Most Linux distributions have a mail server
installed by default. The email service, for example, can be used to verify a user's
email address when a user subscribes, or for CMS workflow notifications.
</para>
<para>
The email service is configured using the
<filename>$JBOSS_HOME/server/default/deploy/jboss-portal.sar/META-INF/jboss-service.xml</filename>
file. The following is an example of the section which is used to configure the email
service:
</para>
- <para>
-<screen><![CDATA[
+<programlisting role="XML"><xi:include
href="extras/email_mbean.xmlt" parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g...
+<!-- <programlisting><![CDATA[
<mbean
code="org.jboss.portal.core.impl.mail.MailModuleImpl"
name="portal:service=Module,type=Mail"
@@ -216,8 +216,8 @@
<attribute name="SMTPTimeout">10000</attribute>
<attribute name="JNDIName">java:portal/MailModule</attribute>
</mbean>]]>
-</screen>
- </para>
+</programlisting> -->
+
<para>
A different SMTP server (other than localhost) can be configured, along with a SMTP
username and an SMTP password. The following is an example configuration that uses the
Gmail SMTP server:
</para>
Added:
docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/modules/extras/email_mbean.xmlt
===================================================================
---
docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/modules/extras/email_mbean.xmlt
(rev 0)
+++
docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/modules/extras/email_mbean.xmlt 2008-07-09
06:14:53 UTC (rev 11359)
@@ -0,0 +1,17 @@
+<mbean
+code="org.jboss.portal.core.impl.mail.MailModuleImpl"
+name="portal:service=Module,type=Mail"
+xmbean-dd=""
+xmbean-code="org.jboss.portal.jems.as.system.JBossServiceModelMBean">
+<xmbean/>
+<depends>jboss:service=Mail</depends>
+<depends>portal:service=Module,type=IdentityServiceController</depends>
+<attribute name="QueueCapacity">-1</attribute>
+<attribute name="Gateway">localhost</attribute>
+<attribute name="SmtpUser"></attribute>
+<attribute name="SmtpPassword"></attribute>
+<attribute name="JavaMailDebugEnabled">false</attribute>
+<attribute name="SMTPConnectionTimeout">100000</attribute>
+<attribute name="SMTPTimeout">10000</attribute>
+<attribute name="JNDIName">java:portal/MailModule</attribute>
+</mbean>