How to change the hostname of an Applications Tier using AutoConfig

Applies to:

Oracle Applications Technology Stack - Version: 11.5.10.2 to 11.5.10.2 - Release: 11.5.10 to 11.5.10
Information in this document applies to any platform.

Solution

The following method can be used to successfully change an Applications Tier hostname using AutoConfig.
1. Deregister the current Applications server (Required)

As the Applications hostname will be changed, the current Applications server node needs to be de-registered.
To deregister the current Applications server node, run the following command as the owner of the Oracle Applications file system and current database instance:

perl $AD_TOP/bin/adgentns.pl appspass=<APPSpwd> contextfile=<CONTEXT> -removeserver 

If you already changed the information of your existing AutoConfig Context file and have not done the above step, then you can manually update the Net Services Topology Model using the following syntax: 

Locate the System Name:
The System name is the database name
Verify with sql query:

select DB_NAME from FND_DATABASES; 

Locate the server name corresponding to the tier in question:
Query on the Applications tier:

select NAME, SERVER_TYPE from FND_APP_SERVERS, FND_NODES 
where FND_APP_SERVERS.NODE_ID = FND_NODES.NODE_ID and 
SERVER_TYPE='APPS' and FND_NODES.NODE_NAME=upper('hostname'); 

Run the following PL/SQL block:

begin
FND_NET_SERVICES.remove_server('<SYSTEM_NAME'>, '<SERVER_NAME>');
end;
/
commit;
/

 2. Update the AutoConfig Context files (conditional)

If the Context file values have already been changed previously and you had to manually remove the Tier server, then you can skip this step
Create a new context file using the following syntax:-

cd $APPL_TOP/admin
perl $AD_TOP/bin/adclonectx.pl contextfile=$CONTEXT_FILE

This will create a new Context file of the format <SID>_<new hostname>.xml in the current working directory 

3. Shutdown the Applications Tier Services (Required)

Shutdown the Middle Tier services using the script under the following location:-

 

$COMMON_TOP/admin/scripts/<old SID_hostname>/adstpall.sh apps <appspasswd>

4. Change the machine hostname (Required)

Change the hostname at O/S level at this stage
If you use /etc/hosts ensure you remember to update the entries.

Linux Red Hat Platforms Only:

• Verify that the /etc/hosts file contains entries that are similar to the following:
  

127.0.0.1 localhost.localdomain
<ip_address> <node_name>.<domain_name>

• Verify that the /etc/sysconfig/network file contains an entry that is similar to the following:

HOSTNAME=<node_name>.<domain_name>

• Check to see if the /etc/sysconfig/networking/profiles/default/network file exists. If it does, remove it.
  
• If you changed any files in the previous steps, reboot the system.
  

5. Reseed the Net Services Topology Model (Required)

The Net Services Topology Model is automatically updated by running AutoConfig :-

Run AutoConfig on the Applications tier node using the following syntax:-

cd <AD_TOP>/bin

./adconfig.sh contextfile=<full path to new Context file> appspass=<appspasswd>

 

6. Start the Applications Tier Services

Rerun APPSORA.env to set the new Application environment
Start the Applications Tier Services using the script from the new directory:-

$COMMON_TOP/admin/scripts/<SID_<new hostname>/adstrtal.sh apps <appspasswd>

7. Finishing Tasks