pentaho/pentaho-kettle · error · KettleException

HTTPPOSTMeta.Exception.UnableToSaveStepInfo

Error message

HTTPPOSTMeta.Exception.UnableToSaveStepInfo

What it means

HTTPPOSTMeta.saveRep() wraps any exception raised while persisting the HTTP POST step's attributes (URL, fields, request/response headers, result field names) to the Kettle repository in a KettleException with this message, appending the step id. It signals that the step definition could not be saved, so the transformation will be incomplete when reloaded. The cause is always the wrapped repository exception.

Solutions

1. Check the wrapped cause (KettleException.getCause()) for the repository failure — fix connectivity/permissions first
2. Re-run the save operation after restoring the repository connection
3. Verify the repository user has write access to the target transformation folder
4. If using a file repository, check disk space and write permissions on the repository directory

Example fix

// before
transMeta.saveRep(repo, metaStore, transId, true);
// after
try {
  transMeta.saveRep(repo, metaStore, transId, true);
} catch (KettleException e) {
  logError("Failed to save HTTP POST step: " + e.getCause(), e);
  throw e;
}

if (!repo.isConnected()) { repo.connect(user, password); }

boolean isWritableRepo(Repository repo) { return repo != null && repo.isConnected(); }

try { transMeta.saveRep(repo, metaStore, transId, true); } catch (KettleException e) { logger.error("Unable to save step info: " + e.getCause(), e); }

When it happens

Trigger: Calling saveRep (directly or via saving a transformation) when the repository connection fails mid-save, a saveStepAttribute call throws (DB constraint, connection loss, read-only repository), or an invalid id_step is passed.

Common situations: Network drop to the database repository while saving; repository user lacks write permissions; saving a transformation copied between repositories; stale repository session after timeout.

Related errors

• AddSequenceMeta.Exception.UnableToSaveStepInfo
• ColumnExistsMeta.Exception.UnableToSaveStepInfo
• ColumnExistsMeta.Exception.UnexpectedErrorReadingStepInfo
• CreditCardValidatorMeta.Exception.UnableToSaveStepInfo
• CubeInputMeta.Exception.UnableToSaveStepInfo

AI-assisted analysis of pentaho/pentaho-kettle@f3058517a1 (2026-09-13). Data as JSON: /api/errors/059e2cca03e2b636. Report an issue: GitHub.

Appendix: source

Thrown at engine/src/main/java/org/pentaho/di/trans/steps/httppost/HTTPPOSTMeta.java:574

      rep.saveStepAttribute( id_transformation, id_step, "connectionTimeout", connectionTimeout );
      rep.saveStepAttribute( id_transformation, id_step, "closeIdleConnectionsTime", closeIdleConnectionsTime );

      for ( int i = 0; i < argumentField.length; i++ ) {
        rep.saveStepAttribute( id_transformation, id_step, i, "arg_name", argumentField[i] );
        rep.saveStepAttribute( id_transformation, id_step, i, "arg_parameter", argumentParameter[i] );
        rep.saveStepAttribute( id_transformation, id_step, i, "arg_header", argumentHeader[i] );
      }
      for ( int i = 0; i < queryField.length; i++ ) {
        rep.saveStepAttribute( id_transformation, id_step, i, "query_name", queryField[i] );
        rep.saveStepAttribute( id_transformation, id_step, i, "query_parameter", queryParameter[i] );
      }

      rep.saveStepAttribute( id_transformation, id_step, "result_name", fieldName );
      rep.saveStepAttribute( id_transformation, id_step, "result_code", resultCodeFieldName );
      rep.saveStepAttribute( id_transformation, id_step, "response_time", responseTimeFieldName );
      rep.saveStepAttribute( id_transformation, id_step, "response_header", responseHeaderFieldName );
    } catch ( Exception e ) {
      throw new KettleException( BaseMessages.getString( PKG, "HTTPPOSTMeta.Exception.UnableToSaveStepInfo" )
        + id_step, e );
    }
  }

  public void check( List<CheckResultInterface> remarks, TransMeta transMeta, StepMeta stepMeta,
    RowMetaInterface prev, String[] input, String[] output, RowMetaInterface info, VariableSpace space,
    Repository repository, IMetaStore metaStore ) {
    CheckResult cr;

    // See if we have input streams leading to this step!
    if ( input.length > 0 ) {
      cr =
        new CheckResult( CheckResult.TYPE_RESULT_OK, BaseMessages.getString(
          PKG, "HTTPPOSTMeta.CheckResult.ReceivingInfoFromOtherSteps" ), stepMeta );
      remarks.add( cr );
    } else {
      cr =
        new CheckResult( CheckResult.TYPE_RESULT_ERROR, BaseMessages.getString(

View on GitHub (pinned to f3058517a1)