Synaccess netBooter PDU Series User manual

netBooter™ PDU Series User Manual
Quick Startup Reference Guide
The system is shipped with the following default settings.
Local Master Serial Port
Networking
Baud Rate
9600
IP (Static)
192.168.1.100
Data Bits
8
Mask
255.255.0.0
Parity
None
Gateway
192.168.1.1
Stop Bits
1
Hardware
Handshaking
None
Default account Info:
Username: admin
Password: admin
Booting in DHCP Mode
Hold a pin in the “rst” hole when you supply power to the device. This will enable DHCP mode. The
default name of the PDU is REMOTEPDU; you can also find the MAC address printed on a label on top
of the unit.
Resetting to Default Settings
Hold a pin in the rst hole for 10+ seconds and release. This will reset all settings back to factory default,
including the administration settings (e.g. user accounts and passwords will be wiped and reset). Note
that this will NOT interrupt power operations on device outlets.

Connecting to your Device
Connecting via Ethernet (device is connected to network equipment)
Connect to the default static IP by connecting to 192.168.1.100 through your web browser or through
telnet. If the connection is successful on a web browser, you will receive a login prompt. The default
username and password is admin/admin.
If the connection is not successful, it is likely that your network configuration is incompatible with the
default static IP address (192.168.1.100), or the network settings were changed beforehand.
In order to view or change the network settings from this point on, you can either setup a direct ethernet
connection to your PC, or connect your PC via serial port (USB or DB9 depending on model).
Alternatively, you can enable DHCP mode by holding a pin in the “rst” hole when you supply power to the
device.
The default name of the PDU is REMOTEPDU; you can also find the MAC address printed on a label on
top of the unit. Please refer to your router manual to understand how to find the IP address associated
with this device name or MAC address. If you are using a netBooter PDU with an LCD screen, you can
press the “Select” button once to view the assigned IP address (pictured below):
Connecting via Ethernet (device is directly connected to PC ethernet)
In order to connect to a device that is directly connected to your PC via ethernet, you will need to
configure your PC networking settings. This section assumes your device is using default settings (e.g.
static IP 192.168.1.100).
For Windows users, please navigate to your “Network and
Internet Settings”; in Windows 10, you can right click on the
Ethernet icon on the bottom right of your screen (pictured on
the left).

Once you are in the Network & Internet settings window, find the ethernet port that corresponds to the
one you are directly connecting to your device, and click on the “Edit” button for IP Assignment (picture
shown below).
You will need to change the IP settings from “Automatic
(DHCP)” to “Manual”, with the following settings for IPv4 for a
device with default factory settings (also pictured on the left
image)
IP Address: 192.168.1.101
Subnet Mask: 255.255.0.0
Gateway: 192.168.1.1
Once these settings are saved, you should be able to
connect to your device at 192.168.1.100 over a web browser
or telnet.
Connecting via Serial Port (USB / DB9)
Connect your device via its serial port (USB or DB9, depending on model and configuration) to your PC.

For devices with USB serial ports, no extra drivers are needed
for modern versions of Windows. We will need to first retrieve
the COM port assigned to your device. For DB9 devices, this
will correspond to the assigned COM port that you have
connected your device to.
For USB devices, navigate to Device Manager (Windows Key
+ search “Device Manager”), and expand the “Ports (COM &
LPT)” section (pictured on the left).
You should see a “USB Serial Port (COMx)” entry, where x
corresponds to your device connection’s assigned COM port.
Now we can connect to your device now that we know the device is connected and you know your COM
port.Instructions here are provided for PuTTY, a popular client for Windows used to connect via telnet,
serial, and more. Ensure PuTTY is installed, or adapt the instructions to your client of choice.
Once PuTTY is installed, open the
application, and navigate to the
“Serial” section under Connection
on the left hand menu.
The default settings for serial
connections are as follows (also
pictured on left image):
Speed: 9600
Data Bits: 8
Stop Bits: 1
Parity: None
Flow Control: XON/XOFF

Once you have updated the settings,
navigate to the “Session” section at
the top of the left hand menu, set
connection type to “Serial”.
Set your Serial Line to the COM port
that your device is connected to, and
click on the “Open” button at the
bottom.
This will open a terminal console
session with the device. You can
verify you are connected to the device
by typing in “help” to see the help
menu.
Configuring Your Device
Configure System and Network Settings
In the Web UI, you can configure basic network settings in the “Network” section of the left hand menu.
This includes setting the device to DHCP mode, or configuring a static IP. For netBooter models that
support HTTPS (e.g. “DU*” series) HTTPS mode can be enabled for Web UI by setting the HTTP port to
443.

Basic System configuration settings can be configured in the “System” section of the left hand menu. Of
note, this includes enabling/disabling web access, telnet access, setting telnet authentication mode, and
enabling NTP or setting date time information in the absence of NTP.
If you are accessing the device via command line interface (e.g. Telnet or Serial port), you can refer to
the help menu by entering in the “help” command. For reference, key commands related to basic
network settings are documented in the following table:
CLI Command
Description
nwshow
Displays network settings and status, including IP address, gateway, MAC
address, and more
nwset
Resets the network interface
dhcp <x>
Sets IP to DHCP mode (x=1) or Static mode (x=0)
ip <ip> <mask>
Sets the static IP address of the device to <ip> and the mask to <mask>
Please note that this IP setting is only applicable if DHCP mode is disabled (e.g.
device is in static IP mode). In other words, if DHCP mode is enabled, this IP
setting is not active/relevant until static mode is enabled.
gw <gw>
Sets gateway IP to <gw> for static IP mode
Please note that this IP setting is only applicable if DHCP mode is disabled (e.g.
device is in static IP mode). In other words, if DHCP mode is enabled, this IP
setting is not active/relevant until static mode is enabled.
mac
Displays the Ethernet Port Mac Address
web <v>
Enables or disables web access.
“1” = Web access On
“0” = Web access Off

Outlet Setup
In the Web UI, you can configure various Outlet operation settings in the “Outlet Setup” section of the left
hand menu.
Please note that making a change in this section requires you to click on the “Save Outlet Settings”
button within that section (and not necessarily the Save button at the bottom of the screen.
For basic outlet operations and settings (pictured above), refer to the following table for more
information:
Setting
Description
Name
Configure a designed name for a given outlet
Enable Daily Power Recycle
If enabled, this will trigger a daily reboot at a specified time (see next
column “Recycle ClockTime”).
Recycle ClockTime
If “Daily Power Recycle” is enabled, then the daily reboot will happen
at this specified time.
Reboot Duration
When a Reboot operation is triggered for this outlet (including daily
power cycle and normal reboot operation), this setting describes how
long to wait (in seconds) between turning off and turning back on.
Power Up Initial State
When the device powers on, this sets what power state to set the
outlet to.
ON: Outlet will always be turned ON when the device powers up
OFF: Outlet will always be turned OFF when the device powers up
Prev State: Outlet will be set to the last known state before device was
powered off.
Lock Web Outlet ON/OFF and Reboot
Operation
If this setting is enabled, then users will be unable to control outlets via
Web UI (only monitor).
Only Enable Web Outlet Reboot
Operation
If this setting is enabled, then Web UI users will only be able to initiate
Reboot commands for outlet control (provided the previous “Lock web
outlet ON/oFF and reboot operation” is disabled).

Groups of outlets can be defined (pictured below) in the “Global Settings” section for group-based
operations (e.g. turn on/off/reboot all outlets in Group 1 or 2).
Sequential On Delay refers to the time to wait between turning on each outlet within the group.
If you would like to restrict access and control to specified outlets by user account, refer to the User
Administration and Outlet Reservation section.
SNMP
SNMP functionality is available on “DU*” model netBooters, and can be enabled and configured in the
“Network” settings of the left hand menu. netBooter PDUs support SNMPv1 and SNMPv2c.
Please note that changing SNMP settings requires a network restart, which can be done by clicking
on the “Restart Network” button.
MIB files can be found in the Download section of our Website Support section.

AutoPing
AutoPing gives you functionality to automatically reboot a set of outlets after a specified number of pings
to a destination IP fail. This can be used to test if a device powered by the PDU is still alive, and to
power cycle this device if no ping response is returned. This feature can be enabled and configured in
the “AutoPing” section of the left hand menu of the web UI.
Refer to the following table for more information on each setting:
Setting
Description
Destination IP
The destination IP to ping to test connectivity
Outlet List
The list of outlets to perform an action on (as defined by Action Type)
when specified number of ping failures happen
Ping Failures Before Action
The number of consecutive ping failures that happen before an action
takes place
Action Type
Action to take once specified number of ping failures happen.
Reboot: Reboots outlets specified in outlet list
On: Turns outlets in outlet list on
Off: Turns outlets in outlet list off
Email Only: Sends an email notification (provided network connectivity
on the PDU is still present)
Setting
Description
Ping Destination IP Interval
The time (in seconds) between each ping

Reboot Attempts to Fix Problem
For Action Type = ‘Reboot”, the number of times to attempt a reboot if
pings continue to fail. Max value is 254. A value of 0 will infinitely
attempt reboots.
ICMP Time Out in Seconds
(only on DU models)
The maximum time (in seconds, between 1 and 9) that the PDU will
wait for a ping response before determining failure.
AutoPing Stops if Network Link is Not
Active
(only on DU models. By default this is
always enabled on B series models)
If enabled, this setting will automatically disable AutoPing if an active
network link is not detected
User Administration and Per-User Outlet Reservation
User accounts can be configured and modified in the “Administration” section in the left hand menu of
the Web UI. Up to 3 user accounts can be created.
Additionally, outlets can be reserved for a given user, where only that user has access to that outlet’s
operations. A given outlet can only be reserved by 1 and not multiple users.
Event Logging and Notifications
Event logging can be configured to trigger on a specified set of events, and to either locally log the event,
or send an email notification on trigger.

Event logging can be configured in the web UI in the “Event Notification” section. Locally stored event
logging can be viewed in the “View Event Logging” section of the Web UI.
Refer to the following tables for documentation on each setting or event:
Event Trigger
Description
User Login
Anytime a user logs in (through any access method), an event is
logged
Outlet On/Off
Anytime outlet state is set to On, Off, or rebooted, an event is
logged
AutoPing/Reboot
Anytime autoping fires and triggers a reboot, an event is logged
AC Current Draw or KWH Threshold
**(DU models only)
Anytime specified AC Current draw threshold (configured in
following section) is crossed, an event fires
Environment Temperature Threshold
**(DU models only)
Anytime environmental low or high temperature threshold is
triggered (configured in following section), an event fires
External AC Voltage
**(DU series only with external AC sensing)
For customized 0x05 models (e.g. NP-0205DU), logs if external
power source is no longer present.
Additionally, for DU models with AC and temperature sensing, the following additional settings can be
configured:
Settings
Description
Aggregated AC Current Draw Threshold
Threshold (in Amps) to use for trigger “AC Current Draw” event
logging

Environment Temperature Upper Threshold
Upper temperature threshold (in Celsius) to use for triggering
“Environment Temperature Threshold” event logging
Lower Threshold
Lower temperature threshold (in Celsius) to use for triggering
“Environment Temperature Threshold” event logging
Email Interval (in Minutes)
Interval between email (in minutes), specifically for current and
temperature threshold event notifications via email
Local Event Logging & SNMP TRAP Sending
(in Seconds)
Interval (in seconds) to wait, specifically for current and
temperature threshold events, in between log a local event or
sending SNMP TRAP
FAQ and Troubleshooting
I’m having trouble connecting to my device
Common issues related to initial connection typically relate to varying network setups.
If your network uses static IP for its clients, make sure no other client is using 192.168.1.100 on your
local network to access any factory default PDU unit through that IP address.
If your network set up uses DHCP to assign IP addresses, then you can restart the device in DHCP
mode. Once you restart the device in DHCP mode, check your router for the connection made for your
device’s IP address, device name (default value is REMOTEPDU), or MAC address (printed on a label
on top of the PDU). Once you have a working IP address, you can connect to your device with telnet or
web page to further tweak any settings to your needs.
If none of the following works to access your device, then accessing the PDU via serial port or a direct
ethernet connection is a reliable way to connect.
My device is connected to the network but I cannot access my device’s webpage
If you can’t access the webserver of your PDU but it’s connected to the network, then ensure your
webserver is enabled by issuing a “web 1” command over telnet or serial command line interface.
If the webserver is enabled, then sometimes restarting the PDU’s network interface card will fix any
intermittent issues. Try using the command ‘nwset’ inside a telnet or serial console session to restore
inactive networking applications. Using nwset will not reset your outlets.

Will resetting the PDU power cycle the outlets?
If you reset your PDU using “nwset” or “Restart network”, your device outlets will maintain their power
state through a reset.
Why am I getting a 414 error when accessing the PDU webpage from a domain name?
Depending on the PDU model, the longest allowable domain name is no longer than 15 characters. Be
sure to clear all cookies and cache. If a previous left cookie exceeds a certain length, a 414 error can
happen. To fix this, clear all cookies and cache on your browser/http client.
Is there a programmable API / Scripting support?
There is a programmable HTTP API you can utilize for any scripting needs from an external source. You
can access them through any programming language that can receive and issue HTTP requests. Visit
our GitHub for code examples. Additionally, you can utilize telnet/serial inside scripts to create
programmable functions for the device.
How do I operate the yellow “Manual Switch” button on the PDU?
Most netBooter DU models with more than 2 ports have a yellow button on the face of the PDU that
allows you to manually control outlet power state.
Pressing this button once will go into “selection” mode, where the LED for a given power outlet will start
blinking. If the LED is blinking, this means you have currently selected that given outlet. Each time you
press the Manual Switch button, you will go to the next outlet.
In order to change the power state once a given outlet is selected, hold down the Manual Switch button
for 3 seconds. You should hear a click, and the outlet state will flip.
Appendix: CLI Commands
The following table summarizes various CLI commands available via Telnet or direct serial port
connection.

Networking and System Configuration/Operations
CLI Command
Description
nwshow
Displays network settings and status, including IP address, gateway, MAC
address, and more
nwset
Resets the network interface
dhcp <x>
Sets IP to DHCP mode (x=1) or Static mode (x=0)
ip <ip> <mask>
Sets the static IP address of the device to <ip> and the mask to <mask>
Please note that this IP setting is only applicable if DHCP mode is disabled (e.g.
device is in static IP mode). In other words, if DHCP mode is enabled, this IP
setting is not active/relevant until static mode is enabled.
gw <gw>
Sets gateway IP to <gw> for static IP mode
Please note that this IP setting is only applicable if DHCP mode is disabled (e.g.
device is in static IP mode). In other words, if DHCP mode is enabled, this IP
setting is not active/relevant until static mode is enabled.
mac
Displays the Ethernet Port Mac Address
web <v>
Enables or disables web access.
“1” = Web access On
“0” = Web access Off
mask <m>
Sets the mask of the device to <mask>
emailsend
Sends a test mail to the configured email(s)
hp <port>
Sets the HTTP port to <port>
tp <port>
Sets the Telnet port to <port>
help
Help menu
Ipsrc <ip>
Sets filtered source IP to <ip>, and only allows said ip to access unit
login
Logs into the unit
logout
Logs out of the unit
sysshow
Shows system information
ver
Shows version of firmware

Power Outlet Operations
CLI Command
Description
pset <n> <v>
Sets outlet # <n> to <v>, where <n> represents the outlet number, and v
represents state (0 is OFF, 1 is ON)
For example, “pset 2 1” will set outlet number 2 to ON
ps <v>
Sets all outlets to state <v>, where 0 is OFF and 1 is ON
pshow
Shows outlet status
rb <n>
Reboots outlet <n>
gpset <n> <v>
Sets outlet group <n> to <v> (0 is OFF and 1 is ON)
For example, “gpset 1 0” will turn off all outlets in group 1
grb <n>
Reboots outlet group <n>
Appendix: HTTP API / Programming Interface Reference
The unit can be easily managed by using direct TCP or serial port interfacing.
Using Telnet
Port: default port # is 23.
Format: CmdCode Arg1 Arg2
Using HTTP/HTTPS.
Note: HTTPS is applicable only for *DU* models.
http://my_IP_addr/cmd.cgi?cmdCode Arg1 Arg2
Command LIst
Command
Code
Description/Args
Set Outlet ON/OFF
$A3
Arg1: Outlet Number
Arg2: State (0=OFF, 1=ON)
Example to turn off outlet 1
“http://192.168.1.100/cmd.cgi?$A3 1 0”
Reboot
$A4
Outlet Number

Example to reboot outlet 2
“http://192.168.1.100/cmd.cgi?$A4 2”
Get Outlet Status
$A5
Returns:
xxxx,cccc,cccc,tt
OR xxxx,cccc,tt
Where each “x” denotes an outlet state (1=ON, 0=OFF), with the
right most “x” representing outlet 1.
“c” denotes AC current draw(amps) and “t” represents temperature
(Celsius)
Set all Outlets to
ON/OFF
$A7
1 = ON, 0 = OFF
Return Codes
The Programming interface will return a code as described in the following table
Code
Description
$A0
OK - Executed successfully
$AF
Action failed or unknown