Attachment 696795 Details for Bug 910738 – QE review comments for installation guide

QE review comments for installation guide

install-guide-review.txt (text/plain), 4.40 KB, created by Michal Vanco on 2013-02-13 12:55:56 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Michal Vanco

Created: 2013-02-13 12:55:56 UTC

Size: 4.40 KB

patch

obsolete

>Installation Guide review
>-------------------------
>
>first page, Abstract
> - change link https://access.redhat.com/knowledge/docs/JBoss_Enterprise_Portal_Platform to https://access.redhat.com/knowledge/docs/JBoss_Portal_Platform/ (+ make the link clickable)
>(I'm also wondering why https://access.redhat.com/knowledge/docs/JBoss_Portal_Platform without slash in the end doesn't work)
>
>intro, 2.2 feedback
> - update link to bz report - https://bugzilla.redhat.com/enter_bug.cgi?product=JBoss%20Enterprise%20Portal%20Platform%206 and make it a link (not only text)
>
>1.2 Beta documentation
> - remove this section for GA
>
>3.3
> - quickstarts and wolf repo should be added at this table (I suppose it will be available on CSP) - ask Divya for more details
>
>4.2
>JBoss Enterprise Application Platform 6 requires Java 6 or Java 7.
>->
>JBoss Portal Platform 6 requires Java 6 or Java 7.
>
>You must have a working installation of JDK 1.6
>->
>You must have a working installation of JDK (6 or 7)
>
>4.3
>- beginning of the first sentence is missing:
>"at Enterprise Linux for use with JBoss enterprise products."
>
>- This task shows you how to install OpenJDK in Red Hat Enterprise Linux, and how to configure your system to use it as the defa 
>->
>  This task shows you how to install OpenJDK in Red Hat Enterprise Linux, and how to configure your system to use it as the default java installation.
>
>- what is Red Hult JDK ? :/
>OpenJDK is one of many Java Development Kits (JDKs) supported in Red Hult JDK.
>
>- OpenJDK is not available or supported for Red Hat Enterprise Linux 5.
>->
>  OpenJDK 7 is not available or supported for Red Hat Enterprise Linux 5.
>
>4.5, example 4.3
> - feel free to remove this example of domain directory - domain mode is not supported
>
>4.6
>allowing you to start a Managed Domain or Standalone Server configuration
>->
>allowing you to start a Standalone Server configuration (Managed Domain configuration isn't supported for JPP 6)
>
>4.7, proc 4.3, 4)
>Customize the script, paying special attention to the following variables, which you will need to customize to start JBoss Portal Platform as a managed domain.
>->
>Customize the script, paying special attention to the following variables, which you will need to customize to start JBoss Portal Platform.
>
>4.8, proc. 4.4
> - is this content related to Portal? There are parts about native utilities and I haven't used this service on Windows (please ask Thomas to confirm)
> - refer to the JBoss Portal Platform Installation Guide, available here: https://access.redhat.com/knowledge/docs/JBoss_Enterprise_Application_Platform/
>->
>   refer to the JBoss Portal Platform Installation Guide, available here: https://access.redhat.com/knowledge/docs/JBoss_Portal_Platform/
> - there is actually no information how to setup portal variables or whole service
>
>4.9, proc 4.6
> - change EAP_HOME to JPP_HOME (even if this content is related to EAP6 management console)
>
>4.11
> - remove sentence: "In a managed domain, you see a similar message for each locally-run server."
>
>5.1
> - remove "Whether you use a managed domain or standalone server configuration." (onyl standalone configuration is supported)
>
>5.2, proc 5.1
> - remove point 2) Managed Domain: Determine the socket binding group your server group uses.
>
>5.3
> - remove sentence: "The file is in a different location if the JBoss Enterprise Application Platform 6 is configured as a managed domain or a standalone server."
> - also remove below: Managed domain, EAP_HOME/domain/configuration/mgmt-users.properties
> - change EAP_HOME to JPP_HOME at standalone server
>
>5.5
>via the "users and Group management" web interface
>->
>via the "Users and Group management" web interface
>
>Chapter 6 with portal specific configuration is ok - it was verified based on updates at sections
>
>6.5 clustering
> - comments added at https://bugzilla.redhat.com/show_bug.cgi?id=909770 (not yet incorporated)
>
>6.8
> - Read and understand how keypairs and certificates operate in the "SSL Encryption Overview" section of the JBoss Enterprise Application Platform Security Guide
>(there is a link to some section of EAP5 documentation, this should be updated to EAP6 reference and AFAIK - you didn't want to include direct links to other documents)
>
> - update link to keytool - http://docs.oracle.com/javase/7/docs/technotes/tools/solaris/keytool.html (currently it points to javase 1.5)
>
>7.1
> - I think this part was already fixed to include JPP 6 instead of EAP 6 naming, there is no other special change (maybe it was overwritten)

Actions: View

Attachments on bug 910738: 696795