From 00ce9aab00965d8321b45953d27960421a51ba26 Mon Sep 17 00:00:00 2001 From: Lars Uffmann Date: Sat, 11 Nov 2023 09:05:06 +0100 Subject: [PATCH 1/2] Add a Restarting a stopped or failed Job section to the batch howto See gh-38326 --- .../spring-boot-docs/src/docs/asciidoc/howto/batch.adoc | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/batch.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/batch.adoc index f2113a06974..324c3199de0 100644 --- a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/batch.adoc +++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/batch.adoc @@ -53,7 +53,12 @@ Consider the following command: This provides only one argument to the batch job: `someParameter=someValue`. +[[howto.batch.restarting-a-failed-job]] +=== Restarting a stopped or failed Job +In order to restart a failed `Job`, all parameters (identifying and non-identifying) have to be re-specified on the command line. Non-identifying parameters are *not* copied from the previous execution. This allows them to be modified or removed. + +NOTE: When using a custom `JobParametersIncrementer`: Be prepared to gather all parameters managed by the incrementer in order to restart a failed execution. [[howto.batch.storing-job-repository]] === Storing the Job Repository From ba998302bda397d591a3a19ba7cb3419bdae084d Mon Sep 17 00:00:00 2001 From: Moritz Halbritter Date: Mon, 13 Nov 2023 12:07:16 +0100 Subject: [PATCH 2/2] Polish "Add a Restarting a stopped or failed Job section to the batch howto" See gh-38326 --- .../src/docs/asciidoc/howto/batch.adoc | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/batch.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/batch.adoc index 324c3199de0..3322bf3cfc3 100644 --- a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/batch.adoc +++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/batch.adoc @@ -53,12 +53,18 @@ Consider the following command: This provides only one argument to the batch job: `someParameter=someValue`. + + [[howto.batch.restarting-a-failed-job]] === Restarting a stopped or failed Job -In order to restart a failed `Job`, all parameters (identifying and non-identifying) have to be re-specified on the command line. Non-identifying parameters are *not* copied from the previous execution. This allows them to be modified or removed. +To restart a failed `Job`, all parameters (identifying and non-identifying) must be re-specified on the command line. +Non-identifying parameters are *not* copied from the previous execution. +This allows them to be modified or removed. + +NOTE: When you're using a custom `JobParametersIncrementer`, you have to gather all parameters managed by the incrementer to restart a failed execution. + -NOTE: When using a custom `JobParametersIncrementer`: Be prepared to gather all parameters managed by the incrementer in order to restart a failed execution. [[howto.batch.storing-job-repository]] === Storing the Job Repository