Configuring an application service interface

If you already have an application that is active and using a particular IP Address as a base address on network interface, you can configure this service IP label in PowerHA® SystemMirror® without disrupting your application.

About this task

If you are configuring the cluster when the application is not active, you do not need to follow this procedure.

The following steps guide you through configuring your application service IP label in PowerHA SystemMirror in order not to disrupt your application:

Procedure

  1. Configure a PowerHA SystemMirror cluster
  2. Configure PowerHA SystemMirror nodes
  3. Configure PowerHA SystemMirror networks
  4. Run Discovery.
  5. Configure PowerHA SystemMirror network interfaces.
  6. Run verification and synchronization to propagate your configuration to all the nodes.
  7. For each node that has an application using a particular IP Address:
    1. For the network interface currently hosting the application IP address, determine a new address to use as the interfaces base address. This address will be configured on the interface when the system boots and is referred to as the Boot_IP_Address. The cluster manager will alias the application IP address onto the interface when bringing the application online during normal cluster operation, but you will run the following command to perform this step manually initially to avoid disrupting your application.
    2. Run the sample utility clchipdev:
      /usr/es/sbin/cluster/samples/appsvclabel/clchipdev

Results

The utility clchipdev helps configure an application service interface correctly in PowerHA SystemMirror when you have an active application that is using a particular IP Address as a base address on network interface before starting PowerHA SystemMirror.

clchdev -n NODE -w network_name -a 'App_IP_Address=Boot_IP_Address'

Where:

  • NODE is the nodename.
  • network_name is the name of the network that contains this service interface.
  • App_IP_Address is the IP Address currently in use by the application (and currently configured in the CuAt as the base address for the given interface).
  • Boot_IP_Address is the IP Address that is to be used as the new base (boot) address.

For example, if NodeA has an IP Address 10.10.10.1 that is being used to make an application highly available, you would use the following steps:

  1. Run the utility clchipdev.

    clchdev -n NodeA -w net_ip -a '10.10.10.1=192.3.42.1'.

    The sample utility performs the following:

    • Performs rsh to NodeA and determines the network interface for which 10.10.10.1 is currently configured as the base address.
    • Determines the network interface to be en0.
    • Determines the network type as defined in PowerHA SystemMirrornetwork ODM, using the network name.
    • Runs: chdev -l en0 -a netaddr=192.3.42.1 -P

      This changes the CuAt on that node to use the new Boot_IP_Address as the base address.

    • Replaces 10.10.10.1 in PowerHA SystemMirroradapter ODM with 192.3.42.1.
    • Configures to PowerHA SystemMirror the IP Address 10.10.10.1 as a service IP address.
  2. Add this service IP label to a resource group.
  3. Run verification and synchronization.