ORA-12514: TNS:listener does not currently know of service requested in connect descriptor

Issue:

On Oracle Applications 12.2 version, ADOP generates error at prepare stage when trying to apply patch with phase=prepare option

*******FATAL ERROR*******
PROGRAM : (apps/fs1/EBSapps/appl/ad/12.0.0/bin/adzdoptl.pl)
TIME : Sat Apr 6 20:02:22 2019
FUNCTION: ADOP::Phase::executeSQL [ Level 1 ]
ERRORMSG: Invalid Credentials


adop patch log file has below error:

AutoPatch error:
The following ORACLE error:

ORA-12514: TNS:listener does not currently know of service requested in connect descriptor

Casue:

There may be multiple reasons for this but following is the cause:

1) ebs_patch service is not registered in listener due to local_listener parameter set .

local_listener is not define in init.ora.

During adop run when it tries to connect to database through ebs_patch service get the error ORA-12514. Which suggest that service is not available and checking listener status does not show service .

Listener status shows

Services Summary...
Service "<sid>" has 1 instance(s).
 Instance "<sid>", status UNKNOWN, has 1 handler(s) for this service...
The command completed successfully

In the init.ora service_names=<service_name> exist but no local_listener available and listener is not using default port . There for even though following command does not give any errors service is not registering .
alter system set SERVICE_NAMES='<service_name>';

Solution:

To implement the solution execute the following steps:

1. Add following line to init.ora:

local_listener = _LOCAL

In this SID is database instance name.

e.g

local_listener = <sid>_LOCAL

2. Restart database.

3. Retest the issue.

4. Migrate the solution as appropriate to other environments.

Reference:

ADOP Failed At Prepare Stage With Invalid Credential Error ORA-12514 (Doc ID 1546945.1)