Author: mmcallis Date: 2008-02-01 02:06:19 -0500 (Fri, 01 Feb 2008) New Revision: 9697 Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml Log: 2.3.3. Building and Deploying from the Sources updating section with more verbose instructions Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml =================================================================== --- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml 2008-02-01 05:11:42 UTC (rev 9696) +++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml 2008-02-01 07:06:19 UTC (rev 9697) @@ -311,41 +311,68 @@ </sect3> </sect2> <sect2 id="building_deploying_from_source"> - <title>Building and Deploying from Sources</title> - <para>To build and deploy the JBoss Portal service, go to - <filename>JBOSS_PORTAL_HOME_DIRECTORY/build</filename> - and type: - <programlisting>build deploy</programlisting> - <mediaobject> - <imageobject> - <imagedata align="center" valign="middle" fileref="images/setup/build_deploy.png"/> - </imageobject> + <title>Building and Deploying from the Sources</title> + <para>To build and deploy JBoss Portal from the sources, change into the <filename>JBOSS_PORTAL_INSTALL_DIRECTORY/build/</filename> directory. Microsoft Windows users need to run the <command>build.bat deploy</command> command, and Linux users need to run the <command>./build.sh deploy</command> command. + </para> + <para> + During the first build, third-party libraries will be obtained from an online + repository, so you must be connected to Internet, and if you are behind a proxy server, you also + need to define your proxy address and host. If you are running Linux, add the following line to the <filename>JBOSS_INSTALLATION_DIRECTORY/bin/run.sh</filename> file: + </para> + <para> +<screen> +JAVA_OPTS=-Dhttp.proxyHost=&lt;<replaceable>proxy-hostname</replaceable>&gt; -Dhttp.proxyPort=&lt;<replaceable>proxy-port</replaceable>&gt; +</screen> + </para> + <para> + Replace <replaceable>proxy-hostname</replaceable> with the proxy server's hostname, and <replaceable>proxy-port</replaceable> with the correct proxy server port number. If you are running Microsoft Windows, add the following line to the <filename>JBOSS_INSTALLATION_DIRECTORY/bin/run.bat</filename> file: + </para> + <para> +<screen> +set JAVA_OPTS=-Dhttp.proxyHost=&lt;<replaceable>proxy-hostname</replaceable>&gt; -Dhttp.proxyPort=&lt;<replaceable>proxy-port</replaceable>&gt; +</screen> + </para> + <para> + Replace <replaceable>proxy-hostname</replaceable> with the proxy server's hostname, and <replaceable>proxy-port</replaceable> with the correct proxy server port number. + </para> + <para> + At the end of the build process, the <filename>jboss-portal.sar</filename> file is copied into the <filename>JBOSS_HOME/server/default/deploy/</filename> directory: + </para> + <mediaobject> + <imageobject> + <imagedata align="center" valign="middle" fileref="images/setup/build_deploy.png"/> + </imageobject> </mediaobject> - <note> - <para>During the first compilation, third-party libraries will be obtained from an online - repository, you need to be connected to Internet and if you are behind a proxy, you also - need to define your proxy address and host by adding: - <literal>JAVA_OPTS=-Dhttp.proxyHost=&lt;Proxy Host&gt; -Dhttp.proxyPort=&lt;Proxy Port&gt;</literal> in your environment. - </para> - </note> - <note>To build the clustered version, you will need to go to - <filename>JBOSS_PORTAL_HOME_DIRECTORY/build</filename> - and type: - <command>build main</command> - Then, go to - <filename>JBOSS_PORTAL_HOME_DIRECTORY/core</filename> - and type: - <command>build deploy-ha</command> - This will copy the - <filename>jboss-portal-ha.sar</filename> - to your - <filename>all</filename> - configuration for you. - </note> - At the end of the build process, the - <filename>jboss-portal.sar</filename> - is copied to <filename>JBOSS_HOME/server/default/deploy</filename>. - </para> + <para> + To build the clustered version on Linux Operating Systems: + </para> + <para> + <orderedlist> + <listitem> + <para> + Change into the <filename>JBOSS_PORTAL_HOME_DIRECTORY/build/</filename> directory, and run the following command: + </para> + <para> +<screen> +./build.sh main +</screen> + </para> + </listitem> + <listitem> + <para> + Change into the <filename>JBOSS_PORTAL_HOME_DIRECTORY/core/</filename> directory, and run the following command: + </para> + <para> +<screen> +./build.sh deploy-ha +</screen> + </para> + <para> + After <command>./build.sh deploy-ha</command> completes, the <filename>jboss-portal-ha.sar</filename> file is copied into the <filename>JBOSS_HOME/server/all/deploy/</filename> directory. + </para> + </listitem> + </orderedlist> + </para> </sect2> <sect2> <title>Setting up the database</title>