This guide is designed to make it as easy as possible to get your Junos device connected to OneConfig. We'll walk you through the simple steps to add your device, get the configlet and add it to your device. We'll have you using OneConfig in no time!

Add your device.

When you login to OneConfig you'll see the dashboard and a link asking you to add a device. When you click on this you will be prompted for some information such as device name, type, username and password.

1. Get the configuration snippet from OneConfig Web interface

When you've added the device you'll have two ways to get the configuration snippet. Firstly, there will be a popup box in the application which can be copied directly. Secondly, there will be an email sent to your nominated email address containing the configlet details. This configuration is a list of "set" commands of which you will paste on to your Juniper device using a terminal session.

2. Add the configuration to your Juniper SRX or EX

2.1 Telnet or SSH to the device

Find your terminal session software (such as Putty for Windows, or Terminal/iTerm for the Mac) and initiate a Telnet or SSH session to your device's IP address or hostname. Login with your usual administrator details.

At this point it is useful to ensure that your Juniper device will be able to contact OneConfig with a quick ping test.

Issue the following command:

lab@SRX> ping my.oneconfig.com 
PING my.oneconfig.com (192.237.250.140): 56 data bytes
64 bytes from 192.237.250.140: icmp_seq=0 ttl=64 time=1.301 ms
64 bytes from 192.237.250.140: icmp_seq=1 ttl=64 time=2.158 ms
^C
--- my.oneconfig.com ping statistics ---
2 packets transmitted, 2 packets received, 0% packet loss
round-trip min/avg/max/stddev = 1.301/1.729/2.158/0.429 ms

lab@SRX>

- if you receive no result from ping you should check routing, next-hop or your DNS settings. - (optional) add static host mapping

2.3 enter configuration mode

To enter configuration mode issue the following command:

lab@SRX> configure 
Entering configuration mode

[edit]
lab@SRX# 

2.4 copy/paste in the configuration lines

Here is an example configuration snippet, you should paste it in to the terminal "[edit]" mode:

[edit]
lab@SRX# set system services ssh protocol-version v2 

[edit]
lab@SRX# set system login user oneconfig class super-user 

[edit]
lab@SRX# set system login user oneconfig authentication encrypted-password

[edit]
lab@SRX# set system services outbound-ssh client oneconfig device-id new-device-devco 

[edit]
lab@SRX# set system services outbound-ssh client oneconfig secret

[edit]
lab@SRX# set system services outbound-ssh client oneconfig keep-alive retry 3 

[edit]
lab@SRX# set system services outbound-ssh client oneconfig keep-alive timeout 5 

[edit]
lab@SRX# set system services outbound-ssh client oneconfig services netconf 

[edit]
lab@SRX# set system services outbound-ssh client oneconfig my.oneconfig.net port 4087 

[edit]
lab@SRX# set system services outbound-ssh client oneconfig my.oneconfig.net retry 1000 

[edit]
lab@SRX# set system services outbound-ssh client oneconfig my.oneconfig.net timeout 60 

2.5 commit the configuration

[edit]
lab@SRX# commit 
commit complete

[edit]
lab@SRX# 

3.0 Go to my.oneconfig.com to ensure the device is connected You will see the device in the dashboard with a green icon to the right, and the device details in the table.

Thanks for adding your device to OneConfig. If you encounter any issues, please email support@oneconfig.com for assistance.