Oracle Application Server 10g Administrator's Guide 10g (9.0.4) Part Number B10376-01 |
|
This chapter provides procedures for changing the network configuration of an Oracle Application Server host.
It contains the following topics:
Oracle Application Server supports a variety of options for configuring and changing networking features. Depending on your operating system platform, you can install Oracle Application Server on:
After installation, you may want to change the networking configuration. This chapter provides procedures for changing the networking configuration of an Oracle Application Server host.
See Also:
Oracle Application Server 10g Release Notes to determine which networking features are supported for your operating system platform |
Follow this procedure if your host uses a static IP address and hostname, and you would like to change to a different static IP address, hostname, or both. This procedure is for hosts that contain one or more middle-tier instances.
Some examples of when to use this procedure are:
Follow this procedure if your host uses a static IP address and hostname, an you would like to change to a different static IP address. The hostname must remain the same. This procedure is for hosts that contain an Infrastructure. You can use this procedure if your host moves to a new subnet.
This section provides procedures for moving an Oracle Application Server host on and off the network. You may use DHCP or a static IP address when on the network. You can use these procedures, for example, if you installed Oracle Application Server on your laptop and would like to plug in to different networks to use it.
This section provides procedures for changing from a static IP address to DHCP, and from DHCP to a static IP address. You might use these if you install on a static IP address but then decide you would like to use DHCP so you can be more mobile, or if you are using DHCP and must plug in to a network using a static IP address.
This section describes how to change the hostname and IP address of a host that contains one or more Oracle Application Server middle-tier installations. You can use this procedure to change:
You can use this procedure on J2EE and Web Cache, Portal and Wireless, and Business Intelligence and Forms installations. This procedure is not supported for OracleAS Developer Kits 10g installations.
Note:
If any installations contain Oracle Content Management SDK, you must perform additional steps. Refer to Oracle Content Management SDK Administrator's Guide before starting this procedure. |
The procedure includes:
The details on how to do this are not provided, since this varies according to your operating system type and configuration. Consult your operating system documentation to determine how to do this before beginning the procedure.
The details on how to do this are provided in the procedure. For tips on recovering from errors, see Section 9.7, "Recovering from Errors when Using chgiphost.sh".
In this step, you prepare your host for the change by removing instances from clusters and stopping all processes.
Oracle Application Server 10g High Availability Guide for instructions on removing instances from a cluster
See Also:
Oracle Application Server Web Cache Administrator's Guide for instructions on removing caches from a cluster
See Also:
ORACLE_HOME
/bin/emctl stop iasconsoleORACLE_HOME
/opmn/bin/opmnctl stopall
/etc/init.d
scripts.
In this step, you update your operating system with the new hostname, IP address, or both, reboot, and verify that the host is functioning properly on your network. Consult your operating system documentation, system administrator, and network administrator for more information on how to do this.
In this step, you update the Oracle Application Server middle-tier instances on your host with the new hostname and IP address. Follow these steps for each middle-tier instance on your host. Be sure to complete the steps entirely for one middle-tier instance before you move on to the next.
ORACLE_HOME
environment variable is set to the middle-tier Oracle home.
cd ORACLE_HOME
/chgip/scripts
./chgiphost.sh -mid
The chgiphost.sh
command prompts for information, as shown in Table 9-1. You may not receive all of the prompts, depending on your middle-tier installation type.
Note that the prompts may provide values in parenthesis. These are not default values--they are just reminders. You must enter a value for each prompt.
Prompt | Action |
---|---|
Enter the fully qualified host name (hostname.domainname) of the new system |
If you are changing the hostname of the system, enter the new fully-qualified hostname Otherwise, enter the current fully-qualified hostname |
Enter the IP Address of the new system |
If you are changing the IP address of the system, enter the new IP address Otherwise, enter the current IP address |
Enter the fully qualified host name (hostname.domainname) of the old system |
If you are changing the hostname of the system, enter the old fully-qualified hostname Otherwise, enter the current fully-qualified hostname |
Enter the IP Address of the old system |
If you are changing the IP address of the system, enter the old IP address Otherwise, enter the current IP address |
Enter the password for the Mid Tier IAS instance (ias_admin) |
Enter the |
Confirm the password for the Mid Tier IAS instance (ias_admin) |
Enter the |
Note: Depending on your configuration, you may not receive the rest of the prompts in this table. |
|
Enter the password for the OID Administrator |
Enter the |
Confirm the password for the OID Administrator |
Enter the |
Enter the password for the SYS user, of the infra database |
Enter the Note: You can determine which Metadata Repository is used by an instance by looking in the following file:
The Metadata Repository is the value of the |
Confirm the password for the SYS user, of the infra database |
Enter the |
Enter the password for the dsGateway user, of the infra database |
If you are using OracleAS Syndication Services, enter the If you are not using OracleAS Syndication Services, you can enter any dummy password such as "welcome". |
Confirm the password for the dsGateway user, of the infra database |
Enter the |
ORACLE_HOME
/chgip/log
In this step, you restart the middle-tier instances and restore your configuration back to the way it was before you started the procedure.
ORACLE_HOME
/opmn/bin/opmnctl startallORACLE_HOME
/bin/emctl start iasconsole
Oracle Application Server 10g High Availability Guide for instructions on adding instances to a cluster
See Also:
Oracle Application Server Web Cache Administrator's Guide for instructions on adding caches to a cluster
See Also:
This is a special step required for updating OracleAS Portal and OracleAS Wireless when you change the hostname.
Refer to Oracle Application Server Portal Configuration Guide for instructions.
Refer to the section on "Updating the OracleAS Wireless Portal Service URL Reference" in Oracle Application Server Portal Configuration Guide for instructions.
If you edited a file and entered the hostname as part of a user-defined parameter such as the Oracle Home path, the hostname is not automatically updated by running the chgiphost.sh
script. To update the hostname in such cases, you need to edit the files manually. For example, the plsql.conf file may contain an NFS path including the hostname, such as: /net/dsun1/private/...
.
The chgiphost.sh
script also does not edit the hostname references in the documentation files. You will need to manually edit these files to update the hostname. Examples of such files are the following files in the ORACLE_HOME
/Apache/Apache/htdocs
directory.
index.html.de
index.html.es_ES
index.html.fr
index.html.it
index.html.ja
index.html.ko
index.html.pt_BR
index.html.zh_CN
index.html.zh_TW
The password for the DSGATEWAY
schema in the Metadata Repository is stored in Oracle Internet Directory. It is usually a randomly-generated password. If you do not know the DSGATEWAY
password, you can obtain it using the ldapsearch
command.
Run the following command in the middle-tier Oracle home:
ORACLE_HOME
/bin/ldapsearch -h oid_host -p oid_port -D cn=orcladmin -w orcladmin_password -b "orclresourcename=dsgateway, orclreferencename=metadata_repository
, cn=ias infrastructure databases, cn=ias, cn=products, cn=oraclecontext" -s base "objectclass=*" orclpasswordattribute
Where:
oid_host
is the Oracle Internet Directory host name
If you are not sure of this value, it is listed as OIDhost
in the following file in the middle-tier Oracle home:
ORACLE_HOME
/config/ias.properties
oid_port
is the Oracle Internet Directory non-SSL port number
If you are not sure of this value, it is listed as OIDport
in the following file in the middle-tier Oracle home:
ORACLE_HOME
/config/ias.properties
orcladmin_password
is the cn=orcladmin
user password in Oracle Internet Directory
metadata_repository
is the name of the Metadata Repository
If you are not sure of this value, it is listed as InfrastructureDBCommonName
in the following file in the middle-tier Oracle home:
ORACLE_HOME
/config/ias.properties
For example:
ORACLE_HOME
/bin/ldapsearch -h myhost -p 3060 -D cn=orcladmin -w welcome1 -b
"orclresourcename=dsgateway, orclreferencename=asdb.myhost.mydomain.com cn=ias
infrastructure databases, cn=ias, cn=products, cn=oraclecontext" -s base
"objectclass=*" orclpasswordattribute
The ldapsearch
command prints several lines of output. The DSGATEWAY
password is listed as the orclpasswordattribute
, for example:
orclpasswordattribute=B7149q3s
This section describes how to change the IP address of a host that contains an Oracle Application Server Infrastructure.
The procedure includes:
The details on how to do this are not provided since this varies according to your operating system type and configuration. Consult your operating system documentation to determine how to do this before beginning the procedure.
The details on how to do this are provided in the procedure. For tips on recovering from errors, see Section 9.7, "Recovering from Errors when Using chgiphost.sh".
In this step, you prepare your host for the change by stopping all processes.
ORACLE_HOME
and ORACLE_SID
environment variables.
ORACLE_HOME
/bin/emctl stop iasconsoleORACLE_HOME
/opmn/bin/opmnctl stopallORACLE_HOME
/bin/lsnrctl stopORACLE_HOME
/bin/sqlplus /nolog SQL> connect SYS as SYSDBA SQL> shutdown SQL> quit
/etc/init.d
scripts.
In this step, you update your operating system with the new IP address, reboot, and verify that the host is functioning properly on your network. Consult your operating system documentation, system administrator, and network administrator for more information on how to do this.
In this step, you update the Infrastructure on your host with the new IP address.
ORACLE_HOME
and ORACLE_SID
environment variables.
ORACLE_HOME
/bin/sqlplus /nolog
SQL> connect / as SYSDBA
SQL> startup
SQL> quit
ORACLE_HOME
/opmn/bin/opmnctl start
ORACLE_HOME
/opmn/bin/opmnctl startproc ias-component=OID process-type=OID
cd ORACLE_HOME
/chgip/scripts
./chgiphost.sh -infra
The chgiphost.sh
command prompts for the old and new IP address.
ORACLE_HOME
/bin/chgip/log
In this step, you restart the Infrastructure and any middle-tier instances that use it.
ORACLE_HOME
and ORACLE_SID
environment variables.
ORACLE_HOME
/bin/sqlplus /nolog SQL> connect SYS as SYSDBA SQL> startup SQL> quitORACLE_HOME
/lsnrctl startORACLE_HOME
/opmn/bin/opmnctl startallORACLE_HOME
/bin/emctl start iasconsole
chgiphost.sh
script on the middle-tier instance before restarting the middle-tier processes.
This section describes how to move an Oracle Application Server host on and off the network. The following assumptions and restrictions apply:
localhost.localdomain
). The hosts should be configured to use a standard hostname and the loopback IP should resolve to that hostname.
This procedure assumes you have installed Oracle Application Server on a host that is off the network, using a standard hostname (not localhost
), and would like to move on the network and use a static IP address. The IP address may be the default loopback IP, or any standard IP address.
To move onto the network, you can simply plug the host into the network. If you would like to change the static IP address at that time, follow the appropriate procedure:
This procedure assumes you have installed on a host that is off the network, using a standard hostname (not localhost
), and would like to move on the network and use DHCP. The IP address of the host can be any static IP address or loopback IP address, and should be configured to the hostname.
If the original installation was performed using the loopback IP, you do not need to change the IP address.
Follow this procedure if your host is on the network, using a static IP address, and you would like to move it off the network.
/etc/hosts
file so the IP address and hostname can be resolved locally.
Follow this procedure if your host is on the network, using DHCP in loopback mode, and you would like to move it off the network.
This section describes how to change between a static IP address and DHCP. The following assumptions and restrictions apply:
localhost.localdomain
). The hosts should be configured to use a standard hostname and the loopback IP should resolve to that hostname.
To change a host from a static IP address to DHCP:
To change a host from DHCP to a static IP address:
This section describes how to recover from typical errors you might encounter when using the chgiphost.sh
script. It contains the following scenarios:
Suppose you ran the chgiphost.sh
script but specified the wrong destination name. In this case, you can remedy the error by running chgiphost.sh
again. Here are the details.
Suppose the current source hostname is loire985, the incorrect destination hostname you specified is mqa985, and the correct destination hostname is sqb985. Initially, you ran chgiphost.sh
with source = loire985 and destination = mqa985.
To recover from this error:
chgiphost.sh
with source = mqa985 and destination = sqb985.
chgiphost.sh
again with source = loire985 and destination = sqb985.
If you encounter an error when running chgiphost.sh
, you should fix the error and run chgiphost.sh
again.
For example, you will get an error message if you enter the wrong password for Oracle Internet Directory or OracleAS Syndication Services. In this case, you should run chgiphost.sh
again, with the same source and destination hostnames as before, and make sure to supply the correct password when prompted.
|
![]() Copyright © 2002, 2003 Oracle Corporation. All Rights Reserved. |
|