Data Collection for Epiphany

This guide is under construction. Please excuse our dust.

Junos OS SSH Collection

Epiphany also has the capability to extract network appliance information via Secure Shell (SSH). The SSH collectors will establish an SSHv2 session with the appliances and run the needed show commands for data collection.

If there are firewalls between the local Epiphany collector and a network appliance, configure the firewall to allow SSH traffic from the collector to the network appliance.

Step 1: Provide the following data for each Juniper OS network appliance:

• IP Address

• Username/Password

• Generate a new user:

set system login user epiphany class read-only authentication encrypted-password <password>

This data is must be provided via in JSON format.

Example Data:

{"ip":"192.168.0.1",
    "user":"username",
    "passw":"password123"},
{"ip":"192.168.0.2",
    "user":"username",
    "passw":"password123"}

Step 2:

• Upload the credentials via the process described in the Submission section in the Juniper OS Manual Collection section below.

Juniper OS Manual Collection

If Ephiphany's collectors can't reach your assets via an API or SSH, data can be manually collected for the network modeling process. A command line interface (CLI) connection to the devices is needed, as well as a terminal emulator such as Putty or SecureCRT, capable of logging data presented via the show commands used.

Step 1:

• Authenticate to the device.

• Run the following commands:

show configuration | display json
show arp
show route
show vlans
show chassis hardware
show version
show lldp neighbors

Submission

Once all data is collected from the JunOS dashboard, create a .zip file named Collector_Upload_JunOS.zip containing the data from JunOS.

To use secure copy protocol (SCP) to upload the file to the On-Premises Epiphany Collector, follow the steps below:

Step 2:

• Use a web browser to navigate to the Epiphany dashboard.

• Download PEM file to the local device. Once the PEM file is downloaded, it can be used to perform SCP of the compressed map folder to the Epiphany Collector.

Step 3:

Follow the steps below according to the operating system in use.

Linux

• Send the file to the ‘upload’ user using the following commands:

scp -i ~/.ssh/key.pem <Collector_Upload> upload@<Collector_IP>:~/upload

The PEM file and map file can be anywhere on the file system, so provide that file’s pathway for the SCP command.

Windows 10

• Enable OpenSSH Client on Windows 10 by going to Settings > Apps and features > Optional Features.

• Select Add a feature.

• Search for OpenSSH Client. If it is not already installed, install OpenSSH Client.

• Open a command prompt and use the following command:

scp -i ~/.ssh/key.pem < Collector_Upload> upload@<Collector_IP>:~/upload

The PEM file and map file can be anywhere on the file system, so provide that file’s pathway for the SCP command.