This guide provides step-by-step instructions on how to get started with Puppet for Junos OS in order to automate network configuration and orchestration.

1. Puppet for Junos OS How-to Guide
Introduction
Puppet is IT automation software developed by Puppet Labs to manage large-scale server deployments in the data
center. Puppet for Junos OS enables IT organizations to automate network configuration and orchestration, allowing
seamless integration with the rest of the compute (physical or virtual) infrastructure when it is automated by Puppet.
This guide provides step-by-step instructions on how to get started with Puppet.
Puppet for Junos consists of two different components.
Puppet Server Module: This is the module that is installed
in the Puppet Master and used to communicate to the puppet
agent on the Juniper devices.
Junos Puppet Agent: Runs on the Juniper device included
in the “jpuppet” package.
The Puppet for Junos solution requires the installation of
both these modules. Puppet for Junos is supported on the
12.3R2 release.
Installing the Puppet Server Modules
The Puppet server modules are installed the same as any
other Puppet module today. Running the following
commands will automatically install all the required
components.
gem i nst al l net conf
puppet m odul e i nst al l j uni per / net dev - st dl i b- j unos
Installation and Configuration of the jpuppet Agent on Junos
Download the jpuppet package from Puppet Labs and store it in a location on your network.
ht t ps: / / downl oads. puppet l abs . com j unos/
/
Installation
• Allow Junos accepts commercial package:
set system extensions providers juniper license-type juniper deployment-scope
commercial
commit and-quit
• Install the package on top of Junos:
request system software add path-to-jpuppet-package no-validate
© Juniper Networks, Inc. | 1

2. Puppet for Junos How-to Guide
• Configure the account username, login class, authentication method, and shell:
set system login user puppet class <class>
set system login user puppet authentication <credentials>
set system login user puppet shell csh
commit
Configuration
After installing the jpuppet package on a Junos device, configure the agent to talk to the Puppet master.
Go under shell as Puppet…
> start shell
%
• Setup ENV variable
% setenv PATH ${PATH}:/opt/sdk/juniper/bin
• Create directory structure:
% mkdir -p $HOME/.puppet/var/run
% mkdir -p $HOME/.puppet/var/log
• Setup puppet.conf under $HOME/.puppet directory.
#puppet.conf
[main]
libdir = $vardir/lib
logdir = $vardir/log/puppet
rundir = $vardir/run/puppet
ssldir = $vardir/ssl
factpath = $libdir/facter
moduledir = $libdir
pluginsync = true
[agent]
server = tme-puppetm-01.dcbg.juniper.net
classfile = $vardir/classes.txt
localconfig = $vardir/localconfig
daemonize = false
Detailed information on how to install the jpuppet package is available at
http://www.juniper.net/techpubs/en_US/junos-puppet1.0/information-products/pathway-pages/junos-puppet.html.
Start Puppet Run
A Puppet run can now be started using the following command.
% puppet agent -t --no-daemonize
© Juniper Networks, Inc. | 2

3. Puppet for Junos How-to Guide
More Information
• Puppet for Junos OS Administrative Guide: http://www.juniper.net/techpubs/en_US/junos-puppet1.0/information-
products/pathway-pages/junos-puppet.html
• Puppet Labs Juniper Networks Solutions: https://puppetlabs.com/solutions/juniper-networks/
• Download:
- Junos jpuppet package: https://downloads.puppetlabs.com/junos/1.0R1.1/
- Junos Puppet Netdev modules:
http://forge.puppetlabs.com/juniper/netdev_stdlib_junos
http://forge.puppetlabs.com/netdevops/netdev_stdlib
Corporate and Sales Headquarters APAC Headquarters EMEA Headquarters
Juniper Networks, Inc. Juniper Networks (Hong Kong) Juniper Networks Ireland
1194 North Mathilda Avenue 26/F, Cityplaza One Airside Business Park
Sunnyvale, CA 94089 USA 1111 King’s Road Swords, County Dublin, Ireland
Phone: 888.JUNIPER (888.586.4737) Taikoo Shing, Hong Kong Phone: 35.31.8903.600
or 408.745.2000 Phone: 852.2332.3636 EMEA Sales: 00800.4586.4737
Fax: 408.745.2100 Fax: 852.2574.7803 Fax: 35.31.8903.601
Copyright 2013 Juniper Networks, Inc. All rights reserved. Juniper Networks, the Juniper Networks logo, Junos, NetScreen, and ScreenOS are registered trademarks of
Juniper Networks, Inc. in the United States and other countries. All other trademarks, service marks, registered marks, or registered service marks are the property of their
respective owners. Juniper Networks assumes no responsibility for any inaccuracies in this document. Juniper Networks reserves the right to change, modify, transfer, or
otherwise revise this publication without notice.
April 2013
Juniper Networks, Inc. | 3