Solaris Scripts


ipmp

ipmp is a script for setting up IPMP (IP MultiPathing). This allows you to have IP failover without the need of EtherChannel or 802.3ad.

IPMP is not the worlds most difficult thing to set up but this script may take some of the pain out of it.

The Script: ipmp

ipmp - A setup tool for IPMP
 Usage:
  ipmp -c
  ipmp -i <if> -T <ip> -t <name> [-P <ip> -p <name>] [-g <group_name>]
  ipmp -l
  ipmp -u
  ipmp -v
  ipmp -h
 Options:
  -c              - PreCheck. Insure IPMP can be set up.
  -v              - PostCheck. Validate IPMP setup.
  -u              - Set MAC addresses to be unique.
  -l              - List availible interfaces.
  -i <interface>  - Interface this config will be on.
  -T <test_ip>    - The IP address to use for testing.
  -t <test_name>  - The name used for the test IP address.
  -P <prod_ip>    - The IP address used for production traffic.
  -p <prod_name>  - The name used for the prod IP address.
  -g <group_name> - The name used to group IPMP interfaces.
 Requirements:
  To form a failover group the following conditions must be met
  - All interfaces must have unique MAC address. (ipmp -c will check for this)
  - Two or more interfaces are required.
  - One test address for each interface is required.
  - At least one production address for the failover group is required.
 Example:
  Config
   Interfaces
    bge0
    bge1
   Production
    192.168.1.1   dredscott
   Alternate
    192.168.1.2   dredscott-alt
   Test
    192.168.1.3   dredscott-bge0
    192.168.1.4   dredscott-bge1
   Netmask
    255.255.255.0
  Actions
   Check to see if system is ready for IPMP.
    ipmp -c
   Setup two interfaces for IPMP
    ipmp -i bge0 -T 192.168.1.3 -t dredscott-bge0 -P 192.168.1.1 \
         -p dredscott -g ipmp-grp
    ipmp -i bge1 -T 192.168.1.4 -t dredscott-bge1 -P 192.168.1.2 \
         -p dredscott-alt -g ipmp-grp
   Reboot, then verify setup
    ipmp -v
 Notes:
  - ipmp will make entries for each address in the /etc/hosts file if they do 
    not exist. If they pre-exist, it is not necessary to specify both the IP
    and the name as ipmp will attempt to resolve one from the other.
  - All changes made are for next boot. A temporary option does not exist.
    the system must be rebooted (or interfaces restarted) for the changes
    to take effect. It is recommended that the system be restarted to insure
    that the changes have the desired effect on connectivity.
  - It is also recommended that cables be pulled to test network failover
    before placing a configuration into production.
  - Sun recommends defining an alternate production address to balance outbound
    load. This is not a requirement for configuration.
  - ipmp will attempt to configure IP addresses for interfaces with matching
    MAC addresses. It it recommended that the -c option be run successfully
    before attempting to configure the system for IPMP.