Scroll to navigation

px2_configure(1p) User Contributed Perl Documentation px2_configure(1p)

NAME

px2_configure - deploy and configure PX2

SYNOPSIS

px2_configure COMMAND [ARGUMENTS]

DESCRIPTION

PX2 deployment and configuration utility.

COMMANDS

Configure some or all devices (network settings, unit name and SNMP settings).

The behavior of this command is different depending on whether concrete IP addresses or the 'all' keyword is specified:

  • If IP addresses are specified the program will contact each device, read its serial number and search for a matching entry in the device list. It will then change the device's network settings to the values from the device list. The initial IP addresses do not have to match the values from the device list, they might as well be dynamically assigned by a DHCP server.
  • If the 'all' keyword is specified the IP addresses are taken from the device list. The devices' network settings are expected to be properly configured at this point, so the network configuration part will be skipped.
Verify device settings and SNMP access.
Identify some or all devices (show a distinctive string for two seconds in each unit's display).
Reboot some or all devices.
Fetch fitness data from some or all devices and write them to a file in CSV format.
Device firmware update. The firmware image will be sequentially uploaded to each device, then all devices will be instructed to perform the firmware update in parallel.
Print list of supported timezones with its IDs.
Set the timezone of all devices.

ARGUMENTS

Device list in CSV format.
Device IP addresses; use 'all' to run on all IPs in the CSV file.
Device IP address.
Output file name.
Firmware image file.
Timezone ID as printed by the "print_timezones" command.

EXAMPLES

Connect to the device at 192.168.2.3, read its serial number and look it up in the device list file named devices.csv. Configure the device's network, PDU name and SNMP settings.
Verify the network settings, PDU name and SNMP access for all devices in the list file.
Update all devices to firmware version 2.1.6.

DEVICE LIST FORMAT

The device list file contains a list of PX2 devices in CSV format. It could e.g. be exported from an inventory spreadsheet. Each device line contains five or six fields, separated by commas:

1. Unit Serial Number
2. PDU Name
3. IP Address
4. Gateway IP Address
5. Netmask
6. Optional comment; the line is ignored if "ignore" is included here

Lines with less than five fields are silently ignored. Likewise, lines that do not contain a valid serial number (i.e. a string starting with 'P') are disregarded.

REQUIREMENTS

The following Perl modules are required to run this script:

Additionally, the verify command uses the snmpget utility to verify SNMP access.

2020-09-24 perl v5.30.3