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>&lt;context-root&gt;</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>