[jboss-svn-commits] JBoss Portal SVN: r5500 - docs/trunk/referenceGuide/en/modules
jboss-svn-commits at lists.jboss.org
jboss-svn-commits at lists.jboss.org
Wed Oct 25 11:59:20 EDT 2006
Author: roy.russo at jboss.com
Date: 2006-10-25 11:59:19 -0400 (Wed, 25 Oct 2006)
New Revision: 5500
Modified:
docs/trunk/referenceGuide/en/modules/configuration.xml
docs/trunk/referenceGuide/en/modules/tutorials.xml
Log:
Syntax changes to 2.6 referenceguide
Modified: docs/trunk/referenceGuide/en/modules/configuration.xml
===================================================================
--- docs/trunk/referenceGuide/en/modules/configuration.xml 2006-10-24 20:04:54 UTC (rev 5499)
+++ docs/trunk/referenceGuide/en/modules/configuration.xml 2006-10-25 15:59:19 UTC (rev 5500)
@@ -23,9 +23,11 @@
<title>Changing the port</title>
<para>It is common to have a server running on the port 80 instead of the default port 8080.</para>
<para>It might be easier to use
- <ulink url="http://wiki.jboss.org/wiki/Wiki.jsp?page=JBossOnPort80">port forwarding</ulink> than to change the
- port manually. Since port forwarding is not always possible, below are the instructions to change the port
- number manually.</para>
+ <ulink url="http://wiki.jboss.org/wiki/Wiki.jsp?page=JBossOnPort80">port forwarding</ulink>
+ than to change the
+ port manually. Since port forwarding is not always possible, below are the instructions to change the port
+ number manually.
+ </para>
<para>To change it, you need to edit the file
<literal>$JBOSS_HOME/server/default/deploy/jbossweb-tomcat50.sar/server.xml</literal>
and change the port value of the HTTP Connector. You can also change the value of the SSL
@@ -46,19 +48,30 @@
</para>
<para>You also need to change the port number in the following files for WSRP:
<itemizedlist>
- <listitem><literal>jboss-portal.sar/portal-wsrp.sar/default-wsrp.xml</literal></listitem>
- <listitem><literal>jboss-portal.sar/portal-wsrp-client.jar/META-INF/jboss-client.xml</literal>
- (for the producer with the <literal>self</literal> id.</listitem>
- <listitem><literal>jbossws.sar/META-INF/jboss-service.xml</literal> as indicated in
+ <listitem>
+ <literal>jboss-portal.sar/portal-wsrp.sar/default-wsrp.xml</literal>
+ </listitem>
+ <listitem>
+ <literal>jboss-portal.sar/portal-wsrp-client.jar/META-INF/jboss-client.xml</literal>
+ (for the producer with the
+ <literal>self</literal>
+ id.
+ </listitem>
+ <listitem>
+ <literal>jbossws.sar/META-INF/jboss-service.xml</literal>
+ as indicated in
<ulink url="http://wiki.jboss.org/wiki/Wiki.jsp?page=JBWSFAQURLRewriting">JBoss WS' URL rewriting
- FAQ</ulink></listitem>
+ FAQ
+ </ulink>
+ </listitem>
<listitem>http-invoker.sar/META-INF/jboss-service.xml</listitem>
</itemizedlist>
</para>
<para>Now you can restart JBoss and use the new port that you defined. On systems like Linux,
you need privileges to be able to run a server on a port lower than 1000, starting JBoss on
the port 80 as a regular user will not work, for testing you can log as root but is not
- recommended if the server is public as it could be a security breach in your system.</para>
+ recommended if the server is public as it could be a security breach in your system.
+ </para>
</sect1>
<sect1 id="configuration-contextroot">
<title>Changing the context path</title>
@@ -69,6 +82,11 @@
<literal>http://localhost:8080/index.html</literal>
.
</para>
+ <note>
+ By default, Tomcat holds on to the root context '/'. Some users have mentioned that you also need to remove the
+ <emphasis>$JBOSS_HOME\server\default\deploy\jbossweb-tomcat55.sar\ROOT.war</emphasis>
+ for the below changes to take effect on restart.
+ </note>
<para>You can accomplish this, with either a deployed jboss-portal.sar or before you build from source:
<itemizedlist>
<listitem>
@@ -78,7 +96,8 @@
<listitem>
<para>Open
<emphasis>
- JBOSS_INSTALL_DIRECTORY/server/default/deploy/jboss-portal.sar/portal-server.war/WEB-INF/jboss-web.xml</emphasis>
+ JBOSS_INSTALL_DIRECTORY/server/default/deploy/jboss-portal.sar/portal-server.war/WEB-INF/jboss-web.xml
+ </emphasis>
<programlisting><![CDATA[
<?xml version="1.0"?>
<jboss-web>
@@ -109,11 +128,15 @@
<para>
<emphasis role="bold">Source method:</emphasis>
Edit the file
- <literal>$PORTAL_HOME/build/local.properties</literal> (You can copy the file
- <literal>$PORTAL_HOME/build/etc/local.properties-example</literal> and modify it for your
- own settings.) and change <literal>portal.web.context-root</literal>
+ <literal>$PORTAL_HOME/build/local.properties</literal>
+ (You can copy the file
+ <literal>$PORTAL_HOME/build/etc/local.properties-example</literal>
+ and modify it for your
+ own settings.) and change
+ <literal>portal.web.context-root</literal>
to anything you want.
- <para>Now clean the project (ant clean) then build JBoss portal (ant) and redeploy it for the context path changes to take
+ <para>Now clean the project (ant clean) then build JBoss portal (ant) and redeploy it for the context
+ path changes to take
effect. For build instructions, please see:
<xref linkend="install_source"/>
</para>
@@ -130,11 +153,14 @@
</para>
<sect2>
<title>DB Dialect settings for the portal core</title>
- <para>Modify <emphasis>jboss-portal.sar/conf/hibernate/[module]/hibernate.cfg.xml</emphasis>. A list of supported dialects
+ <para>Modify
+ <emphasis>jboss-portal.sar/conf/hibernate/[module]/hibernate.cfg.xml</emphasis>
+ . A list of supported dialects
for Hibernate3, can be found
<ulink
- url="http://www.hibernate.org/hib_docs/v3/reference/en/html/session-configuration.html#configuration-optional-dialects"
- >here</ulink>
+ url="http://www.hibernate.org/hib_docs/v3/reference/en/html/session-configuration.html#configuration-optional-dialects"
+ >here
+ </ulink>
.
<programlisting><![CDATA[
<?xml version='1.0' encoding='utf-8'?>
@@ -162,11 +188,14 @@
</sect2>
<sect2>
<title>DB Dialect settings for the CMS component</title>
- <para>Modify <emphasis>jboss-portal.sar/portal-cms.sar/conf/hibernate/cms/hibernate.cfg.xml</emphasis>. A list of supported dialects
+ <para>Modify
+ <emphasis>jboss-portal.sar/portal-cms.sar/conf/hibernate/cms/hibernate.cfg.xml</emphasis>
+ . A list of supported dialects
for Hibernate3, can be found
<ulink
- url="http://www.hibernate.org/hib_docs/v3/reference/en/html/session-configuration.html#configuration-optional-dialects"
- >here</ulink>
+ url="http://www.hibernate.org/hib_docs/v3/reference/en/html/session-configuration.html#configuration-optional-dialects"
+ >here
+ </ulink>
.
<programlisting><![CDATA[
<?xml version='1.0' encoding='utf-8'?>
Modified: docs/trunk/referenceGuide/en/modules/tutorials.xml
===================================================================
--- docs/trunk/referenceGuide/en/modules/tutorials.xml 2006-10-24 20:04:54 UTC (rev 5499)
+++ docs/trunk/referenceGuide/en/modules/tutorials.xml 2006-10-25 15:59:19 UTC (rev 5500)
@@ -454,7 +454,7 @@
<title>Introduction</title>
<para>This section will introduce the reader to deploying a simple JSP portlet in JBoss Portal. It requires
you
- download the HelloWorldPortlet from PortletSwap.com, using this
+ download the HelloWorldJSPPortlet from PortletSwap.com, using this
<ulink
url="http://anonsvn.jboss.org/repos/portletswap/portlets/2_4/bundles/HelloWorldJSPPortlet.zip">
link</ulink>
More information about the jboss-svn-commits
mailing list