![](<https://www.versio.io/img/supported-technology/juniper.svg>)

# Juniper network device importer

Versio.io can import, historize and process configuration data from Juniper Networks network devices.

## Configuration

You can find the configuration option in Versio.io at `Environment settings > OneImporter > Configurations > Juniper`.

Here you can edit all existing configurations, create new configurations or delete existing configurations. To add a new configuration, enter a `Name` for your importer and an `Entity suffix` (default: `-juniper`) to clearly identify your Juniper entities.  
Note that the `Entity suffix` is fixed and cannot be changed afterwards.

Click `Add` to proceed to the configuration.

To edit an existing configuration, click the arrow on the left of your importer name to expand the configuration options.

The following configuration options are available:

| Field | Description | Advice |
| --- | --- | --- |
| **Name** | Meaningful name | Add the word "Juniper" to identify the importer when viewing the logs |
| **Active** | Option to activate and deactivate the configuration. Data is only imported if the configuration is activated. |  |
| **Port** | SSH port of the network devices. | Default is port `22`. |
| **Credential** | Select authorization for network device access. | Enter SSH username and password at `Settings > Access Management > Credential Vaults` |
| **Domains &amp; IPs** | Enter all network device domains or IPs. |  |
| **Entities** | Select the entities to be inventoried by Versio.io. |  |
| **Executing OneImporter** | Select a Versio.io OneImporter to import the data based on the importer configuration. | Requires an installed OneImporter: [Installation instructions](<https://docs.versio.io/setup-one-importer/index.md>) |
| **Schedule time (cron format)** | Determine the frequency of imports in CRON format | Learn more about CRON format: [https://en.wikipedia.org/wiki/Cron](<https://en.wikipedia.org/wiki/Cron>) |

*Table: Juniper network device configuration parameters*

## Create group and user on Juniper network device

Versio.io runs the following commands on your Juniper network device to inventory it:

```text
show configuration | display xml
show chassis environment | display xml
show chassis hardware | display xml
show chassis firmware | display xml
show configuration | display set 
show system configuration rescue | no-more | display xml
show chassis mac-addresses | no-more | display xml
show virtual-chassis | no-more | display xml
show chassis cluster status | no-more | display xml
show chassis cluster information | no-more | display xml
show chassis cluster interfaces | no-more | display xml

# Network topology
show lldp neighbors detail | no-more | display xml
show ethernet-switching table | no-more | display xml
```

*Commands: Executed commands for inventory*

For the inventory, it is necessary to create a group and a user so that Versio.io can authenticate itself on the Juniper network device. You can create the group and user with the following commands:

```text
cli 
configure 

# Create an inventory group on Juniper network device
set system login class versioGroup permissions all
set system login class versioGroup allow-commands "^(quit|show (configuration|system configuration rescue|interfaces|virtual-chassis|lldp neighbors detail|ethernet-switching table|(chassis (hardware|environment|firmware|mac-addresses|cluster status|cluster information|cluster interfaces))))$"
set system login class versioGroup deny-commands .*

# Create an inventory user on Juniper network device  
set system login user versioUser class versioGroup
set system login user versioUser authentication encrypted-password <PASSWORD>

commit and-quit
```

*Commands: Create an inventory group and user*

## Reference

- [CLI User Guide for Junos OS](<https://www.juniper.net/documentation/us/en/software/junos/cli/index.html>)
