Bug 779631 (SOA-2001) - QE Review - Getting Started Guide
Summary: QE Review - Getting Started Guide
Keywords:
Status: CLOSED NEXTRELEASE
Alias: SOA-2001
Product: JBoss Enterprise SOA Platform 4
Classification: JBoss
Component: Documentation
Version: 4.3 CP04 ER1
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: ---
: 4.3 CP04 CR1
Assignee: David Le Sage
QA Contact:
URL: http://jira.jboss.org/jira/browse/SOA...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2010-03-22 00:14 UTC by David Le Sage
Modified: 2010-05-10 20:17 UTC (History)
0 users

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2010-05-10 20:17:48 UTC
Type: Task


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker SOA-2001 0 None None None Never

Description David Le Sage 2010-03-22 00:14:21 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
Date of First Response: 2010-03-25 14:48:43
project_key: SOA

Please review the Getting Started Guide to ensure all Docs JIRAs have been successfully added.

Comment 2 Len DiMaggio 2010-03-25 19:34:55 UTC
Review Comments: 

Section: 1.1.2. Certified and Compatible Configurations
We should remove the certified/compatible sections from the document and follow the model of listing DB, OS requirements as did for SOA-P 5.0:
   http://downtown.englab.bne.redhat.com/drafts/JBoss_Enterprise_SOA_Platform/5.0.0/Getting_Started_Guide/html-single/#sect-OS_requirements

Procedure 1.1. Installing the Sun JDK on Red Hat Enterprise Linux
This section title refers to the Sun JDK, the text, however, describes how to install OpenJDK. 

Procedure 1.4. Installing Apache Ant on other Operating Systems
    At time of writing the current version was 1.7.1
(The current version is 1.8)

Section 2.1.3.1. Securing the JBPM Console should be removed - see SOA-1586



Comment 3 David Le Sage 2010-03-26 04:58:22 UTC
Thanks for the feedback, Len. I have made the requisite changes.

Comment 5 David Le Sage 2010-03-31 00:51:41 UTC
After discussing with Darrin, I have backported the rewritten installation instructions from 5.0 as these are much clearer and use better expression.

Comment 6 Len DiMaggio 2010-03-31 01:31:55 UTC
Problems with the recent additions to:

http://downtown.englab.bne.redhat.com/drafts/JBoss_Enterprise_SOA_Platform/4.3.CP03/Getting_Started_Guide/html-single/#sect-server_install

1) Why does the example use the standalone server?

2) Wrong file name

Edit jboss-redhat-init.sh
The script jboss-redhat-init.sh in the bin directory is the script used to launch the server as a service. Add two lines to the beginning of this script so that the first three lines look like those below. 

The file is actually named:  jboss_init_redhat.sh

3) The jboss user needs a home dir - this command is the culprit: adduser -r jboss

[root@ldimaggi bin]# service jboss_soa start
JBOSS_CMD_START = cd /jboss/local/43_CP03_ER1/jboss-soa-p-standalone.4.3.0/jboss-esb/bin; /jboss/local/43_CP03_ER1/jboss-soa-p-standalone.4.3.0/jboss-esb/bin/run.sh -c default
su: warning: cannot change directory to /home/jboss: No such file or directory


Comment 7 David Le Sage 2010-03-31 04:20:52 UTC
Fixed filenames for the .sh.


adduser command was already there.


Replaced references to standalone with platform in example.

Comment 8 Len DiMaggio 2010-03-31 14:39:49 UTC
Still seeing adduser -r:

Add a JBoss User
Use the adduser command with the -r parameter to create a system user account for the JBoss Enterprise SOA Platform. Do this as the root user. (Failure to do so will result in an error message when the service is started.)
   adduser -r jboss

Here:
   http://downtown.englab.bne.redhat.com/drafts/JBoss_Enterprise_SOA_Platform/4.3.CP03/Getting_Started_Guide/html-single/#sect-server_install





Comment 9 David Le Sage 2010-04-01 03:22:29 UTC
As per IRC discussion, removed the -r switch from the instructions.

Comment 11 Len DiMaggio 2010-04-01 19:10:24 UTC
Spoke too soon - one more change:

Assign ownership of files
Use the chown and chgrp commands on the installation directory to change the owner and group of the JBoss Enterprise SOA Platform files to the user created in the previous step.

[localhost]# chown -R jboss jboss-soa-p-platform
[localhost]# chgrp -R jboss jboss-soa-p-platform

================================

The directory is actually named: jboss-soa-p.4.3.0

Comment 12 Len DiMaggio 2010-04-05 11:11:41 UTC
Open pending final edit by David

Comment 13 David Le Sage 2010-04-06 23:52:15 UTC
I have made this correction.


Note You need to log in before you can comment on or make changes to this bug.