Maya - Installation

Owned by Mihnea Balta (Unlicensed)
Last updated: 19 Jun, 2012Version comment
4 min read

Windows

On Windows, the plug-in is provided as a self-extracting installer. The plug-in is compatible with Windows XP and above and with Maya 2008 and above (both 32-bit and 64-bit). The installer will automatically detect which versions of Maya are present on the system and where they are located:

Custom Windows install

If you only want to extract the plug-in files without copying them to the Maya directories (e.g. for creating a package or some other form of customized deployment), you can change the autodetected path for the relevant Maya version to point to an empty directory (the directory must exist). You may want to uncheck "Uninstaller" in the Components page, since you probably don't need an uninstaller to be created in this case.

Keep in mind though that in order for Maxwell to work in batch render mode with the render.exe utility, the file maxwellRenderer.xml must be copied in the bin\rendererDesc subdirectory of the Maya install path. Maya does not look for renderer description files in standalone packages, so if you want to use that method of deployment you will need to make sure the XML file is copied separately to the correct path.

The install directory for a given Maya version is determined by looking at the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Autodesk\Maya\VERSION\Setup\InstallPath (64-bit or native 32-bit) or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Autodesk\Maya\VERSION\Setup\InstallPath (32-bit Maya on 64-bit Windows). These keys are set by the Maya installer. If you ever move Maya to a different directory after installing it, make sure you update the corresponding keys, or the Maxwell plug-in installer will be unable to find the new path.

Silent Windows install

The plug-in can be installed silently by passing the /S flag on the command line:

    maxwell_maya_win_2.7.4.exe /S

In this mode, the installer will use the autodetected directories and will not ask any questions.

 

Mac OS X

On OS X, the plug-in is provided as a self-installing package. The minimum supported OS X version is 10.6 and the minimum supported Maya version is 2008. The platform requirements are the same as for Maya itself: 32-bit Intel for Maya 2008 - 2010, 32/64-bit Intel for Maya 2011, 64-bit Intel for Maya 2012 and above.

The plug-in files are installed under /Users/Shared/Autodesk/maya/VERSION, except for maxwellRenderer.xml, which is copied in:

  • /Applications/Autodesk/mayaVERSION/Maya.app/Contents/bin/rendererDesc
  • /Applications/Autodesk/mayaVERSION/Maya.app/Contents/MacOS/rendererDesc

If you create customized deployments, make sure this file is copied explicitly to the correct locations, otherwise batch/command line rendering will not work with Maxwell.

Silent OSX install

To perform a silent installation you can use a command similar to this:

    installer -verbose -pkg maxwell_maya_osx_2.7.4.pkg -target /

The installer needs superuser privileges, so you may need to add sudo before the command.

Linux

For Linux systems, the plug-in is provided in 3 forms of packaging:

  • .deb for distributions which use the Debian package manager, such as Debian and Ubuntu. Install using dpkg -i plugin_package.deb.
  • .rpm for distributions which use the Redhat package manager, such as Redhat Enterprise Linux, Fedora, CentOS and SUSE. Install using rpm -Uhv plugin_package.rpm. On some configurations you may need to add the --force and/or --nodeps flags to the install command line.
  • .tar.gz archives for manually installing the files. These should be unpacked in /usr/autodesk.

The plug-in supports 64-bit Intel platforms with GLIBC 2.3 and above, and Maya versions starting from 2008.

Loading the plug-in in Maya

Once the plug-in is correctly installed, it should appear in the Maya plug-in manager:

Set the plug-in to autoload to avoid issues with the UI initialization order. Particularly, if autoload is off and the Attribute Editor is opened before loading the plug-in manually, the Maxwell-specific attributes will not appear on geometry nodes, lights etc.

Due to a limitation in the Maya SDK, the plug-in cannot be unloaded by unchecking the "Loaded" box. To unload the plug-in, uncheck "Auto load" and restart Maya. If the plug-in is loaded automatically when opening a scene despite cleaning up all the Maxwell objects from it, save the scene with the Maya ASCII format (.ma), open the file in a text editor, look for a line starting with requires "maxwell" near the top, remove it and save the file.

Notes

For a complete chart showing the supported platforms and versions, see this page.

On Windows and Linux, the plug-in depends on the MAXWELL2_ROOT environment variable being set correctly. If this variable is missing or wrong, the plug-in will be unable to start the renderer or the standalone material editor. The Maxwell installer sets this variable on Windows, but you have to update it if you ever move Maxwell to a different directory. See here for more details.

On OS X, the plug-in locates the Maxwell executable by looking at the association for MXS files. This association is set up by Maxwell and Studio when they start up, so make sure you run one of them manually once before attempting to render from Maya for the first time.

The plug-in doesn't require a Maxwell license in order to run. The only restriction in the absence of a valid license is that the horizontal resolution of the FIRE viewport is limited to 720 pixels.