Maya 환경 변수 설정 가이드
개요
Maya 환경 변수 이해하기
전문 렌더링 워크플로우를 위해 Maya를 설정할 때, 환경 변수는 가장 중요한 구성 요소 중 하나가 됩니다. 로컬에서 작업하든 render farm 제출을 위한 씬을 준비하든, 이러한 변수는 Maya가 플러그인, 스크립트, 모듈, 렌더 엔진에 접근하는 방식을 제어해요.
우리는 잘못 구성된 환경 변수가 다른 어떤 문제보다 더 많은 render farm 실패를 유발한다는 것을 발견했습니다. 로컬에서 완벽하게 렌더링되는 씬이 환경 설정이 다르기 때문에 render farm 노드에서 완전히 실패할 수 있어요. 이 가이드는 모든 플랫폼에서 Maya 환경 변수를 구성하는 방법과 render farm 시스템과의 호환성을 보장하는 방법을 안내합니다.
Maya 환경 변수란?
Maya 환경 변수는 Maya가 리소스를 찾는 위치를 제어하는 텍스트 기반 설정입니다. 다음을 결정해요:
- 플러그인 위치(MAYA_PLUG_IN_PATH)
- 모듈 검색 경로(MAYA_MODULE_PATH)
- 스크립트 디렉토리(MAYA_SCRIPT_PATH)
- 렌더 엔진 구성
- 라이센스 서버 위치
- 사용자 정의 도구 경로
우리는 이러한 변수를 maya.env 파일에 정의합니다. 이는 Maya가 시작할 때 읽는 일반 텍스트 구성 파일이에요. 구문은 간단합니다: NAME=value, 그러나 플랫폼별 세부 사항은 안정성을 위해 중요합니다.
플랫폼별 디렉토리 위치
maya.env 파일을 생성하거나 편집하기 전에, 운영 체제에 맞는 올바른 디렉토리를 찾아야 해요.
Windows Windows에서 maya.env 파일은 Maya 버전별 documents 폴더에 있습니다:
C:\Users\[username]\Documents\maya\[version]
예를 들어, Maya 2026을 실행하는 경우 경로는 다음과 같습니다:
C:\Users\JohnDoe\Documents\maya\2026
macOS Mac 시스템에서 Maya는 Preferences 폴더에 구성을 저장합니다:
/Users/[username]/Library/Preferences/Autodesk/maya/[version]
Maya 2026의 전체 경로는 다음과 같습니다:
/Users/johndoe/Library/Preferences/Autodesk/maya/2026
Linux Linux 설치는 홈 디렉토리 maya 폴더를 사용합니다:
~/maya/[version]
다음으로 확장됩니다:
/home/username/maya/2026
maya.env 파일 생성 및 편집
maya.env 파일은 일반 텍스트 파일(ASCII)이어야 하며, RTF 또는 서식이 있는 문서가 아니에요. VSCode, Sublime Text 또는 Windows의 Notepad와 같은 적절한 텍스트 편집기를 사용하는 것을 권장합니다.
플랫폼별 위치에 정확히 maya.env라는 이름의 새 파일(파일 확장자 없음)을 생성하세요. 디렉토리가 존재하지 않으면 먼저 생성합니다.
Maya 환경 변수 구문
각 환경 변수는 간단한 형식을 따릅니다:
VARIABLE_NAME=value
한 줄에 하나의 변수. 등호 주변에 공백 없음. 주석은 해시 기호(#)로 시작합니다.
# This is a comment
MAYA_PLUG_IN_PATH=/path/to/plugins
MAYA_MODULE_PATH=/path/to/modules
플랫폼별 경로 구문
경로 구문은 운영 체제에 따라 다릅니다. 여기서 주의해야 해요.
Windows 경로 구문 Windows는 경로 구분자로 백슬래시를 사용하고 여러 경로를 구분하기 위해 세미콜론을 사용합니다:
MAYA_PLUG_IN_PATH=C:\Program Files\Plugins;C:\Custom\Plugins;C:\Renders\Plugins
Windows의 변수 치환은 퍼센트 기호를 사용합니다:
MAYA_PLUG_IN_PATH=%MAYA_LOCATION%\bin\plug-ins;C:\Custom\Plugins
macOS 및 Linux 경로 구문 Unix 기반 시스템은 슬래시와 콜론을 사용하여 경로를 구분합니다:
MAYA_PLUG_IN_PATH=/usr/local/plugins:/opt/custom/plugins:/home/renders/plugins
변수 치환은 달러 기호를 사용합니다:
MAYA_PLUG_IN_PATH=$MAYA_LOCATION/bin/plug-ins:/opt/custom/plugins
우리 워크플로우에 필수적인 환경 변수
render farm 통합에 가장 중요한 핵심 변수를 식별했습니다:
MAYA_MODULE_PATH Maya가 모듈(플러그인, 스크립트, 쉘프 정의의 조직화된 컬렉션)을 찾는 위치를 제어합니다. render farm 작업을 위해, 이는 farm의 모듈 위치를 포함해야 합니다:
# Windows
MAYA_MODULE_PATH=C:\Program Files\Autodesk\Maya2026\modules;C:\Farm\modules
# Mac/Linux
MAYA_MODULE_PATH=/Applications/Autodesk/maya2026/modules:/opt/farm/modules
MAYA_PLUG_IN_PATH 플러그인 위치를 지정합니다. 렌더 엔진과 특수 도구에 필수적이에요:
# Windows
MAYA_PLUG_IN_PATH=C:\Program Files\Autodesk\Maya2026\bin\plug-ins;C:\RenderEngine\plugins
# Mac/Linux
MAYA_PLUG_IN_PATH=/Applications/Autodesk/maya2026/plug-ins:/opt/renderengine/plugins
MAYA_SCRIPT_PATH Maya가 MEL 및 Python 스크립트를 찾는 위치를 결정합니다:
# Windows
MAYA_SCRIPT_PATH=C:\Program Files\Autodesk\Maya2026\scripts;C:\Custom\Scripts
# Mac/Linux
MAYA_SCRIPT_PATH=/Applications/Autodesk/maya2026/scripts:/opt/custom/scripts
라이센스 서버 변수 render farm을 사용할 때, 라이센스 서버를 가리킵니다:
MAYA_LICENSE=8000
MAYA_LICENSE_SERVER=license.yourcompany.com
Render Farm별 구성
render farm 제출을 위한 씬을 준비할 때, 몇 가지 추가 변수가 중요해져요. 우리 노드는 Linux 서버에서 실행되므로 특정 경로가 구성되어야 합니다.
렌더 엔진 플러그인 위치 렌더 엔진(Arnold, RenderMan, V-Ray 등)이 farm 노드에서 접근 가능해야 합니다:
MAYA_PLUG_IN_PATH=/opt/farm/renderers/arnold/bin:/opt/farm/renderers/vray/bin
Farm 마운트 경로 farm이 프로젝트 드라이브를 마운트하는 경우, 해당 경로를 구성하세요:
PROJECT_PATH=/mnt/renders/projects
TEXTURE_PATH=/mnt/shared/textures
CACHE_PATH=/mnt/renders/cache
배치 렌더링 변수 farm에서 배치/헤드리스 렌더링을 위해:
MAYA_BATCH_RENDER_TIMEOUT=3600
MAYA_DISABLE_PARALLEL_BATCH_RENDERING=0
일반적인 Maya.env 구성 예제
예제 1: Windows 개발 설정
# Windows Maya 2026 for local development
MAYA_MODULE_PATH=C:\Program Files\Autodesk\Maya2026\modules;C:\Users\artist\Documents\maya\modules
MAYA_PLUG_IN_PATH=C:\Program Files\Autodesk\Maya2026\bin\plug-ins;C:\Tools\plugins;C:\RenderEngine\arnold\bin
MAYA_SCRIPT_PATH=C:\Program Files\Autodesk\Maya2026\scripts;C:\Users\artist\Documents\maya\scripts
MAYA_DISABLE_CNETWORK=1
MAYA_LICENSE_SERVER=192.168.1.100
예제 2: macOS 개발 설정
# macOS Maya 2026 for local development
MAYA_MODULE_PATH=/Applications/Autodesk/maya2026/modules:/Users/artist/Library/Preferences/Autodesk/maya/modules
MAYA_PLUG_IN_PATH=/Applications/Autodesk/maya2026/plug-ins:/opt/tools/plugins:/opt/renderers/arnold/bin
MAYA_SCRIPT_PATH=/Applications/Autodesk/maya2026/scripts:/Users/artist/Library/Preferences/Autodesk/maya/scripts
MAYA_LICENSE_SERVER=license.internal.com
예제 3: Linux Render Farm 노드 구성
# Linux Maya 2026 on render farm nodes
MAYA_MODULE_PATH=/opt/autodesk/maya2026/modules:/opt/farm/modules:/opt/renderers/modules
MAYA_PLUG_IN_PATH=/opt/autodesk/maya2026/bin/plug-ins:/opt/farm/plugins:/opt/renderers/arnold/bin:/opt/renderers/vray/bin
MAYA_SCRIPT_PATH=/opt/autodesk/maya2026/scripts:/opt/farm/scripts
PROJECT_PATH=/mnt/renders/projects
TEXTURE_PATH=/mnt/shared/textures
MAYA_LICENSE_SERVER=license.farm.internal
MAYA_DISABLE_PARALLEL_BATCH_RENDERING=0
환경 변수 문제 해결
환경 변수가 잘못될 때 가장 자주 보는 문제들을 정리했습니다.
공백이 있는 경로 Windows 경로에는 종종 공백이 포함됩니다(Program Files). maya.env에서 전체 경로를 인용하지 마세요:
# WRONG
MAYA_PLUG_IN_PATH="C:\Program Files\Plugins"
# CORRECT
MAYA_PLUG_IN_PATH=C:\Program Files\Plugins
혼합된 구분자 Windows에서 슬래시를 사용하거나 Linux에서 백슬래시를 사용하면 경로가 깨집니다:
# WRONG on Windows
MAYA_PLUG_IN_PATH=C:/Program Files/Plugins
# CORRECT on Windows
MAYA_PLUG_IN_PATH=C:\Program Files\Plugins
Render Farm 불일치 로컬 설정이 farm 설정과 다릅니다. 변수가 로컬 전용 경로를 가리킬 때 씬이 로컬에서는 렌더링되지만 farm에서는 실패해요. 항상 farm 등가 경로로 씬을 테스트하세요.
플러그인이 로드되지 않음 올바른 경로에도 불구하고 플러그인이 로드되지 않으면, farm의 파일 권한을 확인하세요. 일부 플러그인은 실행 권한이 필요합니다:
chmod +x /opt/farm/plugins/pluginname.so
변수 값의 공백 일부 값(예: 경로)은 공백을 포함하지만 변수 자체는 인용을 지원하지 않아요. 이것은 작동합니다:
MAYA_MODULE_PATH=/path with spaces/modules
그러나 복잡한 값은 시스템에서 이스케이프가 필요할 수 있습니다.
환경 변수를 위한 권장 관행
안정성을 보장하기 위해 다음 관행을 권장합니다:
maya.env를 체계적으로 유지하고 문서화하세요. 다른 사람들이 인식하지 못할 수 있는 불명확한 경로나 변수를 설명하는 주석을 추가하세요.
현재 환경 설정으로 render farm에 씬 내보내기를 테스트하세요. 모든 플러그인과 의존성이 올바르게 해결되는지 확인하세요.
maya.env 구성을 버전 관리하세요. 렌더 엔진을 추가하거나 farm 소프트웨어를 업데이트할 때 변경 사항을 추적합니다. 우리는 버전 제어에 저장해요.
가능한 경우 환경 변수 치환을 사용하세요. 경로를 하드코딩하는 대신, $MAYA_LOCATION 또는 %MAYA_LOCATION%와 같은 기존 변수를 참조하세요.
동일한 변수에서 로컬과 farm 경로를 혼합하지 마세요. 로컬 개발과 farm 제출을 위한 별도의 구성 파일을 생성하세요.
개인 스크립트와 플러그인을 애플리케이션 기본값과 분리하세요. 이는 업데이트를 더 쉽게 만들고 충돌을 방지합니다.
구성 테스트
maya.env를 설정한 후, render farm에 중요한 작업을 제출하기 전에 테스트하세요.
Maya를 열고 Script Editor에서 이 Python 명령을 실행하세요:
import os
print(os.getenv('MAYA_MODULE_PATH'))
이는 Maya가 사용하는 실제 확장된 경로를 보여줍니다. 플러그인이 올바르게 로드되는지 확인하세요: Windows > Settings/Preferences > Plug-in Manager. 사용자 정의 플러그인이 목록에 나타나는지 확인하세요.
render farm 테스트의 경우, 사용자 정의 플러그인이 활성화된 간단한 테스트 씬을 제출하세요. 이는 프로덕션 씬에 영향을 미치기 전에 구성 오류를 포착합니다.
Maya 구성에 대해 더 알아보기
버전별 세부 사항 및 고급 구성 옵션은 공식 Autodesk Maya 문서를 확인하는 것을 권장합니다. 문서는 환경 변수를 포괄적으로 다루며 각 Maya 릴리스마다 업데이트됩니다.
render farm 통합 세부 사항에 대해서는, farm 측 구성과 씬 제출 워크플로우를 다루는 시작 가이드를 참조하세요. 통합된 워크플로우 솔루션을 위해 3ds Max 클라우드 렌더링과 Arnold 클라우드 render farm 서비스도 탐색할 수 있어요.
FAQ
Q: maya.env에서 경로가 올바른데도 Maya가 내 플러그인을 찾지 못하는 이유는 무엇인가요? A: 플러그인 파일 자체에 읽기 권한이 있고 Maya 버전과 일치하는지 확인하세요(Maya 2025용 플러그인은 Maya 2026에서 로드되지 않습니다). 또한 Maya 버전에 맞는 올바른 위치에서 maya.env 파일을 편집하고 있는지 확인하세요.
Q: maya.env에서 $MAYA_LOCATION과 같은 환경 변수 치환을 사용할 수 있나요? A: 네, Windows(%VARIABLE%)와 Unix 스타일($VARIABLE) 치환 모두 작동합니다. 이는 시스템 간에 구성을 이식 가능하게 만들어요.
Q: 다른 Maya 버전에 대해 별도의 maya.env 파일이 필요한가요? A: 네. Maya는 버전별 디렉토리에 구성을 저장합니다. 각 버전은 자체 maya.env 파일을 읽으므로, Maya 2025와 Maya 2026에 대해 다른 구성을 가질 수 있어요.
Q: MAYA_PLUG_IN_PATH에 존재하지 않는 경로를 포함하면 어떻게 되나요? A: Maya는 오류 없이 존재하지 않는 경로를 건너뜁니다. 경로가 누락된 경우 플러그인이 단순히 로드되지 않습니다. 테스트하기 전에 항상 경로가 존재하는지 확인하세요.
Q: 변수에 기본 Autodesk 경로를 포함해야 하나요? A: 아니요. Maya는 자동으로 기본 경로를 포함합니다. 이를 다시 포함하면 중복 검색이 발생하고 시작이 느려져요. 사용자 정의 경로와 타사 위치만 추가하세요.
마무리
Maya 환경 변수를 올바르게 설정하는 것은 render farm 작업 시 큰 배당금을 제공합니다. 우리는 플랫폼별 구문, render farm 통합을 위한 필수 변수, 개발 및 farm 노드 설정을 위한 일반적인 구성을 보여주었어요.
핵심은 프로덕션 작업을 제출하기 전에 철저히 테스트하는 것입니다. 작은 구성 실수가 farm 제출 실패와 낭비된 렌더 시간으로 연쇄됩니다.
환경은 다른 사람의 예가 아닌 실제 시스템 경로를 반영해야 합니다. 우리가 보여준 패턴에 대해 특정 설정을 매핑하고, 경로가 존재하고 올바른 파일을 포함하고 있는지 확인하고, 항상 간단한 씬으로 먼저 테스트하는 데 시간을 투자하세요.
