Bug 724414 (BRMS-359) - Modeshape install/config details required for docs (inc. switching from JackRabbit to Modeshape)
Summary: Modeshape install/config details required for docs (inc. switching from JackR...
Keywords:
Status: CLOSED NEXTRELEASE
Alias: BRMS-359
Product: JBoss Enterprise BRMS Platform 5
Classification: JBoss
Component: Documentation
Version: 5.1.0 GA
Hardware: Unspecified
OS: Unspecified
urgent
unspecified
Target Milestone: ---
: 5.1.0 GA
Assignee: Len DiMaggio
QA Contact:
URL: http://jira.jboss.org/jira/browse/BRM...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2010-08-30 01:55 UTC by Dana Mison
Modified: 2014-05-27 01:30 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2011-03-22 07:51:19 UTC
Type: Task


Attachments (Terms of Use)
drools_repository.properties (588 bytes, application/octet-stream)
2010-10-21 04:33 UTC, Kurt Stam
no flags Details


Links
System ID Private Priority Status Summary Last Updated
Red Hat Bugzilla 724451 0 high CLOSED ModeShape Integration support 2021-02-22 00:41:40 UTC
Red Hat Issue Tracker BRMS-359 0 None Closed Modeshape install/config details required for docs (inc. switching from JackRabbit to Modeshape) 2011-08-23 15:27:19 UTC

Internal Links: 724451

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




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