HP StorageWorks MSA 2/8 HP StorageWorks Fabric OS 3.X Document Addendum (AA-RW - Page 163

Operands, Example, The following operands are optional - home

Page 163 highlights

Operands Example Fabric OS reference guide Note: Security parameters and the switch's identity cannot be changed by configdownload. Parameters such as the switch's name and IP address are ignored; they are the lines in the configuration file that begin boot. Security parameters such as secure mode setting and version stamp are ignored; they are the lines in the configuration file that begin with sec. A license key is accepted only if the boot.mac line matches the World Wide Name of the switch performing the download; otherwise, it is ignored. The download process is additive; the lines read from the file are added to the current switch configuration. It is therefore possible to change a single configuration variable by downloading a file with a single line. All other variables remain unchanged. This is particularly important when downloading a zoning configuration. Because the new zoning information is added to the current configuration, there cannot be any conflicts. If the current zoning configuration is to be replaced, the keyword clear might be inserted into the configuration file immediately before the zoning lines (start at the line [Zoning]). If the configuration file contains keyword enable followed by a zoning configuration, that zoning configuration is enabled in the fabric. If there is no enable keyword in the configuration file, or no zoning configuration by that name exists, or if enable fails for any reason (such as dangling aliases): ■ The effective configuration remains what it was before the configdownload; that is, all the enable statements are discarded. ■ The defined configuration changes to reflect the new zoning configuration. The following operands are optional: host user file Host name or IP address in quotes; for example, citadel or 192.168.1.48. The configuration file is downloaded from this host. User name in quotes; for example, jdoe. This user name is used to gain access to the host. A file name in quotes: for example, config.txt. Absolute path names can be specified using a forward slash ( / ). Relative path names search for the file in the user's home directory on UNIX hosts and in the directory where the FTP or RSHD server is running on Windows hosts passwd If present, selects FTP. To download a configuration file from host citadel, using account jdoe and file config.txt: switch:admin> configDownload "citadel","jdoe","config.txt" Committing configuration...done. download complete Fabric OS 3.x Document Addendum 163

  • 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

Fabric OS reference guide
163
Fabric OS 3.x Document Addendum
Note:
Security parameters and the switch’s identity cannot be changed by
configdownload
.
Parameters such as the switch’s name and IP address are ignored; they are the lines in the
configuration file that begin
boot
. Security parameters such as secure mode setting and version
stamp are ignored; they are the lines in the configuration file that begin with
sec
.
A license key is accepted only if the
boot.mac
line matches the World Wide Name of the
switch performing the download; otherwise, it is ignored.
The download process is additive; the lines read from the file are added to the current switch
configuration. It is therefore possible to change a single configuration variable by downloading
a file with a single line. All other variables remain unchanged.
This is particularly important when downloading a zoning configuration. Because the new
zoning information is added to the current configuration, there cannot be any conflicts. If the
current zoning configuration is to be replaced, the keyword
clear
might be inserted into the
configuration file immediately before the zoning lines (start at the line
[Zoning]
).
If the configuration file contains keyword
enable
followed by a zoning configuration, that
zoning configuration is enabled in the fabric. If there is no
enable
keyword in the
configuration file, or no zoning configuration by that name exists, or if enable fails for any
reason (such as dangling aliases):
The effective configuration remains what it was before the
configdownload
; that is,
all the
enable
statements are discarded.
The defined configuration changes to reflect the new zoning configuration.
Operands
The following operands are optional:
Example
To download a configuration file from host
citadel
, using account
jdoe
and file
config.txt
:
host
Host name or IP address in quotes; for example,
citadel
or
192.168.1.48
. The configuration file is downloaded from this host.
user
User name in quotes; for example,
jdoe
. This user name is used to gain
access to the host.
file
A file name in quotes: for example,
config.txt
. Absolute path names
can be specified using a forward slash ( / ). Relative path names search for
the file in the user's home directory on UNIX hosts and in the directory
where the FTP or RSHD server is running on Windows hosts
passwd
If present, selects FTP.
switch:admin>
configDownload "citadel","jdoe","config.txt"
Committing configuration...done.
download complete