Bug 1163923 - Please add a WARNING message to alert customers not to use BPMS/BRMS deployable installer on existing BRMS/BPMS setup
Summary: Please add a WARNING message to alert customers not to use BPMS/BRMS deployab...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: JBoss BPMS Platform 6
Classification: Retired
Component: Documentation
Version: 6.0.3
Hardware: All
OS: All
high
high
Target Milestone: CR2
: One-off release
Assignee: Vikram Goyal
QA Contact: Marek Baluch
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2014-11-13 17:21 UTC by Musharraf Hussain
Modified: 2018-12-09 19:10 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Build Name: 22689, Installation Guide-6.0 Build Date: 03-11-2014 02:10:00 Topic ID: 22553-711083 [Specified]
Last Closed: 2014-12-18 05:05:16 UTC
Type: Enhancement
Embargoed:


Attachments (Terms of Use)

Description Musharraf Hussain 2014-11-13 17:21:33 UTC
Title: Installing the EAP6 package

Describe the issue:
- Sometimes customers do not interpret these lines in the documentation correctly and attempt to install the BPMS/BRMS deployable installer on an existing EAP6.1.1 installation where they have already installed an earlier release of BPMS/BRMS (e.g. version 6.0.0/6.0.1/6.0.3) .
~~~
To install the deployable package for an EAP that has yet to be configured,...
...
 To install the deployable package for a previously configured EAP,...
...
 Ensure the target EAP does not include a deployment with a colliding name. Copy the folder jboss-eap-6.1/standalone/deployments into the EAP_HOME directory from the BPMS distribution. ...
~~~

As of BPMS/BRMS 6.0.x releases we do not have any smart update tool for this product , hence it is a natural tendency amongst customer community to simply apply the latest versions of these products on an already installed BPMS)/BRMS set-up for a quick set-up. Which leads to many issues.

Suggestions for improvement:
- My suggestion to the documentation team is to enhance this topic and put a WARNING message (like a dialogue box appearing in this section of documentation) to warn customers not to attempt to install this deployable version of BPMS/BRMS on top of an existing BPMS/BRMS set-up. This should prevent customers from facing further complications due to wrong installation.

Additional information:
- DOC URL:

https://access.redhat.com/documentation/en-US/Red_Hat_JBoss_BPM_Suite/6.0/html-single/Installation_Guide/index.html#Installing_standalone_package

Comment 1 Vikram Goyal 2014-11-18 02:25:33 UTC
MAny thanks Musharraf for filing this bug.

If I understand correctly, there is no option to update an existing BPMS/BRMS installation with a newer version.

I agree that the information in this section could be made clearer by specifying that these instructions are for installing a new version of the product and not updating it.

I have now added a warning at the start of this section and also separated the install on a new EAP and an existing EAP procedures into separate sections.

This can be verified here [1].

Further, I believe the same issue applies to the BRMS install on EAP 6 as well and have added the warning there as well.

This can be verified here [2]

Hope this helps.

Once these have been verified, I will make an async release for this to update the documentation on access.redhat.com.

[1] https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_JBoss_BPM_Suite/6.0/html-single/Installation_Guide/index.html#Installing_standalone_package

[2] http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_JBoss_BRMS/6.0/html-single/Installation_Guide/index.html#Installing_the_standalone_package1

Comment 2 Musharraf Hussain 2014-11-18 10:05:28 UTC
Hello Vikram,

Thank you for your prompt action on this "Enhancement" request. Indeed the WARNING message box looks awesome and catchy ;)


Regards,
Musharraf Hussain

Comment 3 Marek Baluch 2014-12-10 11:36:10 UTC
Verified on links provided in comment #1.


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