000028148 - KB-1332 - How to modify the Appliance hostname

Document created by RSA Customer Support Employee on Jun 14, 2016Last modified by RSA Customer Support Employee on Apr 21, 2017
Version 2Show Document
  • View in full screen mode

Article Content

Article Number000028148
Applies ToAffected Versions: 4.X; 3.6.X
If ACM/IMG is installed, for Versions 5.x and higher, refer to the Installation Guide for hostname changes..  It is CRUCIAL that the documented scripts be used to change any TCP/IP settings such as Hostname IP address and DNS nameservers.
 
ResolutionIf you require the Aveksa Appliance to use the proper DNS name for your network, you cannot just change /etc/hosts you must also modify the Oracle environment. Aveksa provides the "modifyhostname.sh" script for this function. Please review the documented steps for the version you are running before proceeding.  (These steps are documented in the Installation Guide for each version)
Note: this process is for use with Aveksa built appliances running RedHat only. SuSE systems can use Yast to accomplish this.
For ACM version 4.X
 
1. Login as Root
2. Change /etc/hosts to match the desired host name
2. Source the Aveksa/ Oracle variables
. /home/oracle/setDeployEnv.sh
3. Stop the Aveksa Services
service aveksa_server stop

4. Stop the database
service dbora stop

5. Stop the Oracle Enterprise Manager using the command
emctl stop

6. Change the host name by running this script with the fully qualified host name
/usr/bin/modifyhostname.sh host.domain.com
7. Reboot the server

The appliance should now be accessible from the new host name, please validate the list of changed files listed below.

For ACM version 3.X
 
1. Login as Root
2. Change the /etc/hosts file to match the new hostname
3. Source the Aveksa/ Oracle variables
. /home/oracle/setDeployEnv.sh
4. Upload the attached modifyhostnames.sh script to the target appliance
5. Replace the current /usr/bin/modifyhostname.sh with the attached file
6. Change the file to an executable Linux file with these commands
chmod 755 modifyhostname.sh
dos2unix modifyhostname.sh
 

7. Stop the Aveksa Services
service aveksa_agent stop

service aveksa_server stop

8. Stop the database
service dbora stop

9 Stop the Oracle Enterprise Manager using command
emctl stop

10. Change the host name by running this script with the fully qualified host name
/usr/bin/modifyhostname.sh host.domain.com

11. Reboot the server

The appliance should now be accessible from the new host name

For both versions the following files are changed by this script:
1. /etc/hosts
2. /etc/sysconfig/network
3. /usr/bin/tomcat/webapps/aveksa/currHostname
4. /u01/app/oracle/product/10.2.0/db_1/network/admin/listener.ora
5. /u01/app/oracle/product/10.2.0/db_1/network/admin/tnsnames.ora
6. /u01/app/oracle/product/10.2.0/db_1/log/<hostname>
7. /etc/oracle/scls_scr/<hostname>
8. /u01/app/oracle/product/10.2.0/db_1<hostname.domain.com>_AVD

Attachments

    Outcomes