6:58 p.m.
Author: mmcallis
Date: 2008-02-05 19:58:13 -0500 (Tue, 05 Feb 2008)
New Revision: 9790
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/configuration.xml
Log:
revising/adding content to:
3.2. Changing the Context Path
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/configuration.xml
===================================================================
---
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/configuration.xml 2008-02-05
23:59:16 UTC (rev 9789)
+++
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/configuration.xml 2008-02-06
00:58:13 UTC (rev 9790)
@@ -46,43 +46,22 @@
</para>
</sect1>
<sect1 id="configuration-contextroot">
- <title>Changing the context path</title>
- <para>By default, the "main" page of JBoss portal will be
accessible at
- <literal>http://localhost:8080/portal/index.html</literal>
- . You may want to change that
- either to a different name or to
- <literal>http://localhost:8080/index.html</literal>
- .
- </para>
- <note>
- By default, Tomcat holds on to the root context '/'. You may need to
either remove
-
<literal>$JBOSS_HOME/server/default/deploy/jboss-web.deployer/ROOT.war</literal>
- or add a <literal>jboss-web.xml</literal> file (declaring another
context-root other than '/') under
- <literal>ROOT.war/WEB-INF</literal> directory for the below changes
to take effect on restart.
- <programlisting><![CDATA[
-<?xml version="1.0"?>
-<jboss-web>
- <context-root>/tomcat-root</context-root>
-</jboss-web>]]></programlisting>
- </note>
- <para>You can accomplish this, with either a deployed jboss-portal.sar or
before you build from source:
- <itemizedlist>
- <listitem>
- <para>
- <emphasis role="bold">Binary method:</emphasis>
- <orderedlist>
- <listitem>
- <para>Open
- <emphasis>
-
JBOSS_INSTALL_DIRECTORY/server/default/deploy/jboss-portal.sar/portal-server.war/WEB-INF/jboss-web.xml
- </emphasis>
+ <title>Changing the Context Path</title>
+ <para>By default, the main JBoss Portal page is accessible by navigating to
<emphasis>http://localhost:8080/portal/index.html</emphasis>. This
+can be changed to a different path, for example,
+<emphasis>http://localhost:8080/index.html</emphasis>. The context path can
be changed when using the deployed <filename>jboss-portal.sar/</filename>, or
before building from source. To change the context path when using the JBoss Portal binary
package:
+</para>
+<para>
+ <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><![CDATA[
<?xml version="1.0"?>
<jboss-web>
<security-domain>java:jaas/portal</security-domain>
<context-root>/portal</context-root>
<replication-config>
- <replication-trigger>SET_AND_GET</replication-trigger>
+ <replication-trigger>SET</replication-trigger>
<replication-type>SYNC</replication-type>
</replication-config>
<resource-ref>
@@ -94,34 +73,72 @@
</listitem>
<listitem>
<para>Edit the
- <emphasis>context-root</emphasis>
- element to whatever you desire.
-
<programlisting><![CDATA[<context-root>/</context-root>]]></programlisting>
- </para>
+
<computeroutput><context-root></computeroutput> element with the
desired context path:
+ </para>
+ <para>
+<screen>
+<![CDATA[<context-root>/testing</context-root>]]>
+</screen>
+ </para>
+ <para>
+ Using this example, the JBoss Portal main page would be reached by navigating to
<emphasis>http://localhost:8080/testing</emphasis>.
+ </para>
</listitem>
</orderedlist>
</para>
- </listitem>
+ <para>
+ To change the context path before building from source:
+ </para>
+ <para>
+ <orderedlist>
<listitem>
<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>
- 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
- effect. For build instructions, please see:
- <xref linkend="install_source"/>
- </para>
- </para>
- </listitem>
- </itemizedlist>
- </para>
+ Copy the
<filename>JBOSS_PORTAL_INSTALLATION_DIRECTORY/build/etc/local.properties-example</filename>
and save it as
<filename>JBOSS_PORTAL_INSTALLATION_DIRECTORY/build/local.properties</filename>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Open the
<filename>JBOSS_PORTAL_INSTALLATION_DIRECTORY/build/local.properties</filename>
file and edit the <computeroutput>portal.web.context-root</computeroutput>
section with the desired context path:
+ </para>
+ <para>
+<screen>
+# Context root for the portal main servlet
+portal.web.context-root=/testing
+</screen>
+ </para>
+ <para>
+ Using this example, the JBoss Portal main page would be reached by navigating to
<emphasis>http://localhost:8080/testing</emphasis>.
+ </para>
+ </listitem>
+ <listitem>
+
+ <para>
+ To clean the project, make sure you are connected to the Internet, and change into
the <filename>JBOSS_PORTAL_INSTALLATION_DIRECTORY/build/</filename> directory.
Run the <command>ant clean</command> command.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Re-build and re-deploy JBoss Portal. See <xref
linkend="install_source"/> for build instructions.
+ </para>
+ </listitem>
+ </orderedlist>
+</para>
+ <para>
+ <note>
+ <para>
+ By default, Tomcat holds on to the root context,
<emphasis>/</emphasis>. You may need to remove the
<filename>$JBOSS_HOME/server/default/deploy/jboss-web.deployer/ROOT.war/</filename>
directory,
+ or add a <filename>jboss-web.xml</filename> file, which declares
another
+ 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 context path to
<computeroutput>/tomcat-root</computeroutput>:
+ </para>
+ <para>
+<programlisting><![CDATA[
+<?xml version="1.0"?>
+<jboss-web>
+ <context-root>/tomcat-root</context-root>
+</jboss-web>]]></programlisting>
+ </para>
+ </note>
+</para>
</sect1>
<sect1 id="configuration-hibdialect">
<title>Forcing the DB dialect</title>