# Puppet Commands

### FACTER

| Command | Description |
| ------- | ----------- |
| `facter` | show all facters |
| `facter osfamily` | show OS Family facter |
| `facter -y` | show facters in YAML|
| `facter -j` | show facters in JSON |
| `notify { "OS is ${::facts['operatingsystem']}": }` | use fact inside a manifest using 'facter' function |
| `notify { "OS is $::operatingsystem": }` | use fact inside manifest directly |
| `$::operatingsystemmajrelease` | get OS major release from manifest |

### PUPPET AGENT

| Command | Description |
| ------- | ----------- |
| `puppet agent --test (or -t)` |Apply catalog using -verbose, -ignorecache, -no-daemonize -detailed-exit-codes, -show_diff |
| `puppet agent -t --debug` |Run in debug mode with more output |
| `puppet agent -t --noop ` | Run simulation (no changes to system)|
| `puppet agent -t --environment development` | Run catalog for different environment than whats configured in Puppet Agent's conf file |
| `puppet agent --disable` | Disable puppet agent from running on node|
| `puppet agent --enable` | Enable puppet agent to run on node |
| `puppet resource package` | show all installed packages |
| `puppet resource package apache ensure=present/absent` | install or remove package |
| `puppet resource` | show all managed resources |
| `puppet agent -t --graph` |show a graph of all dependencies found in a catalog, stored in a .dot image |

### Mcollective

| Command | Description |
| ------- | ----------- |
| `sudo -i -u peadmin` |Run MCollective as 'peadmin'|
| `mco ping` |check connection to nodes |
| `mco facts timezone` |get nodes by Facter name|
| `mco puppet count` |check how many MCO nodes are running|
| `mco rpc service restart service=httpd` | restart apache service|
| `mco package status puppet` | check status of a package |
| `mco inventory ––list-collectives` | list all subcollectives |
| `mco puppet disable -I nodename` |disable puppet agent on node |
| `mco ping -F architecture=x86_64` | find all nodes that are x64 |
| `mco find ––with-identity /nyc/` |find all nodes containing NYC in hostname |
| `mco find ––with-class nginx` |find all nodes with nginx class|
| `mco puppet runall -F osfamily=Redhat 5` |kick off 'puppet agent -t' on your nodes |
| `mco ping -T us_collective` |run command against a subcollective |
| `mco service ntp start -I ny14.nyc` |start/stop service on a node |
| `mco plugin doc` |show all available MCO plugins |
| `mco rpc puppet last_run_summary` |show last run statistics for all nodes |
| `/var/lib/peadmin/.mcollective.d/client.log` |mco client logs (on PE Master) |

### Modules

| Command | Description |
| ------- | ----------- |
| `puppet config print modulepath`|print modulepath|
| `puppet help module` |modules help|
| `puppet module search 'nginx'`|search available modules: (PuppetForge)|
| `puppet module install author/module`|install a module|
| `puppet module generate author/module`|build new module with full skeleton|
| `puppet module list`| list installed modules |
| `puppet module list --tree`| check for missing module dependencies|
| `puppet module build author/module`|build a module release package (.tar.gz)|
| `puppet module changes`| show modified files of an installed module|


### Puppet Server

| Command | Description |
| ------- | ----------- |
| `puppet cert list --all`|List all certs|
| `puppet cert sign 'certname'` |sign certificate|
| `puppet cert clean 'certname'`|remove client cert|
| `puppet apply -e "class { 'my_super_module': version => '1.2'}"`|apply config directly from command line and pass parameter|
| `/var/log/puppetlabs/puppetserver/puppetserver.log`|Puppet Server log|
| `/var/log/puppetlabs/puppetdb/puppetdb.log`|PuppetDB log|
| `/etc/puppetlabs/puppet/ssl`|SSL certs location|
| `/etc/puppetlabs/puppet/puppet.conf`|Master Configuration file|
| `puppet config print all`|Print all configuration settings|