NAME

       puppet-device - Manage remote network devices

SYNOPSIS

       Retrieves  all  configurations  from the puppet master and apply them to the remote devices configured in
       /etc/puppet/device.conf.

       Currently must be run out periodically, using cron or something similar.

USAGE

       puppet device [-d|--debug] [--detailed-exitcodes] [-V|--version]

                       [-h|--help] [-l|--logdest syslog|<file>|console]
                       [-v|--verbose] [-w|--waitforcert <seconds>]

DESCRIPTION

       Once the client has a signed certificate for a given remote device, it will  retrieve  its  configuration
       and apply it.

USAGE NOTES

       One need a /etc/puppet/device.conf file with the following content:

       [remote.device.fqdn] type type url url

       where:  *  type: the current device type (the only value at this time is cisco) * url: an url allowing to
       connect to the device

       Supported url must conforms to: scheme://user:password@hostname/?query

       with: * scheme: either ssh or telnet * user: username, can be  omitted  depending  on  the  switch/router
       configuration  *  password:  the  connection  password  *  query:  this is device specific. Cisco devices
       supports an enable parameter whose value would be the enable password.

OPTIONS

       Note that any configuration parameter that´s valid in  the  configuration  file  is  also  a  valid  long
       argument.  For  example,  ´server´  is  a  valid  configuration  parameter,  so you can specify ´--server
       servername´ as an argument.

       --debug
              Enable full debugging.

       --detailed-exitcodes
              Provide transaction information via exit codes. If this is enabled, an  exit  code  of  ´2´  means
              there  were  changes, an exit code of ´4´ means there were failures during the transaction, and an
              exit code of ´6´ means there were both changes and failures.

       --help Print this help message

       --logdest
              Where to send messages. Choose between syslog, the console, and a log file.  Defaults  to  sending
              messages to syslog, or the console if debugging or verbosity is enabled.

       --verbose
              Turn on verbose reporting.

       --waitforcert
              This  option  only  matters  for  daemons  that  do not yet have certificates and it is enabled by
              default, with a value of 120 (seconds). This causes +puppet agent+ to connect to the server  every
              2  minutes  and  ask  it  to sign a certificate request. This is useful for the initial setup of a
              puppet client. You can turn off waiting for certificates by specifying a time of 0.

EXAMPLE

         $ puppet device --server puppet.domain.com

AUTHOR

       Brice Figureau

COPYRIGHT

       Copyright (c) 2011 Puppet Labs, LLC Licensed under the Apache 2.0 License

Puppet Labs, LLC                                  January 2013                                  PUPPET-DEVICE(8)