From do-not-reply at jboss.org Tue May 4 00:57:24 2010 Content-Type: multipart/mixed; boundary="===============0995682621237431147==" MIME-Version: 1.0 From: do-not-reply at jboss.org To: gatein-commits at lists.jboss.org Subject: [gatein-commits] gatein SVN: r2953 - portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Installation_Guide/en-US. Date: Tue, 04 May 2010 00:57:23 -0400 Message-ID: <201005040457.o444vNHE000860@svn01.web.mwc.hst.phx2.redhat.com> --===============0995682621237431147== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: smumford Date: 2010-05-04 00:57:23 -0400 (Tue, 04 May 2010) New Revision: 2953 Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Install= ation_Guide/en-US/Getting_Started.xml portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Install= ation_Guide/en-US/Installation.xml portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Install= ation_Guide/en-US/Post_Installation.xml Log: JBEPP-274: Minor Edits. Added Hardware info from EAP 4.3.0CP07. Added DOC T= ODOs Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_= Installation_Guide/en-US/Getting_Started.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Instal= lation_Guide/en-US/Getting_Started.xml 2010-05-04 03:27:34 UTC (rev 2952) +++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Instal= lation_Guide/en-US/Getting_Started.xml 2010-05-04 04:57:23 UTC (rev 2953) @@ -21,12 +21,98 @@
System Requirements - - For the latest information on supported Operating System / JVM co= mbinations and supported Database platforms, please always refer to http://www.jboss.com/products/platforms/portals/testedconfigurations/. + + DOC TODO: + + These requirements taken from the EAP 4.3.0CP07 Docs. Are they appropriate? + + + + Minimum Installation Requirements + + The minimum hardware required to support the installation of the JB= oss Application Server is a 240MB hard disk drive. Additional space is requ= ired for the installation of the JDK upon which the the JBoss Application S= erver depends. The JDK installation size is currently up to 150MB. + + + + Minimum Operational Requirements + + The minimum hardware required to support an operational JBoss Appli= cation Server varies depending on the following: = + + + + + + The size and complexity of the applications being served; = + + + + + The demand placed on the server by the number and frequency of clien= t requests; = + + + + + The server configuration including the selected log files, their des= ignated size and general server tuning. = + + + = + + The following discussion relates to the deployment of a simple applica= tion on a server experiencing minimal demand. In view of this, the absolute= minimum requirements for an operational server are: + + + + Disk Space: 1GB = + + + + + The default server log file storage configuration is 500MB. + + + + + The remaining 500MB is allocated to the server installation (240MB= ), the required JDK (150MB) and some additional space for applications (110= MB). + + + + + + + CPU: Intel Pentium Processor @ 1GHz + + + + + Core 2 Duo, Core 2 Quad and Intel Xeon chips will improve the perf= ormance of servers which experience high demand. = + + + + + + + RAM: 128 MB = + + + + + RAM installations of 1GB or more will be required to run a server = upon which small to medium applications are deployed. 4GB or more is prefer= able for larger applications or to run a GUI server interface. + + + + + + + + A server's performance must be viewed in light of the applications de= ployed on the server, the demand placed on the server by client requests an= d any post-installation server configuration or tuning. + + + + Supported Installations + + For the latest information on supported Operating System / JVM combi= nations and supported Database platforms, please always refer to = http://www.jboss.com/products/platforms/portals/testedconfigurations/. + + The following is a list of certified operating systems and JVM version= combinations: @@ -55,7 +141,7 @@ - RHEL 5 x86 + &RHEL; 5 x86 Sun JVM 1.6 Update 15 @@ -63,7 +149,7 @@ - RHEL 5 x86 + &RHEL; 5 x86 OpenJDK 1.6.0-b09 = @@ -71,7 +157,7 @@ - RHEL 5 x86 + &RHEL; 5 x86 IBM JDK 1.6.0 SR5 @@ -79,7 +165,7 @@ = - RHEL 5 x86_64 + &RHEL; 5 x86_64 Sun JVM 1.6 Update 15 @@ -87,7 +173,7 @@ - RHEL 5 x86_64 + &RHEL; 5 x86_64 OpenJDK 1.6.0-b09 = @@ -95,7 +181,7 @@ - RHEL 5 x86_64 + &RHEL; 5 x86_64 IBM JDK 1.6.0 SR5 @@ -326,13 +412,12 @@ Applications that run with more than 1.5GB of RAM (including free s= pace for garbage collection optimization) should utilize the 64-bit JVM. - - - Applications that run on a 32-bit JVM and do not require more than = minimal heap sizes will gain nothing from a 64-bit JVM. Barring memory issu= es, 64-bit hardware with the same relative clock speed and architecture is = not likely to run Java applications faster than their 32-bit cousin. - - - = + + + Applications that run on a 32-bit JVM and do not require more than m= inimal heap sizes will gain nothing from a 64-bit JVM. Barring memory issue= s, 64-bit hardware with the same relative clock speed and architecture is n= ot likely to run Java applications faster than their 32-bit cousin. + + Installing and Configuring JDK 6.0 using RHN @@ -340,7 +425,7 @@ Java SDKs are provided by the Red Hat Enterprise Linux 5 Base and S= upplementary channels for your Linux variant and architecture. The availabl= e JDKs corresponding to each channel and architecture are listed below: - RHEL 5 Java SDKs + &RHEL; 5 Java SDKs Channel: rhel-<arch>-server-5 @@ -441,11 +526,15 @@ Download and install the appropriate -compat RPM= from JPackage here. Please ensure you = choose a matching version of the -compat package to the = JDK you installed. - Note to Reviewer + + DOC TODO: The latest JDK available from Sun's site is update 19. The jpackag= e site linked to above lists the latest -compat rpm at u= pdate 6 (java-1.6.0-sun-compat-1.6.0.06-1jpp.i586.rpm). So there is a confl= ict here as the downloaded package and the -compat rpm cannot be matched as= stated above. - End Note to Reviewer + + QE NOTE: "Download and install the appropriate -compat RPM from JPa= ckage here." Should we instruct users to install unsigned rpms? = + + @@ -511,9 +600,12 @@ - Note to Reviewer - Better to use java-1.6.0-variant rather th= an java-1.6.0-sun as could be sun or openjdk. Also include openJDK download= site info http://openjdk.java.net/install/ ? - End Note to Reviewer + + DOC TODO: + + Better to use java-1.6.0-variant rather than java-1.6.0-sun as co= uld be sun or openjdk. Also include openJDK download site info http://openj= dk.java.net/install/ ? + + Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_= Installation_Guide/en-US/Installation.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Instal= lation_Guide/en-US/Installation.xml 2010-05-04 03:27:34 UTC (rev 2952) +++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Instal= lation_Guide/en-US/Installation.xml 2010-05-04 04:57:23 UTC (rev 2953) @@ -11,7 +11,7 @@ Downloading = - The officially supported archives are available from the JBoss Customer= Support Portal (CSP) located at = https://support.redhat.com. Platforms including in your Support sub= scription are listed in the Software section. + The officially supported versions are available from the JBoss Customer= Support Portal (CSP) located at https://support.redhat.com/jbossnetwork/r= estricted/main.htmlm. Platforms including in your Support subscript= ion are listed in the Software section.
= @@ -37,7 +37,7 @@ - Note: server configurations + Server Configurations Six types of server configurations will be included i= n your installation: minimal, default= , production, all, standard<= /literal> and web. = The Getting Started Guide of &JBEAP; 5.0 explains in detail the dif= ferent server configuration file sets. = @@ -59,7 +59,7 @@ - the default server configuration includes non-clu= stered Portal components. This is the server configurat= ion that is started when no other configuration is specified = + the default server configuration includes non-clu= stered Portal components. This is the server configuration tha= t is started when no other configuration is specified. = = @@ -74,8 +74,7 @@ = - - Note: gatein.ear archive + gatein.ear Archive The gatein.ear archive, which contains the Portal components, is loca= ted in the deploy folder of the default, all and production server configurations. = Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_= Installation_Guide/en-US/Post_Installation.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Instal= lation_Guide/en-US/Post_Installation.xml 2010-05-04 03:27:34 UTC (rev 2952) +++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Instal= lation_Guide/en-US/Post_Installation.xml 2010-05-04 04:57:23 UTC (rev 2953) @@ -15,14 +15,17 @@ Create an environment variable that points to the installation directo= ry (JBOSS_DIST/jboss-as) and call it JBOSS_HO= ME. Add $JBOSS_HOME/bin to the system path to = be able to run the server from the command line. You can do this by adding = the following lines to the .bashrc file in your home d= irectory. - + + + #In this example /home/user/jboss-epp-5.0/jboss-as is the installation dir= ectory. export JBOSS_HOME=3D/home/user/jboss-epp-5.0/jboss-as export PATH=3D$PATH:$JBOSS_HOME/bin = - + + Set this variable for the user account(s) that will run the server. = - + On Microsoft Windows @@ -62,9 +65,16 @@ Post Installation Security Configuration - When installed from the zip archive, authentication is required to acce= ss the majority of JBoss services, including administrative services. User = accounts have not been set up to eliminate the possibility of default usern= ame/password based attacks. + When installed from the zip archive, authentication is required to acce= ss the majority of JBoss services, including administrative services. User = accounts have not been set up to eliminate the possibility of default usern= ame/password based attacks. = - Default admin user configuration + + DOC TODO: + + Is this still the case in 5.0? It seems to have default accounts in pl= ace. + + + + Default Admin User Configuration It is recommended that the admin=3Dadmin username and password configu= ration, which is commented out by default, not be used for a production ser= ver. The admin user is included as an example of the username/password defi= nition format only. = @@ -122,24 +132,26 @@ - Note to Reviewer - - /server/$CONFIG/deploy/messaging/messaging-service.xml - - <!-- The password used by the message sucker connections to c= reate connections. + + DOC TODO: + + /server/$CONFIG/deploy/messaging/messaging-service.xml + +<!-- The password used by the message sucker connections to cre= ate connections. THIS SHOULD ALWAYS BE CHANGED AT INSTALL TIME TO SECURE SYSTEM <attribute name=3D"SuckerPassword"></attribute> - - Question 1: Should this file also have the SuckerPassword set? - - = - Question 2: Should I document this? - = - End Note to Reviewer + + Question 1: Should this file also have the SuckerPassword se= t? + + = + Question 2: Should I document this? + = + =
Disabling Authentication = + = Authentication is disabled by default. Once enabled, it is possible to = disable authentication for specific services by following the instructions = in this section. All paths specified in the sub-sections below are relative to = $JBOSS_HOME. --===============0995682621237431147==--