Bug 724339 (BRMS-284)

Summary: Add a minimal/short-cut getting started path to BRMS User Guide
Product: [JBoss] JBoss Enterprise BRMS Platform 5 Reporter: Len DiMaggio <ldimaggi>
Component: DocumentationAssignee: Len DiMaggio <ldimaggi>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: unspecified Docs Contact:
Priority: high    
Version: 5.0.2   
Target Milestone: ---   
Target Release: 5.0.2   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/BRMS-284
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2010-04-21 11:34:00 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:
Bug Depends On:    
Bug Blocks: 724340    

Description Len DiMaggio 2010-03-29 17:22:33 UTC 
Affects: Documentation (Ref Guide, User Guide, etc.)
Date of First Response: 2010-04-19 03:17:14
securitylevel_name: Public

The installation information in the BRMS user guide (http://www.redhat.com/docs/en-US/JBoss_Enterprise_BRMS_Platform/5.0.1/html-single/BRMS_Userguide/index.html#sect-installation) is complete and correct, but it does not include a minimal or "short-cut" path to getting BRMS up and running with the minimal number of steps. This path could be used by customers performing demos or exploratory testing and would not be intended for production environments as it would support logins, but not authentication through an LDAP server or other authentication utilities.

The steps that we should cover are:

a) The user needs EAP 4.3 - and not EAP 5.0 or SOA-P 5.0 (this is even more important since the release of EAP and SOA-P 5
b) The user needs to unzip the war, drop into deploy and use the "production" config of EAP 4.3
c) The user needs to uncomment admin=admin in the server's jboss-as/server/production/conf/props/jmx-console-users.properties
Comment 2 Len DiMaggio 2010-03-30 01:16:57 UTC 
Link: Added: This issue is a dependency of BRMS-285
Comment 3 Dana Mison 2010-04-19 07:17:14 UTC 
 - added a "Quick Install" note describing the difference in procedure for this method immediately before the installation procedure.
- added 4.3 to all EAP references.
- added clarification regarding only supporting the "production" server profile

I also streamlined the installation procedure a little, removing some unnecessary information to make it clearer.
Comment 4 Len DiMaggio 2010-04-19 13:31:50 UTC 
Found the note - it looks good - one change to the wording is needed:

NOTE: Quick Installation
The JBoss Enterprise BRMS Platform WAR file can be quickly deployed with no configuration. This is only suitable for development and demonstration scenarios. To do this, skip three of the installation procedure and enable one or more users in jboss-as/server/production/conf/props/jmx-console-users.properties. 

This should read:  "skip step 3"
Comment 5 Dana Mison 2010-04-20 05:47:36 UTC 
updated