From ed9d33a406cc1b061e0c8a5d8050773f7f6c1c51 Mon Sep 17 00:00:00 2001 From: Cole Bollig Date: Wed, 22 May 2024 14:44:37 -0500 Subject: [PATCH 1/2] HTCONDOR-2457: Document how to convert to new job router syntax --- docs/v23/configuration/job-router-overview.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/docs/v23/configuration/job-router-overview.md b/docs/v23/configuration/job-router-overview.md index 57ca1513..a4313232 100644 --- a/docs/v23/configuration/job-router-overview.md +++ b/docs/v23/configuration/job-router-overview.md @@ -30,7 +30,7 @@ The HTCondor [ClassAd transforms](https://htcondor.readthedocs.io/en/lts/classad originally introduced to HTCondor to perform in-place transformations of user jobs submitted to an HTCondor pool. In the HTCondor 8.9 series, the Job Router was updated to support transforms and HTCondor-CE 5 adds the configuration necessary to support routes written as ClassAd transforms. -If configured to use trasnform-based routes, HTCondor-CE routes and transforms jobs that by chaining ClassAd transforms +If configured to use transform-based routes, HTCondor-CE routes and transforms jobs that by chaining ClassAd transforms in the following order: 1. Each transform in `JOB_ROUTER_PRE_ROUTE_TRANSFORM_NAMES` whose requirements are met by the job @@ -89,6 +89,23 @@ Additionally, it is now easier to include job transformations that should be eva including transforms in the lists of `JOB_ROUTER_PRE_ROUTE_TRANSFORM_NAMES` and `JOB_ROUTER_PRE_ROUTE_TRANSFORM_NAMES`, respectively. +### Converting To New Syntax ### + +For existing HTCondor-CE's utilizing the deprecated old job router syntax can do the following steps to convert +to using the new syntax: + +1. Output the current configuration by running `condor_ce_config_val -summary > summary-file` +2. Convert the stored configuration by running `condor_transform_ads -convert:file summary-file` +3. Place the output of the previous command into the HTCondor-CE's configuration. +4. Tweak new job routes as needed. For assistance please reach out to [htcondor-users@cs.wisc.edu](mailto:htcondor-users@cs.wisc.edu) +5. Set [JOB_ROUTER_USE_DEPRECATED_ROUTER_ENTRIES](https://htcondor.readthedocs.io/en/latest/admin-manual/configuration-macros.html#JOB_ROUTER_USE_DEPRECATED_ROUTER_ENTRIES)=False + in the HTCondor-CE's configuration. +6. Restart the HTCondor-CE + +!!! note "Not Using Custom Job Routes?" + Conversion of job router syntax from the deprecated old version to new only needs to occur + if custom job routes have been configured. + How Jobs Match to Routes ------------------------ From 882232ee420a8c1def78cec91373a99bc41fa10a Mon Sep 17 00:00:00 2001 From: Cole Bollig Date: Thu, 23 May 2024 09:58:31 -0500 Subject: [PATCH 2/2] HTCONDOR-2457: Have example pipe output into file --- docs/v23/configuration/job-router-overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/v23/configuration/job-router-overview.md b/docs/v23/configuration/job-router-overview.md index a4313232..e8c0fa97 100644 --- a/docs/v23/configuration/job-router-overview.md +++ b/docs/v23/configuration/job-router-overview.md @@ -95,8 +95,8 @@ For existing HTCondor-CE's utilizing the deprecated old job router syntax can do to using the new syntax: 1. Output the current configuration by running `condor_ce_config_val -summary > summary-file` -2. Convert the stored configuration by running `condor_transform_ads -convert:file summary-file` -3. Place the output of the previous command into the HTCondor-CE's configuration. +2. Convert the stored configuration by running `condor_transform_ads -convert:file summary-file > converted-job-routes.conf` +3. Place the `converted-job-routes.conf` from the previous command into the HTCondor-CE's configuration. 4. Tweak new job routes as needed. For assistance please reach out to [htcondor-users@cs.wisc.edu](mailto:htcondor-users@cs.wisc.edu) 5. Set [JOB_ROUTER_USE_DEPRECATED_ROUTER_ENTRIES](https://htcondor.readthedocs.io/en/latest/admin-manual/configuration-macros.html#JOB_ROUTER_USE_DEPRECATED_ROUTER_ENTRIES)=False in the HTCondor-CE's configuration.