Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

HTCONDOR-2457: Document how to convert to new job router syntax #602

Merged
merged 2 commits into from
May 28, 2024
Merged

HTCONDOR-2457: Document how to convert to new job router syntax #602

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ed9d33a
HTCONDOR-2457: Document how to convert to new job router syntax
ColeBollig May 22, 2024
882232e
HTCONDOR-2457: Have example pipe output into file
ColeBollig May 23, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 18 additions & 1 deletion docs/v23/configuration/job-router-overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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 [[email protected]](mailto:[email protected])
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
------------------------

Expand Down
Loading