Terminal (Program Port/Telnet) Commands
104
NX-Series Controllers - WebConsole & Programming Guide
Terminal (Program Port/Telnet) Commands
Overview
There are two types of terminal communications available on NetLinx Integrated Controllers:
Program Port
- The "Program" port is a Type-B USB port located on the Master that allows terminal communication with
the Master. This type of terminal communication requires that you are physically connected to the Master to access the
configuration options and commands supported. Since this method of terminal communication requires physical
proximity as well as a physical connection to the Master, it is the most secure form of terminal communication.
For this reason, all Security Configuration options are only available via the Program port (and cannot be accessed via
Telnet).
Telnet
- This type of terminal communication can be accessed remotely, via TCP/IP. It is a less secure form of terminal
communication, since it does not require a physical connection to the Master to connect. Further, the Telnet interface
exposes information to the network (which could be intercepted by an unauthorized network client).
NOTE:
It is recommended that you make initial configurations as well as subsequent changes via the WebConsole. Refer to the On-
Board WebConsole User Interface section on page 34.
section on page 105 for a listing of all commands available in a terminal session.
Note that all commands in the table are available for both Program Port and Telnet sessions, with two exceptions: "Help Security"
and "Resetadminpassword". These commands are only available via a Program Port connection.
Establishing a Terminal Connection via the Program Port
To establish a terminal session via the Program Port, the USB port on your PC must be physically connected to the Program port on
the NetLinx Master.
Establishing a Terminal Connection via Telnet
1.
In your Windows task bar, select
Start > Run
to open the Run dialog.
2.
Type
cmd
in the
Open
field and click
OK
to open an instance of the Windows command interpreter (cmd.exe).
3.
In the CMD (command), type "
telnet
" followed by a space and the Master’s IP address info.
Example:
>telnet XXX.XXX.XXX.XXX
4.
Press
Enter
.
Unless Telnet security is enabled, a session will begin with a welcome banner:
Welcome to NetLinx vX.XX.XXX, AMX LLC
>
If Telnet security is enabled, type in the word
login
to be prompted for a Username and Password before gaining access to
the Master.
5.
Enter your username to be prompted for a password.
If the password is correct, you will see the welcome banner.
If the password is incorrect, the following will be displayed:
Login: User1
Password: *****
Login not authorized. Please try again.
After a delay, another login prompt will be displayed to allow you to try again.
If after 5 prompts, the login information is not entered correctly, the following message will be displayed and the
connection closed:
Login not allowed. Goodbye!
To restrict access to the Master via terminal connection, enable Telnet/SSH on the Master via the Telnet/SSH option on the
Security page - see the
section on page 124 for details). With Configuration Security enabled, a
valid user with Configuration Security access will have to login before being able to execute Telnet commands. If security
is not enabled, these commands are available to all.
If a connection is opened, but a valid username / password combination is not entered (i.e. just sitting at a login prompt),
the connection will be closed after one minute.
