본문 바로가기
Deadline/Deadline Client Applications

Command

by 르면가게 2024. 12. 28.

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에 저장합니다.
    Deadline 애플리케이션 위치
    • deadlinecommanddeadlinecommandbg는 다음 경로에서 찾을 수 있습니다:
      • 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 장면 제출

  1. 작업 제출 정보 파일 생성 (예: C:\job_info.job)
  2. 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