Referencing Configuration Data Files

To reference configuration data as a file, a client application emits the file location between <url> tag elements within the <rpc> and the <edit-config> tag elements.

The data within these files can be formatted as either JUNOS XML or CLI configuration statements. When the configuration data is formatted as CLI configuration statements, you set the <url> format attribute to text.

The configuration file can be placed locally or as a network resource:

• When placed locally, the configuration file path can be relative or absolute:
  • Relative file path—The file location is based on the user’s home directory.
  • Absolute file path—The file location is based on the directory structure of the router, for example<drive>:filename or <drive>/:path/filename, If you are using removable media, the drive can be in the MS-DOS or UNIX (UFS) format.
• When located on the network, the configuration file can be accessed using FTP or HTTP:
  • FTP example:

    ftp://username:password@hostname/path/filename

    Note: The default value for the FTP path variable is the user’s home directory. Thus, by default the file path to the configuration file is relative to the user directory. To specify an absolute path when using FTP, start the path with the characters %2F; for example: ftp://username:password@hostname/%2Fpath/filename.

  • HTTP example:

    http://username:password@hostname/path/filename

Before loading the file, the client application or an administrator saves JUNOS XML tag elements as the contents of the file. The file includes the tag elements representing all levels of the configuration hierarchy from the root (represented by the <configuration> tag element) down to each element to change. The notation is the same as that used to request configuration information, as described in Requesting Information. For more detailed information about the JUNOS XML representation of JUNOS configuration statements, see Mapping Configuration Statements to JUNOS XML Tag Elements.

The following example shows how to incorporate configuration data stored in the file /var/tmp/configFile on the FTP server called ftp.myco.com:

Copyright © 2009, Juniper Networks, Inc. All rights reserved. Trademark Notice.