Profile Commands

reset user

set active

set inactive

set profile

set profile id

set user

show profile

unset

Profile Commands

This chapter describes the commands you use to create and configure user profiles.

Note The command syntax includes a combination of bold and regular uppercase and lowercase alphanumeric characters. You can enter commands in full or you can enter abbreviated forms of many commands. The abbreviated form consists of the first characters in each word of the syntax that appear in bold uppercase type in command syntax in this chapter. These characters represent the minimum you must enter for the command to be recognized and executed.

reset user

To delete a profile, use the reset user command.

REset USer <username>

Syntax Description

username Name of the profile to be deleted.

Default

None

Command Mode

System level or profile mode

Usage Guidelines

After you enter this command, you will be at the system level.

Example

The following steps delete profile 2503:

Step 1 Enter the reset user command:


Host:2503>


reset user 2503

Step 2 Enter y in response to the following prompt:


Are you sure>


Host:2503>

If you do not want to delete the profile, press Return.

Related Command

set user

show user

set active

To set a profile to active, use the set active command.

SEt ACtive [<username>]

Syntax Description

active Creates a virtual connection to the remote router associated with this profile. Incoming packets from the LAN cause a call to be made to the remote router (if on-demand dialing is enabled with the set auto command).
Incoming calls from the remote router associated with the profile use the profile's configurations. Whether the profile's state is active or inactive.

username Username.

Default

active

Command Mode

System level or profile mode

Usage Guidelines

Newly created profiles are inactive until activated, or until a reboot is performed.

Example

The following example configures profile 2503 to be active and opens a connection

Host> set active 2503 
Connection 2 opened

Related Commands

set auto
set user

set inactive

To set a profile to inactive, use the set inactive command.

SEt INactive [<username>]

Syntax Description

inactive Closes all virtual and physical connections to the remote router. Any calls in process will be disconnected.
Outgoing packets destined for the remote router associated with this profile will be ignored.

username Username of the profile to be deactivated.

Default

None

Command Mode

Profile mode

Example

The following example set the profile 2503 to be inactive.

Host> set 2503 inactive Connection 2 closed

set profile

To configure profile activity status after power on and call disconnect, use the set profile command:

SEt PROFile [POwerup = ACtive | INactive] [DIsconnect = DEactivate | KEep] [USer= <new profile name>]

Syntax Description

power (Optional) Profile activation state when the router is powered on

active Profile becomes active when the router is powered on. Incoming packets from the LAN cause a call to be made to the remote router (if on-demand dialing is enabled with the set auto command). Incoming calls from the remote router associated with the profile use the profile's configurations. Depending on how the profile has been configured with the set profile command, the profile either is deactivated or remains active after the physical connection has been disconnected.

inactive Profile is inactive when the router is powered on.
Outgoing packets destined for the remote router associated with this profile are ignored.

disconnect (Optional) Profile activation state when the physical connection has been terminated.

deactivate Profile becomes inactive when all the links of its physical connection are disconnected.

keep Profile remains active when all the links of its physical connection are disconnected.

user User (optional) used to change the name of an existing profile.

Default

powerup active
disconnect keep

Note Incoming calls from the remote router associated with a profile will cause that profile to become active regardless of the profile activity settings.

Command Mode

Profile mode

Example

The following example configures the profile 2503 to be inactive after the unit powers up and inactive after all physical links to the remote router are disconnected:

Host:2503> set profile powerup inactive disconnect deactivate

set profile id

To associate the Ethernet address of a remote router with a profile, use the set profile id command (CPP only).

SEt PROfile ID <ethernet address>

Syntax Description

ethernet address Ethernet address of the remote router that is associated with the profile. Every profile using Combinet Packet Protocol (CPP) must have an Ethernet address entered with this command.
When it receives a call, the Cisco router uses the Ethernet address of the remote router to locate the correct profile to be used with the remote router.

Default

No Ethernet address is configured.

Command Mode

Profile mode for the profile you are configuring.

Example

The following example configures the profile 2503 with the Ethernet address of the remote router:

Host:2503> set profile id 00000c0012ff

set user

To create a new profile or modify an existing profile, use the set user command.

SEt USer [<username>] [INcoming | OUTgoing]

Syntax Description

username Name of profile. A profile name can be 1 to 20 characters. Names are case sensitive only when being displayed.

incoming (Optional) Profile will be initialized for incoming calls only. Incoming profiles have the following default values:
· Powerup inactive (change with set profile command)
· Disconnect deactivate (change with set profile command)
· On-demand dialing off (change with set auto command)
If this keyword is not specified, the profile applies to both incoming and outgoing calls.

outgoing (Optional) Profile will be initialized for incoming or outgoing calls. Outgoing profiles have the following default values:
· Powerup active (change with set profile command)
· Disconnect keep (change with set profile command)
· On-demand dialing on (change with set auto command)

Note The incoming and outgoing keywords are shortcuts for the indicated set profile and set auto commands.

Default

outgoing

Command Mode

System level or profile mode

Examples

The following example configures a new profile, 2503:

Host> set user 2503 outgoing

The following example changes an outgoing profile to be optimized for incoming calls:

Host> set user 2503 incoming

Related Commands

set auto
set profile

show profile

To display the Ethernet address and activity status of the current profile, use the show profile command.

SHow PRofile

Syntax Description

This command has no keywords or arguments.

Default

None

Command Mode

Profile mode

Example

The following example shows output from the show profile command for profile 2503:

Host:2503> show profile

Profile for user
    Ethernet Address 00 00 00 00 00 00
    Power Up         ACTIVATE
    Disconnect       KEEP

Table 4-1 describes the fields shown in the display.

Table 4-1 : Show Profile Field Descriptions

Field Description

Ethernet Address Ethernet address of the remote router associated with the profile. Configured with the set profile id command. (CPP only)

Powerup Indicates whether the profile is active when the router is powered on. Configured with the set active command

Disconnect Indicates whether the profile remains active after a physical connection to the remote router has been terminated. Configured with the set active command.

<*> Indicates that the values shown apply to this profile only.

Field	Description
Ethernet Address	Ethernet address of the remote router associated with the profile. Configured with the set profile id command. (CPP only)
Powerup	Indicates whether the profile is active when the router is powered on. Configured with the set active command
Disconnect	Indicates whether the profile remains active after a physical connection to the remote router has been terminated. Configured with the set active command.
<*>	Indicates that the values shown apply to this profile only.

unset

To return profile-configured parameters to the profile template value, use the unset command.

UNset <original command parameter>

Syntax Description

command parameter Original command modifier used to configure the parameter. Refer to Table 4-2 for a complete list of all unset commands with the original command modifier.

Default

None

Command Mode

Profile mode

Table 4-2 : Unset Command Syntax Descriptions

Original Command Unset Command Syntax

set auto unset <link> auto

set bridging unset bridging

set callback unset callback

set callback ID unset callbackid

set caller ID unset callerid

set compression unset compression

set cpp password client unset cpp password client

demand unset <link> demand

set encapsulation unset encapsulation

set learn unset learn

set number unset <link> number

set CPP protocol unset protocol

set ppp authentication unset ppp authentication

set ppp callback unset ppp callback

set ppp password host unset ppp password host

set ppp secret host unset ppp secret host

set passthru unset passthru

set ringback unset <link> ringback

set speed unset speed

set timeout unset <link> timeout

Original Command	Unset Command Syntax
set auto	unset <link> auto
set bridging	unset bridging
set callback	unset callback
set callback ID	unset callbackid
set caller ID	unset callerid
set compression	unset compression
set cpp password client	unset cpp password client
demand	unset <link> demand
set encapsulation	unset encapsulation
set learn	unset learn
set number	unset <link> number
set CPP protocol	unset protocol
set ppp authentication	unset ppp authentication
set ppp callback	unset ppp callback
set ppp password host	unset ppp password host
set ppp secret host	unset ppp secret host
set passthru	unset passthru
set ringback	unset <link> ringback
set speed	unset speed
set timeout	unset <link> timeout

Example

The following example returns the profile 2503's PPP client password to the profile template value:

Host:2503> unset ppp client password

active	Creates a virtual connection to the remote router associated with this profile. Incoming packets from the LAN cause a call to be made to the remote router (if on-demand dialing is enabled with the set auto command). Incoming calls from the remote router associated with the profile use the profile's configurations. Whether the profile's state is active or inactive.
username	Username.

inactive	Closes all virtual and physical connections to the remote router. Any calls in process will be disconnected. Outgoing packets destined for the remote router associated with this profile will be ignored.
username	Username of the profile to be deactivated.

power	(Optional) Profile activation state when the router is powered on
active	Profile becomes active when the router is powered on. Incoming packets from the LAN cause a call to be made to the remote router (if on-demand dialing is enabled with the set auto command). Incoming calls from the remote router associated with the profile use the profile's configurations. Depending on how the profile has been configured with the set profile command, the profile either is deactivated or remains active after the physical connection has been disconnected.
inactive	Profile is inactive when the router is powered on. Outgoing packets destined for the remote router associated with this profile are ignored.
disconnect	(Optional) Profile activation state when the physical connection has been terminated.
deactivate	Profile becomes inactive when all the links of its physical connection are disconnected.
keep	Profile remains active when all the links of its physical connection are disconnected.
user	User (optional) used to change the name of an existing profile.

username	Name of profile. A profile name can be 1 to 20 characters. Names are case sensitive only when being displayed.
incoming	(Optional) Profile will be initialized for incoming calls only. Incoming profiles have the following default values: · Powerup inactive (change with set profile command) · Disconnect deactivate (change with set profile command) · On-demand dialing off (change with set auto command) If this keyword is not specified, the profile applies to both incoming and outgoing calls.
outgoing	(Optional) Profile will be initialized for incoming or outgoing calls. Outgoing profiles have the following default values: · Powerup active (change with set profile command) · Disconnect keep (change with set profile command) · On-demand dialing on (change with set auto command)

Table of Contents

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Command

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

Default

Command Mode

Example

Default

Command Mode

Example

Syntax Description

Default

Command Mode

Example

Syntax Description

Default

Command Mode

Examples

Related Commands

Syntax Description

Default

Command Mode

Example

Syntax Description

Default

Command Mode

Example