Author: mmcallis Date: 2008-01-31 02:39:36 -0500 (Thu, 31 Jan 2008) New Revision: 9668 Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml Log: rephrasing installation section, binary download 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-01-31 06:23:15 UTC (rev 9667) +++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml 2008-01-31 07:39:36 UTC (rev 9668) @@ -33,7 +33,7 @@ <note> <title>SQL Errors</title> <para> - Tables are automatically created the first time JBoss Portal starts. When you deploy JBoss Portal for the first time, Portal checks for the existence of the initial tables, which have not been created yet. This causes errors such as the following, which can safely be ignored: + Tables are automatically created the first time JBoss Portal starts. When deployed for the first time, JBoss Portal checks for the existence of the initial tables, which have not been created yet. This causes errors such as the following, which can safely be ignored: </para> <para> <programlisting> @@ -48,49 +48,42 @@ </note> </sect1> <sect1 id="install_binary"> - <title>Installing from Binary Download</title> - <para>The binary download package typically consists of the - <filename>jboss-portal.sar</filename> - , documentation (which you are already reading), and a set of preconfigured datasource descriptors that allow - JBoss Portal to communicate with a database. - </para> - <para>This installation method is preferred by those who already have JBoss Application Server installed or those we need to install - the version ready for clustering.</para> + <title>Installing the Binary Download</title> + <para>The binary package typically consists of the + <filename>jboss-portal.sar</filename> directory, documentation such as the JBoss Portal User Guide and the JBoss Portal Reference Guide, and a set of pre-configured Datasource descriptors that allow + JBoss Portal to communicate with an external database. This installation method is recommended for users who already have JBoss EAP or JBoss AS installed, or those who need to install JBoss Portal in a clustered environment.</para> <sect2> - <title>Setting up your environment</title> + <title>Setting up your Environment</title> <sect3 id="install_binarydownload"> <title>Getting the Binary</title> <para> - The binary download is available from our - <ulink url="http://labs.jboss.com/portal/jbossportal/download/index.html&qu... page</ulink> - . - </para> - <para> - Once downloaded and extracted, the folder hierarchy should look like this: + The binary download is available from the <ulink url="http://labs.jboss.com/portal/jbossportal/download/index.html&qu... Portal Downloads</ulink> page. Look for the <computeroutput>JBoss Portal Binary</computeroutput> package. Once the binary zip file is downloaded and extracted, the folder hierarchy will look like the following: + </para> + <para> <mediaobject> <imageobject> <imagedata align="center" valign="middle" fileref="images/setup/package.png"/> </imageobject> </mediaobject> - We will be using files contained in this download in the further sections, so please download and extract - it first. + </para> + <para> + File contained in this download will be used in later sections. Download and extract the JBoss Portal binary zip file before proceeding. </para> </sect3> <sect3> - <title>Application Server Setup</title> - <para>Of course you will need to install JBoss Application Server prior to installing JBoss - Portal, if you didn't do so yet, please install JBoss EAP 4.2 or JBoss AS 4.2.2. If you have a - subscription contract with Red Hat, you can have access to the EAP - version from the <ulink url="http://network.jboss.com/">support portal</ulink>. - For the other versions you can get them - <ulink url="http://labs.jboss.com/portal/jbossas/download/index.html"&... . - <warning>Make sure to download the JBoss AS Zip version. + <title>JBoss EAP and JBoss AS Setup</title> + <para>Before deploying JBoss Portal, make sure you have JBoss EAP or JBoss AS installed. Customers who have access to the <ulink url="https://support.redhat.com/portal/login.html">JBoss Customer Support Portal (CSP)</ulink> should download and install JBoss EAP 4.2. Customers who do not have access to the JBoss CSP are advised to use <ulink url="http://labs.jboss.com/jbossas/downloads/">JBoss AS</ulink>. For JBoss AS installation instructions, please refer to the <ulink url="http://labs.jboss.com/jbossas/docs/index.html">JBoss AS Installation Guide</ulink>. + </para> + <warning> + <para> + Make sure to download the JBoss AS Zip version <emphasis role="bold">DO NOT ATTEMPT to deploy JBoss Portal on the installer version of JBoss AS! </emphasis> We are currently working on aligning the Application installer with JBoss Portal. + </para> </warning> - </para> + </sect3> <sect3> <title>Database Setup</title>