4: Configuration Using XML
XPort Pro™ Command Reference
69
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.
CAUTION:
The file name xport_pro.xcr is not acceptable, since performing
a FTP get on that name produces the current configuration and does not
get anything from the filesystem. Also, the file name xport_pro.xsr is not
acceptable, since performing a FTP get on that name produces the current
status and does not get anything from the filesystem.
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 will be 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>
The same guidelines above regarding importing configurations also apply to exporting
configurations. If no groups are specified, then the export command will export all
configuration settings to the file. If instances are specified after the groups, only those
group instances are written. If no instance is specified, all instances of that group are
written.
The following example exports only the accept mode tunneling settings for line 1 to the
file “tunnel_1.xcr” on the device server filesystem:
xcr export tunnel_1.xcr “tunnel accept:1”
The following example exports only the connect mode tunneling settings for all ports to
the file “tunnel_all.xcr” on the device server filesystem:
xcr export tunnel_all.xcr “tunnel connect”
The following example imports only the settings for line 4 from a XCR named
“factory_config.xcr” on the device server filesystem. If “factory_config.xcr” has other
configuration settings, they are ignored:
xcr import factory_config.xcr “line:4”
The following example imports only line settings for all ports from a configuration record
on the device server filesystem named “foobar.xcr”:
xcr import foobar.xcr “line”
To import only disconnect mode tunneling settings for port 1 and serial line settings for
port 4 from an XML configuration record named “production.xcr” that contains these
settings (and possibly more), issue the following command:
xcr import production.xcr "tunnel disconnect:1, line:4"
The following example imports all tunneling settings and line settings for all serial ports
from a file named xcr_file: