Bug 1097129

Is this bug for documentation of Native Components, or Native Utilities? (or both?)

For Native Components on RHEL, I can use content from this KCS[1], but is there any similar content for Windows etc?

[1] https://access.redhat.com/site/solutions/222023

This bug is meant for both Native components and Native utilities. Neither of them is documented.

The process for installing natives is almost the same for all the platforms. 

I see in the KCS[1] just one part which differs and that is name of lib subdir [2]. Setting this explicitly is not needed for default locations, it is autodetected by the EAP if you set native="true" attribute of the web subsystem.




[1] https://access.redhat.com/site/solutions/222023
[2] <resource-root path="lib/linux-x86_64"/>     <!--   THIS LINE IS MANUALLY ADDED HERE -->

Thanks Radim.

I have begun work on a new topic for this: Download and Install Native Components and Native Utilities [35287]

New topic created with new content: Download and Install Native Components and Native Utilities [35287]

and inserted into the 6.3 Installation Guide [CS22510, rev. 665478].

The new topic can be previewed on DocBuilder:

http://docbuilder.usersys.redhat.com/22510/#Download_and_Install_Native_Components_and_Native_Utilities

Once a new build is done to the stage, the status will be changed to ON_QA when it is ready for review.

Nidhi will be doing extra work on the topic to address extra issues with native components raised in BZ#831862

New topic: "Download and Install Native Components and Native Utilities" [35287]
is onstage and ready for review (Revision 6.3.0-18):

http://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/Installation_Guide/index.html#Download_and_Install_Native_Components_and_Native_Utilities

Permaine,

could you please write down all package prerequisites for EAP natives on all RHEL platforms?

I am changing request for more information from Permaine to Weinan.

Weinan,
could you please write down all package prerequisites for EAP natives on all RHEL platforms?

I did preview and I suggest:

1. If there is not consistency reason or so, I suggest rephrase sentence :
'If you intend to use tomcat-native and the APR, the tomcatjss package must be removed before installing tomcat-native.'

To smth. like (all informations are important but my phrasing is not nice):
'If you intend to use 'Tomcat Native Library' which is part of 'Native component', the OS native package 'tomcatjss' must be removed before installation.'


2. I believe it will be useful to mention that 'Native component' consist of: 
'Native support for HornerQ (AIO)' (with related link) and 'Tomcat Native Library'.

FYI
Usage Tomcat Native Library implies usage of APR.

The changes from comment 13 are now onstage and ready for review (Revision 6.3.0-20):

http://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/Installation_Guide/index.html#sect-Installing_Native_Components_and_Utilities

Verified in revision 6.3.0-20 - FAILED

a] Procedure 4.13. Download and Install Native Components   
   Add information how the zip look like (jboss-eap-native-EAP_VERSION-ARCH.zip)

b] Procedure 4.14. Download and Install Native Utilities
   Add information how the zip look like (jboss-eap-native-utils-EAP_VERSION-ARCH.zip)

c] I still don't see any information about web connectors 
   I would expect very general information somewhere in text 
    * that web connectors are used for load balancing and clustering (1 sentence)
    * that web connectors are in archive like (1 sentence)
      jboss-eap-native-webserver-connectors-EAP_VERSION-ARCH.zip
    * how to configure them could be found in other guide (1 sentence)
   
   I expect this will affect (at least) following text, because it mentions only 
   'Native Components' and later in text we assume by 'Native components' 
   Tomcat Native libs only:
   ---------- 
   "Following Native Components installation, information on configuring specific
    Native Components is located in the Administration and Configuration Guide."
   ----------

Ok, about archive names, 
I have just checked that customer does not see archives directly but see understandable titles -> ignore my request regarding archives names from previous comment.

Thanks Jan, I have removed the paragraph you quoted in comment 15, and replaced it with a specific web connectors one:

"In addition to Native Components and Native Utilities, Webserver Connector Natives are used for load balancing and clustering. See the Administration and Configuration Guide to configure Webserver Connector Natives."

Change made in topic:  Installing Native Components and Utilities [38700, revision 680227].

Preview available on DocBuilder: http://docbuilder.usersys.redhat.com/22510/#sect-Installing_Native_Components_and_Utilities

Change from comment 17 is ready for review (Revision 6.3.0-21):

http://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/Installation_Guide/index.html#sect-Installing_Native_Components_and_Utilities

Verified in revision 6.3.0-21 - PASSED

The needinfo request[s] on this closed bug have been removed as they have been unresolved for 1000 days