System Administration Commands vrrpadm(1M) NAME vrrpadm - VRRP administration tool SYNOPSIS vrrpadm create-router -V -l -A {inet | inet6} [-p ] [-i ] [-o ] vrrpadm delete-router vrrpadm disable-router vrrpadm enable-router vrrpadm modify-router [-p priority] [-i adv_interval] [-o flags] vrrpadm show-router [-P | -x] [-p] [-o field[,...]] [] DESCRIPTION The vrrpadm command is used to administer the VRRP (Virtual Router Redundancy Protocol) service in the system. VRRP specifies an election protocol that dynamically assigns responsibility for a virtual router to one of the VRRP routers within a LAN. At one time, only one VRRP router is controlling the IPv4 or IPv6 address(es) (virtual addresses) associated with a virtual router (Master), and it is forwarding packets sent to these IP addresses. The election process provides dynamic fail over in the forwarding responsibility should the Master become unavailable. Each vrrpadm subcommand operates on a VRRP router, which is identified by a name given by the administrator. VRRP routers with the same VRID and address family within a LAN comprise a virtual router, which protects a set of virtual IP addresses. A system can have multiple VRRP routers, each belongs to a different virtual router. SUBCOMMANDS The following subcommands are supported. Note, most subcommands (create-router, delete-router, enable-router, disable-router, modify-router) require the solaris.network.vrrp authorization to operate; the show-router subcommand doesn't require extra authorizations. vrrpadm create-router Create a VRRP router with the given configuration. -V , --VRID= The virtual router identifier (VRID). Together with address family, it identifies a corresponding virtual Router within a LAN. -A {inet | inet6}, --address_family={inet | inet6} Address family. Either IPv4 or IPv6. -l , --link= The data-link on which the VRRP router is configured. This determines the LAN this VRRP router is running in. The data-link can be a physical link, a VLAN or an aggregation. -p , --priority= The priority of this VRRP router used in Master selection for this virtual router. The higher the value is, the higher possibility the router is selected as the Master. The default value is 255, which indicates this VRRP router is the IP Address Owner, and owns all the virtual IP addresses. A IP Address Owner will respond to the packets addressed to one of the virtual IP addresses for ICMP pings, TCP connections, etc. The range 1-254 is available for VRRP routers backing up a virtual router. Master selection prefers the VRRP router with the higher priority. -i , --adv_interval= The advertisement interval in milliseconds. Default is 1000 (1 second). The valid interval range is 10-40950. -o , --flags= The preempt and accept modes, delimited by a comma. Values can be: preempt, un_preempt, accept, no_accept. By default both are set to true. The preempt mode controls whether an enabled higher priority Backup router preempts a lower priority Master router. If preempt mode is true, then the preemption is allowed; otherwise, the preemption is prohibited. Note that the preempt mode must be true if the VRRP router is the owner of the virtual IP addresses. The accept mode controls the local packet acceptance to the virtual IP addresses. If accept mode is true, the Master must accept packets destined to the virtual IP addresses. If accept mode is false, the Master must not accept those packets except it must repond to ARP requests or ND Solicitations and Advertisment for the virtual IP addresses. It also must forward packets for this router. Note that the accept mode must be true if the VRRP router is the owner of the virtual IP addresses. Example: -o preempt,no_accept. router_name The name of this VRRP router. This name is used to identify this VRRP router in other vrrpadm subcommands. The maximum length of a valid router name is 31 characters, and the legal characters in a router name are: alphanumeric (a-z, A-Z, 0-9) and underscore ('_'). vrrpadm delete-router Delete the VRRP router identified by . vrrpadm disable-router Disable the virtual router identified by . Once the router is disabled, it will stop participating Master selection process in the virtual router. vrrpadm enable-router Reenable the virtual router identified by that was disabled. The router will start participating in Master selection process in the virtua router. vrrpadm modify-router Modify the configuration of the VRRP router identified by . Only the priority, the advertisement interval, the preempt mode and the accept mode can be modified. -p , --priority= The new priority of this VRRP router. -i , --adv_interval= The new advertisement interval. -o , --flags= The new preempt and/or accept modes. Either one or both can be specified. If both are specified, they are delimited by a comma. Example: -o preempt,no_accept vrrpadm show-router Display the information of the VRRP router identified by . If no is specified, display all the VRRP routers on the system. By default (with no options), the following fields are displayed: NAME The name of the VRRP router VRID The VRID of the VRRP router LINK The data-link on which the VRRP router is created on. Note that the name of the link can change over time unless the router is enabled. AF The address family of the VRRP router. Either IPv4 or IPv6 PRIO The priority of this VRRP router used in Master selection ADV_INTV The advertisement interval in milliseconds STATE The current state of the VRRP router, can be INIT (Initialize), BACK (Backup) or MAST (Master). MODE A set of flags associated with the VRRP router. Possible values are: e The router has been enabled p Preempt mode is true a Accept mode is true o Virtual address owner VNIC The VRRP VNIC created for this VRRP router Note that the name of the VNIC can change over time unless the router is enabled. -x, --extended Display additional information of the given VRRP router PRIMARY_IP The primary IP address selected by the VRRP router' VIRTUAL_IPS The virtual IP addresses configured on the VRRP router PRV_STAT The previous state of the VRRP router STAT_LAST Time since the last state transition -P, --peer Display the information of the backup VRRP router. This option is only meaningful when the VRRP router is in the backup state. The following fields are displayed: NAME The name of the VRRP router PEER The primary IP address of the peer VRRP router P_PRIO The priority of the peer VRRP router contained in the advertisement received from the peer. P_INTV The advertisement interval (in milliseconds) contained in advertisements received from the peer P_ADV_LAST Time since last received advertisement from the peer MASTER_DOWN_INT Time interval (in milliseconds) to declare Master down -p, --parsable Display the VRRP router information in the machine parsable format. -o field[,...], --output=field[,...] A case-insensitive, comma-separated list of output fields to display. The field name must be one of the fields listed above, or the special value all to display all fields. By default (without -o), vrrpadm show displays all fields. SEE ALSO vrrpd(1M), dladm(1M)