Cisco Cisco Prime IP Express 8.3 Technical References
failover-pair <name> setPartnerDown [<date>]
The setPartnerDown command notifies the DHCP server that its
failover partner server is down. The date specified represents a
time equal to or later than the last known time the partner
server could have been operational. If no date is specified, the
last known time of contact with the partner server is used.
The setPartnerDown command notifies the DHCP server that its
failover partner server is down. The date specified represents a
time equal to or later than the last known time the partner
server could have been operational. If no date is specified, the
last known time of contact with the partner server is used.
The partner server's available IP addresses will be available to
the remaining server to lease once the MCLT has elapsed from the
time that is used by the setPartnerDown command. These IP
addresses will continue to be in state other-available, but the
remaining server will be able to allocate them to clients once
the MCLT has elapsed.
the remaining server to lease once the MCLT has elapsed from the
time that is used by the setPartnerDown command. These IP
addresses will continue to be in state other-available, but the
remaining server will be able to allocate them to clients once
the MCLT has elapsed.
If the MCLT has not passed since the partner server went down,
you can make that partner's leases available to the remaining
server to lease to new clients immediately, though there is risk
to this approach. To make these leases immediately available,
you would enter a time on the setPartnerDown command which was
more than the MCLT prior to the current time. This will allow
the remaining server to immediately lease all available leases to
DHCP clients. Should you do this, you will incur a risk that
there will be some doubly allocated IP addresses, since some
address allocations made by the partner server to DHCP clients
may not have been communicated to the remaining server prior to
it going down. These IP addresses may then be allocated to other
DHCP clients by the remaining server. We do not recommend this
approach -- but if you are out of addresses, it is certainly
preferable to disabling failover altogether.
you can make that partner's leases available to the remaining
server to lease to new clients immediately, though there is risk
to this approach. To make these leases immediately available,
you would enter a time on the setPartnerDown command which was
more than the MCLT prior to the current time. This will allow
the remaining server to immediately lease all available leases to
DHCP clients. Should you do this, you will incur a risk that
there will be some doubly allocated IP addresses, since some
address allocations made by the partner server to DHCP clients
may not have been communicated to the remaining server prior to
it going down. These IP addresses may then be allocated to other
DHCP clients by the remaining server. We do not recommend this
approach -- but if you are out of addresses, it is certainly
preferable to disabling failover altogether.
The time value should be entered using the local time of the
nrcmd process. Formats for the date are:
nrcmd process. Formats for the date are:
-<num><value>
where <num> is a decimal number and <value> is one of 's',
'm', 'h', 'd', 'w', in which 's' is seconds, 'm' is minutes,
'h' is hours, 'd' is days and 'w' is weeks.
<month> <day> <hour>:<minute>[:<second>] <year>
where <month> is the name or first three letters of the name
of the month, <hour> is the hour on a 24- hour clock, and
<year> is the fully-specified year or a two-digit
representation in which 98 = 1998, 99 = 1999 and all other two
digit values XX = 20XX.
failover-pair <name> getStatus
This displays the failover-pair's related server object (same as
dhcp getRelatedServers full, but without any other servers).
This displays the failover-pair's related server object (same as
dhcp getRelatedServers full, but without any other servers).
failover-pair <name> pollLeaseHistory
failover-pair <name> getLeaseHistoryState
These commands are only available when connected to a regional
cluster and can be used to initiate a lease history poll
operation or examine the lease hsitory state.
failover-pair <name> getLeaseHistoryState
These commands are only available when connected to a regional
cluster and can be used to initiate a lease history poll
operation or examine the lease hsitory state.
failover-pair <name> rebalancePool
This command can be used to initiate a pool rebalance process.
This command can be used to initiate a pool rebalance process.
Examples
Status
See Also
Attributes
(0)
Identifies the cluster that contains the backup server for
a failover pair.
a failover pair.