Skip to content

Commit

Permalink
Merge pull request #89 from ynput/documentation/deadline_updates
Browse files Browse the repository at this point in the history
Deadline: Updates for Ayon
  • Loading branch information
kalisp authored Oct 31, 2023
2 parents 141ad95 + 8d9366f commit 5fb971b
Show file tree
Hide file tree
Showing 7 changed files with 18 additions and 12 deletions.
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

0 comments on commit 5fb971b

Please sign in to comment.