adop phase=prepare fails with: Error Message : ORA-12514: TNS:listener

Issue:

adop phase=prepare fails with: Error Message : ORA-12514: TNS:listener does not currently know of service requested in connect descriptor

Symptoms:

Attempts to execute "adop phase=prepare" fail with the following error:

ERROR
-----------------------
  [EVENT] [END 2018/04/15 11:24:56] Generating ad_zd_logs before truncating
  [EVENT] [START 2018/04/15 11:24:56] Check and create Patch Edition (if required)
  [EVENT] [START 2018/04/15 11:24:56] Checking if Patch Edition already exists
  [EVENT] [END 2018/04/15 11:24:56] Check and create Patch Edition (if required)
  [EVENT] [START 2018/04/15 11:24:56] Performing steps to synchronise the FS
  [ERROR] Cannot connect to database
  [ERROR] Error Message : ORA-12514: TNS:listener does not currently know of service requested in connect descriptor (DBD ERROR: OCIServerAttach)
  [ERROR] *** Error occurred while calling ad_zd_log. Please check log file for the details. ***
  [UNEXPECTED]Error while runPendingClone sub-routine is called
  [EVENT] [START 2018/04/15 11:24:58] Check and Stop patch FS Admin Server

The issue can be reproduced at will with the following steps:

1. execute adop phase=prepare


Cause:

The local_listener not set properly in the init.ora parameter file.

Solution:

To implement the solution test the following steps in a development instance and then migrate accordingly:

1. Ensure a valid backup exists before testing the solution.
2. Check if the local_listener is set incorrectly by using:

At the RDBMS HOME:
sqlplus / as sysdba
SQL>show parameter local_listener

NAME                                 TYPE        VALUE
------------------------------------ ----------- ------------------------------
local_listener                       string      VIS_LOCAL

In this scenario VIS is the SID used in this Environment
3. If the local listener value returned is incorrect, change it to the correct value in the init.ora parameter file.

4. Restart the Database tier and the listener.

5. Execute the "adop phase=prepare" again and confirm the error no longer occurs.


Reference:

adop phase=prepare fails with: Error Message : ORA-12514: TNS:listener does not currently know of service requested in connect descriptor (Doc ID 2007225.1)