Working With cfxEdgeCollector
Working with cfxEdgeCollector

Logging into cfxEdgeCollector User Interface (UI)

  1. 1.
    Open a browser and navigate to cfxEdgeCollector URL (https://<ipaddress>:8888)
  2. 2.
    Enter username and password as shown below.
  • The default username is cfxcollector
  • The default password is <Please contact CloudFabrix support>
Change default password using the following command from shell / CLI option
>>> cfxedgecollector configure --update password <new-password>
A sample login screen as shown below.
cfxEdgeCollector Login Screen
Click on the Sign-in button (as shown in the above screen capture) and the user will be logged into cfxEdgeCollector home page.

UI Logging using TACACS

  1. 1.
    Enter the following command to configure logging using Tacacs.
1
>>> cfxedgecollector authconfig --help
2
usage: cfxedgecollector authconfig [-h] [--authprovider {basic,tacacs}]
3
[--host HOST] [--port PORT]
4
[--secret SECRET] [--status]
5
[--timeout TIMEOUT] [--users USERS]
6
[--useradd USERADD]
7
[--userdelete USERDELETE]
8
9
optional arguments:
10
-h, --help show this help message and exit
11
--authprovider {basic,tacacs}
12
Type of the authentication provider
13
--host HOST auth server location
14
--port PORT auth server port
15
--secret SECRET secret for auth server
16
--status Show authentication status
17
--timeout TIMEOUT Authentication timeout
18
--users USERS Users who can access the edgecollector
19
--useradd USERADD Add an user to the allowed user list
20
--userdelete USERDELETE Remove an user from the allowed user list
21
Copied!

How to change authconfig for adding/modifying users

For changing authconfig, UI container should be in stopped state.

Adding Tacacs User:

1
>>> cfxedgecollector authconfig --authprovider tacacs --host <host IP or FQDN> --port <port number>
2
--secret <user> --timeout 15 --users <user>
Copied!

Finding AuthConfig Status

To find the authconfig status, run the following command
1
[For Basic]
2
>>> cfxedgecollector authconfig --status
3
4
Output:
5
Authentication provider: basic
Copied!
1
[For Tacacs]
2
>>> cfxedgecollector authconfig --status
3
Example Output:
4
Authentication provider: tacacs
5
Host: 10.95.107.169
6
Port: 49
7
Users: hari
Copied!

How to create new cfxEdgeCollector job

Job: A logical definition or entity in cfxEdgeCollector context that captures all the necessary details like IP Address, MAC address, etc, to run cfxEdgeCollector to collect inventory data from a network.
  1. 1.
    From the home screen, click on 'Create New Job' from the home screen as shown below.
2. The default value will be normal for the collection profile. Users can change this based on the user's request.
3. Enter the job name and click on the 'Seeds and Restrictions' tab.
4. Enter the IP address or IP addresses range under the 'Seed Addresses' text field provided in the UI. For example, 10.95.158.1 - 10.95.158.24, 10.95.159.*/24
The seed address is used to discover all the network devices in a multi-hop fabric network.
5. Enter the IP address /address range which needs to be excluded from the discovery and inventory data collection under 'Exclude addresses'. This helps users to exclude IP addresses which are not needed to be part of discovery operation within the user's network.
6. Enter the IP address/addresses range under the 'Contain-To' address field to limit the device discovery and inventory data collection to specified IP address/addresses range.
7. Enter maximum discovery hops or leave the default value.
8. Click on the 'Credentials' tab to select and enter the required credentials details for discovery operation using various protocols.
9. Select Credential Type to select the type of credentials for example SNMP, SSH, or other protocols.
10. Below screen capture provides an example of defining SSH credentials for executing CLI commands. IP address field is used to apply the credentials during discovery and inventory data collection.
11. Click on 'Tags' tab and click on Add to assign tag names based on network.
12. Click on 'Features' tab and select the options as shown.
Features tab allow users to pick and choose what features are needed during the discovery.
13. Click on 'Save' to save the job.

How to run cfxEdgeCollector job?

  1. 1.
    Navigate to cfxEdgeCollector command line folder/home directory where cfxedgecollector is installed using terminal(shell) console.
  2. 2.
    Execute cfxedgecollector collect command with necessary parameters to start the collection (discovery and collection of data as per job configured via UI).
1
example:
2
>>> cfxedgecollector collect <jobname>
Copied!
The following section provides an example:
1
>>> cfxedgecollector collect new
2
Picked load profile 'normal' from 'system' directory
3
Starting edge collection with load profile normal.[ memory minimum 2000m with 100 workers ]
4
549c33d4c0431c8c13599891ed8d62f26724ce136bcf2fb1a2408e11388baf1b
5
6
cfxedgecollector job is running in the background with Id: 549c33d4c043
7
8
License is a Trial License
9
License Granted To: EdgeCollector Trial License with Expiration Date: 01/30/2021
10
11
/collector-data/new/logs/discovery.log
12
/collector-data/new/logs/discovery_20200428061721.log
13
14
15
Starting Discovery Engine...
16
old logs archived at /collector-data/new/logs/discovery_20200428061721.log.zip
17
Total provided seed addresses: 1
18
Log/Data location: /collector-data
19
---------------------------------------------------------------------------------------------------------------------------------------------------------------------
20
| IP Address | Protocol | Port Status | Used credential | Auth status| Comment|
21
---------------------------------------------------------------------------------------------------------------------------------------------------------------------
22
Seeding hosts information..
23
Starting discovery worker threads...
24
| 10.95.158.1 | ICMP | (Not Applicable) | | Success | |
25
| 10.95.158.1 | snmpv2c | 161(Not Applicable) | snmp | Success | Cisco IOS Software, C3560E Software (C3560E-UNIVERSALK9-M), Ver|
26
Collection status....
27
Total/Completed/Pending 1/0/1 ; Success/Failed/Duplicates 0/0/0
28
| 10.95.158.1 | SSHV2 | 22(Success ) | ssh | Success | 15.2(3)E:CFX-MainSwitch:FDO1709Z29Q:FDO1709Z29Q|
29
Total/Completed/Pending 1/0/1 ; Success/Failed/Duplicates 0/0/0
30
Total/Completed/Pending 1/0/1 ; Success/Failed/Duplicates 0/0/0
31
Total/Completed/Pending 1/1/0 ; Success/Failed/Duplicates 1/0/0
32
Discovery and Connector Execution is finished.
33
Gracefully shutting down Host Seeder Threads
34
Gracefully shutting down SNMP Worker Threads
35
Gracefully shutting down Connector Worker Threads
36
Gracefully shutting down DNS Resolver Threads
37
Collection completed (Duration: 76 secs)
38
-
39
Overall Job Summary:
40
======================
41
42
Seeded: 1, In Progress: 0, Success: 0, Partial Success: 1, Failed: 0, Duplicate: 0
43
Copied!
cfxedgecollector collect --help provides syntax and supported CLI options.

How to export the collected inventory data

  1. 1.
    Run below command to export the collected data locally.
1
>>>cfxedgecollector export --jobname <job-name> --localonly
Copied!
The above command creates a zip file of the collected inventory data of all devices and will be saved under ~/cfxedgecollector-1.0.27/exported-data folder/directory.
Note: This inventory data can be later uploaded to back-end applications (cfxAIA).
Last modified 1yr ago