Skip Headers

Oracle9i Application Server Release Notes Addendum
Release 2 (9.0.2.0.1) for Microsoft Windows
Part No. A90336-10
  Go To Documentation Library
Home		 Go To Table Of Contents
Contents
Previous Next  

4 Changing the IP Address of an Oracle9iAS Host

This chapter describes how to change the IP address of a host that has Oracle9iAS Release 2 (9.0.2.1.0) installed on it.

It describes how to change the static IP address only. It does not describe how to configure DHCP or change the hostname.

It contains the following topics:

4.1 How to Use This Chapter

The following table describes how to use this chapter:

If you... Do this...
Want to change the IP address of a host with one Oracle9iAS installation
  1. Read Section 4.2, "Things to Know Before You Start".

  2. Follow the procedure in Section 4.3, "Changing the IP Address of a Host with One Oracle9iAS Installation".

Want to change the IP address of a host with more than one Oracle9iAS installation You have two options:

Option 1 (Supported)

The following procedure is fully supported by Oracle:

  1. Read Section 4.2, "Things to Know Before You Start".

  2. Deinstall all but one Oracle9iAS installation on the host.

  3. Follow the procedure in Section 4.3, "Changing the IP Address of a Host with One Oracle9iAS Installation".

  4. Reinstall the rest of the Oracle9iAS installations.

Option 2 (Beta support)

The following procedure is under test and has been used successfully by beta sites:

  1. Read Section 4.2, "Things to Know Before You Start".

  2. Follow the procedure in Section 4.4, "Changing the IP Address of a Host with Multiple Oracle9iAS Installations".

Attempted to change the IP address of a pre-9.0.2.1.0 release and had problems Refer to Section 4.5, "Recovering From a Failed IP Address Change".

4.2 Things to Know Before You Start

Please review this entire section before you start the IP address change procedure.

It contains the following topics:

4.2.1 Which Versions Are Supported?

The following table describes which Oracle9iAS Release 2 versions are supported for an IP address change. All Oracle9iAS installations on your host must be at a supported version level.

Oracle9iAS Release 2 Version Supported?
9.0.2.0.0 and 9.0.2.0.1 No. You must upgrade to 9.0.2.1.0 before you perform the IP address change.

If you have attempted an IP address change on 9.0.2.0.0 or 9.0.2.0.1 and have failed, refer to Section 4.5, "Recovering From a Failed IP Address Change" for tips on how to recover.

9.0.2.1.0 and all subsequent 9.0.2.x versions Yes.

To determine the version number of an installation:

  1. Run Oracle Universal Installer:

    Select Start > Programs > Oracle Installation Products > Universal Installer

  2. Click Installed Products and view the version number for the Oracle home of the Oracle9iAS installation.

4.2.2 Which Install Types Are Supported?

The following table describes which Oracle9iAS Release 2 install types are supported for an IP address change. You must make sure that all install types on your host are supported. If you have an install type that is not supported, you must deinstall it, perform the IP address change, and reinstall it.

Oracle9iAS Release 2 Install Type Supported?
J2EE and Web Cache

(May or may not be associated with an infrastructure; may or may not be clustered)

Yes
Portal and Wireless Yes
Business Intelligence and Forms Yes
Infrastructure Yes
OC4J Standalone

(This is the OC4J Standalone release that can be downloaded from OTN)

No
Developer Kits No

4.2.3 Are There Any Special Requirements for Hosts That Are Part of a Farm?

Yes. If your host contains an installation that is part of a farm, and other members of the farm exist on other hosts, you must:

  • Make sure that all Oracle9iAS installations in the farm (even those on other hosts) are at a version that supports an IP address change (9.0.2.1.0).

  • Make sure that all members of the farm that exist on other hosts are up and running during the IP address change

This is because during the procedure you will run a command that updates all members of the farm with the new IP address information. So all members of the farm must be running and must be at a supported version level so they can register the new IP address.

More Information About Farms

A farm is a group of Oracle9iAS installations that use the same metadata repository. Often, the members of a farm are spread across different hosts. For example, all of these installations are in the same farm:

  • Host A: Infrastructure containing a metadata repository

  • Host B: J2EE and Web Cache installation that uses the metadata repository on Host A

  • Host C: Portal and Wireless installation that uses the metadata repository on Host A

In order to change the IP address on any of these hosts, you need to make sure the installations on the other two hosts are up and running.

You can determine if an installation is part of a farm by running the following command in the Oracle home of the installation: 

ORACLE_HOME\dcm\bin\dcmctl listInstances

This will list all Oracle9iAS installations that are in the same farm.

4.2.4 Can I Change Multiple Hosts in Any Order?

Yes. If you intend to change the IP address of more than one Oracle9iAS host, you may do so in any order. Be sure to completely finish changing the address of one host before moving on to the next.

4.3 Changing the IP Address of a Host with One Oracle9iAS Installation

This section contains the steps to change the IP address of a Windows NT or Windows 2000 host with exactly one Oracle9iAS installation. Oracle recommends you review all steps before starting.


Note:

Arrange for system downtime before you begin, since this procedure includes shutting down Oracle9iAS and rebooting the host.

  1. Verify the Oracle9iAS installation is at a supported version level (9.0.2.1.0).


    See Also:

    Section 4.2.1, "Which Versions Are Supported?"

  2. Verify the Oracle9iAS installation is a supported install type.


    See Also:

    Section 4.2.2, "Which Install Types Are Supported?"

  3. Determine if the installation is part of a farm. If it is, and any members of the farm exist on other hosts:

  4. Stop the Enterprise Manager Web site: 

    ORACLE_HOME\bin\emctl stop

    This command will prompt you for the ias_admin password.

  5. Shut down the majority of Oracle9iAS: 

    ORACLE_HOME\dcm\bin\dcmctl shutdown -v

  6. In the Services Control Panel, stop any running Oracle9iAS services in the following order (skip over any services you do not have or are not running):

    1. Oracle<ORACLE_HOME_NAME>Discoverer

    2. Oracle<ORACLE_HOME_NAME>WebCacheAdmin

    3. Oracle<ORACLE_HOME_NAME>WebCache

    4. The process in this step should already by shut down at this point. If it is not, be sure to shut it down now.

      Oracle<ORACLE_HOME_NAME>ProcessManager

    5. Oracle<ORACLE_HOME_NAME>Agent


      Note:

      If you have an infrastructure, DO NOT shut down any of the following:

      • Oracle<ORACLE_HOME_NAME>InternetDirectory_iasdb

      • Oracle<ORACLE_HOME_NAME>TNSListener

      • OracleServiceIASDB


  7. If the following file exists: 

    WINDOWS_HOME\system32\drivers\etc\hosts

    and it contains the host's IP address, update it with the new IP address. It is not necessary (or recommended) to modify this file if it doesn't contain an entry for the host.

  8. Update the host with the new IP address.

    On Windows NT:

    1. Open the Network Control Panel.

    2. Select the Protocols tab.

    3. Select TCP/IP Protocol and click Properties.

      Be sure to select the TCP/IP Protocol associated with your Oracle9iAS installation. Check ORACLE_HOME\opmn\conf\ons.conf for an IP address match, if necessary.

    4. Select the IP Address tab and replace the existing IP address with the new one. You may also need to update the subnet mask, default gateway, and DNS information.

    5. Click OK. Windows will immediately, dynamically change the IP address of your host.

    On Windows 2000:

    1. Open the Network and Dial-up Connections Control Panel.

    2. Right-click Local Area Connection. Select Properties.

      Note that Local Area Connection is the default connection - you may have changed the name of the connection. Be sure to click the connection associated with your Oracle9iAS installation. Check ORACLE_HOME\opmn\conf\ons.conf for an IP address match, if necessary.

    3. Select Internet Protocol (TCP/IP). Click Properties.

    4. Replace the existing IP address with the new one. You may also need to update the subnet mask, default gateway, and DNS information.

    5. Click OK. Windows will immediately, dynamically change the IP address of your host.

  9. Verify that the new IP address is working. (Do not reboot your host or restart Oracle9iAS yet).

    1. Make sure DNS or the hosts file on other Oracle9iAS hosts in your network are updated with the new IP address. Again, please note that if the Windows NT/2000 hosts do not already have an entry in their hosts file for the host whose IP address you are changing, there is no need to add one.


      See Also:

      Section 4.6, "Troubleshooting Tips"

    2. Verify that you can ping the host from another host in your network. Be sure to ping using the hostname, not the new IP address, to verify that the host name is resolved properly. Verify that other Oracle9iAS hosts that are in the same farm can ping the host.

  10. Run the following command to register the new IP address. You only need to run this command on the host on which you are changing the IP address; it will automatically update any other members of the farm on other hosts. Make sure all members of the farm on other hosts are up (specifically, that DCM is up) when you run this: 

    ORACLE_HOME\dcm\bin\dcmctl resetHostInformation -v

  11. Wait approximately one minute and then verify that DCM has propagated the new IP address to all members of the farm.

    You can do this by checking the following file in the Oracle home of each Oracle9iAS installation in the farm. Verify that the file contains the new IP address and that the old IP address is no longer present: 

    ORACLE_HOME\opmn\conf\ons.conf

    You must verify this file in the Oracle home on the host whose IP address you are changing, as well as any Oracle homes on other hosts that are part of the farm.

    Do not proceed to the next step until the file has been updated in each Oracle home.

  12. If you have an infrastructure:

    Unless you have already created and added a startup item to start Oracle Internet Directory, start Oracle Internet Directory manually with the following command: 

    ORACLE_HOME\bin\oidctl server=oidldapd inst=1 start

  13. Verify that all Oracle9iAS services have started properly. You should be able to access all of your Oracle9iAS applications.

  14. Perform the following step if you have configured a proxy plug-in for the host whose IP address you changed.

    • If you configured your proxy plug-in to route requests to the Oracle9iAS host using the hostname, restart your iPlanet or IIS server so that the new IP address will get resolved correctly.

    • If you configured your proxy plug-in to route requests to the Oracle9iAS host using the IP address, reconfigure your proxy plug-in to use the new IP address and restart your iPlanet or IIS server.

4.4 Changing the IP Address of a Host with Multiple Oracle9iAS Installations

This section contains the steps to change the IP address of a Windows NT or Windows 2000 host with more than one Oracle9iAS installation. Oracle recommends you review all steps before starting.


Note:

Arrange for system downtime before you begin, since this procedure includes shutting down Oracle9iAS and rebooting the host.

  1. Verify that all Oracle9iAS installations on the host are at a supported version level (9.0.2.1.0).


    See Also:

    Section 4.2.1, "Which Versions Are Supported?"

  2. Verify that all Oracle9iAS installations on the host are a supported install type.


    See Also:

    Section 4.2.2, "Which Install Types Are Supported?"

  3. If any Oracle9iAS installations are part of a farm:

  4. Stop the Enterprise Manager Web site by running the following command in the primary Oracle home: 

    ORACLE_HOME\bin\emctl stop

    This command will prompt you for the ias_admin password.

  5. Shut down the majority of Oracle9iAS by running the following command in each Oracle home: 

    ORACLE_HOME\dcm\bin\dcmctl shutdown -v

  6. In the Services Control Panel, stop all Oracle9iAS installations services in the following order (ignore any listed Oracle9iAS services that you do not have):

    1. Oracle<ORACLE_HOME_NAME>Discoverer

    2. Oracle<ORACLE_HOME_NAME>WebCacheAdmin

    3. Oracle<ORACLE_HOME_NAME>WebCache

    4. The process listed in this step should already by shut down at this point. If it is not, be sure to shut it down now.

      Oracle<ORACLE_HOME_NAME>ProcessManager

    5. Oracle<ORACLE_HOME_NAME>Agent


      Note:

      If you have an infrastructure, DO NOT shut down any of the following services:

      • Oracle<ORACLE_HOME_NAME>InternetDirectory_iasdb

      • Oracle<ORACLE_HOME_NAME>TNSListener

      • OracleServiceIASDB


  7. If the following file exists: 

    WINDOWS_HOME\system32\drivers\etc\hosts

    and it contains the host's IP address, update it with the new IP address. It is not necessary (or recommended) to modify this file if it doesn't contain an entry for the host.

  8. Update the host with the new IP address.

    On Windows NT:

    1. Open the Network Control Panel.

    2. Select the Protocols tab.

    3. Select TCP/IP Protocol and click Properties.

      Be sure to select the TCP/IP Protocol associated with your Oracle9iAS installation. Check ORACLE_HOME\opmn\conf\ons.conf for an IP address match, if necessary.

    4. Select the IP Address tab and replace the existing IP address with the new one. You may also need to update the subnet mask, default gateway, and DNS information.

    5. Click OK. Windows will immediately, dynamically change the IP address of your host.

    On Windows 2000:

    1. Open the Network and Dial-up Connections Control Panel.

    2. Right-click Local Area Connection. Select Properties.

      Note that Local Area Connection is the default connection - you may have changed the name of the connection. Be sure to click the connection associated with your Oracle9iAS installation. Check ORACLE_HOME\opmn\conf\ons.conf for an IP address match, if necessary.

    3. Select Internet Protocol (TCP/IP). Click Properties.

    4. Replace the existing IP address with the new one. You may also need to update the subnet mask, default gateway, and DNS information.

    5. Click OK. Windows will immediately, dynamically change the IP address of your host.

  9. Verify that the new IP address is working.

    1. Make sure DNS or the hosts file on other Oracle9iAS hosts in your network are updated with the new IP address.


      Note:

      If the Windows NT/2000 hosts do not already have an entry in their hosts file for the host IP address you are changing, then there is no need to add one.

    2. Again, please note that


      See Also:

      Section 4.6, "Troubleshooting Tips"

    3. Verify that you can ping the host from another host in your network. Be sure to ping using the hostname, not the new IP address, to verify that the host name is resolved properly. Verify that other Oracle9iAS hosts that are in the same farm can ping the host.

  10. In this step you will register the new IP address. You will run a command in each Oracle9iAS Oracle home on the host whose IP address you are changing and it will automatically update any members of the farm that are on other hosts.

    Before you perform this step, make sure that all Oracle9iAS instances are down on the host whose IP address you are changing, and all instances are up (specifically, DCM) on the other hosts.


    Note:

    You must only run the following command on the host IP address you are changing

    Run the following command in each Oracle home on the host whose IP address you are changing: 

    ORACLE_HOME\dcm\bin\dcmctl resetHostInformation -v


    Note:

    Run the command in each Oracle home in the order shown.

    If you have an infrastructure on this host:

    1. Run it in the infrastructure Oracle home first.

    2. Run it in all middle-tier Oracle homes, in any order.

    3. Run it in the infrastructure Oracle home again.

    If you don't have an infrastructure on this host:

    1. Choose any mid-tier Oracle home and run it there first.

    2. Run it in the other mid-tier Oracle homes.

    3. Run it again in the Oracle home you chose in step `.

  11. Wait approximately one minute and then verify that DCM has propagated the new IP address to all members of the farm.

    Check the ons.conf file in the Oracle home of each Oracle9iAS installation in the farm to verify that the file contains the new IP address and that the old IP address is no longer present. The ons.conf file is located at: 

    ORACLE_HOME\opmn\conf\ons.conf

    You must verify this file in the Oracle home on the host whose IP address you are changing, as well as any Oracle homes on other hosts that are part of the farm.

    Do not proceed to the next step until the file has been updated in each Oracle home.

  12. If you have an infrastructure:

    Unless you have added a startup item to start Oracle Internet Directory, start Oracle Internet Directory manually with the following command: 

    ORACLE_HOME\bin\oidctl server=oidldapd inst=1 start

  13. Verify that all Oracle9iAS services have started properly. You should be able to access all of your Oracle9iAS applications.

  14. Perform the following step if you have configured a proxy plug-in for the host whose IP address you changed.

    • If you configured your proxy plug-in to route requests to the Oracle9iAS host using the hostname, restart your iPlanet or IIS server so that the new IP address will get resolved correctly.

    • If you configured your proxy plug-in to route requests to the Oracle9iAS host using the IP address, reconfigure your proxy plug-in to use the new IP address and restart your iPlanet or IIS server.

4.5 Recovering From a Failed IP Address Change

If you attempted to change the IP address on an unsupported Oracle9iAS version (eg: 9.0.2.0.1) and failed, you can recover as follows:

  1. Change the IP address back to the original IP address.

  2. Make sure Oracle9iAS is working properly using the original IP address.

  3. Upgrade to 9.0.2.1.0.

  4. Go back to the beginning of this chapter and follow the steps for changing an IP address on 9.0.2.1.0.

If you cannot change the IP address back to the original because the network is no longer available, you can either reinstall Oracle9iAS or make the network available, whichever is the most cost-effective solution.

4.6 Troubleshooting Tips

This section contains possible IP change problems and their solutions. It features the following topics:

4.6.1 Web Cache Ports Are Not Accessible After a Restart

Problem

You cannot access your Web Cache ports after a restart.

Solution

Check your Event Viewer's application log for any errors. If errors exist, it is likely that the hosts file was improperly modified.

To correct the problem:

  1. Check the following file and make sure that it contains the correct, new IP address for the host: 

    WINDOWS_HOME\system32\drivers\etc\hosts

    The file most likely contains an incorrect IP address.

  2. If the file contains an incorrect IP address, update the file with the correct IP address (the IP address should match the Windows machine settings).

  3. Save the file and start Web Cache from the Services Control Panel. A reboot should not be necessary.

4.6.2 The ons.conf File Was Not Updated in Every Oracle Home

Problem

After you finish the IP change procedure, the new IP address does not appear in all ons.conf files in your farm.

Solution

This problem typically happens because all members of the farm that exist on other hosts did not have DCM running while you performed the IP address change procedure.

To correct the problem:

  1. Review the IP address change procedure and make sure you followed all steps completely and in the proper order. If not, try repeating the procedure.

  2. If you followed the procedure correctly, try the following:

    1. Make sure DCM is up and running in all members of the farm on all hosts.

    2. Run the following command in each Oracle home whose ons.conf file did not get updated: 

      ORACLE_HOME\dcm\bin\dcmctl resetHostInformation -v

4.6.3 Getting DCM Error ADMN-100999 On Any Hosts in the Farm

Problem

You have received the following DCM error on any host in the same farm as the host whose IP address you changed. 

ADMN-100999

See base exception for details.

Base Exception:
oracle.ias.repository.schema.SchemaException: Unable to connect to Directory Server:javax.naming.CommunicationException:<HOST.DOMAIN>:<OID_PORT>[Root exception is java.net.ConnectException: Connection refused: connect]

Solution

This typically occurs due to one of the following issues (in order of likelihood):

  1. The steps were not performed in the proper sequence.

    Verify that all steps were followed in order, especially step 9 "Verify that the new IP address is working."

  2. Your host cannot resolve the hostname of the infrastructure host.

    Try to ping the infrastructure host from the host whose IP address you changed. Make sure to ping using the short and long hostname:

    1. ping hostname

    2. ping fully_qualified_hostname

    If either fails, you can either:

    1. Resolve your DNS issue.

    2. Modify the hosts file appropriately to reflect the new IP address information.

  3. Oracle Internet Directory is not started or not running correctly.

    Run the following command in the Oracle9iAS Oracle home where you are seeing the error: 

    ORACLE_HOME\bin\ldapbind -p OID_port -h OID_host

    If you don't know the values for OID_port and OID_host, look for the following entries in ORACLE_HOME\config\ias.properties:

    • OIDhost

    • OIDport

    If the bind fails, your are having an LDAP problem with the Oracle Internet Directory server.

    Unless you have already created and added a startup item to start Oracle Internet Directory, start Oracle Internet Directory manually with the following command: 

    ORACLE_HOME\bin\oidctl server=oidldapd inst=1 start

    Verify that ldapbind is working.

  Previous Next
Oracle Logo
Copyright © 2002, 2004, Oracle. All rights reserved.
  Go To Documentation Library
Home		 Go To Table Of Contents
Contents