# Linux Installation

# Compatibility

Supported Versions
Linux EL7 (RedHat 7.x or CentOS 7.x) / Other
Maya 2018, 2019, 2020
3DelightNSI 1.7.0+, 2.0.0+
3DelightNSI Cloud Any version
Arnold Arnold 5.2.2.1+/ MtoA-3.1.2.1+
Arnold 5.3.0.1+ / MtoA-3.2.0+
Arnold 5.4.0.0+ / MtoA-3.3.0+
Arnold 6.0.1.0+ / MtoA-4.0.1+
RenderMan 23.2+
VRay 4.30.01+, 5.00.20+
Redshift 3.0.22+

Other Linux Distro

The recommended Linux is EL 7 (RedHat 7 or CentOS 7). It is possible however to run Maya and Multiverse on other O/S such as Arch Linux, Suse, Ubuntu etc.

Maya 2018 with MtoA/Arnold

If you are using Multiverse with Maya 2018 and any version of MtoA (Arnold) on the Linux platform, an extra step is necessary for using the software: check at the bottom of this page.

# Internet Requirements

If you are using the Free Version of Multiverse, your computer must be connected to the internet.

Firewalls & Proxies

If needed, make sure that your firewall allows Maya to connect to the internet.

If you are using the Free Version within a studio network, you need to let your http/https proxy to let Maya communicate with our servers and checkout your free license, contact system administrator. The Multiverse Cloud uses the standard ports 80 (http), 443 (https).

# Installation

After having downloaded the zip archive for Multiverse, unzip it to the desired installation location, e.g:

/opt/software/multiverse/multiverse-6.5.0
1

NOTE — We strongly recommend you to use versioned folders as we provide frequent updates to our customers.

# Run Maya from Terminal

On Linux we strongly recommend to always run Maya from the terminal. This is also useful as all the terminal will print various info/warning/error messages (just like Maya’s “Output Window” on Windows).

  1. Open Linux Terminal and cd to your Multiverse installation folder, e.g:
cd /opt/software/multiverse/multiverse-6.5.0
1
  1. Source the terminal script in for your shell:
# zsh/bash
source ./multiverse-terminal.sh

# tcsh/csh
source ./multiverse-terminal.tcsh
1
2
3
4
5
  1. Launch Maya, e.g:
/usr/autodesk/maya2018/bin/maya
1

TIP

For convenience, you could also make aliases for conveniently launch different Maya versions. You can put aliases in your .bash_profile/.bashrc/.zshrc profiles, e.g:

alias maya18='/usr/autodesk/maya2018/bin/maya'
alias maya19='/usr/autodesk/maya2019/bin/maya'
alias maya20='/usr/autodesk/maya2020/bin/maya'
alias mayapy18='/usr/autodesk/maya2018/bin/mayapy'
alias mayapy19='/usr/autodesk/maya2019/bin/mayapy'
alias mayapy20='/usr/autodesk/maya2020/bin/mayapy'
1
2
3
4
5
6
  1. Once Maya has launched, open the Maya Plug-in manager and load the **MultiverseForMaya** plug-in.

    NOTE

    Multiverse supports multiple rendering engines.

    • Support for Arnold is built-in with the MultiverseForMaya plug-in (being Arnold part of Maya).
    • Support for 3Delight, Renderman and VRay is provided by individual plug-ins extensions which will be automatically loaded for the rendering plugins you have loaded in Maya.
    • Support for Redshift is handled automatically: Redshift handles loading of the Multiverse rendering extension without the need for a dedicated Maya plug-in, hence why there is no Multiverse Redshift plugin visible in the plug-in manager.

    If you don’t have a license the pug-in will not load (and notify you with a popup), so make sure you have a license for either the Free or Pro version:

After loading the plug-in, you should be able to see the Multiverse Shelf in Maya. Learn more about the Multiverse Shelf and other UI in Maya.

# The multiverse-terminal script

To startup the environment correctly we provide terminal shell scripts files that work with bash/zsh and tcsh. You can find these in the Multiverse installation folder. Here below a reference for the multiverse-terminal.sh script file for bash/zsh to see how the environment is set:

# This script needs to be sourced in a bash or zsh shell:
#   source ./multiverse-terminal.sh

# This script must be executed from its folder
export MV_ROOT="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"

export MAYA_MODULE_PATH=$MAYA_MODULE_PATH:$MV_ROOT/Maya
export PATH=$PATH:$MV_ROOT/bin
export PYTHONPATH=$PYTHONPATH:$MV_ROOT/lib/python
export USD_PLUG_IN_PATH=$MV_ROOT/lib/plugin/usd

if [[ "$(uname)" == "Darwin" ]]
then
    export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:$MV_ROOT/lib ;
elif [[ "$(expr substr $(uname -s) 1 5)" == "Linux" ]]
then
    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$MV_ROOT/lib ;
fi

# Used by Maya to Arnold and Arnold standalone
export ARNOLD_PLUGIN_PATH=$MV_ROOT/lib/procedurals/arnold:$ARNOLD_PLUGIN_PATH

# Used by VRay standalone
export VRAY_PLUGINS=$MV_ROOT/lib/procedurals/vray:$VRAY_PLUGINS

# Used by VRay for Maya
export VRAY_FOR_MAYA2018_PLUGINS=$MV_ROOT/lib/procedurals/vray:$VRAY_FOR_MAYA2018_PLUGINS
export VRAY_FOR_MAYA2019_PLUGINS=$MV_ROOT/lib/procedurals/vray:$VRAY_FOR_MAYA2019_PLUGINS
export VRAY_FOR_MAYA2020_PLUGINS=$MV_ROOT/lib/procedurals/vray:$VRAY_FOR_MAYA2020_PLUGINS

# Used by Renderman for Maya
export RFM_PLUGINS_PATH=$MV_ROOT/lib/procedurals/renderman:$RFM_PLUGINS_PATH

# NOTE: As of 3Delight NSI no searchpath is needed for procedurals

echo "Multiverse Environment is set"
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

Note

Users of the tcsh wor csh will find a multiverse-terminal.tcsh file to source on tcsh as the syntax of bash/zsh is incompatible on tcsh.

# Environment Variables

Read more about Environment Variables.

# Using Multiverse with Maya 2018 with MtoA on Linux

This is a very specific issue that arises only when using Maya with MtoA (Arnold) on the Linux platform. It was recently fixed for some of our customers.

First of all, you need one of the following Multiverse builds:

  • Multiverse-6.4.3-77b94b4 (if you were provided of)
  • Multiverse-6.5.0-RC1 (Release Candidate)
  • Multiverse-6.5.0 (official release), or newer

Then, you must ser LD_PRELOAD to preload the Arnold rendering library that ships with MtoA (libai.so) before launching Maya (or Maya batch), e.g:

LD_PRELOAD=/path/to/mtoa/3.3.0.2/2018/bin/libai.so /usr/autodesk/maya2018/bin/maya
1

Note

Using LD_PRELOAD will not be needed if you render from the terminal via kick file.ass

This issue does not manifest in 2018 (macOS, Windows) nor in Maya 2019 or 2020 (any platform).

Last Updated: 10/2/2020, 6:49:38 PM