Bug 724414 (BRMS-359)

Summary: Modeshape install/config details required for docs (inc. switching from JackRabbit to Modeshape)
Product: [JBoss] JBoss Enterprise BRMS Platform 5 Reporter: Dana Mison <dmison>
Component: DocumentationAssignee: Len DiMaggio <ldimaggi>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: unspecified Docs Contact:
Priority: urgent    
Version: 5.1.0 GACC: jlocker, ldimaggi, psiroky
Target Milestone: ---   
Target Release: 5.1.0 GA   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/BRMS-359
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-03-22 07:51:19 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:
Attachments:
Description Flags
drools_repository.properties none

Description Dana Mison 2010-08-30 01:55:09 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)

Documentation is required for how to replace the current BRMS JCR (JackRabbit) with ModeShape.

This will be documented in the BRMS Administrator Guide

Information is required regarding:
1 - where the ModeShape files will be available from
2 - how to replace JackRabbit with ModeShape
3 - update to "Changing the Repository's Location" section
4 - update to "Database Configuration" section

Comment 1 Dana Mison 2010-08-31 00:08:27 UTC
note: all modeshape content needs to have the clarification that it only applies to 5.1 and onwards. 

Comment 2 Dana Mison 2010-09-02 03:12:03 UTC
Hi, it was suggested that you were the best person to assign this to.

We need enough info to get started with being able to go through the processes ourselves to document them.

I realize that we probably won't have complete info on this for a while, but anything to get started would be good.

Comment 3 Tihomir Surdilovic 2010-09-02 14:16:48 UTC
The work on Drools Guvnor and ModeShape is currently being done in in it's own branch ( http://anonsvn.jboss.org/repos/labs/labs/jbossrules/branches/kstam_guvnor_modeshape/ ). I will post the status of the completion of this work here. Currently there are still some failing tests that are being worked on.

Comment 4 Tihomir Surdilovic 2010-09-29 13:25:09 UTC
Development and testing for ModeShape integration is not completed yet. We should be getting some docs from Kurt Stam hopefully end of next week. At this point we need to look into what docs are available and what we want to provide to the customer.

Comment 5 Kurt Stam 2010-10-21 00:37:42 UTC
Link: Added: This issue related BRMS-396


Comment 6 Kurt Stam 2010-10-21 04:20:23 UTC
Hi Tihomir, I have checked in the modeshape integration code. To switch from JR to MS do the following:

1. drools-repo/jcr-ms-impl, if you have a ModeShape 2.3-SNAPSHOT, then run 'mvn clean install'
2. drools-repo/drools-repository: change dependency from jr to ms in the pom, and change the settings in the drools_repository.properties (see attachment), then run 'mvn clean install'
3. drools-guvnor should now pick up ModeShape due to the change in 2.

The ModeShape configuration lives in drools-repository/src/test/resources/modeshape, make sure this is on your classpath if you run the tests in step 3 (or copy this directory into guvnor-drools/src/main/resources). I still need to address the complete guvnor configuration solution in BRMS-407 and BRMS-408.

I hope this gets you going.

Cheers,

--Kurt

Comment 7 Kurt Stam 2010-10-21 04:33:31 UTC
Switch to MS by using the settings as in this file.

Comment 8 Kurt Stam 2010-10-21 04:33:31 UTC
Attachment: Added: drools_repository.properties


Comment 9 Dana Mison 2010-10-27 03:05:48 UTC
Release Notes Text: Added: test


Comment 10 Dana Mison 2010-10-27 03:13:24 UTC
Release Notes Text: Removed: test 


Comment 11 David Le Sage 2010-10-29 03:38:47 UTC
Release Notes Docs Status: Added: Not Required
Writer: Added: dlesage


Comment 13 Len DiMaggio 2010-11-23 18:51:20 UTC
Security: Removed: Public 


Comment 15 Dana Mison 2010-11-29 01:32:32 UTC
content has been added to BRMS Admin guide - still need to add clarification about using org.drools.repository.secure.passwords

Comment 16 Dana Mison 2010-12-09 11:26:20 UTC
added password encoding optional step

Comment 17 Dana Mison 2010-12-14 00:55:30 UTC
this content has been removed from the BRMS admin guide & will ship as a smaller doc when the modeshape files are made available separately

Comment 18 Dana Mison 2011-03-01 05:21:27 UTC
Labels: Removed: rn-dlesage rn-not-needed 


Comment 19 Dana Mison 2011-03-01 05:21:50 UTC
Database configuration info for jackrabbit and modeshape: https://access.redhat.com/kb/docs/DOC-37076

Comment 20 Dana Mison 2011-03-01 05:36:12 UTC
more content here too: https://access.redhat.com/kb/docs/DOC-43075

Comment 22 Dana Mison 2011-03-22 07:51:19 UTC
needs review

Comment 23 Petr Široký 2011-03-22 14:01:15 UTC
I read and tried the instructions described in doc and the modeshape was installed successfully (and BRMS was correctly running). But the instructions are only for standalone version. In case of deployable there are some major or minor changes depending on container used. In case of EAP and SOA-P it's probably only different names for properties files, but for EWS or WAS the changes will be much bigger, as they are nonJBoss containers.

Comment 24 Len DiMaggio 2011-03-22 16:53:23 UTC
The doc includes steps to install modeshape in a standalone BRMS distribution, but not for installing to another container such as EWS, EAP, SOA-P.  The differences are very small, probably the properties file name (brms-roles vs jmx-roles),

On EAP, SOA-P the names are jmx-{roles,users} by default. In case of EWS, tomcat handles JAAS differently, so the EWS installation will have to be updated.

Open issues:

* EWS install - I'll ping EWS QE about this
* Installing/Configuring Modeshape when BRMS is deployed to IBM WAS7 - I'd vote to document this in a separate KB article