| Summary: | QE Review - Getting Started Guide | ||
|---|---|---|---|
| Product: | [JBoss] JBoss Enterprise SOA Platform 4 | Reporter: | David Le Sage <dlesage> |
| Component: | Documentation | Assignee: | David Le Sage <dlesage> |
| Status: | CLOSED NEXTRELEASE | QA Contact: | |
| Severity: | high | Docs Contact: | |
| Priority: | high | ||
| Version: | 4.3 CP04 ER1 | ||
| Target Milestone: | --- | ||
| Target Release: | 4.3 CP04 CR1 | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| URL: | http://jira.jboss.org/jira/browse/SOA-2001 | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2010-05-10 20:17:48 UTC | Type: | Task |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
|
Description
David Le Sage
2010-03-22 00:14:21 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 Thanks for the feedback, Len. I have made the requisite changes. After discussing with Darrin, I have backported the rewritten installation instructions from 5.0 as these are much clearer and use better expression. 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 Fixed filenames for the .sh. adduser command was already there. Replaced references to standalone with platform in example. 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 As per IRC discussion, removed the -r switch from the instructions. 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 Open pending final edit by David I have made this correction. Verified in the docs here: http://anonsvn.jboss.org/repos/labs/labs/jbossesb/trunk/product/etc/schemas/xml/jbossesb-1.0.1.xsd |