====== Puppet-Dashboard ======

**NOTE**: Depreciated

A GUI for managing puppet agents.

===== Rake API =====
The console provides rake tasks that can group nodes, create classes, and assign classes to groups. You can use these tasks as an API to automate workflows or bypass the console’s GUI when performing large tasks.
%%(bash)
pez:/usr/share/puppet-dashboard rake RAILS_ENV=production -f Rakefile <command>
%%
[[http://docs.puppetlabs.com/pe/2.5/console_classes_groups.html#rake-api Documentation]]
[[https://github.com/puppetlabs/puppet-dashboard Github]]
[[http://pez.votesmart.org:3000/nodes Puppet-dashboard on PEZ]]

======Guides======
The following are a few guides for getting it running smoothly on Pez.

==view signed certs==
%%(bash)
pez:puppetca list --all

# revoke a certificat

pez: puppetca clean <fqdn>

%%

==fix for puppetd agents on zbox==
Because the original setup was default, and addresses come from dhcp.

Edit ##/etc/default/puppet##
%%(bash)
# Defaults for puppet - sourced by /etc/init.d/puppet

# wait for the fqdn
sleep 10

# Start puppet on boot?
START=yes

# Startup options
DAEMON_OPTS="--server pez.votesmart.org"

%%

Then:

%%(bash)
# rm the old ssl certs
agent: rm -r /var/lib/puppet/ssl

# restart puppet
agent: /etc/init.d/puppet restart
%%

This will cause the agent to use it's ##dhcp-xxx.votesmart.org## fqdn for the generated certificate, which will be auto-signed by the puppetmaster. (puppet master is configured to auto-sign ##*.votesmart.org## as the fqdn.)

==delayed jobs==
In case where Pez has re-started and you notice that ##puppet-dashboard## is not processing the logs, make sure the ##delayed_job## script is running.

[[http://docs.puppetlabs.com/dashboard/manual/1.2/bootstrapping.html#starting-and-managing-delayed-job-workers delayed-job-workers]]

==scalability solution==
[[https://projects.puppetlabs.com/projects/puppet/wiki/Using_Mongrel_On_Debian Using Mongrel On Debian]]

==apt-update==
[[https://help.ubuntu.com/community/AutomaticSecurityUpdates Ubuntu Automatic Security Updates]]
[[https://help.ubuntu.com/10.04/serverguide/automatic-updates.html 10.04 unattended-upgrades]]

======Help======
[[http://www.mail-archive.com/puppet-users@googlegroups.com/info.html puppet-users group]]
irc.freenode.net #puppet

======Links======
[[http://puppetcookbook.com/ Puppet Cook-book]]
[[http://docs.puppetlabs.com/dashboard/manual/1.2/index.html puppet-dashboard 1.2 manual]]

CategoryITDefunct