Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This resolves an issue where UAM cannot reach all devices if some of them were cloned after their initial configuration.

Table of Contents
Info

For more information on how to execute scripts in different environments, view the “Client Scripts” page.

Contents of Package

This scripts script is composed of 2 python two Python files:

  • ApiClient.py

  • DuplicateNodeScript.py

  • : ApiClient can be used to interface with the Edge Node’s API but will do nothing if run directly.

  • DuplicateNodeScript.py: DuplicateNodeScript must be run in the same folder with ApiClient.

There is an examples folder an export csv The “Examples” folder contains a CSV that can be used as an example of formatting.

...

When first run, it will create a Node folder. In that folderTo detect and correct duplicates, place an appropriately formatted CSV and when next run file in the Node folder. Execute the command again and the devices will be scanned and modified as required.

Info

The devices whose Node IDs are changed will have the Edge Manager restarted.

For further details on running scripts in different environments, see Client Scripts

CSV Formatting

The CSV file’s top row of the CSV file must include the following headers:

...

Each column's meaning is detailed below

Site Name

The unique name for the site , this which will be assigned to the to level Node of the edge Edge device. Each Site Name must be unique within the CSV.

Edge Device IP

The IP address or url URL of the edge Edge device; this is the IP we will attempt to contact. Unless otherwise specified, it will be assumped an IP or url is of the format, Eg By default, the IP address will be preceded with “http://” and the port used will be 8080, e.g. “192.168.0.10” will be read as “http://192.168.0.10:8080”. If a different port is expected, or the node is configured for https, that must be included, eg e.g. https://192.168.0.10:8181”. Each Edge Device IP must be unique within the CSV.

reachable

If this is a Enter the lower case letter x in this field to signify the script will should attempt to connect to and configure the device. Otherwise If any other value is entered, or it is left blank, this row will be ignoredskipped.

eACM username

The web interface username used to connect to the Edge Manager website and API. Default: admin

eACM password

The web interface password used to connect to the Edge Manager website and API. Default: admin

OS username

The operating system username

OS password

The operating system password

Output

Depending on the results of While the script is running, files will be collected from the Import folder and moved into the Process folder. After running the script, the files will be moved as follows. The files will end up in into one of four subfolders of Importsthese:

  • Complete - The script has successfully run succesfully on at least one of the devices in the csvCSV file. Consult the log for details.

  • Error - Either the script did not recognize the formatting of the csv CSV file or one of the devices in the csv CSV file did not recognize the formatting of the json JSon file. Check the log for details.Process - Files should only be here while the script is running; they will be collected from Import, moved to Process, then sent to Error or Complete. Any files that remain

  • here Unrecognized - Files that are not CSV or JSon, as well as CSV and JSon files without matching names, will be moved here.

Note

Any files that remain in the Process folder when the program is done indicate an unexpected exception. Check the log for further details and contact support if necessary

...

.

Logs

This script will generate its logs in NodeScript.log. It can be checked for further details if an error appears in the Complete report.