API Gateway: Procedure for adding addition IP's to the Gateway Appliance on a single network interface
Article ID: 113738
Updated On:
Products
CA Rapid App Security
CA API Gateway
Issue/Introduction
Requirement to split traffic received by the gateway on different hostname/IP’s. Looking to create Multiple IP addresses to one Single Network Interface
The concept of creating or configuring multiple IP addresses on a single network interface is called IP aliasing. IP aliasing is very useful for setting up multiple virtual sites for the Gateway using one single network interface with different IP addresses on a single subnet network.
The main advantage of using this IP aliasing is, you don’t need to have a physical adapter attached to each IP, but instead you can create multiple or many virtual interfaces (aliases) to a single physical card
The concept of creating or configuring multiple IP addresses on a single network interface is called IP aliasing. IP aliasing is very useful for setting up multiple virtual sites for the Gateway using one single network interface with different IP addresses on a single subnet network.
The main advantage of using this IP aliasing is, you don’t need to have a physical adapter attached to each IP, but instead you can create multiple or many virtual interfaces (aliases) to a single physical card
Environment
API Gateway
Resolution
Creating Virtual Interface and Assign Multiple IP Addresses
Interface called “ifcfg-eth0“, the default interface for the Ethernet device.
These device network files are located in “/etc/sysconfig/network-scripts/” directory.
For the Gateway Appliance you add virtual addresses through the configuration menu no need to modify files in /etc/sysconfig/network-scripts/ but is it good to understand where the changes take place for reference
Navigate to the directory and do “ls -l” to list all devices.
# cd /etc/sysconfig/network-scripts/
# ls -l
Create three additional virtual interfaces to bind three IP addresses (10.162.22.133 & 10.162.22.137, and 10.162.22.138) to the NIC. Desired configuration::
Adapter IP Address Type
-------------------------------------------------
eth0 10.162.23.176 Primary
eth0:0 10.162.22.133 Alias 1
eth0:1 10.162.22.137 Alias 2
eth0:2 10.162.22.138 Alias 3
Gateway Configuration Screen Enter 1
Next screen select #2 to see current configuration “Display current network configuration”
Select 1 “Configure networking and system time setting”
Example configuration for the first virtual interface: eth0:0
Networking and system time settings
This wizard will guide you through the process of configuring the following items;
1) network interface
2) default gateway
3) hostname
4) dns
5) timezone
6) time synchronization (NTP)
The wizard can be stopped at anytime by typing 'quit'
To move back to the previous question type '<'
To move back to the previous section type '<<'
To move forward to the next section type (only possible if the current section has already been completed) '>>'
Available network interfaces available for configuration.
1) eth0
2) configure unlisted interface
Please select an interface to configure: 2
Interface Configuration
This section will guide you through the process of configuring a networking interface.
Enter the interface name: eth0:0
Enable interface on boot (y/n)?: y
IPv4 Networking
This section will guide you through the process of configuring IPv4 networking.
Would you like to configure IPv4 networking (y/n)?: y
IPv4 Networking
Enter the protocol (static/dhcp): static
Enter the IPv4 address: 10.162.22.133
Enter the IPv4 netmask: 255.255.254.0
Enter the IPv4 gateway: 10.162.22.1
IPv6 Networking
This section will guide you through the process of configuring IPv6 networking.
Would you like to configure IPv6 networking (y/n)?: n
Would you like to enter another network interface (y/n)?: n
The current IPv4 gateway and interface configuration:
default IPv4 gateway: Not configured
default IPv4 interface: Not configured
Would you like to change the current default IPv4 gateway and interface (y/n)?: n
Networking Configuration
This section will guide you through the process of configuring general networking settings.
Enter the fully qualified hostname [mcqst02-ssg930-4.ssosites.com]: mcqst02-133.ssosites.com
DNS Configuration
This section guides you through the process of configuring DNS entries.
NOTE: Leave both fields blank if you want name servers and search domains to be generated by DHCP.
Enter one or more name server (comma separated) [10.162.24.139,141.202.1.108]:
Enter one or more search domain (comma separated) [ssosites.com,ca.com]:
The current timezone configuration is 'America/New_York'.
Do you want to change the current timezone configuration(y/n)? [n]:
The current timeservers configuration is '0.rhel.pool.ntp.org,1.rhel.pool.ntp.org,2.rhel.pool.ntp.org,3.rhel.pool.ntp.org'.
Do you want to change the current timeservers configuration(y/n)? [n]:
The following changes will be made:
Networking
Enable Networking : true
Hostname : mcqst02-133.ssosites.com
Default Gateway :
Default Gateway Device :
Enable IPv6 : false
Default IPv6 Gateway :
Default IPv6 Gateway Device :
Network Interfaces
eth0
Boot Protocol: DHCP
DHCP Hostname: mcqst02-ssg930-4
eth0:0
Boot Protocol: STATIC
Address: 10.162.22.133
Netmask: 255.255.254.0
Gateway: 10.162.22.1
DNS
Name servers: 10.162.24.139, 141.202.1.108
Search domains: ssosites.com, ca.com
Time Settings
Timezone: America/New_York
Time servers: 0.rhel.pool.ntp.org, 1.rhel.pool.ntp.org, 2.rhel.pool.ntp.org, 3.rhel.pool.ntp.org
Do you wish to apply the changes above (y/n)?y
Repeat same steps for interface eth0:1 & eth0:2
NOTE Need to reset primary hostname mcqst02-ssg930-4.ssosites.com
Go back to reconfigure the hostname for primary interface
Through Configure network in system time settings, then select primary interface "eth0" keep all defaults except "Enter the fully qualified hostname"
Provide the default FQDN for GW: mcqst02-ssg930-4.ssosites.com
Display and verify when completed:
Please make a selection: 2
Hostname: mcqst02-ssg930-4.ssosites.com
Interface "eth0"
Details:
Boot Protocol: DHCP
Currently Online: yes
Hardware Address (MAC): 00:50:56:83:09:09
Addresses:
10.162.22.138/23
10.162.22.137/23
10.162.22.133/23
10.162.23.176/23
FQDNs:
mcqst02-138.ssosites.com
mcqst02-137.ssosites.com
mcqst02-133.ssosites.com
mcqst02-ssg930-4.ssosites.com
Hostname: mcqst02-ssg930-4.ssosites.com
Interface "eth0:2"
Details:
Boot Protocol: STATIC
Currently Online: yes
Hardware Address (MAC): 00:50:56:83:09:09
Addresses:
10.162.22.138/23
FQDNs:
mcqst02-138.ssosites.com
Hostname: mcqst02-ssg930-4.ssosites.com
Interface "eth0:1"
Details:
Boot Protocol: STATIC
Currently Online: yes
Hardware Address (MAC): 00:50:56:83:09:09
Addresses:
10.162.22.137/23
FQDNs:
mcqst02-137.ssosites.com
Hostname: mcqst02-ssg930-4.ssosites.com
Interface "eth0:0"
Details:
Boot Protocol: STATIC
Currently Online: yes
Hardware Address (MAC): 00:50:56:83:09:09
Addresses:
10.162.22.133/23
FQDNs:
mcqst02-133.ssosites.com
Press [Enter] to continue
Example configuration for the first virtual interface: eth0:0
Networking and system time settings
This wizard will guide you through the process of configuring the following items;
1) network interface
2) default gateway
3) hostname
4) dns
5) timezone
6) time synchronization (NTP)
The wizard can be stopped at anytime by typing 'quit'
To move back to the previous question type '<'
To move back to the previous section type '<<'
To move forward to the next section type (only possible if the current section has already been completed) '>>'
Available network interfaces available for configuration.
1) eth0
2) configure unlisted interface
Please select an interface to configure: 2
Interface Configuration
This section will guide you through the process of configuring a networking interface.
Enter the interface name: eth0:0
Enable interface on boot (y/n)?: y
IPv4 Networking
This section will guide you through the process of configuring IPv4 networking.
Would you like to configure IPv4 networking (y/n)?: y
IPv4 Networking
Enter the protocol (static/dhcp): static
Enter the IPv4 address: 10.162.22.133
Enter the IPv4 netmask: 255.255.254.0
Enter the IPv4 gateway: 10.162.22.1
IPv6 Networking
This section will guide you through the process of configuring IPv6 networking.
Would you like to configure IPv6 networking (y/n)?: n
Would you like to enter another network interface (y/n)?: n
The current IPv4 gateway and interface configuration:
default IPv4 gateway: Not configured
default IPv4 interface: Not configured
Would you like to change the current default IPv4 gateway and interface (y/n)?: n
Networking Configuration
This section will guide you through the process of configuring general networking settings.
Enter the fully qualified hostname [mcqst02-ssg930-4.ssosites.com]: mcqst02-133.ssosites.com
DNS Configuration
This section guides you through the process of configuring DNS entries.
NOTE: Leave both fields blank if you want name servers and search domains to be generated by DHCP.
Enter one or more name server (comma separated) [10.162.24.139,141.202.1.108]:
Enter one or more search domain (comma separated) [ssosites.com,ca.com]:
The current timezone configuration is 'America/New_York'.
Do you want to change the current timezone configuration(y/n)? [n]:
The current timeservers configuration is '0.rhel.pool.ntp.org,1.rhel.pool.ntp.org,2.rhel.pool.ntp.org,3.rhel.pool.ntp.org'.
Do you want to change the current timeservers configuration(y/n)? [n]:
The following changes will be made:
Networking
Enable Networking : true
Hostname : mcqst02-133.ssosites.com
Default Gateway :
Default Gateway Device :
Enable IPv6 : false
Default IPv6 Gateway :
Default IPv6 Gateway Device :
Network Interfaces
eth0
Boot Protocol: DHCP
DHCP Hostname: mcqst02-ssg930-4
eth0:0
Boot Protocol: STATIC
Address: 10.162.22.133
Netmask: 255.255.254.0
Gateway: 10.162.22.1
DNS
Name servers: 10.162.24.139, 141.202.1.108
Search domains: ssosites.com, ca.com
Time Settings
Timezone: America/New_York
Time servers: 0.rhel.pool.ntp.org, 1.rhel.pool.ntp.org, 2.rhel.pool.ntp.org, 3.rhel.pool.ntp.org
Do you wish to apply the changes above (y/n)?y
Repeat same steps for interface eth0:1 & eth0:2
NOTE Need to reset primary hostname mcqst02-ssg930-4.ssosites.com
Go back to reconfigure the hostname for primary interface
Through Configure network in system time settings, then select primary interface "eth0" keep all defaults except "Enter the fully qualified hostname"
Provide the default FQDN for GW: mcqst02-ssg930-4.ssosites.com
Display and verify when completed:
Please make a selection: 2
Hostname: mcqst02-ssg930-4.ssosites.com
Interface "eth0"
Details:
Boot Protocol: DHCP
Currently Online: yes
Hardware Address (MAC): 00:50:56:83:09:09
Addresses:
10.162.22.138/23
10.162.22.137/23
10.162.22.133/23
10.162.23.176/23
FQDNs:
mcqst02-138.ssosites.com
mcqst02-137.ssosites.com
mcqst02-133.ssosites.com
mcqst02-ssg930-4.ssosites.com
Hostname: mcqst02-ssg930-4.ssosites.com
Interface "eth0:2"
Details:
Boot Protocol: STATIC
Currently Online: yes
Hardware Address (MAC): 00:50:56:83:09:09
Addresses:
10.162.22.138/23
FQDNs:
mcqst02-138.ssosites.com
Hostname: mcqst02-ssg930-4.ssosites.com
Interface "eth0:1"
Details:
Boot Protocol: STATIC
Currently Online: yes
Hardware Address (MAC): 00:50:56:83:09:09
Addresses:
10.162.22.137/23
FQDNs:
mcqst02-137.ssosites.com
Hostname: mcqst02-ssg930-4.ssosites.com
Interface "eth0:0"
Details:
Boot Protocol: STATIC
Currently Online: yes
Hardware Address (MAC): 00:50:56:83:09:09
Addresses:
10.162.22.133/23
FQDNs:
mcqst02-133.ssosites.com
Press [Enter] to continue
Additional Information
- In Gateway 10, the default network interface is called ssg_eth0.
- This document helps to configure multiple hostnames for the same interface and this is not a complete solution for setting up multiple sites.
- The request for a service from all these hosts will resolve to the same service (as the service name is unique within the Gateway).
- For example, https://mcqst02-137.ssosites.com/service1 and https://mcqst02-138.ssosites.com/service1 will resolve to the same service
Attachments
Feedback
Yes
No
Powered by
