Manoj Reddy's Reference Guide

boot host

To change the default name of the host configuration filename from which to load configuration commands, use the boot host global configuration command. Use the no form of this command to restore the host configuration filename to the default.

boot host remote-url

no boot host remote-url

Syntax Description

remote-url 

Configures the router to boot the configuration file specified by the FTP, rcp, or TFTP URL:

  • ftp: [[[// [username[: password]@ ]location]/ directory]/ filename]
  • rcp: [[[// [username@ ]location]/ directory]/ filename]
  • tftp: [[[// location]/ directory]/ filename]

Defaults

The router uses its host name to form a host configuration filename. To form this name, the router converts its name to all lowercase letters, removes all domain information, and appends confg.

Command Modes

Global configuration

Command History

ReleaseModification
10.0

This command was introduced.

Usage Guidelines

Use the service config command to enable the loading of the specified configuration file at reboot time. Without this command, the router ignores the boot host command and uses the configuration information in NVRAM. If the configuration information in NVRAM is invalid or missing, the serviceconfig command is enabled automatically.

The network server will attempt to load two configuration files from remote hosts. The first is the network configuration file containing commands that apply to all network servers on a network. Use the boot network command to identify the network configuration file. The second is the host configuration file containing commands that apply to one network server in particular. Use the boot host command to identify the host configuration file.

Loading a Configuration File Using rcp

The rcp software requires that a client send the remote username on each rcp request to the network server. If the server has a directory structure (such as UNIX systems), the rcp implementation searches for the configuration files starting in the directory associated with the remote username.

When you load a configuration file from a server using rcp, the Cisco IOS software sends the first valid username in the following list:

  1. The username specified in the file-URL, if a username is specified.
  2. The username set by the ip rcmd remote-username command, if the command is configured.
  3. The router host name.

An account for the username must be defined on the destination server. If the network administrator of the destination server did not establish an account for the username, this command will not execute successfully.

Load a Configuration File Using FTP

The FTP protocol requires a client to send a remote username and password on each FTP request to a server. The username and password must be associated with an account on the FTP server. If the server has a directory structure, the configuration file or image copied from the directory associated with the username on the server. Refer to the documentation for your FTP server for more details.

When you load a configuration file from a server using FTP, the Cisco IOS software sends the first valid username in the following list:

  1. The username specified in the boot host command, if a username is specified.
  2. The username set by the ip ftp username command, if the command is configured.
  3. Anonymous.

The router send the first valid password in the following list:

  1. The password specified in the boot host command, if a password is specified.
  2. The password set by the ip ftp password command, if the command is configured.
  3. The router forms a password username @routername .domain . The variable username is the username associated with the current session, routername is the configured host name, and domain is the domain of the router.

Examples

The following example sets the host filename to wilma-confg at address 192.168.7.19:

boot host tftp://192.168.7.19/usr/local/tftpdir/wilma-confg
service config

Related Commands

CommandDescription
boot network Changes the default name of the network configuration file from which to load configuration commands.
service config Enables autoloading of configuration files from a network server, use the service config global configuration command.

Printed for apswan@ctr.ap.nic.in on Wed Mar 5 22:32:57 PST 2003

All material in this document copyright 2000 Cisco Systems, Inc. All rights reserved. No material may be reproduced or distributed without written permission of Cisco Systems, Inc.