Tripp Lite B0930042E4U Owners Manual for B093- B097- and B098-Series Console S - Page 215

Configuration from the Command Line

Page 215 highlights

14. Configuration from the Command Line For those who prefer to configure their console server at the Linux command line level (rather than use a browser and the management console), this chapter describes using command line access and the config tool to manage the console server and configure the ports. When displaying a command, this chapter uses single quotes ('') for user defined values (e.g., descriptions and names). Element values without single quotes must be typed exactly as shown. 14.1 Accessing Config from the Command Line The console server runs a standard Linux kernel and embeds a suite of open source applications. If you do not want to use a browser and the management console tools, you can configure the console server and manage connected devices from the command line using standard Linux and Busybox commands as well as applications like ifconfig, gettyd, stty, powerman, NUT, etc. However, without careful management, these settings may not withstand a power-cycle-reset or reconfiguration. Tripp Lite provides a number of custom command line utilities and scripts that easily configure the console server and ensure changes are stored in the console server's flash memory. The config utility allows manipulation of the system configuration from the command line. With config, a new configuration can be activated by running the relevant configurator, which performs the action necessary to make the configuration changes live. To access config from the command line: • Power up the console server and connect the "terminal" device: o If connecting using the serial line, plug a serial cable between the console server's local DB-9 console port and the terminal device. Configure the serial connection of the terminal device you are using to 115200bps, 8 data bits, no parity and one stop bit. o If you are connecting over LAN, you will need to interconnect the Ethernet ports and direct your terminal emulator program to the IP address of the console server (192.168.0.1 by default). • Log on to the console server by pressing return a few times. The console server will request a username and password. Enter the username root and the password default. The command line prompt should appear as a hash (#). This section is not intended to teach you Linux. In following these instructions, we assume you already have a certain level of understanding before executing Linux kernel level commands. The config tool Syntax config [ -ahv ] [ -d id ] [ -g id ] [ -p path ] [ -r configurator ] [ -s id=value ] [ -P id ] Description The config tool is designed to perform multiple actions from one command so options can be chained together. The config tool allows manipulation and querying of the system configuration from the command line. Using config, the new configuration can be activated by running the relevant configurator, which performs the necessary action to apply the configuration changes in real-time. The custom user configuration is saved in the /etc/config/config.xml file. This file is transparently accessed and edited when configuring the device using the management console browser GUI. Only the user 'root' can configure from the shell. By default, the config elements are separated by a '.' character. The root of the config tree is . To address a specific element, place a '.' between each node/branch. To access and display the description of user1, type: # config -g config.users.user1.description The root node of the config tree is . To display the entire config tree, type: # config -g config To display the help text for the config command, type: # config -h 215

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288

215
14. Configuration from the Command Line
For those who prefer to configure their console server at the Linux command line level (rather than use a browser and the
management console), this chapter describes using command line access and the
config
tool to manage the console server
and configure the ports.
When displaying a command, this chapter uses single quotes (‘’) for user defined values (e.g., descriptions and names).
Element values without single quotes must be typed exactly as shown.
14.1 Accessing Config from the Command Line
The console server runs a standard Linux kernel and embeds a suite of open source applications. If you do not want to use a
browser and the management console tools, you can configure the console server and manage connected devices from the
command line using standard Linux and Busybox commands as well as applications like
ifconfig, gettyd, stty, powerman,
NUT,
etc. However, without careful management, these settings may not withstand a power-cycle-reset or reconfiguration.
Tripp Lite provides a number of custom command line utilities and scripts that easily configure the console server and ensure
changes are stored in the console server’s flash memory.
The
config
utility allows manipulation of the system configuration from the command line. With config, a new configuration can
be activated by running the relevant configurator, which performs the action necessary to make the configuration changes live.
To access
config
from the command line:
• Power up the console server and connect the “terminal” device:
o If connecting using the serial line, plug a serial cable between the console server’s local DB-9 console port and the
terminal device. Configure the serial connection of the terminal device you are using to 115200bps, 8 data bits, no parity
and one stop bit.
o If you are connecting over LAN, you will need to interconnect the Ethernet ports and direct your terminal emulator program
to the IP address of the console server (192.168.0.1 by default).
• Log on to the console server by pressing return a few times. The console server will request a username and password. Enter
the username root and the password default. The command line prompt should appear as a hash (#).
This section is not intended to teach you Linux. In following these instructions, we assume you already
have a certain level of understanding before executing Linux kernel level commands.
The config tool
Syntax
config [ -ahv ] [ -d id ] [ -g id ] [ -p path ] [ -r configurator ] [ -s id=value ] [ -P id ]
Description
The config tool is designed to perform multiple actions from one command so options can be chained together.
The config tool allows manipulation and querying of the system configuration from the command line. Using config, the
new configuration can be activated by running the relevant configurator, which performs the necessary action to apply the
configuration changes in real-time.
The custom user configuration is saved in the
/etc/config/config.xml
file. This file is transparently accessed and edited when
configuring the device using the management console browser GUI. Only the user ‘
root
’ can configure from the shell.
By default, the config elements are separated by a ‘.’ character. The root of the config tree is
<config>
. To address a specific
element, place a ‘.’ between each node/branch. To access and display the description of
user1
, type:
# config -g config.users.user1.description
The root node of the
config
tree is <config>. To display the entire
config
tree, type:
# config -g config
To display the help text for the
config
command, type:
# config -h