Bug 1204802 - WAS: Document setup for git and SSH features
Summary: WAS: Document setup for git and SSH features
Keywords:
Status: CLOSED EOL
Alias: None
Product: JBoss BRMS Platform 6
Classification: Retired
Component: Documentation
Version: 6.1.0
Hardware: Unspecified
OS: Unspecified
unspecified
high
Target Milestone: CR1
: 6.1.0
Assignee: brms-docs@redhat.com
QA Contact: Radovan Synek
Dawn Eisner
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2015-03-23 14:10 UTC by Radovan Synek
Modified: 2020-03-27 19:47 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2020-03-27 19:47:33 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)

Description Radovan Synek 2015-03-23 14:10:14 UTC
Please see bug 1201763, comment 3 and [1]. In short: in order to get SSH repository cloning (and kie-config-cli) working with Business Central deployed on WebSphere, bouncy castle must be configured as a shared library referenced from Business Central and JVM system property org.apache.sshd.registerBouncyCastle set to true.

[1] http://mswiderski.blogspot.com/2014/04/jbpm-6-on-websphere-installation-notes.html

Comment 1 Vikram Goyal 2015-03-25 06:26:36 UTC
Thanks for filing this Radovan.

I wanted to try and document the exact steps to create the reference to the Bouncy Castle Crypto API library, but these steps are not working for me based on available documentation. 

Considering that this is a blocker for GA (next week), I have documented the steps as best as I can, without including the direct steps.

This can be verified as the last steps in the Setting up Business Central section here [1].

Moving this to ON_QA.

[1] https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_JBoss_BPM_Suite/6.1/html-single/IBM_WebSphere_Installation_and_Configuration_Guide/#Install_Business_Central

Comment 2 Radovan Synek 2015-03-25 07:04:38 UTC
Vikram,

there are three steps needed to configure Bouncy Castle, that worked for me:
prerequisite: login to WebSphere AS Admin UI
1. navigate to Environment -> Shared Library, choose proper scope and create new library. Name it and set the classpath - i.e. path to bcprov-jdk16-1.46.jar, ok + save config.

2. navigate to Applications -> Application types -> WebSphere enterprise applications, choose Business Central, navigate to Shared library references in section References, select the module, click on Reference shared libraries and select the bouncy castle library created in previous step. Ok + save config.

3. create the JVM system properties org.apache.sshd.registerBouncyCastle and org.uberfire.domain (already done as I see).

Comment 4 Vikram Goyal 2015-03-25 09:02:31 UTC
Hi Radovan. Thanks for these!!

I personally prefer screenshots, but the issue is that we have to write documentation based on early ER's. By the time a CR comes around, the screenshots change and we have to change all the ones we added in ER stage :).

We are having to re-do screenshots for the installer currently as it has changed from ER6 to CR1 :)

I will add these steps shortly today and rebuild. I am going to take your word for these instructions working :)

Comment 5 Radovan Synek 2015-03-25 09:08:27 UTC
Hi Vikram,
I can see your point, however, talking about WebSphere, for us it's a stable environment, so screenshots describing configuration there can hardly ever change. The same applies to WebLogic, it will not change during our release.

Comment 6 Vikram Goyal 2015-03-25 11:57:57 UTC
Thanks Radovan.

Changes with your detailed steps have been added. This can be verified here [1] (last step).

Thanks for the pointer about the screenshots and sending them through. If time permits before GA, I will try and add them.

Moving this to ON_QA.

[1] https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_JBoss_BPM_Suite/6.1/html-single/IBM_WebSphere_Installation_and_Configuration_Guide/#Install_Business_Central

Comment 7 Radovan Synek 2015-03-26 11:01:37 UTC
Vikram,

a few more comments regarding the most recent changes:

The first step (about properties) could be contained as an optional section in 3.5. Add custom JVM properties. Or some note clearly telling these are custom JVM properties should be added. From the current description, a user without at least rough idea what to do could be confused what and where is he supposed to configure.

In the next step, "select your module" was just my shortage to guide you via the GUI, I'm not sure whether this is suitable for our customers. GUI shows two options in this part - entire application and it's web module, the library should be added to the web module. Maybe it could work with the entire app as well, but I haven't tested that.

Thanks

Comment 8 Vikram Goyal 2015-03-27 00:21:18 UTC
(In reply to Radovan Synek from comment #7)
> Vikram,
> 
> a few more comments regarding the most recent changes:
> 
> The first step (about properties) could be contained as an optional section
> in 3.5. Add custom JVM properties. Or some note clearly telling these are
> custom JVM properties should be added. From the current description, a user
> without at least rough idea what to do could be confused what and where is
> he supposed to configure.

:) Thanks Radovan.

My thinking was that the users are on one of the last sections of installing B*MS, so they would know by now where to go to set these properties. But you are right, they should have some direction. Instead of moving these properties, I have set a link to the previous section on Adding custom properties.

> 
> In the next step, "select your module" was just my shortage to guide you via
> the GUI, I'm not sure whether this is suitable for our customers. GUI shows
> two options in this part - entire application and it's web module, the
> library should be added to the web module. Maybe it could work with the
> entire app as well, but I haven't tested that.
> 

:) Ok. I have changed it to say web module. 

This can be verified here [1].

[1] https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_JBoss_BPM_Suite/6.1/html-single/IBM_WebSphere_Installation_and_Configuration_Guide/#Install_Business_Central

> Thanks

Comment 9 Radovan Synek 2015-03-27 10:06:25 UTC
Thanks Vikram, looks good to me now.


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