Author: mmcallis Date: 2008-02-01 00:11:42 -0500 (Fri, 01 Feb 2008) New Revision: 9696 Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml Log: revising content: 2.3.2.2. Operating System Environment Settings 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 04:12:08 UTC (rev 9695) +++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml 2008-02-01 05:11:42 UTC (rev 9696) @@ -253,37 +253,22 @@ </para> </sect2> <sect2> - <title>Setting up the application server</title> + <title>Setting up the JBoss Application Server</title> <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" - >here - </ulink> - . - </para> + <title>JBoss Application Server 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> </sect3> <sect3 id="install_source_env"> - <title>Operating System Environment Setting</title> - <para>For the build targets to work, you must first set the - <filename>JBOSS_HOME</filename> - environment variable in your - operating system, to the root directory of the JBoss Application Server installation. - </para> - <para>In Windows, this is accomplished by going to - <emphasis>Start > Settings > Control Panel > System > Advanced > Environment Variables</emphasis> - . Now under the + <title>Operating System Environment Settings</title> + <para>For build targets to work, you must configure a <filename>JBOSS_HOME</filename> environment variable. This environment variable must point to the root directory of the JBoss EAP or JBoss AS installation directory, which is the directory where the JBoss EAP or JBoss AS files were extracted to. + </para> + <para>When using Microsoft Windows, this is accomplished by going to + <emphasis>Start > Settings > Control Panel > System > Advanced > Environment Variables</emphasis>. Under the <emphasis>System Variables</emphasis> section, click - <emphasis>New</emphasis> - . You will be setting the - <filename>JBOSS_HOME</filename> - environment variable to the location of your JBoss Application Server installation: + <emphasis>New</emphasis>. Set the <filename>JBOSS_HOME</filename> + environment variable to the location of your JBoss EAP or JBoss AS installation directory: <mediaobject> <imageobject> <imagedata align="center" valign="middle" fileref="images/setup/win_envsetup.gif"/> @@ -291,13 +276,42 @@ </mediaobject> </para> <para> - On a Unix-like Operating System, you would accomplish this by typing: - <command>export JBOSS_HOME=/path/to/your/jboss/directory</command> - </para> - </sect3> + To configure the <filename>JBOSS_HOME</filename> environment variable on Linux: + </para> + <para> + <orderedlist> + <listitem> + <para> + Add the following line to the <filename>~/.bashrc</filename> file. Note: this must be configured while logged in as the user who will run JBoss EAP or JBoss AS: + </para> + <para> +<screen> +export JBOSS_HOME=/path/to/installation/ +</screen> + </para> + </listitem> + <listitem> + <para> + Run the following command to enable the <filename>JBOSS_HOME</filename> environment variable: + </para> + <para> +<screen> +source ~/.bashrc +</screen> + </para> + </listitem> + </orderedlist> + </para> + <note> + <title>JBoss EAP <filename>JBOSS_HOME</filename> Environment Variable</title> + <para> + If you are running JBoss EAP, configure the <filename>JBOSS_HOME</filename> environment variable to point to the <filename>/path/to/jboss-eap-<replaceable>version</replaceable>/jboss-as/</filename> directory. + </para> + </note> + </sect3> </sect2> <sect2 id="building_deploying_from_source"> - <title>Building/Deploying from Sources</title> + <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: