Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1200379

Summary: [Doc Bug Fix] Regression in Install the Apache HTTP Server included with JBoss EAP 6 (Zip)
Product: [JBoss] JBoss Enterprise Application Platform 6 Reporter: Michal Karm Babacek <mbabacek>
Component: DocumentationAssignee: David Michael <dmichael>
Status: CLOSED CURRENTRELEASE QA Contact: Michal Karm Babacek <mbabacek>
Severity: urgent Docs Contact:
Priority: unspecified    
Version: 6.4.0CC: dmichael, jan.snelders, jstefl, mbabacek, nziakova
Target Milestone: ER3Keywords: Documentation, EasyFix
Target Release: EAP 6.4.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Build Name: 22924, Administration and Configuration Guide-6.4 Beta-1 Build Date: 20-02-2015 09:06:16 Topic ID: 5728-742647 [Latest]
Last Closed: 2015-04-17 05:45:46 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Attachments:
Description Flags
diff_between_ER3_and_ER1-respin5 none

Description Michal Karm Babacek 2015-03-10 12:46:25 UTC
Created attachment 999894 [details]
diff_between_ER3_and_ER1-respin5

Title: Install the Apache HTTP Server included with JBoss EAP 6 (Zip)

Describe the issue:

Someone edited the command in a fashion that it makes no sense now, see the attachment. Login shell /sbin is completely wrong.


Call to action:

 - fix the article according to the undermentioned suggestion

Please, go to the Procedure 19.2, Section 4 and paste the text enclosed within {code} marks _verbatim_ in the documentation.

{code}
getent group apache >/dev/null || groupadd -g 48 -r apache
getent passwd apache >/dev/null || useradd -r -u 48 -g apache -s /sbin/nologin  -d HTTPD_HOME/httpd/www -c "Apache" apache
{code}

The text consists of two long lines. If you need to break any of these lines you must terminate the wrapped line with '\' symbol.
There follows an example of such formatting:

{code}
getent group apache >/dev/null || groupadd -g 48 -r apache
getent passwd apache >/dev/null || useradd -r -u 48 \
-g apache -s /sbin/nologin  -d HTTPD_HOME/httpd/www -c "Apache" apache
{code}

THX

Comment 2 Michal Karm Babacek 2015-03-10 13:04:24 UTC
*** Bug 1026536 has been marked as a duplicate of this bug. ***

Comment 3 Michal Karm Babacek 2015-03-10 13:14:36 UTC
Additional explanation and notes for Jan Snelders who reported the BZ  1026536: https://bugzilla.redhat.com/show_bug.cgi?id=1026536#c3

Comment 4 Michal Karm Babacek 2015-03-10 13:35:35 UTC
Regarding Chapter 5. Configure the Apache HTTP Server.
======================================================
The current text states:

> Switch to the new user account using the following command
> 
> sudo su apache
>
> and then configure the Apache HTTP server as the apache user
> to meet the needs of your organization. You can use the documentation
> available from the Apache Foundation at http://httpd.apache.org/
> for general guidance. 

The part about switching to apache user is wrong within our context. Besides, with nologin shell (which _is_ correct for apache user :-)), one can't switch to apache user's shell.

It does not matter as which user one configures Apache HTTP Server as long as the general user/group and ACL permissions on files remain correct.
ACL, user, group and SELinux configuration is described in RHEL Documentation.

Call to action
==============
Rephrase:

> Prior to starting the Apache HTTP Server, configure it to
> meet the needs of your organization. You can use the documentation
> available from the Apache Foundation at http://httpd.apache.org/
> for general guidance. 

Cheers

-K-

Comment 7 Michal Karm Babacek 2015-03-27 03:21:39 UTC
ok