On Windows and OS X you do not need to manually configure the RenderMan for Maya plug-in. The following instructions are for advanced users.

Please note that users may need to set the correct path variables for Xgen to render.

• MAYA%MAYA_PATHPATH%/bin
• MAYA%MAYA_PATHPATH%/lib
  
• MAYA%MAYA_PATHPATH%/plug-ins/xgen/bin
• MAYA%MAYA_PATHPATH%/plug-ins/xgen/lib
• %RMANTREE%\/lib;

Where MAYA_PATH is your installed location of Maya for your operating system (OS). See the table below where to add these paths based on your OS.

For example, on Windows you might have the following path: C:\Program Files\Autodesk\Maya2018\

When updating/changing versions you may need to reset/remake your Maya Preferences if the above settings no longer work.

For each OS below it should be added to the following system environment variables:

PATH

LD_LIBRARY_PATH

DYLD_LIBRARY_PATH

Note that Interactive Groom on Xgen introduced in Maya 2017 is not currently supported. It must be baked/exported as an Alembic cache before rendering.

• A RenderMan_for_Maya.module file must contain the path to the RenderMan for Maya installation.
• Maya must find the RenderMan_for_Maya.module file in one of the locations that it searches for modules.
• Maya's command line Render command requires rmanRenderer.xml to be found by Maya.

On Windows and OS X, the installer takes care of these, but if for some reason they need to be adjusted, read on.

Install Location

Examples of the default install location of RenderMan for Maya:

C:\Program Files\Pixar\RenderManForMaya-21.0-maya2016

/Applications/Pixar/RenderManForMaya-21.0-maya2016

/opt/pixar/RenderManForMaya-21.0-maya2016

Examples of the default install location of RenderMan Pro Server:

C:\Program Files\Pixar\RenderManProServer-21.0

/Applications/Pixar/RenderManProServer-21.0

/opt/pixar/RenderManProServer-21.0

RenderMan for Maya respects environment variables called RMSTREE and RMANTREE, which can be used to specify the location of the RenderMan for Maya and RenderMan Pro Server installations.  If these variables are not set they are inferred.

Module Location

These are examples of where the RenderMan_for_Maya.modulefile can go so that Maya will find it (adjust versions as necessary):

C:\Program Files\Common Files\Autodesk Shared\Modules\Maya\2016

~/Documents/maya/2016/modules

/Applications/Autodesk/maya2016/Maya.app/Contents/modules

~/Library/Preferences/Autodesk/maya/2016/modules

/usr/autodesk/maya2016/modules

~/maya/2016/modules

Alternatively, you can put the module file in a non-standard location and set the MAYA_MODULE_PATH environment variable. Run getenvMAYA_MODULE_PATH in Maya's Script Editor to see the standard locations that Maya checks for modules.

Module Contents

The module file should contain a path to the install location.  These are examples of the contents of the file on different platforms (adjust versions as necessary):

+ RenderMan_for_Maya 21.0 C:/Program Files/Pixar/RenderManForMaya-21.0-maya2016

+ RenderMan_for_Maya 21.0 /Applications/Pixar/RenderManForMaya-21.0-maya2016

DYLD_FALLBACK_LIBRARY_PATH+=/Applications/Autodesk/maya2016/plug-ins/xgen/lib

+ RenderMan_for_Maya 21.0 /opt/pixar/RenderManForMaya-21.0-maya2016

Note, on OS Xbatchrenders using XGen may require the DYLD_FALLBACK_LIBRARY_PATH to be set, and this can happen via the module file or as an environment variable.

Render Command

For Maya's Render command to work with RenderMan, you need to copy or symlink $RMSTREE/etc/rmanRenderer.xml into Maya's rendererDesc directory.  

sudo ln -s /opt/pixar/RenderManForMaya-21.0-maya2016/etc/rmanRenderer.xml /usr/autodesk/maya2016/bin/rendererDesc/rmanRenderer.xml

Anchor
RenderMan for Maya Installation Troubleshooting RenderMan for Maya Installation Troubleshooting

RenderMan for Maya is not listed in Maya's Plug-in Manager

Maya did not find the RenderMan_for_Maya.module file or the path listed inside the RenderMan_for_Maya.module does not point at a valid install of RenderMan for Maya.

• Check that the module file is in one of the locations returned when you type "getenvMAYA_MODULE_PATH" in Maya's Script Editor.
• Check that the path inside the file looks correct and that the install directory actually exists.  The RenderMan_for_Maya plug-in must be present in the plug-ins directory under the install location.  Note, Maya knows to look intheplug-inssub-directory of the installation.  The path listed in the module file should not actually include the plug-ins sub-directory.

RenderMan for Maya won't load

You see either of these errors:

// Error: line 1: The specified procedure could not be found.
 (RenderMan_for_Maya) //

A common reason for this error is attempting to load the plug-in into the wrong version of Maya.  Check that the version in the error string matches the version of Maya you are running.  Especially if you have multiple versions of Maya installed, the RenderMan Installer may have only downloaded the plug-in for your newest version of Maya.