ODA How to Alter the DNS Names Post-Deployment Using GridInst.pl and the Oracle Database Appliance onecommand.params File

Asset ID:	1-71-1600317.1
Update Date:	2015-10-19
Keywords:

Solution Type Technical Instruction Sure

Solution 1600317.1 : ODA How to Alter the DNS Names Post-Deployment Using GridInst.pl and the Oracle Database Appliance onecommand.params File

Applies to:

Oracle Database Appliance X3-2 - Version All Versions to All Versions [Release All Releases]
Oracle Database Appliance - Version All Versions to All Versions [Release All Releases]
Oracle Database Appliance X4-2 - Version All Versions to All Versions [Release All Releases]
Information in this document applies to any platform.

Goal

How to change the DNS Names for your ODA

Solution

How to change the DNS Post-Deployment for the Oracle Database Appliance (ODA): This note is only regarding DNS Server entries for the ODA:

To change the dns information the steps are:

1. Reset the root password to the default value "welcome1" on both nodes

2. Identify the steps fpr SetupSSHroot and SetupDNS#. Start with setting up the root user SSH.

# cd /opt/oracle/oak/onecmd
#./GridInst.pl -o -l |grep SetupSSHroot

o Step 3 = SetupSSHroot

• Setup the ssh

# ./GridInst.pl -o s 3 -- Use -s for the Step# and -o for Virtualized Platform ODAVP
- or -
# ./GridInst.pl -s 3 -- Use -s for the Step# on Bare Metal

-- This completes the rootSSH configuration --

3. Update the /opt/oracle/oak/onecommand.params for the new or additional DNS address (Example)

# grep -i dns /opt/oracle/oak/onecmd/onecommand.params

IsDNSUSED=true
DNS_SERVERS=(130.45.67.89 130.33.222.11 )

Modify the above entries as needed.

4. Setup the DNS

o Identify the step#

/opt/oracle/oak/onecmd/GridInst.pl -l |grep SetupDN

Step 4 = SetupDNS

o Make the changes by executing the SetupDNS step

./GridInst.pl -o s 4
./GridInst.pl -s 4 -- Use -s for the Step# on Bare Metal

-- This completes the DNS steps --

5. Re-secure the machine :

# /opt/oracle/oak/onecmd/GridInst.pl -o -l |grep -i ResecureMachine

Step 23 = ResecureMachine -- Confirm the step as this is version specific

o Make the changes by executing the ResecureMachine step

./GridInst.pl -o s 23 -- Use -o for ODAVP
./GridInst.pl -s 23 - - Use -s only on Bare Metal

The above steps will not change the dns settings in the dom-0.

Use "oakcli configure firstnet" or update the /etc/resolv.conf manually for changing the dns settings in dom-0

1) Log into the ODA as root

To run the suggested script step #5 below you will need to change the password to default(welcome1)
such that it matches the onecommand.params default password on both nodes.

2) Change directories to the location where GridInst.pl and the onecommand.params exist

cd /opt/oracle/oak/onecmd

3) Confirm your current DNS settings

cat /etc/resolv.conf

e.g.

[root@odarm1 onecmd]# cat /etc/resolv.conf

   # Following added by OneCommand
     search anywhere.oracle.com
     nameserver 144.20.199.99
     nameserver 192.135.12.123
   # End of section

4) Review the onecommand.params file to confirm that this matches

[root@odarm1 onecmd]# view onecommand.params

Example

# onecommand.params generated by GUI tool
# Confuration information

CONFIGVERSION=2.7.0.0.0
HWTYPE=V1
ENVTYPE=BM
ApplicationType=Generic
...
... -- skip down to the DNS_SERVERS values under # SCAN INFO section of the onecommands.params file
...

...

# SCAN INFO
SCAN_NAME=odarm-scan
SCAN_IPS=(10.148.12.344 10.148.12.345)
SCAN_PORT=1521
IsDNSUSED=true
DNS_SERVERS=(144.20.199.99 192.135.12.123 ) < -- this should match your /etc/resolv.conf values
...

exit and create a backup of the onecommand.params file

cp onecommand.params onecommand.params.old

5) Use ./GridInst.pl -l to confirm the current steps for the specific version used -- The order and number of steps can change between versions!

[root@odarm1 onecmd]# ./GridInst.pl -l
INFO : Logging all actions in /dev/null and traces in /dev/null
The steps in order are...


12.1.x	2.9.0.0.0 - 2.10.0.0.0	2.7.0.0.0	2.1. -> 2.3.0.0.0
Step 0 = ValidateParamFile	Step 0 = ValidateParamFile	Step 0 = ValidateParamFile	Step 0 = ValidateParamFile
Step 1 = SetupNetwork	Step 1 = SetupNetwork	Step 1 = SetupNetwork	Step 1 = SetupNetwork
Step 2 = WriteNodelists	Step 2 = WriteNodelists	Step 2 = WriteNodelists	Step 2 = WriteNodelists
Step 3 = SetupSSHroot	Step 3 = SetupSSHroot	Step 3 = SetupSSHroot	Step 3 = SetupSSHroot
Step 4 = SetupDNS	Step 4 = SetupDNS	Step 4 = SetupDNS	Step 4 = SetupDNS
Step 5 = UpdateEtcHosts	Step 5 = UpdateEtcHosts	Step 5 = UpdateEtcHosts	Step 5 = UpdateEtcHosts
Step 6 = SetTimezone	Step 6 = SetTimezone	Step 6 = SetTimezone	Step 6 = SetTimezone
Step 7 = SetupNTP	Step 7 = SetupNTP	Step 7 = SetupNTP	Step 7 = SetupNTP
Step 8 = SetupILOM	Step 8 = SetupILOM	Step 8 = SetupILOM	Step 8 = SetupILOM
Step 9 = ValidateEnv	Step 9 = ValidateEnv	Step 9 = ValidateEnv	Step 9 = CreateUsers <<
Step 10 = CreateUsers	Step 10 = CreateUsers	Step 10 = CreateUsers	Step 10 = SetupStorage <<
Step 11 = SetupStorage	Step 11 = SetupStorage	Step 11 = SetupStorage	Step 11 = ValidateEnv <<
Step 12 = SetupSSHusers	Step 12 = SetupSSHusers	Step 12 = SetupSSHusers	Step 12 = SetupSSHusers
Step 13 = InstallGIClone	Step 13 = InstallGIClone	Step 13 = InstallGIClone	Step 13 = InstallGIClone
Step 14 = RunGIClonePl	Step 14 = RunGIClonePl	Step 14 = RunGIClonePl	Step 14 = RunGIClonePl
Step 15 = RunRootScripts	Step 15 = RunRootScripts	Step 15 = RunRootScripts	Step 15 = RunRootScripts
Step 16 = GIConfigAssists	Step 16 = GIConfigAssists	Step 16 = GIConfigAssists	Step 16 = GIConfigAssists
Step 17 = CreateASMDiskgroups	Step 17 = CreateASMDiskgroups	Step 17 = CreateASMDiskgroups	Step 17 = CreateASMDiskgroups
Step 18 = InstallDBClone	Step 18 = InstallDBClone	Step 18 = InstallDBClone	Step 18 = InstallDBClone
Step 19 = RunDBClonePl	Step 19 = RunDBClonePl	Step 19 = RunDBClonePl	Step 19 = RunDBClonePl
Step 20 = DbcaDB	Step 20 = DbcaDB	Step 20 = DbcaDB	Step 20 = DbcaDB
Step 21 = SetupACFS	Step 21 = SetupEMDbControl	Step 21 = SetupEMDbControl	Step 21 = SetupEMDbControl
Step 22 = SetupASR	Step 22 = SetupACFS	Step 22 = SetupACFS	Step 22 = SetupACFS
	- TFA auto installed -	Step 23 = SetupTFA << Different	--- --- ---
Step 23 = ResecureMachine	Step 23 = SetupASR	Step 24 = SetupASR	Step 23 = SetupASR
	Step 24 = ResecureMachine	Step 25 = ResecureMachine	Step 24 = ResecureMachine

12c no longer uses DBcontrol

6) Now we are ready to change the values
- This example will ADD a new DNS server: you could use the same steps to change or remove DNS server entries also

#onecommand.params generated by GUI tool
# Confuration information

CONFIGVERSION=2.7.0.0.0
...
...
-- continue down to the DNS_SERVERS entry

...
...
# SCAN INFO
SCAN_NAME=odarm-scan
SCAN_IPS=(10.148.12.344 10.148.12.345)
SCAN_PORT=1521
IsDNSUSED=true
DNS_SERVERS=(144.20.199.99 192.111.12.123 192.111.45.67) << edit this line - this example adds a new DNS Server address
NTP_SERVERS=...

- save as onecommand.params with your new DNS server value

7) As root you will execute the steps listed below from Node0 in order

[root@odarm1 onecmd]# ./GridInst.pl -s XX -- where XX is the Single Step Number
optionally you can use ./GridInst.pl -r xx-yy -- where xx-yy is a Range of consecutive step

Issue .GridInt.pl from /opt/oracle/oak/onecmd for proper steps

If you are executing the above steps and you are using a non-default password you may get an error similar to the following

./GridInst.pl -r 0-5

    -----
     SUCCESS: All nodes in /opt/oracle/oak/onecmd/tmp/priv_ip_group are pingable and alive.
     INFO   : Setting up ssh across the private network...
     .....ERROR: cannot open file /tmp/setssh-root/tmpfile at GridSteps.pm line 5750

ACTION: Change the password to welcome1 for all steps used

Example (excerpt)
-- Always check the proper set as previously suggested

# ./GridInst.pl -r 0-5 -- This command runs steps 0-5 using the GridInst.pl -r xx-yy [RANGE] flag. The script will stop at the current step if there is a failure

...
INFO   : Logging all actions in /opt/oracle/oak/onecmd/tmp/STEPS-3-4-20131114124438.log and traces in /opt/oracle/oak/onecmd/tmp/STEPS-3-4-20131114124438.trc
INFO   : Loading configuration file /opt/oracle/oak/onecmd/onecommand.params...
INFO   : Creating nodelist files...
==================================================================================
INFO   : 2013-11-14 12:44:39
INFO   : Step 3 SetupSSHroot
...
... etc
...
INFO   : Step 4 SetupDNS
INFO   : Setting up DNS across all nodes...
INFO   : did not do scp for node: odarm1
INFO   : Running as root: /usr/bin/ssh -l root odarm1 /opt/oracle/oak/onecmd/tmp/updatedns.sh
INFO   : Background process 29670 (node: odarm1) gets done with the exit code 0
INFO   : Running as root: /usr/bin/ssh -l root odarm2 /opt/oracle/oak/onecmd/tmp/updatedns.sh
INFO   : Background process 29721 (node: odarm2) gets done with the exit code 0
INFO   : Time spent in step 4 SetupDNS is 1 seconds.
==================================================================================
INFO   : Log file is /opt/oracle/oak/onecmd/tmp/STEPS-3-4-20131114124438.log...

Exiting...

For the last Step: Run

#./GridInst.pl -s 24

8) Confirm your new DNS server has been added

# Following added by OneCommand
     search for anywhere.oracle.com
     nameserver 144.20.199.99
     nameserver 192.111.12.123
     nameserver192.111.45.67
# End of section

Deployment error on Step 16

If you are encountering errors during deployment as you are not planning on using DNS you can
remove or rename /etc/resolv.conf file on each node as a workaround

IsDNSUSED=false DNS_SERVERS=( )

INFO : Step 16 GIConfigAssists INFO : Running post configuration assistants INFO : This is root, will become grid and run: /bin/su grid -c /usr/bin/ssh ... ... ERROR : /bin/su grid -c "/u01/app/12.1.0.2/grid/cfgtoollogs/configToolAllCommands RESPONSE_FILE=/opt/oracle/oak/onecmd/tmp/postcfgassts.rsp > /opt/oracle/oak/onecmd/tmp/configToolAllCommands-rac06box1-log 2>&1" did not complete successfully. Exit code 3 #Step 16# INFO : Time in GIConfigAssists is 828 seconds. Exiting...

Resolution

1) Remove /etc/resolv.conf on both nodes

mv /etc/resolve.conf /etc/resolve.conf.old

2) Rerun the deployment from step 16*

cd /opt/oracle/oak/onecmd/
./GridInst.pl -s 16

If this is successful then run the rest of the steps*

./GridInst.pl -r 17-23

* depending on ODA version

For more complete information on changing network IP addresses please refer to

INTERNAL - ODA: How to Change Oracle Database Appliance IP Addresses Post Deployment (Doc ID 1504734.1)

References

<NOTE:1504734.1> - ODA: How to Change Oracle Database Appliance IP Addresses Post Deployment
<NOTE:1519975.1> - How to change the Timezone in your ODA (Oracle Database Appliance)

Attachments

This solution has no attachment