FAQ for when worker cannot find Blender executable #104232

Merged
Sybren A. Stüvel merged 5 commits from michael-2/flamenco:faq_worker_not_finding_blender into main 2023-08-23 15:15:39 +02:00
Showing only changes of commit 20ea130d96 - Show all commits

View File

@ -61,6 +61,32 @@ file][workercfg].
[workercfg]: {{< ref "usage/worker-configuration" >}} [workercfg]: {{< ref "usage/worker-configuration" >}}
## My Worker cannot find Blender, what do I do?
When installing and starting the Flamenco Worker you may see a warning in the logs that says
the Worker cannot find Blender.
Example Flamenco Worker <=v3.2 log message...
michael-2 marked this conversation as resolved

I think this line can be removed, and the period in the sentence above can be turned into a colon:

... that says the Worker cannot find Blender:

IMO there is no need to specify which version of Flamenco is used. If you do want to be explicit, use something like "Flamenco Worker v3.2 would log:"

I think this line can be removed, and the period in the sentence above can be turned into a colon: > ... that says the Worker cannot find Blender: IMO there is no need to specify which version of Flamenco is used. If you do want to be explicit, use something like "Flamenco Worker v3.2 would log:"
```
WRN Blender could not be found, Flamenco Manager will have to supply a full path
```
There are two ways to resolve this problem:
michael-2 marked this conversation as resolved

This can be written more positively. It's just a warning, not a "problem". Something like "There are two ways to address this" would be better.

This can be written more positively. It's just a warning, not a "problem". Something like "There are two ways to address this" would be better.
1. Blender be installed in [platform dependent paths][blenderpaths] using the Blender installer or
available in the environment $PATH.
2. Use a [two-way variable named `blender`][blendervar] for each platform (eg: Windows, Linux or MacOS).
For option (1), Flamenco will attempt to locate Blender by examining the system.
In option (2) the `blender` path for the Worker is sent when a Render Job Task is enqueued.
The Worker will still show a warning on startup and expect the Flamenco Manager to send the Blender
path to use.
[blendervar]: {{< ref "usage/variables/blender" >}}
[blenderpath]: https://docs.blender.org/manual/en/latest/advanced/blender_directory_layout.html#platform-dependent-paths
## Can I change the paths/names of the rendered files? ## Can I change the paths/names of the rendered files?