Dell PowerEdge R830 Integrated Remote Access Controller 8 Version 2.70.70.70 U - Page 233

Installing and using VMCLI utility, Installing VMCLI, Running VMCLI utility, VMCLI syntax

Page 233 highlights

16 Installing and using VMCLI utility The Virtual Media Command Line Interface (VMCLI) utility is an interface that provides virtual media features from the management station to iDRAC on the managed system. Using this utility you can access virtual media features, including image files and physical drives, to deploy an operating system on multiple remote systems in a network. NOTE: VMCLI supports only the TLS 1.0 security protocol. The VMCLI utility supports the following features: • Manage removable devices or images that are accessible through virtual media. • Automatically terminate the session when the iDRAC firmware Boot Once option is enabled. • Secure communications to iDRAC using Secure Sockets Layer (SSL). • Execute VMCLI commands until: • The connections automatically terminate. • An operating system terminates the process. NOTE: To terminate the process in Windows, use the Task Manager. Topics: • Installing VMCLI • Running VMCLI utility • VMCLI syntax Installing VMCLI The VMCLI utility is included in the Dell Systems Management Tools and Documentation DVD. To install the VMCLI utility: 1. Insert the Dell Systems Management Tools and Documentation DVD into the management station's DVD drive. 2. Follow the on-screen instructions to install DRAC tools. 3. After successful install, check install\Dell\SysMgt\rac5 folder to make sure vmcli.exe exists. Similarly, check the respective path for UNIX. The VMCLI utility is installed on the system. Running VMCLI utility • If the operating system requires specific privileges or group membership, you require similar privileges to run the VMCLI commands. • On Windows systems, non-administrators must have Power User privileges to run the VMCLI utility. • On Linux systems, to access iDRAC, run VMCLI utility, and log user commands, non-administrators must prefix sudo to the VMCLI commands. However, to add or edit users in the VMCLI administrators group, use the visudo command. VMCLI syntax The VMCLI interface is identical on both Windows and Linux systems. The VMCLI syntax is: VMCLI [parameter] [operating_system_shell_options] For example, vmcli -r iDRAC-IP-address:iDRAC-SSL-port The parameter enables VMCLI to connect to the specified server, access iDRAC, and map to the specified virtual media. NOTE: VMCLI syntax is case-sensitive. Installing and using VMCLI utility 233

  • 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
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298

Installing and using VMCLI utility
The Virtual Media Command Line Interface (VMCLI) utility is an interface that provides virtual media features from the management
station to iDRAC on the managed system. Using this utility you can access virtual media features, including image files and physical drives,
to deploy an operating system on multiple remote systems in a network.
NOTE:
VMCLI supports only the TLS 1.0 security protocol.
The VMCLI utility supports the following features:
Manage removable devices or images that are accessible through virtual media.
Automatically terminate the session when the iDRAC firmware
Boot Once
option is enabled.
Secure communications to iDRAC using Secure Sockets Layer (SSL).
Execute VMCLI commands until:
The connections automatically terminate.
An operating system terminates the process.
NOTE:
To terminate the process in Windows, use the Task Manager.
Topics:
Installing VMCLI
Running VMCLI utility
VMCLI syntax
Installing VMCLI
The VMCLI utility is included in the
Dell Systems Management Tools and Documentation
DVD.
To install the VMCLI utility:
1.
Insert the
Dell Systems Management Tools and Documentation
DVD into the management station’s DVD drive.
2.
Follow the on-screen instructions to install DRAC tools.
3.
After successful install, check
install\Dell\SysMgt\rac5
folder to make sure
vmcli.exe
exists. Similarly, check the respective path
for UNIX.
The VMCLI utility is installed on the system.
Running VMCLI utility
If the operating system requires specific privileges or group membership, you require similar privileges to run the VMCLI commands.
On Windows systems, non-administrators must have
Power User
privileges to run the VMCLI utility.
On Linux systems, to access iDRAC, run VMCLI utility, and log user commands, non-administrators must prefix
sudo
to the VMCLI
commands. However, to add or edit users in the VMCLI administrators group, use the
visudo
command.
VMCLI syntax
The VMCLI interface is identical on both Windows and Linux systems. The VMCLI syntax is:
VMCLI [parameter] [operating_system_shell_options]
For example,
vmcli -r iDRAC-IP-address:iDRAC-SSL-port
The
parameter
enables VMCLI to connect to the specified server, access iDRAC, and map to the specified virtual media.
NOTE:
VMCLI syntax is case-sensitive.
16
Installing and using VMCLI utility
233