Bug 1397288

Summary: Typo in logconv.pl man page
Product: Red Hat Enterprise Linux 7 Reporter: Marc Muehlfeld <mmuehlfe>
Component: 389-ds-baseAssignee: mreynolds
Status: CLOSED ERRATA QA Contact: Viktor Ashirov <vashirov>
Severity: low Docs Contact:
Priority: unspecified    
Version: 7.3CC: amsharma, mreynolds, nkinder, rmeggins
Target Milestone: pre-dev-freeze   
Target Release: 7.4   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: 389-ds-base-1.3.6.1-6.el7 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-08-01 21:12:24 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:

Description Marc Muehlfeld 2016-11-22 07:54:53 UTC 
Description of problem:
The logconv.pl(1) man page recommends to use a RAM disk for the -D parameter, if there is _NOT_ enough RAM, what makes no sense.



Version-Release number of selected component (if applicable):
DS 10.1: 389-ds-base-1.3.5.10-11.el7.x86_64
DS: 9.1: 389-ds-base-1.2.11.15-84.el6_8.x86_64



Steps to Reproduce:
1. Open the logconv.pl(1) man page



Actual results:
> -D, --data <Location for temporary data files>
>     DEFAULT -> /tmp
>     TIP -> If there is not enough RAM, a RAM disk can be used instead:



Expected results:
>     TIP -> If there is enough RAM...



Additional info:
This is wrong in the DS 9.1 and 10.1.
Comment 2 mreynolds 2017-03-31 14:50:55 UTC 
Upstream ticket:
https://pagure.io/389-ds-base/issue/49205
Comment 3 mreynolds 2017-03-31 16:34:47 UTC 
Fixed upstream
Comment 5 Amita Sharma 2017-04-04 07:17:43 UTC 
LOGCONV.PL(1)                                                 General Commands Manual                                                LOGCONV.PL(1)

NAME
       logconv.pl - analyzes Directory Server access log files
[root@ibm-x3250m4-02 ~]# rpm -qa | grep 389
389-ds-base-1.3.6.1-6.el7.x86_64
389-ds-base-libs-1.3.6.1-6.el7.x86_64

man logconv.pl
==================

SYNOPSIS
       logconv.pl [-h] [-d <rootDN>] [-s <size limit>] [-v] [-V] [-S <start time>] [-E <end time>] [-T <min etime>] [-efcibaltnxgjuU] [ access log
       ... ... ]

DESCRIPTION
       Analyzes Directory Server access log files for specific information defined on the command line

OPTIONS
       A summary of options is included below:

       -h, --help
              help/usage

       -d, --rootDN <Directory Managers DN>
              DEFAULT -> cn=directory manager

       -D, --data <Location for temporary data files>
              DEFAULT -> /tmp
              TIP -> If there is enough RAM, a RAM disk can be used instead:

                     mkdir /dev/shm/logconv, and use this directory for the "-D" value.

Hence VERIFIED.
Comment 6 errata-xmlrpc 2017-08-01 21:12:24 UTC 
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2017:2086