An IP address change should not impact the API Gateway appliance negatively when it is configured correctly. This article will check several configuration values to ensure that they are not set in such a manner that a static IP address change may cause an issue. The following items can cause complications when updating the static IP address of a Gateway appliance when set impropertly:
This section will provide instructions on verifying these configuration items and determining if they need to be adjusted. If the adjustment is required then instructions for adjustment will be provided.
The Gateway database connection properties should use fully qualified domain names that are resolvable via DNS or via a Hosts file. IP addresses should not be used in this space. This procedure will check for the use of IP addresses.
If these values are set to IP addresses then they should be changed to fully qualified domain names. Save the file and exit the editor. Restart the Gateway in order to force the changes to take effect.
The Gateway database contains a set of unique grants for replication that provide unprivileged access to a specific user account. These grants should have been created using fully qualified domain names but may be set to IP addresses. This procedure will check for the use of IP addresses.
If IP addresses are present in the host column then it can be changed via these SQL queries:
UPDATE mysql.user SET host = "gw1.domain.com" WHERE host = "<IP for gw1>";
UPDATE mysql.user SET host = "gw2.domain.com" WHERE host = "<IP for gw2>";
The API Gateway can be managed via the CA Enterprise Service Manager. This integration requires configuration of a specific management setting. This setting may be set to a specific IP address that should reflect the IP address assigned to an existing interface on the API Gateway. This address will need to be changed if the applicable IP address has been set.
Listen ports used by the API Gateway for inbound requests can be bound to one or all interfaces. A listen port should be bound to all interfaces or a specific interface range using CIDR. The default listen ports for the Gateway are always assigned to all interfaces but that may have been changed by an administrator prior to the IP address change event. Perform the following procedure to check if a listen port is bound to a specific interface or interface range:
All ports should display (ALL) as the current assigned interface. If an interface displays an IP address or name then the port configuration should be inspected to ensure it will be valid after changing the Gateway's IP address. That can be done as follows:
If an address or pattern would be invalidated by an IP address change then select the pattern or address and click Edit Address Pattern. A dialog will appear and the change can be supplied. The Gateway will need to be restarted for this change to take effect.
The Hosts file provides a DNS-less method of mapping IP addresses to hostnames. Verify this file contains valid IP addresses for any new interfaces as follows: