Bug 1371591 - Installation Guide Does not Address EAP Domain Mode Installation
Summary: Installation Guide Does not Address EAP Domain Mode Installation
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: JBoss Data Virtualization 6
Classification: JBoss
Component: Documentation
Version: 6.3.0
Hardware: Unspecified
OS: Unspecified
unspecified
medium
Target Milestone: GA
: 6.3.0
Assignee: David Le Sage
QA Contact: Filip Elias
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-08-30 14:49 UTC by Jack Ottofaro
Modified: 2017-01-17 21:59 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-01-17 21:59:46 UTC
Type: Bug


Attachments (Terms of Use)

Description Jack Ottofaro 2016-08-30 14:49:06 UTC
Document URL:

https://access.redhat.com/documentation/en/red-hat-jboss-data-virtualization/6.3/paged/installation-guide/

Section Number and Name: 

Chapter 7. Installing the Product 

Describe the issue: 

The "Installation Guide" document does not cover the specifics of installing JDV into a JBoss EAP environment running in Domain mode. In Domain mode, EAP has server groups which can be running on different hosts therefore the JDV installation must be executed on those hosts. There are possibly other differences between installation in Domain mode versus Standalone mode which should be specifically addressed to avoid customer confusion.

In addition, Section 1.3 of the document entitled "Variable Name: MODE" is confusing. It discusses mode as being either Domain or Standalone and infers the term MODE will be used throughout the document to distinguish the two but MODE is never again used and the topic of mode is never again addressed.

Suggestions for improvement: 

Include installation specifics for EAP Domain mode.
Remove Section 1.3 if MODE is not used.

Additional information:

Comment 2 David Le Sage 2016-10-19 00:21:58 UTC
In progress.

Comment 3 David Le Sage 2016-10-21 00:21:57 UTC
Hello Jack

The "MODE" topic is a legacy from when we were trying to have a standardised introduction section for every book in a given product's documentation suite.  That said, we have moved on from those days now, so I have removed it.  

I am investigating Domain mode now.  

Thanks.

Comment 4 Jack Ottofaro 2016-10-21 12:48:43 UTC
Thanks for the update David. Yeah, I kind of figured the MODE issue was due to something like that. Let me know how domain mode goes.

Comment 6 Jan Stastny 2016-12-02 08:27:44 UTC
I see only only domain mode related information in section
8.2. Start JBoss EAP 6 as a Managed Domain
the section should mention Red Hat JBoss Data Virtualization instead.
But still I am missing the information about installing into domain. I'd expected it to be in section 7. Do I see an outdated version of the docs?

Again red warning element:


Error message

    Notice: Undefined index: product in _cirrus_set_analytics() (line 1768 of /opt/jnana/all/themes/cirrus/template.php).
    Notice: Undefined index: version in _cirrus_set_analytics() (line 1768 of /opt/jnana/all/themes/cirrus/template.php).
    Notice: Undefined index: product in _cirrus_set_analytics() (line 1769 of /opt/jnana/all/themes/cirrus/template.php).
    Notice: Undefined index: product in _cirrus_set_analytics() (line 1771 of /opt/jnana/all/themes/cirrus/template.php).
    Notice: Undefined index: version in _cirrus_set_analytics() (line 1772 of /opt/jnana/all/themes/cirrus/template.php).
    Notice: Undefined index: lang in _cirrus_set_analytics() (line 1773 of /opt/jnana/all/themes/cirrus/template.php).
    Notice: Undefined index: title in _cirrus_set_analytics() (line 1774 of /opt/jnana/all/themes/cirrus/template.php).
    Notice: Undefined index: version in _cirrus_set_analytics() (line 1775 of /opt/jnana/all/themes/cirrus/template.php).
    Notice: Undefined index: edition in _cirrus_set_analytics() (line 1776 of /opt/jnana/all/themes/cirrus/template.php).
    Notice: Undefined index: release in _cirrus_set_analytics() (line 1777 of /opt/jnana/all/themes/cirrus/template.php).
    Notice: Undefined index: type in _cirrus_set_analytics() (line 1778 of /opt/jnana/all/themes/cirrus/template.php).

Comment 8 David Le Sage 2016-12-14 03:54:56 UTC
Server is now working and docs have been restored.

Comment 9 Juraj Duráni 2017-01-16 09:54:46 UTC
The chapter has been added, but I have several suggestion for improvement.

1.
Step 4. -the path is incorrect. Script is in folder "cli-scripts" not "scripts". I suggest to update path as follows:
--file=<JBOSS_HOME_DIR>/cli-scripts/teiid-domain-mode-install.cli

2.
Step 4. - the script installs JDV in both "ha" and "full-ha" profiles.

3. Step 2. and 3. - could we add a link to EAP documentation? There are few more steps user need to do in order to run slave node. Or better, link the chapter 7.2 of the same guide and link EAP documentation there (in chapter 7.2. Start JBoss EAP 6 as a Managed Domain)


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