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.

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

Deadline: Updates for Ayon #89

Merged
merged 2 commits into from
Oct 31, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
Binary file modified website/docs/assets/deadline_configure_plugin.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified website/docs/assets/deadline_group.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified website/docs/assets/deadline_review.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added website/docs/assets/deadline_webserver_config.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified website/docs/assets/ffmpeg_path.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified website/docs/assets/ftrack/ftrack-collect-main.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
30 changes: 18 additions & 12 deletions website/docs/module_deadline.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,8 @@ For [AWS Thinkbox Deadline](https://www.awsthinkbox.com/deadline) support you ne

4. Point AYON to your deadline webservice URL in the [AYON Admin Settings](admin_settings_system.md#deadline).

![Webservice url](assets/deadline_webserver_config.png)

5. Install our custom plugin and scripts to your deadline repository. It should be as simple as copying content of `ayon/modules/deadline/repository/custom` to `path/to/your/deadline/repository/custom`.


Expand All @@ -38,7 +40,7 @@ destinations accessible by DL process. Check permissions (must be executable and
- Enable `Tools > Super User Mode` in Deadline Monitor

- Go to `Tools > Configure Plugins...`, find `AYON` in the list on the left side, find location of AYON
executable. It is recommended to use the `openpype_console` executable as it provides a bit more logging.
executable. It is recommended to use the `ayon_console` executable as it provides a bit more logging.

- In case of multi OS farms, provide multiple locations, each Deadline Worker goes through the list and tries to find the first accessible
location for itself.
Expand All @@ -51,40 +53,44 @@ To setup tile rendering copy the `OpenPypeTileAssembler` plugin to the repositor

### Pools

The main pools can be configured at `project_settings/deadline/publish/CollectDeadlinePools/primary_pool`, which is applied to the rendering jobs.
The main pools can be configured at `ayon+settings://deadline/publish/CollectDeadlinePools`, which is applied to the rendering jobs.

The dependent publishing job's pool uses `project_settings/deadline/publish/ProcessSubmittedJobOnFarm/deadline_pool`. If nothing is specified the pool will fallback to the primary pool above.
The dependent publishing job's pool uses `ayon+settings://deadline/publish/ProcessSubmittedJobOnFarm`. If nothing is specified the pool will fallback to the primary pool above.

:::note maya tile rendering
The logic for publishing job pool assignment applies to tiling jobs.
:::

## Troubleshooting

#### Publishing jobs fail directly in DCCs
:::note guide
You could check [deadline guide](https://community.ynput.io/t/ayon-openpype-deadline-setup/468) for more detailed steps and additional tips.
:::

### Publishing jobs fail directly in DCCs

- Double check that all previously described steps were finished
- Check that `deadlinewebservice` is running on DL server
- Check that user's machine has access to deadline server on configured port

#### Jobs are failing on DL side
### Jobs are failing on DL side

Each publishing from AYON consists of 2 jobs, first one is rendering, second one is the publishing job (triggered after successful finish of the rendering job).

![Jobs in DL](assets/deadline_fail.png)

- Jobs are failing with `AYON executable was not found` error
- **<font size="4"> Jobs are failing with `AYON executable was not found` error </font>**

Check if AYON is installed on the Worker handling this job and ensure `AYON` Deadline Plug-in is properly [configured](#configuration)


- Publishing job is failing with `ffmpeg not installed` error
- **<font size="4"> Publishing job is failing with `ffmpeg not installed` error </font>**

AYON executable has to have access to `ffmpeg` executable, check AYON `Setting > General`
AYON executable has to have access to `ffmpeg` executable, check AYON `ayon+settings://ayon_third_party`

![FFmpeg setting](assets/ffmpeg_path.png)

- Both jobs finished successfully, but there is no review on Ftrack
- **<font size="4"> Both jobs finished successfully, but there is no review on Ftrack </font>**

Make sure that you correctly set published family to be send to Ftrack.

Expand All @@ -95,19 +101,19 @@ Each publishing from AYON consists of 2 jobs, first one is rendering, second one
- `Families`: "render"
- `Add Ftrack Family` to "Enabled"

Make sure that you actually configured to create review for published subset in `project_settings/ftrack/publish/CollectFtrackFamily`
Make sure that you actually configured to create review for published subset in `ayon+settings://deadline/publish/ProcessSubmittedJobOnFarm`

![Ftrack Family](assets/deadline_review.png)

Example: I want to create review for all reviewable subsets in Harmony :
- Add "harmony" as a new key an ".*" as a value.


- Rendering jobs are stuck in 'Queued' state or failing
- **<font size="4"> Rendering jobs are stuck in 'Queued' state or failing </font>**

Make sure that your Deadline is not limiting specific jobs to be run only on specific machines. (Eg. only some machines have installed particular application.)

Check `project_settings/deadline`
Check `ayon+settings://deadline/publish/HarmonySubmitDeadline`

![Deadline group](assets/deadline_group.png)

Expand Down