Specifications

Internet/IP Licensing

Description

INTERFACELIST syntax,/etc/hostssettings dependency

/etc/hosts settings:

When using internet-based licensing (IPv4 address), the configuration of /etc/hosts can negatively

impact license validation. If LifeKeeper startup fails with:

Error in obtaining LifeKeeper license key:

Invalid host.

The hostid of this system does not match the hostid specified

in the license file.

and the listed internet hostid is correct, then the configuration of /etc/hosts may be the cause. To

correctly match /etc/hosts entries, IPv4 entries must be listed before any IPv6 entries. To verify if

the /etc/hosts configuration is the cause, run the following command:

/opt/LifeKeeper/bin/lmutil lmhostid -internet -n

If the IPv4 address listed does not match the IPv4 address in the installed license file, then

/etc/hosts must be modified to place IPv4 entries before IPv6 entries to return the correct address.

INTERFACELIST syntax:

By default, licensing in LifeKeeper is based on the primary network interface eth0. LifeKeeper

installation and startup errors will occur if interface eth0 is renamed. Renaming is not supported, as

itwill cause LifeKeeper to fail to obtain a unique system HOST ID. To address consistent network

device naming conventions introduced in RedHat Enterprise Linux 6.1, the tunable

INTERFACELIST was added to specify the name of the primary interface in RedHat Enterprise

Linux 6.x.

The consistent network device naming of interfaces uses the name em<port number> for on

board interfaces and pci<slot number>p<port number>_<virtual function instance> for pci

add-in interfaces. By default, LifeKeeper will look for network device em0 on RedHat Enterprise

Linux 6.x systems. If that device does not exist, then the INTERFACELIST tunable must be

configured to specify the primary interface name. The tunable should only contain the primary

interface name but does support additional names in a colon separated list: e.g.

INTERFACELIST=em0:em1.

Note: The INTERFACELIST tunable value should be set in /etc/default/LifeKeeper. If the

LifeKeeper core package has not yet been installed, /etc/default/LifeKeeper will not exist.

In this case, ensure that INTERFACELIST is set in the environment prior to rerunning the setup

script (e.g. export INTERFACELIST=em1).

228Troubleshooting