Command 개요
- 사용 목적: 렌더팜의 작업을 제어하고, 상태를 조회하며, 명령줄을 통해 작업을 제출.
- 명령 형식: deadlinecommand 뒤에 명령어와 옵션을 추가하여 사용.
- 호환성: 대소문자를 구분하지 않으며, Windows, Linux, macOS에서 작동.
명령줄 실행 옵션
- 명령어 도움말: deadlinecommand -Help를 통해 사용 가능한 명령 옵션 확인.
deadlinecommand -Help
- 특정 명령의 세부 정보는 -Help [명령어]로 확인 가능.
deadlinecommand -Help SubmitCommandLineJob
- 백그라운드 실행: deadlinecommandbg를 사용하여 명령을 백그라운드에서 실행 가능.
- 백그라운드 명령 실행 (Running Background Commands)
- deadlinecommand와 동일하지만, 백그라운드에서 실행됩니다.
- deadlinecommandbg를 사용할 때, 출력 결과와 종료 코드는 Deadline의 임시 폴더에 저장됩니다.
- 출력 파일: dsubmitoutput.txt
- 종료 코드 파일: dsubmitexitcode.txt
- 파일 저장 경로를 직접 지정하려면 -outputFiles 옵션을 사용합니다.
- 출력 및 종료 코드 파일의 경로를 지정하여 관리 가능합니다.
- 위 명령은 출력 결과를 c:\output.txt에, 종료 코드를 c:\exitcode.txt에 저장합니다.
- deadlinecommand와 deadlinecommandbg는 다음 경로에서 찾을 수 있습니다:
- Windows/Linux: Deadline bin 폴더
- Windows/Linux: Deadline bin 폴더
deadlinecommandbg -outputFiles c:\output.txt c:\exitcode.txt -Pools
주요 기능 및 예시
- 작업 제출: deadlinecommand [Job Info File] [Plugin Info File] 형식으로 작업 제출.
- 작업 상태 조회 및 변경:
- 작업 상태 확인: -GetJob [Job ID]
- 작업 일시 중단: -SuspendJob [Job ID]
- 작업 재개: -ResumeJob [Job ID]
- 작업 삭제: -DeleteJob [Job ID]
- 작업 아카이브: -ArchiveJob [Job ID]
- 작업 필터링:
- 특정 사용자의 작업 조회: -GetJobsFilter UserName=[사용자명]
- 작업 상태 필터링: -GetJobsFilterAnd Status=completed
- 작업자 조회:
- 특정 풀에 할당된 작업자 확인: -GetSlaveNamesInPool [Pool명] Assigned
- 제외된 작업자 확인: Excluded 키워드 사용.
- 이메일 전송:
- 이메일 전송: -SendeMail -To [수신자 이메일] -Subject [제목] -Message [메시지 파일 경로]
- 첨부 파일 포함 가능.
고급 사용
- Secrets 관리: Deadline Secrets Management를 위한 관리자 명령어 실행.
deadlinecommand Secrets
- 긴 명령어 처리: 여러 명령어를 텍스트 파일로 정리하고 파일 경로를 전달하여 실행 가능.
- 특정 저장소 명령 실행: 저장소 연결 유형(Direct/Remote)과 경로를 지정하여 명령 실행.
Usage Examples
Job 제출에는 전용 명령어 인수가 필요하지 않습니다. 단, Job 제출 정보 파일과 관련 플러그인 정보 파일만 있으면 됩니다.
예시: 3ds Max 장면 제출
- 작업 제출 정보 파일 생성 (예: C:\job_info.job)
- 3dsmax 플러그인 정보 파일 생성 (예: C:\max_info.job)
명령어:
deadlinecommand "C:\job_info.job" "C:\max_info.job" "C:\MyScene.max"
참고: 자세한 내용은 수동 작업 제출 문서를 참조하세요.
필터를 사용한 작업 조회 (Filtering Jobs)
여러 사용자 작업 조회
jsmith 또는 cdavis에 속한 모든 작업 조회:
deadlinecommand -GetJobsFilter UserName=jsmith UserName=cdavis
특정 상태의 작업 조회
jsmith의 완료된 작업 조회:
deadlinecommand -GetJobsFilterAnd UserName=jsmith Status=completed
참고: 자세한 내용은 GetJobsFilter 및 GetJobsFilterAnd를 참조하세요.
특정 풀의 작업자 확인 (Viewing Workers in Pools)
특정 풀에 할당된 작업자 확인
예: 3dsmax 풀에 할당된 작업자:
deadlinecommand -GetSlaveNamesInPool 3dsmax Assigned
특정 풀에서 제외된 작업자 확인
예: Nuke 풀에서 제외된 작업자:
deadlinecommand -GetSlaveNamesInPool Nuke Excluded
참고: GetSlaveNamesInPool에 대한 문서를 참조하세요.
작업 정보 쿼리 (Query Job Information)
특정 작업 ID로 작업 세부 정보 조회
예: 작업 ID 546cc87357dbb04344a5c6b5의 작업 정보 조회:
deadlinecommand -GetJobTasks 546cc87357dbb04344a5c6b5
참고: 자세한 내용은 GetJobTasks를 참조하세요.
작업 상태 검색 및 변경 (Managing Job Status)
작업 상태 검색
- 특정 ID 작업 상태 검색:
deadlinecommand -GetJob 546cc87357dbb04344a5c6b5
- 작업의 세부 정보 검색:
deadlinecommand -GetJobDetails 546cc87357dbb04344a5c6b5
작업 상태 변경
- 작업 일시 중지:
deadlinecommand -SuspendJob 546cc87357dbb04344a5c6b5 deadlinecommand -SuspendJobNonRenderingTasks 546cc87357dbb04344a5c6b5
- 작업 재개:
deadlinecommand -ResumeJob 546cc87357dbb04344a5c6b5
- 작업 재요청:
deadlinecommand -RequeueJob 546cc87357dbb04344a5c6b5
- 작업 삭제:
deadlinecommand -DeleteJob 546cc87357dbb04344a5c6b5
- 작업 보관:
deadlinecommand -ArchiveJob 546cc87357dbb04344a5c6b5
참고: 작업 상태 수정 관련 문서에서 더 많은 명령어를 확인할 수 있습니다.
이메일 보내기 (Sending Emails)
기본 이메일 전송
- jsmith@mycompany.com에 메시지 보내기 (CC: cjones@mycompany.com):
deadlinecommand -SendeMail -To jsmith@mycompany.com -CC cjones@mycompany.com -Subject "the subject" -Message "C:\MyMessage.html"
첨부 파일과 함께 이메일 전송
- 위 메시지에 C:\MyAttachment.txt 첨부:
deadlinecommand -SendeMail -To jsmith@mycompany.com -CC cjones@mycompany.com -Subject "the subject" -Message "C:\MyMessage.html" -Attach "C:\MyAttachment.txt"
주의:
- 필수 옵션: -To, -Subject, -Message
- 선택 옵션: -CC, -Attach