Console - Versionsgeschichte

Lh am 8. April 2024 um 11:57 Uhr

2024-04-08T11:57:43Z

Änderungen zeigen

Lh am 27. März 2024 um 08:23 Uhr

2024-03-27T08:23:47Z

Lh am 27. März 2024 um 08:15 Uhr

2024-03-27T08:15:00Z

Lh am 27. März 2024 um 08:14 Uhr

2024-03-27T08:14:35Z

Lh am 26. März 2024 um 14:52 Uhr

2024-03-26T14:52:12Z

Lh am 26. März 2024 um 14:45 Uhr

2024-03-26T14:45:09Z

Lh am 26. März 2024 um 14:30 Uhr

2024-03-26T14:30:06Z

Änderungen zeigen

Lh: Die Seite wurde neu angelegt: „Datei:Console_80.png
Enable Telnet: Enables Telnet console.
Telnet TCP port:Telnet sessions are accepted on this port.
R…“

2024-03-18T10:31:33Z

Die Seite wurde neu angelegt: „Datei:Console_80.png Enable Telnet: Enables Telnet console. Telnet TCP port:Telnet sessions are accepted on this port. R…“

Neue Seite

[[Datei:Console_80.png]]
 Enable Telnet: Enables Telnet console.
 Telnet TCP port:Telnet sessions are accepted on this port.
 Raw mode:The VT100 editing and the IAC protocol are disabled.
 Activate echo:The echo setting if not changed by IAC.
 Active negotiation:The IAC negotiation is initiated by the server.
 Require user login:Username and password are required.
 Delay after 3 failed logins:After 3 wrong entries of username or password, the next login attempt is delayed.
 Use radius server passwords:Username and password are validated by a Radius
Sever.
 Use locally stored passwords:Username and password are stored locally

@@ Zeile 5: / Zeile 5: @@
 <br /> [[Datei:Login.png]]
-=Command Set=
+='''Command Set'''=
 <br />
 <br />There are several command levels. The following commands are usable from each level:
@@ Zeile 33: / Zeile 33: @@
 <br />The "help" command returns all the commands of the current level. If "help" is called from the top level, e.g. the line "http [subtopics]" appears. This means that there is another level for "http". With the command "http help" all commands below "http" are shown. Alternatively, with entering "http" you can select the http level, and "help" shows all the commands on the selected level. The command "back" again selects the top level. It is possible to use "help" at any position: "http passwd help" provides all commands that have the prefix "http passwd". You will find a complete list of all possible device commands in the chapter "Cmd Overview".
-==Parameter==
+=='''Parameter'''==
 <br />If parameters are expected for the command, the parameter may be passed as numeric or constant. If e.g. you get the following line as help:
 <br />
@@ Zeile 68: / Zeile 68: @@
 |}
-==Bit Field Parameter==
+=='''Bit Field Parameter'''==
 <br />
 <br />Some parameters can take several values at the same time. In the following example, all values between 0 and 5 can be set. In the help, this can be recognized by the fact that the values are not separated by the "|" character, but by commas.
@@ Zeile 87: / Zeile 87: @@
 <br />
-==Return Values==
+=='''Return Values'''==
 <br />
 <br />If a command is unknown or a parameter is incorrect, the output "ERR." is given at the beginning of the line, followed by a description of the fault. Successful instructions without special return value will be acknowledged by "OK.". All other return values are output within a single line. There are of two exceptions:
@@ Zeile 93: / Zeile 93: @@
 # Other configurations (such as the assigned IPv6 addresses) have several values that can change dynamically. This is marked with "Note 3" in the "Cmd Overview" table.
-==Numerical Returns==
+=='''Numerical Returns'''==
 <br />
 <br />For parameters that support constants, these constants are output as return values. To better deal with scripting languages, it may be easier to work only with numerical returns. The command <code>"vt100 numeric set ON"</code> enables that only numerical values appear.
-=Telnet=
+='''Telnet'''=
 <br />If the configuration "Raw Mode" is turned off, it is tried to negotiate the Telnet configuration between client and server using IAC commands. If this fails, the editing functions are not active, and the "Activate echo" option determines whether the characters sent to the Telnet server will be returned. Normally the client begins with the IAC negotiation. If this is not the case with the client, the device configuration "Active negotiation" should be turned on.
-=Raw Mode=
+='''Raw Mode'''=
 <br />
 <br />If you want to use the console only automated, it may be advantageous to set the configuration "Raw mode" to "yes" and "Activate echo" to "no" to. Then there is no interfering interaction with the editor functions and the is no need to filter the sent characters to process the return values.
 <br /> [[Datei:Wichtig_zeichen.png]] If in the console "Raw mode" is activated but not in the used Telnet client, the IAC commands sent at the beginning can appear as interfering characters in the command line (partially invisible).
-=Editing=
+='''Editing'''=
 <br />The following edit functions are available when the terminal supports VT100, and Raw Mode is deactivated. Entered characters are inserted at the cursor position.
@@ Zeile 144: / Zeile 144: @@
 or certain sensors may not be available.
-=Examples of commands=
+='''Examples of commands'''=
 '''a) External Sensors'''
 <br />
@@ Zeile 206: / Zeile 206: @@
 <br 7>
-=SSH=
+='''SSH'''=
 <br />The device supports SSH-2 connections with either public key authentication or user name and password. The "login" must be enabled for SSH. Users and passwords can be stored locally or retrieved via a radius server. If you want to use SSH in a terminal, Activate echo should be enabled.
-==Public Keys==
+=='''Public Keys'''==
 <br />
 <br />The following public keys are accepted:
@@ Zeile 227: / Zeile 227: @@
 |}
-==Generation with PuTTYgen==
+=='''Generation with PuTTYgen'''==
 <br />
 <br /> [[Datei:Key.png]]
@@ Zeile 238: / Zeile 238: @@
 <br />
-==Generation with ssh-keygen==
+=='''Generation with ssh-keygen'''==
 <br />The tool ssh-keygen is mostly shipped with Linux and Windows to generate SSH keys.
 <br />Here is an example to generate an ECDSA 384 key.
@@ Zeile 246: / Zeile 246: @@
 <br />In the file ssh.pub is then the private key, the content of ssh.key.pub is inserted into the field "Upload SSH public key:".
 <br/>
-=All commands=
+='''All commands'''=

@@ Zeile 1: / Zeile 1: @@
 <br />For the configuration and control of the device, there is a set of commands with parameters that can be entered through a console. The console is available via SSH or Telnet, or for devices with RS232 port through using a serial terminal. It is not necessary to use Telnet, in Raw Mode a simple TCP/IP connection is sufficient to send commands. The communication can also be performed automated (e.g. via scripting languages). The console features are configured through the web interface .
-=Login=
+='''Login'''=
 <br />A ssh / telnet log in can be configured with password or without:
 <br /> [[Datei:Login.png]]

@@ Zeile 33: / Zeile 33: @@
 <br />The "help" command returns all the commands of the current level. If "help" is called from the top level, e.g. the line "http [subtopics]" appears. This means that there is another level for "http". With the command "http help" all commands below "http" are shown. Alternatively, with entering "http" you can select the http level, and "help" shows all the commands on the selected level. The command "back" again selects the top level. It is possible to use "help" at any position: "http passwd help" provides all commands that have the prefix "http passwd". You will find a complete list of all possible device commands in the chapter "Cmd Overview".
-=Parameter=
+==Parameter==
 <br />If parameters are expected for the command, the parameter may be passed as numeric or constant. If e.g. you get the following line as help:
 <br />
@@ Zeile 68: / Zeile 68: @@
 |}
-=Bit Field Parameter=
+==Bit Field Parameter==
 <br />
 <br />Some parameters can take several values at the same time. In the following example, all values between 0 and 5 can be set. In the help, this can be recognized by the fact that the values are not separated by the "|" character, but by commas.
@@ Zeile 87: / Zeile 87: @@
 <br />
-=Return Values=
+==Return Values==
 <br />
 <br />If a command is unknown or a parameter is incorrect, the output "ERR." is given at the beginning of the line, followed by a description of the fault. Successful instructions without special return value will be acknowledged by "OK.". All other return values are output within a single line. There are of two exceptions:
@@ Zeile 93: / Zeile 93: @@
 # Other configurations (such as the assigned IPv6 addresses) have several values that can change dynamically. This is marked with "Note 3" in the "Cmd Overview" table.
-=Numerical Returns=
+==Numerical Returns==
 <br />
 <br />For parameters that support constants, these constants are output as return values. To better deal with scripting languages, it may be easier to work only with numerical returns. The command <code>"vt100 numeric set ON"</code> enables that only numerical values appear.
 =Telnet=
@@ Zeile 148: / Zeile 144: @@
 or certain sensors may not be available.
-=Sensor Examples=
+=Examples of commands=
 '''a) External Sensors'''
 <br />
@@ Zeile 213: / Zeile 209: @@
 <br />The device supports SSH-2 connections with either public key authentication or user name and password. The "login" must be enabled for SSH. Users and passwords can be stored locally or retrieved via a radius server. If you want to use SSH in a terminal, Activate echo should be enabled.
-=Public Keys=
+==Public Keys==
 <br />
 <br />The following public keys are accepted:
@@ Zeile 231: / Zeile 227: @@
 |}
-=Generation with PuTTYgen=
+==Generation with PuTTYgen==
 <br />
 <br /> [[Datei:Key.png]]
@@ Zeile 242: / Zeile 238: @@
 <br />
-=Generation with ssh-keygen=
+==Generation with ssh-keygen==
 <br />The tool ssh-keygen is mostly shipped with Linux and Windows to generate SSH keys.
 <br />Here is an example to generate an ECDSA 384 key.
@@ Zeile 249: / Zeile 245: @@
 <br />
 <br />In the file ssh.pub is then the private key, the content of ssh.key.pub is inserted into the field "Upload SSH public key:".

@@ Zeile 194: / Zeile 194: @@
 <br />These variants give the sensor values of the field list or a sensor to at Outlet Port 2.
 <br /> [[Datei:Wichtig_zeichen.png]]The following examples refer to Gude devices that have switchable ports.
-d) Displaying Port Relays
+<br />
->port all state 1 show
+<br />'''d) Displaying Port Relays'''
-P1=ON,P2=OFF,P3=ON,P4=OFF,P5=OFF,P6=OFF,P7=OFF,P8=ON
+<br />
-The command "port all state {MODE0=0|MODE1=1|MODE2=2} show" returns the
+<br /><code>>port all state 1 show</code>
-switching state of all relays in 3 possible formats.
+<br /><code>P1=ON,P2=OFF,P3=ON,P4=OFF,P5=OFF,P6=OFF,P7=OFF,P8=ON</code>
-e) Switching Port Relays
+<br />
-#port all state set "1,2,12" 1
+<br />The command "port all state {MODE0=0|MODE1=1|MODE2=2} show" returns the switching state of all relays in 3 possible formats.
-OK.
+<br />
-The command syntax "port all state set "{port_list}" {OFF=0|ON=1}" sets a list of ports
+<br />'''e) Switching Port Relays'''
-to ON=1 or OFF=0.
+<br />
-.2.1 SSH
+<br /><code>#port all state set "1,2,12" 1</code>
-The device supports SSH-2 connections with either public key authentication or user
+<br /><code>OK.</code>
-name and password. The "login" must be enabled for SSH. Users and passwords can
+<br />
-be stored locally or retrieved via a radius server. If you want to use SSH in a terminal,
+<br />The command syntax "port all state set "{port_list}" {OFF=0|ON=1}" sets a list of ports to ON=1 or OFF=0.
-Activate echo should be enabled.
+<br 7>
-Generation with PuTTYgen
+=Generation with PuTTYgen=
-Generated keys can be copied directly from e.g. PuTTYgen,
+<br />
-and inserted into the Configuration - Console input field. Public keys are accepted in
+<br /> [[Datei:Key.png]]
-SSH2 or OpenSSH format.
+<br />
-Generation with ssh-keygen
+<br />Generated keys can be copied directly from e.g. PuTTYgen,
-The tool ssh-keygen is mostly shipped with Linux and Windows to generate SSH keys.
+<br />
-Here is an example to generate an ECDSA 384 key.
+<br /> [[Datei:Upload.png]]
-ssh-keygen -t ecdsa -b 384 -f ssh.key
+<br />
-In the file ssh.pub is then the private key, the content of ssh.key.pub is inserted into the
+<br />and inserted into the Configuration - Console input field. Public keys are accepted in SSH2 or OpenSSH format.
-field "Upload SSH public key:".
+<br />

@@ Zeile 95: / Zeile 95: @@
 =Numerical Returns=
 <br />
-<br />For parameters that support constants, these constants are output as return values. To better deal with scripting languages, it may be easier to work only with numerical returns.
+<br />For parameters that support constants, these constants are output as return values. To better deal with scripting languages, it may be easier to work only with numerical returns. The command <code>"vt100 numeric set ON"</code> enables that only numerical values appear.
 The command "vt100 numeric set ON" enables that only numerical values
-appear.
+=Comments=
-Comments
+<br/>
-If you use a tool to send an entire file of commands via Telnet, it is helpful, if you can
+<br />If you use a tool to send an entire file of commands via Telnet, it is helpful, if you can place comments in there. Beginning with the comment character "#", the remaining contents of a line is ignored.
 place comments in there. Beginning with the comment character "#", the remaining
-contents of a line is ignored.
+=Telnet=
-Telnet
+<br />If the configuration "Raw Mode" is turned off, it is tried to negotiate the Telnet configuration between client and server using IAC commands. If this fails, the editing functions are not active, and the "Activate echo" option determines whether the characters sent to the Telnet server will be returned. Normally the client begins with the IAC negotiation. If this is not the case with the client, the device configuration "Active negotiation" should be turned on.
 If the configuration "Raw Mode" is turned off, it is tried to negotiate the Telnet configuration
-between client and server using IAC commands. If this fails, the editing functions
+=Raw Mode=
-are not active, and the "Activate echo" option determines whether the characters sent
+<br />
-to the Telnet server will be returned. Normally the client begins with the IAC negotiation.
+<br />If you want to use the console only automated, it may be advantageous to set the configuration "Raw mode" to "yes" and "Activate echo" to "no" to. Then there is no interfering interaction with the editor functions and the is no need to filter the sent characters to process the return values.
-If this is not the case with the client, the device configuration "Active negotiation"
+<br /> [[Datei:Wichtig_zeichen.png]] If in the console "Raw mode" is activated but not in the used Telnet client, the IAC commands sent at the beginning can appear as interfering characters in the command line (partially invisible).
 should be turned on.
-Raw Mode
+=Editing=
-If you want to use the console only automated, it may be advantageous to set the configuration
+<br />The following edit functions are available when the terminal supports VT100, and Raw Mode is deactivated. Entered characters are inserted at the cursor position.
 "Raw mode" to "yes" and "Activate echo" to "no" to. Then there is no interfering
-interaction with the editor functions and the is no need to filter the sent characters
+|- bgcolor="#C1DDFB"
-to process the return values.
+|align="left"|'''Keys'''
-If in the console "Raw mode" is activated but not in the used Telnet client, the IAC
+|align="left"|'''Function'''
-commands sent at the beginning can appear as interfering characters in the command
+|-
-line (partially invisible).
+|- bgcolor="#C1DDFB"
-Editing
+|align="left"|Left, Right
-The following edit functions are available when the terminal supports VT100, and Raw
+|align="left"|moves cursor left or right
-Mode is deactivated. Entered characters are inserted at the cursor position.
+|-
-This chapter is general for all Gude devices. Depending on the device type, ports
+|- bgcolor="#C1DDFB"
 or certain sensors may not be available.
 Sensor Examples
-a) External Sensors
+=Sensor Examples=
->extsensor all show
+'''a) External Sensors'''
-E=1,L="7106",0="21.3°C",1="35.1%",3="1013hPa",4="5.2°C",5="16.0°C""
+<br />
-E=2,L="7102",0="21.2°C",1="35.4%",4="5.3°C",5="15.9°C""
+<br /><code>>extsensor all show</code>
-The command lists one connected external sensor per line, and the individual measured
+<br /><code>E=1,L="7106",0="21.3°C",1="35.1%",3="1013hPa",4="5.2°C",5="16.0°C""</code>
-values are separated by commas after the label name. The digit before the equal
+<br /><code>E=2,L="7102",0="21.2°C",1="35.4%",4="5.3°C",5="15.9°C""</code>
-sign corresponds to the Index field in the External Sensor Table.
+<br />
->extsensor 1 0 value show
+<br />The command lists one connected external sensor per line, and the individual measured values are separated by commas after the label name. The digit before the equal sign corresponds to the Index field in the External Sensor Table.
-Displays temperature of the sensor at Port 1
+<br />
-b) Line Sensors
+<br />>extsensor 1 0 value show
-For devices with 230V input metering (Metered PDU).
+<br />
->linesensor all "0,1,2,3,12" show
+<br />Displays temperature of the sensor at Port 1
-L=1,L="Power Port",0="13000Wh",1="0W",2="225V",3="0A",12="998218s"
+<br />
-L=2,L="Power Port",0="13000Wh",1="0W",2="223V",3="0A",12="996199s"
+<br />
-This command outputs all line sensor values in one line. A list of all fields (according to
+'''b) Line Sensors'''
-the energy sensor table) is transferred as parameter. In this example these are the
+<br />
-fields Absolute Active Energy (0), Power Active (1), Voltage (2), Current (3) and Reset
+<br />[[Datei:Wichtig_zeichen.png]] For devices with 230V input metering (Metered PDU).
-Time (12).
+<br />
->linesensor 1 "0,1,2,3,12" show
+<br /><code>>linesensor all "0,1,2,3,12" show</code>
->linesensor 1 1 show
+<br /><code>L=1,L="Power Port",0="13000Wh",1="0W",2="225V",3="0A",12="998218s"</code>
-These variants give the sensor values of the field list or of a sensor at Line-In 1.
+<br /><code>L=2,L="Power Port",0="13000Wh",1="0W",2="223V",3="0A",12="996199s"</code>
-For devices with Overvoltage Protection, the "linesensor all" command also outputs
+<br />
-the state of the protection ("OVP=x"). A "1" means ok, a "0" a failure of the protection.
+<br />This command outputs all line sensor values in one line. A list of all fields (according to the energy sensor table) is transferred as parameter. In this example these are the fields Absolute Active Energy (0), Power Active (1), Voltage (2), Current (3) and Reset Time (12).
-c) Port Sensors
+<br />
-For devices with 230V output metering (Outlet-Metered PDU).
+<br />>linesensor 1 <cod>"0,1,2,3,12"</code> show
->portsensor all "0,1,2,3,12" show
+<br />>linesensor 1 1 show
-P=1,L="Power Port",0="13000Wh",1="0W",2="225V",3="0A",12="998218s"
+<br />
-P=2,L="Power Port",0="13000Wh",1="0W",2="225V",3="0A",12="996199s"
+<br />These variants give the sensor values of the field list or of a sensor at Line-In 1. For devices with Overvoltage Protection, the "linesensor all" command also outputs the state of the protection ("OVP=x"). A "1" means ok, a "0" a failure of the protection.
-...
+<br />
-P=12,L="Power Port",0="13000Wh",1="0W",2="225V",3="0A",12="998218s"
+<br />'''c) Port Sensors'''
-This command outputs all port sensor values in one line. A list of all fields (according to
+<br />
-the energy sensor table) is passed as parameter. In this example these are the fields
+<br />[[Datei:Wichtig_zeichen.png]]For devices with 230V output metering (Outlet-Metered PDU).
-Absolute Active Energy (0), Power Active (1), Voltage (2), Current (3) and Reset Time
+<br />
-(12).
+<br /><code>>portsensor all "0,1,2,3,12" show</code>
->portsensor 2 "0,1,2,3,12" show
+<br /><code>P=1,L="Power Port",0="13000Wh",1="0W",2="225V",3="0A",12="998218s"</code>
->portsensor 2 1 show
+<br /><code>P=2,L="Power Port",0="13000Wh",1="0W",2="225V",3="0A",12="996199s"</code>
-These variants give the sensor values of the field list or a sensor to at Outlet Port 2.
+<br /><code>...</code>
-The following examples refer to Gude devices that have switchable ports.
+<br /><code>P=12,L="Power Port",0="13000Wh",1="0W",2="225V",3="0A",12="998218s"</code>
 d) Displaying Port Relays
 >port all state 1 show