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

Advanced Configuration

Page 216 highlights

14. Configuration from the Command Line The config application resides in the /bin directory. The environmental variable PATH contains a route to the /bin directory. This allows a user to simply type config at the command prompt instead of the full path /bin/config. Options -a -run-all Run all registered configurators. This performs every configuration synchronization action pushing all changes to the live system. -h -help Display a brief usage message. -v -verbose Log extra debug information. -d -del=id Remove the given configuration element specified by a '.' separated identifier. -g -get=id Display the value of a configuration element. -p -path=file Specify an alternate configuration file to use. The default file is located at /etc/config/config.xml. -r -run=configurator Run the specified registered configurator. Registered configurators are listed below. -s --set=id=value Change the value of configuration element specified by a '.' separated identifier. -e --export=file Save active configuration to file. -i --import=file Load configuration from file. -t --test-import=file Pretend to load configuration from file. -S --separator=char The pattern to separate fields with, default is '.' -P --password=id Prompt user for a value. Hash the value, and then save. The registered configurators are: alerts auth cascade console dhcp dialin eventlog hosts ipaccess ipconfig nagios power serialconfig services Secondary systemsettings time ups users There are three ways to delete a config element value. The simplest way is use the delete-node script detailed in 15. Advanced Configuration. You can also assign the config element to "", or delete the entire config node using -d: # /bin/config -d 'element name' All passwords are saved in plaintext except the user passwords and system passwords, which are encrypted. Note: The config command does not verify whether the nodes edited/added by the user are valid. As such, any node may be added to the tree. For example, if a user were to run the following command: # /bin/config -s config.fruit.apple=sweet the configurator will not verify, though this command is clearly useless. When the configurators are run to turn the config.xml file into live config, they will simply ignore this node. Administrators must make sure of the spelling when typing config commands. Incorrect spelling for a node will not be flagged. Most configurations made to the XML file will be immediately active. To ensure all configuration changes are active, especially when editing user passwords, run all the configurators: # /bin/config -a For information on backing up and restoring the configuration file, refer to 15. Advanced Configuration. 216

  • 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

216
14. Configuration from the Command Line
The
config
application resides in the
/bin
directory. The environmental variable
PATH
contains a route to the
/bin
directory.
This allows a user to simply type
config
at the command prompt instead of the full path
/bin/config
.
Options
-a –run-all
Run all registered configurators. This performs every configuration synchronization action pushing all
changes to the live system.
-h –help
Display a brief usage message.
-v –verbose
Log extra debug information.
-d –del=id
Remove the given configuration element specified by a ‘.’ separated identifier.
-g –get=id
Display the value of a configuration element.
-p –path=file
Specify an alternate configuration file to use. The default file is located at
/etc/config/config.xml
.
-r –run=configurator
Run the specified registered configurator. Registered configurators are listed below.
-s --set=id=value
Change the value of configuration element specified by a ‘.’ separated identifier.
-e --export=file
Save active configuration to file.
-i --import=file
Load configuration from file.
-t --test-import=file
Pretend to load configuration from file.
-S --separator=char
The pattern to separate fields with, default is ‘.’
-P --password=id
Prompt user for a value. Hash the value, and then save.
The registered configurators are:
alerts
ipconfig
auth
nagios
cascade
power
console
serialconfig
dhcp
services
dialin
Secondary
eventlog
systemsettings
hosts
time
ipaccess
ups
users
There are three ways to delete a config element value. The simplest way is use the delete-node script detailed in
15.
Advanced Configuration
. You can also assign the config element to “”, or delete the entire config node using
-d
:
# /bin/config -d ‘element name’
All passwords are saved in plaintext except the user passwords and system passwords, which are encrypted.
Note:
The config command does not verify whether the nodes edited/added by the user are valid. As such, any node may be added to the
tree. For example, if a user were to run the following command:
# /bin/config -s config.fruit.apple=sweet
the configurator will not verify, though this command is clearly useless. When the configurators are run to turn the config.xml file into live
config, they will simply ignore this <fruit> node. Administrators must make sure of the spelling when typing config commands. Incorrect
spelling for a node will not be flagged.
Most configurations made to the XML file will be immediately active. To ensure all configuration changes are active, especially
when editing user passwords, run all the configurators:
# /bin/config -a
For information on backing up and restoring the configuration file, refer to
15. Advanced Configuration
.