Bug 1325716

Summary: Defining unsupported installation scenarios in Installation Guide
Product: [Retired] JBoss BPMS Platform 6 Reporter: Lyle Wang <lywang>
Component: DocumentationAssignee: Dawn Eisner <deisner>
Status: CLOSED EOL QA Contact: Lukáš Petrovický <lpetrovi>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 6.2.0CC: brms-docs, tradej
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2020-03-27 19:41:24 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Lyle Wang 2016-04-10 23:08:50 UTC
Document URL: 
https://access.redhat.com/documentation/en-US/Red_Hat_JBoss_BPM_Suite/6.2/html/Installation_Guide/chap-Installation_options.html#sect-The_Red_Hat_JBoss_BPM_Suite_Installer_installation


Section Number and Name: 
2.1. THE RED HAT JBOSS BPM SUITE INSTALLER INSTALLATION


Describe the issue: 

Having a discussion with BRMS/BPMS QA team lead and it's obvious the Jar installer is not supposed to work with RPM installed EAP.
Need to add some warning in the doc about this to avoid incorrect / unsupported configuration on customer side.

Email confirmation from QA team:
-------------------------------------------------------------------
the BPM Suite installer does not support EAP installed from RPM at all. The only supported EAP distribution is just an unpacked zip archive - the installer requires EAP root directory as an input (which is not applicable to EAP RPM distribution).
-------------------------------------------------------------------


Suggestions for improvement: 

Add a "WARNING" or "IMPORTANT" box in Chapter 2.1 in Installation Guide and highlight the unsupported / suggested installation scenario.

For example:
BPMS (BRMS) Jar installer is NOT supported to work with EAP distribution which was installed by YUM / RPM. If EAP was installed by YUM/RPM, please use "Deployable Zip" to install BPMS (BRMS) as EAP deployment, see chapter "2.1.3. Downloading Deployable ZIP for Red Hat JBoss EAP" for details.


Additional information: 

Some customers want to choose JAR installer for their RPM installed EAP, and the Jar installer might work after some modification / changes on EAP , but it's not a tested scenario and we don't know what would happen after the YUM update. If one choose YUM/RPM to install EAP, then only deployable zip should be used to install BPMS/BRMS.

Comment 2 Tomas 'Sheldon' Radej 2016-04-14 11:12:44 UTC
Tracked in JBoss JIRA. Klara Kufova is working on this.