Change IP Address
- 1 Changing IP Addresses
- 1.1 Recording existing values
- 1.2 Domino Shop?
- 1.3 [Sametime] (aka IBM Collaboration Solutions) Shop?
- 1.4 Time to change
- 1.4.1 Domino Shop?
- 1.4.2 BRMS - Backup and Recovery Media Services Shop?
- 1.4.3 Mimix Shop?
- 1.4.4 SMTP Do you "bind specific"?
- 1.4.5 Mail Forwarding
- 1.4.6 HTTPAdmin Do you "bind specific"?
- 1.4.7 LDAP aka IBM Tivoli Directory Server Do you "bind specific"?
- 1.4.8 SSH Do you "bind specific"?
- 1.4.9 Infor LX ERP LX System Generation
- 1.5 Done Changing, time to start stuff
- 1.6 IBM Documentation
- 1.7 AIX Lpar
- 1.8 Common clean up tasks
Changing IP Addresses
Sometimes one has to change the IP Address on an IBM i. Could be a relocation or whatever. There are several places to remember to check.
Recording existing values
First, record your existing values. Maybe off to the right, write down the new address(es).
CFGTCP 1. Work with TCP/IP interfaces
Internet Subnet Line Line
Address Mask Description Type
2. Work with TCP/IP routes. This is the router or gateway this machine will go through to get to the rest of your network. Off to the right record what the new router entries will be.
Route Subnet Next Preferred
Destination Mask Hop Interface
12. Change TCP/IP domain information. If you are relocating, your network administrator may suggest replacing one or more of these with a more local DNS. Write the new address off to the right. Domain name server(s) internet address(es):
Sometimes one would put the interfaces recorded above into the local host table. Record that:
10. Work with TCP/IP host table entries Internet Host Address Name
If you are running DNS on your i (normally configured using iNav) then you will need to go to iNav, Network, Servers, DNS, Open up NS, right click on DNS Server - NS and select Properties. Then open up the Options tab. On interfaces, if you have an entry there, check it out. When done, File, Save Configuration, then Server, Update.
Now you need to check your http configuration. Point your browser to http://youriSeriesName:2001 When that pops up sign on as someone with QSECOFR authority. Select Web Administration. Select Manage, All Servers, All HTTP Servers. Any that are bound to particular old IP addresses record those here.
Check for SMTP bindings. You can either bind to "select all addresses" or bind to a specific address or addresses. Although there are commands like ADDSMTPLE and RMVSMTPLE, I've yet to find any commands like DSPSMTPLE or WRKSMTPLE. Therefore I recommend using iNav. Network, Servers, TCP/IP, right click on SMTP and select Properties. Check the Bindings tab.
WRKDOMSVR 13=Edit NOTES.INI by each. Search the notes.ini file for TCPIP_TcpIpAddress. Record the address found there below: Domino server IP Address
Also have your Domino administrator check Server documents for buried IP addresses.
[Sametime] (aka IBM Collaboration Solutions) Shop?
The WAS based Proxy server has a way of binding to a specific address as per
Sametime Proxy server is installed on a system with multiple active IP addresses
WRKLNK '/qibm/UserData/WebSphere/AppServer/v7/SametimeWAS/profiles/STPDMgrProfile/config/cells/ProxyCell_Name/nodes/ProxyNode_Name/servers/STProxyServer/*' replacing ProxyCell_Name and ProxyNode_Name with the appropriate values.
Edit the stproxyconfig.xml file.
In the <host> section look for a localip line like
Record that address.
Time to change
Now you are done recording. Start the change. Coordinate with your network administrator, of course. They will need to change routers, DNS entries, etc.
http://youriSeriesName:2001. Sign on as someone with SECOFR authority. Select Web Administration. Select Manage, All Servers, All HTTP Servers. Stop any that need changing. Hopefully you did not bind 2001 to any particular address. Change those that need changing. An alternative to using the above would be to do a WRKLNK '/www/*', drill down into each directory, drill down into the conf directory below that and edit the httpd.conf file and change the Listen line.
6=End server. Repeat for all present.
9=Work server jobs
Wait until all jobs, indented underneath the top subsystem name are ended. Repeat for all Domino servers.
13=Edit NOTES.INI. Search for TCPIP_Tcp_IpAddress. Replace with new address.
Do not start them yet.
Your sametime.ini may have this line in it:
If so, you may have to change some of those addresses.
See the above information you previously recorded. Many of these you may have to delete and readd as changing will certain fields will not be an option.
Check any other iSeries lpars or servers for host table entries that refer to this server.
If you use the networking option of BRMS (Backup and Recovery Media Services) they may start a bare minimum of IP when you are in a restricted state for media management. Run the following:
CALL QBRM/Q1AOLD PARM(‘TCPIPIFC’ ‘*REMOVE’ ‘*ALL’)
CALL QBRM/Q1AOLD PARM(‘TCPIPIFC’ ‘*ADD’ 'aa.xx.yy.zz') where 'aa...' is your new IP address.
11. Configuration menu
2. Work with transfer definitions WRKTFRDFN
System 1 host name or address:
System 2 host name or address:
Later, after you bring stuff up, try
SMTP Do you "bind specific"?
You can check this with iNav, Network, Servers, TCP/IP, right click on SMTP and select properties. However this is how we changed ours:
RMVSMTPLE TYPE(*CLTBIND) INTNETADR('10.10.1.211')
RMVSMTPLE TYPE(*SVRBIND) INTNETADR('10.10.1.211')
ADDSMTPLE TYPE(*CLTBIND) INTNETADR('10.17.6.33')
ADDSMTPLE TYPE(*SVRBIND) INTNETADR('10.17.6.33')
Prompt on CHGSMTPA and see if you have an entry for FWDHUBSVR or Forwarding mailhub server
If so, is it still appropriate?
HTTPAdmin Do you "bind specific"?
For each entry drill into the conf directory and edit the httpd.conf file.
General setup directives
LDAP aka IBM Tivoli Directory Server Do you "bind specific"?
iNav, Network, Servers, TCPIP, Right click on IBM Tivoli Directory Server select Properties, Network, IP Addresses
Look for lines like this (may be more than one)
SSH Do you "bind specific"?
Under this you may notice multiple directories. For example
Each of them have an etc subdirectory. In that etc subdirectory is a file called sshd_config. That file will have a line with ListenAddress. If it is preceeded by a pound sign then it has been commented out. A sample might be
Infor LX ERP LX System Generation
The SYS820D screen of ERP LX System Generation lists a "Mail Host". You can use a name or an IP address. Check this out.
Done Changing, time to start stuff
Test communications from/to this lpar by using the PING command. Your network administrator may block pings. However people don't often do that for internal use - just external users.
Test Domino from your Notes client by using File, Database, Open and using the server name(s) that you just started. You can type in the server name or select it from the list. You may have to select "Other" to see this server if you don't often access this particular Domino server.
Modifying NFS Support for PTF, etc Image catalogs.
Multilpar shops will often have NFS configured to distribute PTFs and OS upgrades from one central lpar to other lpars. Quite common in an IBM i hosting IBM i shop.
1. Work with TCP/IP interfaces
End the virtual ethernet interface with option 10
Record the name of the virtual ethernet line
Create a new interface.
Remove the old interface.
Start the new interface.
10. Work with TCP/IP host table entries
Remove and readd the ones dealing with our change.
8. Work with service tools user IDs and Devices
F13=Select STS LAN adapter
Internet address . . . . . . 10.10.206.26
Gateway router address . . . 10.10.206.1
8=Work with status
10. Work with TCP/IP host table entries
Remove and readd the ones dealing with our change.
At this time the host can ping the guest. The guest cannot ping the host but that's ok.
Changing the TCP/IP Address of the IBM System i System
Changing it's IP address
+--------------------------------------------------------------------------+ | Available Network Interfaces | | | | Move cursor to desired item and press Enter. | | | | en0 Standard Ethernet Network Interface | | et0 IEEE 802.3 Ethernet Network Interface |
Network Interface Name en0 INTERNET ADDRESS (dotted decimal) [10.10.6.90] Network MASK (hexadecimal or dotted decimal) [255.255.254.0]
Host Table Entries
To edit this file is beyond the scope of this.
Using vi to edit the file
Enter until you get to the desired line
:w Will write the file
:q! Will quit without writing the file
:wq! Will write and then quit.
The rest will require you learn how to use vi.
Common clean up tasks
Clearing a Specific ARP Cache Entry
Perhaps you just replaced your routers, upgraded them, or are trying to force through an alternative connection but it seems to continue to use your old route.
This problem was resolved by using the Change TCP/IP Attributes (CHGTCPA) command to set the IP reassembly time-out (IPRSBTIMO) parameter to 90. This will cause IBM i to delete aged ICMP redirect routes and allow IP packets to pass through the correct interface.
There is some debate as to whether or not any change to this parameter is effective or if 90 is a hidden reserved value to reset it. Either way, multiple people have reported this solution as effective.
Routes: See also
IT Jungle: Admin Alert: Setting Up IBM i TCP/IP Host Routes
Flushing DNS Cache
Perhaps you've just changed a DNS entry on some other DNS server and your IBM i is not using it. When you run PING RMTSYS(MYLOCATION) you notice it is using the old IP address.
You've verified that it's not in a host table entry by CFGTCP, 10. Work with TCP/IP host table entries.
The known technique for flushing DNS cache on IBM i is to prompt the CHGTCPDMN command and to press enter on it.
If that continues to use the old IP address then check the DNS entries listed in the CHGTCPDMN command. Perhaps you've changed it on one and it hasn't flushed through to the other. There are a couple of ways to check that. If your IBM i has "57##SS1 31 Domain Name System" loaded on it you can try
NSLOOKUP HOSTNAME('MyEndpoint') DMNNAMSVR('10.10.1.1') in which MyEndpoint is who you are trying to ping and DMNNAMSVR is one of the entries in CHGTCPDMN. You can also try it from Windows DOS prompt with
c:\nslookup MyEndpoint 10.10.1.1
In a location with multiple DNS servers it may take some time for the change to flush through.