Troubleshooting

Do the problems below sound familiar? If you experience such problems, see the solutions suggestion here.

This page includes the following:

While running a job, I get an error in the Agent log (PLOG) report

Problem: The Agent log shows an error when I try to run a job.

Error:Error: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target.

Solution: This error may occur because of an untrusted certificate. To resolve this, you must import the certificate to Java Keystore. Do so by running the following command:

keytool -import -file <path_to_certificateFile> -noprompt -alias jetty -keystore "<JAVA_HOME>\jre\lib\security\cacerts" -storepass changeit

Note: Restart the Agent after the above steps.

Example

keytool -import -file mycert.cer -noprompt -alias jetty -keystore "C:\Program Files\Java\jdk1.8.0_202\jre\lib\security\cacerts" -storepass changeit

I try to run a job, but it keeps on failing

Problem: I do not know why my job is failing. What can I do?

Solution: Check your reports and if you do not find the information you require, you can set additional properties to enable trace level logs in the report. You can turn them on for Agents and Job objects from the Administration perspective in AWI (Automic Automation's web interface), from the ucxjcitx.ini file, or from uc4config.xml, AWI's configuration file. For details, see Setting Trace.

Example

[TRACE]

file=..\temp\RA_TRACE_##.TXT

max_trace_kb=8000

tcp/ip=0

ra=99

trccount=10

I receive an authentication failure with OAuth2

Problem: I have tried to set up the connection according to the documentation. However, I am still getting an "Authentication Failure" message in the PLOG report.

Possible Causes:

  • The IMAP protocol is not enabled for your mail server/account.

  • Required permissions are not properly set up as suggested by documentation.

Solution/Suggested Approach:

  • You might need to define specific properties in the Properties field of the Email Connection section. For example:

    mail.imaps.auth.plain.disable=true;mail.imaps.auth.xoauth2.disable=false

  • For further possible sources of error, specify the property mail.debug=true in the Email Connection object. It will enable authentication logs in the corresponding job's PLOG report in the subsequent run.