Skip to content

Commit 549c699

Browse files
committed
HTCONDOR-2457: Document conversion to new job router syntax
1 parent 90b1741 commit 549c699

File tree

1 file changed

+18
-1
lines changed

1 file changed

+18
-1
lines changed

Diff for: docs/v23/configuration/job-router-overview.md

+18-1
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ The HTCondor [ClassAd transforms](https://htcondor.readthedocs.io/en/lts/classad
3030
originally introduced to HTCondor to perform in-place transformations of user jobs submitted to an HTCondor pool.
3131
In the HTCondor 8.9 series, the Job Router was updated to support transforms and HTCondor-CE 5 adds the configuration
3232
necessary to support routes written as ClassAd transforms.
33-
If configured to use trasnform-based routes, HTCondor-CE routes and transforms jobs that by chaining ClassAd transforms
33+
If configured to use transform-based routes, HTCondor-CE routes and transforms jobs that by chaining ClassAd transforms
3434
in the following order:
3535

3636
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
8989
including transforms in the lists of `JOB_ROUTER_PRE_ROUTE_TRANSFORM_NAMES` and `JOB_ROUTER_PRE_ROUTE_TRANSFORM_NAMES`,
9090
respectively.
9191

92+
### Converting To New Syntax ###
93+
94+
For existing HTCondor-CE's utilizing the deprecated old job router syntax can do the following steps to convert
95+
to using the new syntax:
96+
97+
1. Output the current configuration by running `condor_ce_config_val -summary > summary-file`
98+
2. Convert the stored configuration by running `condor_transform_ads -convert:file summary-file`
99+
3. Place the output of the previous command into the HTCondor-CE's configuration.
100+
4. Tweak new job routes as needed. For assistance please reach out to [[email protected]](mailto:[email protected])
101+
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
102+
in the HTCondor-CE's configuration.
103+
6. Restart the HTCondor-CE
104+
105+
!!! note "Not Using Custom Job Routes?"
106+
Conversion of job router syntax from the deprecated old version to new only needs to occur
107+
if custom job routes have been configured.
108+
92109
How Jobs Match to Routes
93110
------------------------
94111

0 commit comments

Comments
 (0)