NIM

Overview

NIM is a browser based management tool created by artists for artists to track the post-production pipeline from start to finish. See the NIM website for more information.

../_images/nim_dashboard.png

Creating Renders

Renders can either be created automatically on submission (using the NIM Event Plugin), or done manually afterwards.

Automatic Render Creation

When you submit a new job to Deadline, you can have Deadline automatically create a new Render in NIM. This is done by connection to NIM during the submission process, and selecting the Task to which the Job should be tied to. Currently, only the submission scripts for After Effects, Cinema 4D, Maya, and Nuke include the NIM connection option, and other applications will be added when NIM supports them.

For this example, we will use Maya, but the process is basically the same for each submission script.

First, open the Pipeline Tools window via the Pipeline Tools button and navigate to the Project Management tab.

first second

Choose NIM from the Project Management drop down, check the “Create new version” checkbox, and then press the Refresh button to begin. The browser pulls the NIM connection settings from your NIM preferences file, but you can change the user, job, type, etc, as necessary.

../_images/nim_connect.png

After you have selected a Task, you must specify a Render Name and a Description.

../_images/nim_configure.png

After you have configured the Render information, press OK to return to the Maya submitter. The NIM settings will now contain the information you just specified. To include this information with the job, leave the Create New Version option enabled. If you want to change the Render name or description before submitting, you must first reconnect to NIM in the Pipeline Tools window.

Press the Submit Job button in the Maya submitter to finish the submission. When the job completes, the new Render will be created in NIM.

Manual Render Creation

You can also create a Render and tie it to a Job after submission, from the Deadline Monitor. To do this, simply right-click on the job and select ‘Scripts’ -> ‘Integration’ -> ‘Create NIM Render’. This will bring up a NIM browser so that you can connect, pick the appropriate task, and set a description. After specifying the required information, just press OK and the new Render should be created.

Setup

In order to be able to create NIM Renders within Deadline, you must first follow the steps below to setup Deadline’s connection to NIM.

NIM Setup

If you have already set up NIM on your machine to be used in Maya, Nuke, etc, then no additional setup is required to use it for Deadline. The Deadline NIM browser will simply pull all information from your NIM preferences file.

Configure Deadline

You must configure Deadline’s NIM event plugin so that it can connect to NIM. To perform this setup, you need to enter Super User Mode (from the Tools menu), and then select ‘Tools’ -> ‘Configure Events’. Once in the Event Plugin Configuration window, select ‘NIM’ from the list on the left.

../_images/nim_event_config.png

This is where you will configure all the NIM relevant settings in Deadline. There are several different categories of settings you can configure; they are described in more detail below.

Configuration

This section contains fields required for NIM integration to work.

  • State: There are three different states that an Event Plugin can be in: Global Enabled, Opt-In, and Disabled. In order for this feature to function properly, the State must be set to either Global Enabled or Opt-In. Note that if this plugin is in the Opt-In state, the jobs that want to run this plugin must opt into NIM.
  • NIM URL: The URL to access NIM’s API. Simply replace hostname in the screenshot with the host name or IP address of your actual NIM server.
  • NIM API Key: The Render API key which is located in NIM under Security > OPTIONS > RENDER API KEY

Options

This section contains general high-level options that control the behaviour of the Deadline’s NIM integration.

  • Auto Connect: Whether or not to connect to NIM when the pipeline tools dialog finishes loading.
  • Thumbnail Frame: The frame to upload to NIM as a thumbnail.
  • Convert Thumbnailes with Draft: Whether or not to convert the frames to a different format before uploading them to NIM (requires Draft).
  • Thumbnail Conversion Format: The format to which Draft will convert the Thumbnail before uploading it.

Nim Draft Template

  • Draft Template: The default Draft Template when selecting ‘Use Project Management Data’ with NIM when submitting a Custom Draft job.

Rename ExtraInfo Columns

The NIM integration uses ExtraInfo columns 0-5 to display relevant information about the NIM Renders that are tied to Deadline Jobs. Given that “ExtraInfo0” isn’t exactly a descriptive name for what that column is being used for in this context, many people find it useful to rename these columns to be more descriptive.

To do so, you must be in Super User mode and select ‘Tools’ -> ‘Repository Options’. You must then go to the ‘Job Settings’ section, and select the ‘Extra Properties’ tab; from here you’ll be able to change these column names to something more appropriate.

../_images/nim_columns.png

FAQ

Is NIM supported?

Yes.

Error Messages and Meanings

This is a collection of known NIM error messages and their meanings, as well as possible solutions. We want to keep this list as up to date as possible, so if you run into an error message that isn’t listed here, please email Deadline Support and let us know.

Currently, no error messages have been reported for this event plug-in.