Merge pull request #4661 from martinwolst/pulsar-faq

FAQ for using data sources tools with Pulsar as default

CONTRIBUTORS.yaml

@@ -1239,6 +1239,11 @@ mwolfien:
     name: Markus Wolfien
     joined: 2017-09
 
+martinwolst:
+    name: Martin Wolstencroft
+    joined: 2024-01
+    orcid: 0000-0002-6080-1710
+    elixir_node: uk
 smza:
     name: Munazah Andrabi
     joined: 2023-09

topics/admin/faqs/data-source-with-pulsar.md

@@ -0,0 +1,24 @@
+---
+title: Using data source tools with Pulsar
+area: deployment
+box_type: tip
+layout: faq
+contributors: [martinwolst]
+---
+
+Data source tools such as UCSC Main will fail if Pulsar is the default destination.
+
+To fix this issue you can force individual tools to run on a specific destination or handler by adding to your job_conf file:
+
+For job_conf.xml
+```xml
+<tools>
+    <tool id="ucsc_table_direct1" destination="my-local" />
+</tools>
+```
+For job_conf.yml
+```yml
+tools:
+- id: ucsc_table_direct1
+  handler: my-local
+```