# Data Collection for Epiphany

{% hint style="warning" %}
This guide is under construction. Please excuse our dust.
{% endhint %}

## **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.

{% hint style="warning" %}
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.
{% endhint %}

#### 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>
```

{% hint style="danger" %}
This data is must be provided via in JSON format.
{% endhint %}

#### Example Data:

```json
{"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*](#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.

{% tabs %}
{% tab title="Linux" %}

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

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

{% hint style="warning" %}
The PEM file and map file can be anywhere on the file system, so provide that file’s pathway for the SCP command.
{% endhint %}
{% endtab %}

{% tab title="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
```

{% hint style="warning" %}
The PEM file and map file can be anywhere on the file system, so provide that file’s pathway for the SCP command.
{% endhint %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.reveald.com/technical-documentation/data-sources-early-access/juniper-os/data-collection-for-epiphany.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.