EPE - Virheilmoitukset ja ratkaisut
| Virheilmoitus | Ratkaisu |
|
Datapump fails to import Users to ESM. ITSM log says:
|
Tarkista EPE:n mappaukset. Yksi mappauksista käyttää reference-attribuuttia string-attribuutin sijaan. Referenssejä ei tueta. |
|
Datapump fails to import Users to ESM. Datapump log says: 2026-08-07 18:43:24.309 [pool-4-thread-1] INFO c.e.e.datapump.provisioning.ESMProxy - Fetching all enabled entities from ESM, URL: |
Tarkista templaten ja attribuutin oikeudet. Todennäköisimmin oikeudet puuttuvat, jos näet attribuuttikoodin sijaan tietokantakoodin, esimerkiksi näin: and $8576845$
|
Infinite recursion (StackOverflowError) (through reference chain) |
Tarkista EPE:n mappaukset. Yksi mappauksista käyttää reference- tai static-attribuuttia string-attribuutin sijaan. Referenssejä ja static-stringejä ei tueta. |
|
EPE extraction fails: Such issues can arise if a bad key is used during decryption. |
Jos näet tämän virheilmoituksen lokitiedostossa, se tarkoittaa, että EPE-tehtävässä on väärä Private key -salasana. |
Unexpected error: java.security.InvalidAlgorithmParameterException: the trustAnchors parameter must be non-empty
|
Jos näet tämän virheilmoituksen lokitiedostossa, se tarkoittaa, että epe-workerilla ei ole AD:n sertifikaattia. Lisää puuttuva sertifikaatti. |
javax.naming.PartialResultException: [LDAP: error code 10 |
Jos näet tämän virheilmoituksen lokitiedostossa, se tarkoittaa, että ESM:ään (EPE-tehtävään) on määritetty virheellinen 'search base' henkilöille ja/tai ryhmille. |
java.net.SocketTimeoutException: connect timed out |
Jos näet tämän virheilmoituksen lokitiedostossa, se tarkoittaa, ettei epe-worker pysty muodostamaan yhteyttä AD:hen. Tässä tapauksessa on hyvin todennäköistä, että palomuuri estää yhteydet AD:hen. |
|
Caused by:
|
Varmista, että sinulla on uusin voimassa oleva https/ldaps-sertifikaatti. Lisää tai korvaa nykyinen sertifikaatti uusimmalla sertifikaatilla, joka on ladattu lähde-/kohdejärjestelmästä, johon muodostat yhteyden event- tai scheduled-tehtävällä. |
javax.net.ssl.SSLException: Unexpected error: java.security.InvalidAlgorithmParameterException: the trustAnchors parameter must be non-empty at java.base/sun.security.ssl.Alert.createSSLException(Alert.java:133) |
Varmista, että sinulla on uusin voimassa oleva https/ldaps-sertifikaatti. Lisää tai korvaa nykyinen sertifikaatti uusimmalla sertifikaatilla, joka on ladattu lähde-/kohdejärjestelmästä, johon muodostat yhteyden event- tai scheduled-tehtävällä. |
| Cannot fetch attribute mapping configuration from ESM | Jos näet tämän virheilmoituksen lokitiedostossa, se tarkoittaa, että EPE-tehtävän WebAPI-käyttäjän salasana on väärä (tai tunnuksia ei ole määritetty). |
Datapump fails: com.efecte.esm.datapump.exception.ProvisioningException: All rows does not contain strings representing required mappingsOR Index 1 out of bounds for length 1
|
Ota yhteyttä Matrix42:een saadaksesi apua.
|
EPE Worker heartbeat is older than 300 seconds OR INFO c.e.e.m.general.BacgroungWorker - Going to sleep for 300 seconds |
Ota yhteyttä Matrix42:een saadaksesi apua. |
javax.naming.CommunicationExceprtion:Request: 6680 cancelled; remaining name [customer's OU-path] |
LDAP-filtteri on määritettävä oikein:(objectCategory=person) or if 2 (&(objectCategory=person)(objectClass=user))
|
java.lang.ClassCastException: class com.efecte.esm.datapump.jaxb.EntityDeleteErrorReport cannot be cast to class com.efecte.esm.datapump.jaxb.SearchResult |
Osa Identity Attribute Mapping -attribuuteista puuttuu asiakkaan AD:sta. Tätä voi testata lisäämällä mappauksia yksi kerrallaan, kunnes sama virhe alkaa taas esiintyä. |
java.nio.file.NoSuchFileException: /opt/epe/master/config/custom-provisioning-scripts |
Käynnistä EPE worker uudelleen. Tiedosto luodaan automaattisesti. |
LDAP: error code 49 - 80090308: LdapErr: DSID-0C090400, comment: AcceptSecurityContext error, data 52e, v1db1 |
Jos näet tämän virheilmoituksen lokitiedostossa, se tarkoittaa, että EPE-tehtävän LDAP Password -käyttäjän salasana on väärä. |
CANCELLED_TOO_LONG_TIME_WAITING_TO_START |
Ota yhteyttä Matrix42:een saadaksesi apua.
|
Export of data to folder 'folder_code_example' failed with exception: 500 : [no body] |
Tyhjennä EPE-tehtävän data cache. |
TOTAL_TASKS_LAST_EXPORT_TO_ESM_FAILED |
Tarkista itsm.log-tiedostosta, miksi vienti epäonnistuu. Yleisin syy on unique-virhe, workflow tai listener. Jos export status on FAILED, webapi-käyttäjän salasana on väärä |
WARNINGS_LOG_LAST_15_MINUTES_COUNT |
Viesti tarkoittaa, että lokitiedostoon on kirjautunut liikaa "warning"-viestejä viimeisen 15 minuutin aikana. Tämä voi liittyä esimerkiksi ongelmiin 'event based provisioning' -tehtävissä. (epäonnistunut kirjoitus AD:hen/Azureen kirjautuu lokiin 'warning'-viestinä) Jos yllä oleva viesti esiintyy asiakasympäristössä, siihen ei ole vakioratkaisua. Seuraava vaihe on tarkistaa lokitiedostosta, mitä nämä 'warning'-viestit koskevat, ja yrittää sitä kautta löytää ongelma. |
EPE_WORKER_COMPLETED_FAILURE, error message: com.efecte.epe.worker.azure.util.AzureProvisioningException: Number of fetched attributes: 20 doesn't match required: 21 Requested attributes:
|
Ota yhteyttä Matrix42:een saadaksesi apua. |
EPE_WORKER_COMPLETED_FAILURE, error message: java.util.concurrent.ExecutionException: java.net.UnknownHostException: login.microsoftonline.com at java.base/java.util.concurrent.FutureTask.report
|
"UnknownHostException" tarkoittaa, ettei isäntänimen IP-osoitetta pystytty selvittämään. Tässä tapauksessa se tarkoittaa, ettei DNS-palvelu pystynyt löytämään esimerkiksi osoitteen "login.microsoftonline.com" Häiriö oli DNS-palvelussa tai jokin muu verkko-ongelma virtuaalikoneissa. |
Provisioning engine service request finished with error: Failed to query task metadata - failed to decrypt encoded text
|
Ota yhteyttä Matrix42:een saadaksesi apua. |
Authentication task gives error and no realms are displayed in dropdown. Cannot invoke "java.util.Map.get(Object)" because "accessToken" is null
|
ESA:n kanssa on kommunikointiongelma, eikä EPE pysty hakemaan siltä access tokenia. |
EPE_MASTER_FAILED_TO_RETRIEVE_FILES and worker log says json does not exist |
EPE-tehtävän nimessä on ääkkösiä (äöå.), poista ne ja yritä uudelleen. |
EPE_WORKER_COMPLETED_FAILURE, error message: java.util.concurrent.ExecutionException: com.microsoft.aad.adal4j.AuthenticationException: {"error_description":"AADSTS7000215: Invalid client secret provided.
|
Azure EPE -tehtävässä on virheellinen tai vanhentunut client secret. Asiakkaan tulee vaihtaa/tarkistaa secret Entra ID:stä ja toimittaa se EPE:lle. |
EPE_WORKER_COMPLETED_FAILURE, error message: javax.naming.AuthenticationException: [LDAP: error code 49 - 80090308: LdapErr: DSID-0C090569, comment: AcceptSecurityContext error, data 533, v4563
|
LDAP-käyttäjä on poistettu käytöstä. Se pitää vaihtaa toiseen tai ottaa nykyinen käyttäjä uudelleen käyttöön. |
Could not fetch syntax definition for attribute: streetAddress.javax.naming.OperationNotSupportedException: [LDAP: error code 12 - 00002040: SvcErr: DSID-031403F9, problem 5010 (UNAVAIL_EXTENSION), data 0
|
Tämä tarkoittaa, ettei streetAddress ole EPE:n käytettävissä. Tarkista streetAddress-attribuutin oikeudet ja että se löytyy hakemistosta. |
EPE_WORKER_COMPLETED_FAILURE, error message: java.util.concurrent.ExecutionException: com.microsoft.aad.adal4j.AuthenticationException: {"error_description":"AADSTS700016: Application with identifier '123123132' was not found in the directory 'Customer example'.
|
AADSTS700016 on virhekoodi, joka tarkoittaa, ettei sovellusta, johon yrität kirjautua, ole rekisteröity Azure AD:hen/EntraID:hen. Ongelman korjaamiseksi asiakkaan tulee rekisteröidä sovellus Azure AD:hen. |
LDAP: error code 49 - 80090308: LdapErr: DSID-0C090439, comment: AcceptSecurityContext error, data 532, v4563 |
AD:ssa käytettävän palvelutilin salasana on vanhentunut. |
| Saving Workflow does not work, and orchestration nodes color changes to red. Error in Workflow UI after save-button is clicked: Workflow is invalid and cannot be saved |
Tämä ongelma voi ilmetä 2024.2-version päivityksen jälkeen, jossa EPE-migraatio vaikuttaa myös workflow-kulkuihin, joissa on orchestration-noodeja. ESM-cachea ei aina tyhjennetä migraation jälkeen, mikä voi estää workflow-kulkujen tallentumisen. Ongelman ratkaisemiseksi ESM-cache pitää tyhjentää, kun 2024.2-päivitys on valmis. Tämän cachen voi tyhjentää kohdasta Maintenance / Other actions / Clear persistent Object Caches (toiminto suoritetaan heti klikkauksesta kysymättä vahvistusta). |
|
|
Ota yhteyttä Matrix42:een saadaksesi apua. |
2025-02-19 11:51:24,688 ERROR [org.keycloak.broker.oidc.AbstractOAuth2IdentityProvider] (executor-thread-2) Unexpected response from token endpoint https://customer1.sandbox.signicat.com/auth/open/connect/token. status=400, response={"error":"invalid_request","error_description":"The selected IdP requires to encrypt ID tokens, but no encryption key was found.","error_uri":"https://api.signicat.com/auth/open/config/errors/invalid_request"}2025-02-19 11:51:24,694 WARN [org.keycloak.events] (executor-thread-2) type="IDENTITY_PROVIDER_LOGIN_ERROR", realmId="484ad22b-4f1b-4d0e-bda2-9170a513ad83", clientId="https://customerservice-test.customer1.fi/shibboleth", userId="null", ipAddress="185.59.118.105", error="identity_provider_login_failure", code_id="061805f2-5b24-4f8b-8698-ac30bcdda07a"2025-02-19 11:52:33,443 INFO [com.efecte.keycloak.providers.login.itsm.authenticator.EfecteLoginForm] (executor-thread-2) Returning config property: consul.ACLTokenPath -> /var/lib/efecteone/consul/application_token2025-02-19 11:52:47,809 ERROR [org.keycloak.broker.oidc.AbstractOAuth2IdentityProvider] (executor-thread-6) Unexpected response from token endpoint https://customer1.sandbox.signicat.com/auth/open/connect/token. status=400, response={"error":"invalid_request","error_description":"The selected IdP requires to encrypt ID tokens, but no encryption key was found.","error_uri":"https://api.signicat.com/auth/open/config/errors/invalid_request"}2025-02-19 11:52:47,815 WARN [org.keycloak.events] (executor-thread-6) type="IDENTITY_PROVIDER_LOGIN_ERROR", realmId="484ad22b-4f1b-4d0e-bda2-9170a513ad83", clientId="https://customerservice-test.customer1.fi/shibboleth", userId="null", ipAddress="185.59.118.105", error="identity_provider_login_failure", code_id="7746cce3-1230-4b52-b8f6-7b32cac14c61" |
Ota yhteyttä Matrix42:een saadaksesi apua.
|
There was a problem when creating new User: No serializer found for class org.hibernate.proxy.pojo.bytebuddy.ByteBuddyInterceptor and no properties discovered to create BeanSerializer (to avoid exception, disable SerializationFeature.FAIL_ON_EMPTY_BEANS) (through reference chain: com.efecte.rest.provisioning.dto.activity.UserProvisioningRequest["attributesValues"]->java.util.HashMap["employeeType"]->java.util.ImmutableCollections$ListN[0]->com.efecte.datamodel.statics.StaticString$HibernateProxy$IUo9wfr0["attribute"]->com.bitmount.equipment.BSSAttribute["referredTemplates"]->java.util.ArrayList[0]->com.bitmount.equipment.BSSTemplate["permissions"]->org.hibernate.collection.internal.PersistentBag[0]->com.bitmount.equipment.BSSTemplatePermission["adminRole"]->com.efecte.datamodel.AdminRole$HibernateProxy$FXC8y5j9["hibernateLazyInitializer"])
|
EPE-konnektorin mapperit eivät tue ESM:n static-attribuuttia. Käytä mapperissa jotain non-static-kenttää static-attribuutin sijaan. |
Error message on scheduled task like:com.efecte.epe.worker.entra.util.MicrosoftEntraProvisioningException: Exception connecting to MicrosoftEntra, HTTP code: 400 at com.efecte.epe.worker.entra.handlers.AbstractHandler.getDataFromMicrosoftEntraGraph(AbstractHandler.java:245) at com.efecte.epe.worker.entra.handlers.AbstractHandler.getDataFromMicrosoftEntraGraph(AbstractHandler.java:206) at com.efecte.epe.worker.entra.handlers.AbstractHandler$MicrosoftEntraDataFetcher.fetchPartialData(AbstractHandler.java:672) at com.efecte.epe.worker.entra.handlers.AbstractHandler$MicrosoftEntraDataFetcher.get(AbstractHandler.java:612) at com.efecte.epe.worker.entra.handlers.AbstractHandler.fetchAndStoreMicrosoftEntraData(AbstractHandler.java:145) at com.efecte.epe.worker.entra.handlers.GenericHandler.handle(GenericHandler.java:44) at com.efecte.epe.worker.entra.TaskHandler.handleDataFetch(TaskHandler.java:109) at com.efecte.epe.worker.entra.TaskHandler.performGraphSearchUsingSecret(TaskHandler.java:55) at com.efecte.epe.worker.entra.TaskHandler.handle(TaskHandler.java:131) at com.efecte.epe.worker.entra.ProvisioningTaskScheduler.lambda$handleTask$0(ProvisioningTaskScheduler.java:177) at java.base/java.util.Optional.ifPresent(Optional.java:178) at com.efecte.epe.worker.entra.ProvisioningTaskScheduler.handleTask(ProvisioningTaskScheduler.java:160) at com.efecte.epe.worker.entra.ProvisioningTaskScheduler.run(ProvisioningTaskScheduler.java:122) at java.base/java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:539) at java.base/java.util.concurrent.FutureTask.run(FutureTask.java:264) at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1136) at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:635) at java.base/java.lang.Thread.run(Thread.java:840)
|
Tarkista koko epe-workerin lokitiedosto ja etsi tämän kaltaisia lokirivejä:
Tämä kertoo varsinaisen ongelman: mappauksessasi on attribuutti, jota kutsumasi Graph API ei tue. Tässä tapauksessa ongelma oli attribuutissa |
|
Nothing is created/updated to esm. Error in log beeing similar to this:
|
Tarkista ja korjaa scheduled task -tehtävän unique-attribuutin mappaus. (objectGUID)Unique-attribuutin on oltava myös attribuuttien mapping-taulukossa. |
|
|
Virhe 401 tarkoittaa yleensä, ettei EPE pysty autentikoitumaan ESM:ään datakorttien viemiseksi sinne. Tarkista, että konnektorin WebAPI-käyttäjän salasana on asetettu oikein konnektoriin.
Jos ongelma jatkuu, ota yhteyttä Matrix42:een. |
500 : "<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><EOL><EOL> |
Virhe 500 johtuu todennäköisesti data- tai ESM-datakorttikonfiguraation ongelmasta. Tähän mennessä on löydetty seuraavia erilaisia syitä. Ne ovat asiakaskohtaisia, mutta niissä on tiettyjä toistuvia "kaavoja":
|
ERROR c.e.e.d.provisioning.ESMExport - Exception while trying to handle export of data for resource 'users'. Message: Exception thrown while calling Web API with URL: http://1.1.1.1:49019/itsm/ws/dataCardImport.ws?version=1.1&removeEmptyValues=true&folderCode - 500
|
Virhe 500 johtuu EPE:n bugista ja puuttuvasta konfiguraatiosta. Ratkaise tämä määrittämällä arvot: Failure Template, Failure Folder ja Failure Attribute sille scheduled taskille, joka epäonnistuu tähän virheeseen. Nämä ovat pakollisia versiosta 2025.1. alkaen, muuten tehtävä pysähtyy ensimmäiseen epäonnistumiseen. |
|
Operating system kills datapump when it is exporting data to ESM or Datapump freezes after retrieving files from epe-master |
Ota yhteyttä Matrix42:een saadaksesi apua. |
|
Scheduled tasks not running as scheduled Error on log: |
Tarkista ja korjaa scheduled taskin ajastusasetukset. Niissä saa käyttää vain kokonaislukuja, ei desimaalilukuja. |