Sửa lỗi XGen & .tx trên render farm Maya

Giới thiệu

Một scene render hoàn hảo trên workstation nhưng trả về kết quả sai từ render farm là một trong những lỗi gây hoang mang nhất trong pipeline Maya - không có gì trong log chỉ ra "lỗi của bạn," và bản thân file scene cũng không hề bị hỏng. Hai thủ phạm phổ biến nhất là XGen và cache texture .tx. Cả hai đều được thiết kế để hoạt động bên ngoài file scene chính: XGen lưu trữ dữ liệu groom và description trong các thư mục collection và archive riêng biệt, còn plugin MtoA của Arnold có thể âm thầm tạo ra cache texture .tx dạng tiled của riêng nó bên cạnh các texture gốc của bạn. Không vấn đề nào trong số này xuất hiện khi bạn mở file .ma hoặc .mb ở máy local, vì ở local, các file bên ngoài đó đã sẵn ở đúng vị trí mà Maya mong đợi.

Chúng tôi gặp mẫu lỗi này đủ thường xuyên trong các job Maya freelance và studio nhỏ đến mức đáng để ghi lại rõ ràng: phần tóc hoặc lông "biến mất" trên bản render từ farm, và texture gây ra lỗi OpenImageIO không rõ nguyên nhân giữa chừng khi render frame, gần như không bao giờ là lỗi phần mềm. Đó là các vấn đề về thu thập asset và cache bị cũ (stale), và cả hai đều có thể phòng tránh bằng một lượt kiểm tra preflight ngắn trước khi bạn submit.

Sơ đồ cho thấy dữ liệu groom và cache được phân giải đúng trên workstation local nhưng bị thiếu trên node render farm, khiến tóc hoặc lông biến mất khỏi bản render.

Vì sao XGen bị lỗi trên render farm (ngay cả khi scene "trông" vẫn ổn)

XGen không lưu trữ groom hay description dưới dạng geometry được bake vào file .ma/.mb. Nó lưu trữ dưới dạng tham chiếu (reference): một file palette .xgen, cộng thêm - tùy theo cách description được cấu hình - một thư mục collections (dữ liệu groom theo từng description) và một thư mục archives (dữ liệu point-cache hoặc Alembic đã bake, nếu description được thiết lập để render từ archive thay vì tạo trực tiếp). Khi bạn mở scene ở local, Maya phân giải các tham chiếu đó dựa trên các đường dẫn vốn đã tồn tại trên máy của bạn hoặc trên mạng chia sẻ local. Khi cùng scene đó đến một node của render farm, những đường dẫn đó thường không tồn tại - vì chúng là đường dẫn tuyệt đối, vì chúng trỏ đến một UNC share mà node farm không được map tới, hoặc vì chỉ có file .ma/.mb được upload còn thư mục xgen/ đi kèm bên cạnh nó thì không hề được gửi theo.

Kết quả hiếm khi là một lỗi cứng (hard error). XGen thường âm thầm không phân giải được description, và bản render vẫn hoàn tất - chỉ là thiếu phần tóc, lông, hoặc lông vũ đáng lẽ phải có. Đó chính là kiểu lỗi đặc trưng khiến việc debug trở nên khó chịu: mọi thứ khác trong frame vẫn render đúng, các drive vẫn báo cáo là đã được map, và phiên bản Maya cũng như XGen trên farm khớp chính xác với workstation - phần groom chỉ đơn giản là biến mất, vì các file tạo ra nó chưa bao giờ được gửi tới.

Một nguyên nhân thứ hai, có liên quan: ngay cả khi thư mục xgen/ đã được thu thập đầy đủ, cài đặt "generate at render time" (tạo tại thời điểm render) so với "cached/archived" (đã cache/lưu trữ) của description vẫn rất quan trọng. Nếu một description được thiết lập để lấy dữ liệu từ archive, và đường dẫn archive đó là tương đối so với một cấu trúc project mà node farm không có, thì description sẽ phân giải ra "không có gì" thay vì tự động chuyển về tạo groom trực tiếp.

Bảng điều khiển kiểu description editor tổng quát, làm nổi bật các trường đường dẫn collection và archive, minh họa nơi dữ liệu tham chiếu groom của XGen tồn tại bên ngoài file scene chính.

Vì sao file texture .tx bị lỗi trên render farm

.tx là một định dạng texture dạng tiled, có mipmap, được tạo ra bởi công cụ maketx của OpenImageIO. Arnold đọc texture .tx nhanh hơn và tốn ít bộ nhớ hơn so với các định dạng gốc, đó là lý do MtoA (plugin Arnold cho Maya) cung cấp tùy chọn "Auto-Convert Textures to TX Files" - khi save hoặc khi render, nó âm thầm tạo ra một cache .tx ngay bên cạnh các texture gốc của bạn.

Hành vi auto-convert đó khá tiện lợi trên một workstation đơn lẻ với một ổ đĩa local và một bản build OpenImageIO nhất quán. Nhưng nó lại kém tin cậy hơn nhiều khi chạy trên một render farm phân tán, vì ba lý do riêng biệt:

Cache bị cũ (stale cache). Nếu một texture gốc được chỉnh sửa sau khi file .tx đã được tạo, và việc kiểm tra timestamp - vốn thường sẽ kích hoạt việc convert lại - không được thực thi (hoặc vị trí có quyền ghi mà node farm cần lại không giống với vị trí đã tạo ra file đó), Arnold có thể load một file .tx đã lỗi thời mà không có bất kỳ cảnh báo nào rằng nó đã cũ.
Lệch phiên bản (version mismatch). Phiên bản maketx/OpenImageIO khác nhau giữa các bản phát hành Arnold và MtoA. Một cache .tx được tạo bởi một phiên bản OIIO có thể gây ra lỗi đọc - thường hiển thị dưới dạng một lỗi OIIO không xác định làm hủy frame - khi được đọc lại bởi một phiên bản khác ở phía farm.
Xung đột ghi (write contention) trên đường dẫn chia sẻ hoặc read-only. Auto-convert giả định rằng nó có thể ghi một file .tx ngay bên cạnh texture gốc. Trên render farm, vị trí đó có thể là read-only, được chia sẻ giữa nhiều job cùng lúc, hoặc đơn giản là không cùng đường dẫn vật lý mà workstation đã dùng, khiến việc convert hoặc âm thầm thất bại, hoặc hai node cùng tranh nhau ghi vào cùng một file cache.

Vấn đề này đủ phổ biến đến mức tài liệu của các render farm trong toàn ngành - không chỉ riêng của chúng tôi - đều thường xuyên khuyến nghị người dùng Maya/Arnold tắt "Auto-Convert Textures to TX Files" để tránh nó, thay vì cố gắng sửa chính hành vi auto-convert. Cách làm đáng tin cậy hơn là đưa ra một lựa chọn có chủ đích: hoặc pre-convert texture sang .tx với một phiên bản maketx đã được cố định (pinned) và gửi các file .tx đó cùng bộ asset collection, hoặc tắt hoàn toàn auto-convert và submit texture gốc, để renderer của farm tự xử lý việc convert một cách nhất quán ở phía họ.

Sơ đồ pipeline cho thấy một texture gốc được maketx chuyển đổi thành cache .tx, với nhánh thứ hai cho thấy một cache bị cũ hoặc lệch phiên bản dẫn đến lỗi đọc texture.

Những gì Scene Archive của Maya không tự thu thập cho bạn

Tính năng archiving scene có sẵn của Maya (Send To / archive project) được xây dựng xoay quanh mô hình reference tiêu chuẩn: các texture được nối qua chính các file node của Maya, và geometry nằm bên trong scene graph. XGen không hoàn toàn khớp với mô hình đó, đó là lý do vì sao dữ liệu của nó là một trong những phần thường bị bỏ sót nhất trong một bộ asset collection tưởng chừng "đầy đủ." Trước khi submit một scene có XGen tới bất kỳ render farm nào, hãy lên kế hoạch đóng gói tường minh:

Chính file palette .xgen
Thư mục xgen/collections/<description>/ cho mỗi description được tham chiếu trong scene
Thư mục xgen/archives/, nếu có description nào được thiết lập để render từ một archive đã bake
Bất kỳ guide curve, density map, hoặc length map bên ngoài nào mà một modifier của XGen tham chiếu tới, nằm ngoài các file-texture node tiêu chuẩn của Maya - những thứ này đôi khi bỏ qua các công cụ archiving vốn bắt được các texture thông thường
Phiên bản Maya và MtoA (Arnold-cho-Maya) chính xác mà scene đã được xây dựng, để render farm load description bằng đúng bản build plugin tương thích, thay vì một bản gần giống nhưng khác

Không điều nào trong số này đòi hỏi phần mềm đặc biệt - nó chỉ đòi hỏi việc xem dữ liệu XGen như một phần chính thức của asset collection, thay vì một hệ quả ngầm định của việc save scene.

Checklist preflight Maya + Arnold cho các job XGen và .tx

Bước	Cần kiểm tra gì	Vì sao điều này quan trọng
1. Khớp phiên bản	Xác nhận dải phiên bản Maya và Arnold/MtoA mà render farm hỗ trợ có bao phủ đúng phiên bản scene của bạn	Lệch phiên bản có thể phá vỡ khả năng tương thích của description XGen ngay cả khi đường dẫn file đã đúng
2. Thu thập các thư mục XGen	Đóng gói tường minh `xgen/collections/`, `xgen/archives/`, và file `.xgen` - đừng chỉ dựa vào một công cụ scene-archive chung chung	Đây là các file thường bị bỏ sót nhất, khiến tóc/lông âm thầm biến mất
3. Kiểm tra cài đặt generate-vs-archive	Xác nhận từng description tạo trực tiếp hay đọc từ một archive đã bake, và đường dẫn archive đó có đi kèm theo job hay không	Một đường dẫn archive không phân giải được sẽ khiến render trống rỗng, mà không hề báo lỗi
4. Chọn một chiến lược texture duy nhất	Hoặc tắt "Auto-Convert Textures to TX Files" và submit texture gốc, hoặc pre-convert với một phiên bản `maketx` đã cố định và kèm theo các file `.tx`	Để auto-convert bật là đang giả định có quyền ghi ở phía farm và phiên bản OIIO khớp nhau - những giả định không phải lúc nào cũng đúng
5. Re-path các tham chiếu UNC và drive-letter	Thay thế mọi đường dẫn `\\server\share\...` hoặc drive-letter local trong các node XGen và texture bằng đường dẫn tương đối mà farm truy cập được	Các đường dẫn phân giải được ở local thường không tồn tại trên node render
6. Chạy test một frame	Submit một frame test duy nhất trước khi chạy toàn bộ sequence, và kiểm tra render log cụ thể cho các cảnh báo texture-load và XGen-resolution, chứ không chỉ xem render có hoàn tất hay không	Bắt được lỗi thiếu tóc, thiếu texture, và lỗi OIIO trước khi chúng làm tốn cả một sequence
7. Quyết định CPU hay GPU cho shot	Với các groom nặng về XGen, độ phủ tóc/lông dày, và mạng shading tùy chỉnh, hãy lên kế hoạch dùng đường render CPU của Arnold cho frame cuối - các scene procedural nặng và shader tùy chỉnh là loại công việc mà chính hướng dẫn của Arnold khuyến nghị dùng CPU cho output cuối cùng	Quyết định định tuyến CPU/GPU trước khi submit giúp tránh phát hiện ra giới hạn thiết bị giữa chừng khi render

Các vấn đề thường gặp và cách khắc phục

Triệu chứng	Nguyên nhân khả dĩ	Cách khắc phục
Tóc hoặc lông bị thiếu trong bản render từ farm, nhưng có ở local	Thư mục `collections`/`archives` của XGen không được thu thập, hoặc đường dẫn không truy cập được từ farm	Đóng gói tường minh các thư mục XGen và re-path mọi tham chiếu UNC/drive-letter
Render bị hủy với lỗi OpenImageIO không xác định giữa chừng khi render frame	Cache `.tx` bị cũ hoặc lệch phiên bản	Tạo lại `.tx` với một phiên bản `maketx` đã cố định, hoặc tắt auto-convert và submit texture gốc
Texture hoặc bitmap không phân giải được trên node render (cũng gặp trong pipeline Arnold-trong-3ds-Max, một dạng lỗi liên quan nhưng khác biệt - xem hướng dẫn về bitmap bị thiếu trong Arnold trên 3ds Max của chúng tôi)	Đường dẫn texture không phân giải được từ node render	Xác nhận các đường dẫn tương đối, có thể truy cập từ farm, trước khi submit
Job render đúng khi submit lại nhưng bị lỗi ở lần đầu	Auto-convert đã ghi cache `.tx` giữa chừng render ở lượt đầu tiên; lượt thứ hai đọc được cache đã hoàn chỉnh	Pre-convert các file `.tx` trước khi submit, hoặc tắt hoàn toàn auto-convert
Arnold hoặc plugin MtoA báo lỗi khi load	Phiên bản MtoA trên farm không khớp với phiên bản mà scene được tạo ra	Xác nhận dải phiên bản Maya/Arnold mục tiêu trước khi submit

Mô phỏng console render log cho thấy một lỗi đọc texture ở mức cảnh báo (warning-level), minh họa loại thông báo mà một cache .tx bị cũ hoặc lệch phiên bản tạo ra trên node render.

Checklist tổng hợp

Đã xác nhận phiên bản Maya và Arnold/MtoA so với dải hỗ trợ của render farm
xgen/collections/ và xgen/archives/ đã được đưa vào tường minh trong asset collection
Đã kiểm tra cài đặt generate-vs-archive của từng description XGen và xác minh đường dẫn có thể truy cập từ farm
Đã chọn một chiến lược texture duy nhất: .tx đã pre-convert (phiên bản maketx cố định) hoặc texture gốc với auto-convert đã tắt - không dùng cả hai
Mọi đường dẫn UNC và drive-letter đã được thay bằng đường dẫn tương đối, truy cập được từ farm
Đã submit một frame test và kiểm tra render log để tìm cảnh báo XGen và texture, trước khi chạy toàn bộ sequence
Đã quyết định đường render CPU hay GPU cho các shot nặng về XGen hoặc dùng shader tùy chỉnh

Trên farm của chúng tôi, các phiên bản Maya gần đây (2022 trở lên) tự động vượt qua bước version-matching ngay khi submit; các phiên bản cũ hơn trong dải hỗ trợ 2014-2027 sẽ được đưa qua một bước kiểm tra provisioning và tương thích trước khi render bắt đầu, để lỗi lệch phiên bản được phát hiện trước khi tốn frame, thay vì giữa chừng job. Các mục về đường dẫn, cache, và cài đặt archive vẫn mang tính đặc thù theo từng scene và đáng để kiểm tra bất kể job đang gửi tới farm nào.

Để thiết lập cloud rendering tổng quát cho Maya, ngoài phạm vi XGen và texture, hãy xem hướng dẫn cloud rendering cho Maya và hướng dẫn đầy đủ về Arnold renderer của chúng tôi. Để biết dải phiên bản phần mềm hỗ trợ đứng sau việc version-matching của farm, hãy xem các trang Maya render farm và Arnold render farm. Về phía texture, tài liệu maketx chính thức của OpenImageIO là tài liệu tham khảo kỹ thuật rõ ràng nhất về việc convert .tx thực sự đang làm gì và những flag nào kiểm soát hành vi mipmap và tiling.

FAQ

Q: Vì sao tóc hoặc lông XGen biến mất khi tôi render trên cloud render farm nhưng lại ổn khi render local? A: Điều này thường có nghĩa là các thư mục collections và archives của XGen chưa được thu thập cùng với phần còn lại của scene. XGen đọc dữ liệu groom và description từ các file bên ngoài này tại thời điểm render - nếu chỉ có file .ma hoặc .mb được upload, node render sẽ không có gì để tạo ra tóc hoặc lông, và nó sẽ render "trọc" thay vì báo một lỗi rõ ràng.

Q: File .tx là gì và vì sao Arnold cần nó? A: File .tx là một texture dạng tiled, có mipmap, được tạo bởi công cụ maketx của OpenImageIO. Arnold và MtoA dùng texture .tx thay vì định dạng gốc vì mipmap dạng tiled load nhanh hơn và tốn ít bộ nhớ hơn khi render, điều này quan trọng hơn nhiều ở quy mô farm so với trên một workstation đơn lẻ.

Q: Tôi có nên để "Auto-Convert Textures to TX Files" bật khi submit lên render farm không? A: Để nó bật là một nguồn lỗi texture phổ biến ở phía farm. Nó hoạt động tốt trên một workstation với một ổ đĩa, nhưng trên một farm phân tán, nó có thể tạo ra một cache .tx bị cũ hoặc lệch phiên bản, hoặc gặp phải sự khác biệt về quyền ghi trên node render. Pre-convert với một phiên bản maketx đã biết rồi gửi kèm file .tx, hoặc tắt auto-convert và submit texture gốc, sẽ tránh được cả hai kiểu lỗi này.

Q: Phiên bản Maya và Arnold của tôi đã khớp với farm rồi - vì sao bản render vẫn thiếu texture? A: Việc khớp phiên bản ngăn được các lỗi ở cấp độ plugin, nhưng phần lớn lỗi XGen và .tx trên farm lại đến từ đường dẫn file, không phải phiên bản. Nếu XGen tham chiếu đến một đường dẫn UNC hoặc drive letter local không tồn tại trên node render, hoặc cache .tx được tạo dựa trên một vị trí texture mà farm không truy cập được, bản render vẫn sẽ lỗi ngay cả khi phiên bản phần mềm đã khớp.

Q: Làm sao để biết render farm hỗ trợ những phiên bản Maya và Arnold nào? A: Hãy kiểm tra dải phiên bản Maya và Arnold/MtoA mà farm hỗ trợ trước khi submit - việc khớp phiên bản loại bỏ được cả một nhóm lỗi render. Farm của chúng tôi hỗ trợ Maya 2014-2027: các phiên bản 2022 trở lên tự động vượt qua bước version-matching ngay khi submit, còn các phiên bản cũ hơn sẽ được đưa qua một bước kiểm tra tương thích trước khi render.

Q: Các shot dùng XGen nên render trên đường CPU hay GPU của Arnold? A: Các shot nặng về XGen với độ phủ tóc/lông dày và mạng shading tùy chỉnh nên thuộc về đường render CPU của Arnold cho output cuối cùng - đó là loại công việc mà chính hướng dẫn của Arnold khuyến nghị dùng CPU. Dù shot dùng đường nào, hãy đưa ra quyết định thiết bị ngay tại thời điểm submit, như một phần của preflight, thay vì phát hiện ra giới hạn giữa chừng khi render.

Q: Tôi nên kiểm tra những gì trước khi submit một scene Maya có XGen lên render farm? A: Hãy chạy một lượt preflight ngắn: xác nhận phiên bản Maya/MtoA đã khớp, đóng gói tường minh các thư mục xgen/collections và xgen/archives, chọn một chiến lược texture duy nhất (.tx đã pre-convert hoặc texture gốc với auto-convert tắt), re-path mọi tham chiếu UNC hoặc drive local, và submit một frame test trước khi chạy toàn bộ sequence.

Q: Đây có phải là vấn đề chỉ riêng của XGen, hay nó cũng xuất hiện với các DCC khác? A: Cùng một mẫu lỗi nền tảng - dữ liệu tồn tại bên ngoài file scene chính, cộng với dữ liệu texture đã cache bị cũ - cũng xuất hiện ở nơi khác. Người dùng 3ds Max gặp một vấn đề liên quan nhưng khác biệt, với các node bitmap bị thiếu trong Arnold khi đường dẫn texture không phân giải được trên node render; xem hướng dẫn về bitmap bị thiếu trong Arnold trên 3ds Max của chúng tôi để biết phiên bản đó của vấn đề.