Bug 1270789

Summary: Missing environment parameter in puppet document.
Product: Red Hat Satellite Reporter: Ranjan Kumar <rankumar>
Component: Docs User GuideAssignee: Brandi Munilla <bmcelvee>
Status: CLOSED NOTABUG QA Contact: Lucie Jirakova <ljirakov>
Severity: medium Docs Contact:
Priority: medium    
Version: 6.1.2CC: adahms, bmcelvee, bugzilla_rhn, nshaik, sauchter
Target Milestone: Unspecified   
Target Release: Unused   
Hardware: All   
OS: All   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-11-11 21:09:53 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 Ranjan Kumar 2015-10-12 11:58:55 UTC 
Document URL: https://access.redhat.com/documentation/en-US/Red_Hat_Satellite/6.1/pdf/User_Guide/Red_Hat_Satellite-6.1-User_Guide-en-US.pdf

Section Number and Name: 12.6, Configuring the Puppet Agent 

Describe the issue: 
puppet "environment" is missing in agent section of puppet.conf configuration.

Suggestions for improvement: 
For correct syntax please refer:
https://access.redhat.com/documentation/en-US/Red_Hat_Satellite/6.1/html-single/Puppet_Guide/index.html#sect-Red_Hat_Satellite-Puppet_Guide-Applying_Configuration_on_Clients-Applying_Configuration_to_Existing_Clients 

Additional information: 
If environment is not set puppet agent throws warning 
Local environment: "production" doesn't match server specified node environment "KT_Environment", switching agent to "KT_Environment".
 
Here is sample 
[agent]
    # The file in which puppetd stores a list of the classes
    # associated with the retrieved configuratiion.  Can be loaded in
    # the separate ``puppet`` executable using the ``--loadclasses``
    # option.
    # The default value is '$confdir/classes.txt'.
    classfile = $vardir/classes.txt
    pluginsync = true
    report = true
    ignoreschedules = true
    daemon = false
    ca_server = satellite.example.com
    server = satellite.example.com
    environment = KT_Example_Org_Library_RHEL6Server_3

    # Where puppetd caches the local configuration.  An
    # extension indicating the cache format is added automatically.
    # The default value is '$confdir/localconfig'.
    localconfig = $vardir/localconfig
Comment 1 Douglas Furlong 2015-10-13 09:43:53 UTC 
Just to confirm.

This is the case when using puppet 2.7.23.2.el5sat, I'm assuming it's the case with the RHEL5 version of the client, and RHEL6 works fine without the Environment being set.
Comment 2 Andrew Dahms 2016-02-19 06:00:11 UTC 
Assigning to Brandi for review.

Brandi - looks like a quick fix to either add the 'environment' variable to the example in the documentation or a 'Note' box if it only applies to a specific version of RHEL, but we may need to raise a needinfo here to confirm this first.