Integrator Server Connection Errors - Troubleshooting
Errors in the Integrator UI are specific and reflect which part of Jedox suite has problems. In addition to a short error description, a user-friendly message further explains the issues.
Common error messages
Error message | Description |
---|---|
Bad request configuration | Code: ETL_S400 - Failed to execute load New Excel load: Configuration Error in load New Excel load: Only load mode CREATE supported for file location JedoxFiles. |
Server errors
These errors show up if the REST response from the server is returned with 4xx or 5xx code:
Error message | Description |
---|---|
ETL_S400: 'Bad request configuration.' | Integrator Server returns this error if a request cannot be handled due to its content. For example, this error occurs when running a load or job that uses an invalid XML definition in the Integrator UI. |
ETL_S401: 'Authentication credentials invalid.' | This error is returned if a user does not have appropriate rights to an operation. |
ETL_S404: 'No such method.' | This error is returned if a non-existent REST method is called in the Integrator Server. For example, if incompatible versions of the Integrator UI and the Integrator Server are used, this error could occur. |
ETL_S500: 'Internal Integrator server error. Please try again or restart Integrator server.' | This error occurs in case of an internal error in the Integrator Server. The log for Integrator Server may contain additional information in this case. |
ETL_S503: 'Integrator server currently unavailable. Please try again later.' | This error is returned if the Integrator Server did not respond to the request, for example, if it is currently not running. |
RPC etl-mngr client errors
These errors show up in various scenarios when the server returns result, but either it is invalid or it could not be parsed.
Error message | Description |
---|---|
ETL_C01: 'XPath exception error. Parsing XML configuration failed.' | This error occurs if XML is invalid or corrupted and parsing fails in the Integrator UI. |
ETL_C02: 'XML configuration invalid.' | Generally should not be displayed - this happens if building XML configuration from the UI inputs fails. |
ETL_C03: 'Operation unsuccessful.' | This is a generic error that could have multiple causes. It happens when a request is executed but "valid: false" returned, e.g., try to duplicate or rename component when a user with "R" rights on Integrator. |
ETL_C04: 'JSON parsing error. Incorrect JSON format.' | This error covers the rare cases when the JSON parser fails. |
ETL_C05: 'Input/Output error.' | This error shows up if files could not be accessed or an IOException happened. |
ETL_C06: 'Invalid request output please check configuration or query.' | This error shows up if the result of /executions/metadata or /executions/output is invalid. This usually happens if the related SQL query is malformed. |
Updated April 9, 2025