Lantronix PremierWave XC PremierWave XC - Command Reference - Page 18

Best Practices, Importing

Page 18 highlights

4: Configuration Using XML  CLI-XCRs can be imported (captured) or exported (dumped) directly to a Telnet, SSH, or serial line CLI session. Capturing an XCR can be started by pasting a valid XCR directly into the CLI prompt. PremierWave XC immediately processes the configuration record, changing any settings specified. This can be done on any level, including the root. Special tags in the XML allow for providing root and enable level passwords so that this can also be done at the password prompt.  Web browser-Web Manager can be used to import and export an XCR to the device server file system. It can also be used to import an XCR from an external source such as your local hard drive.  FTP-The device server FTP server can export and import XCRs when an FTP get or put command on the filename (pwxc.xcr for export, pwxc_import.xcr for import; both are under the pwxcr directory) is requested. On export (FTP get of pwxc.xcr), the FTP server obtains the current XCR from the PremierWave XC and sends it as a file. On import (FTP put of pwxc_import.xcr), the FTP server processes the file by sending it directly to the XML engine. In both cases the device server filesystem is not accessed. The files pwxc.xcr and pwxc_import.xcr are not read from or written to the file system. See FTP in the PremierWave XC User Guide. Best Practices You can import or export an entire XCR, or just a portion of it, by specifying the group name and/or group instances. In the examples below, import and export operations are performed from the CLI on the local filesystem and require a XCR on the local filesystem. The Web Manager provides the same functionality. Caution: Using Microsoft Word to edit and save an XCR will change the format of the file and make it incompatible with PremierWave XC. This is true even if the file is saved as Plain Text (.txt) or an XML Document (.xml). Notepad, a third party text editor, or a specialized XML editor should be used instead. Importing The following syntax can be used to import configurations from a file: xcr import xcr import The first line imports all groups specified in the XML config record named in . Any filename is valid, and the file name and extension are not important. In the second line:  Instance follows group with a colon (see the third example on the next page).  Multiple groups are separated with a comma.  Any white space requires the list of groups to be quoted.  Only the named groups get imported, even if the XCR contains additional XCR groups. The following syntax can be used to export configurations to a file on the device server's file system: xcr export xcr export PremierWave XC Command Reference 18

  • 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

4: Configuration Using XML
PremierWave XC Command Reference
18
CLI-XCRs can be imported (captured) or exported (dumped) directly to a Telnet, SSH, or
serial line CLI session. Capturing an XCR can be started by pasting a valid XCR directly into
the CLI prompt. PremierWave XC immediately processes the configuration record, changing
any settings specified. This can be done on any level, including the root. Special tags in the
XML allow for providing root and enable level passwords so that this can also be done at the
password prompt.
Web browser-Web Manager can be used to import and export an XCR to the device server file
system.
It can also be used to import an XCR from an external source such as your local hard
drive.
FTP-The device server FTP server can export and import XCRs when an FTP get or put
command on the filename (pwxc.xcr for export, pwxc_import.xcr for import; both are under the
pwxcr directory) is requested. On export (FTP get of pwxc.xcr), the FTP server obtains the
current XCR from the PremierWave XC and sends it as a file. On import (FTP put of
pwxc_import.xcr), the FTP server processes the file by sending it directly to the XML engine.
In both cases the device server filesystem is not accessed. The files pwxc.xcr and
pwxc_import.xcr are not read from or written to the file system. See FTP in the
PremierWave
XC User Guide
.
Best Practices
You can import or export an entire XCR, or just a portion of it, by specifying the group name and/or
group instances. In the examples below, import and export operations are performed from the CLI
on the local filesystem and require a XCR on the local filesystem. The Web Manager provides the
same functionality.
Caution:
Using Microsoft Word to edit and save an XCR will change the format of
the file and make it incompatible with PremierWave XC. This is true even
if the file is saved as Plain Text (.txt) or an XML Document (.xml).
Notepad, a third party text editor, or a specialized XML editor should be
used instead.
Importing
The following syntax can be used to import configurations from a file:
xcr import <file>
xcr import <file> <groups and/or group:instances>
The first line imports all groups specified in the XML config record named in <file>. Any filename is
valid, and the file name and extension are not important.
In the second line:
Instance follows group with a colon (see the third example on the next page).
Multiple groups are separated with a comma.
Any white space requires the list of groups to be quoted.
Only the named groups get imported, even if the XCR contains additional XCR groups.
The following syntax can be used to export configurations to a file on the device server's file
system:
xcr export <file>
xcr export <file> <groups and/or group:instances>