Overview 

Ornatrix can be installed in a few different ways depending on your studio requirements. Follow these steps to get Ornatrix up and running on your system.

 

Installation Methods 

 

Automatic Installation (Recommended) 

The simplest way to install Ornatrix is by using our MSI installer.
  1. Download the MSI installer
  2. Run the installer and follow the on-screen instructions.
  3. The installer will detect your 3ds Max installation directory automatically. In the Custom Setup step, make sure that Plugin Files and Data Files are enabled. These are the plugin binaries and libraries and the custom user data respectively.
    Enable Ornatrix for V-Ray Standalone if you need it.
  4. Click Next and it will set up Ornatrix for you.
 

Installation Directories 

  • Ornatrix 3dsmax is installed into the /plugins directory of 3dsmax. Additional UI and configuration files are installed into a central UI and plugcfg directories which were configured by 3dsmax.
  • The default Groom files are copied into a groom directory specified during installation by the Data Files option.
 

Silent/Batch Installation 

Starting from Version 4, Ornatrix uses MSI packages for deployment, allowing for silent installations.

  • Use the /quiet or /qn options with msiexec for a silent install.
  • Customize the installation location for different 3ds Max versions using properties like MAX_PATH_20XX.
  • Control which 3ds Max versions Ornatrix is installed for using properties like ENABLE_MAX_20XX.

Here's an example command to install Ornatrix for 3ds Max 2016 but not for 3ds Max 2014 without a UI and no reboot:

msiexec /i c:\path\to\ornatrix.setup.msi /quiet /qn /norestart /l*v c:\path\to\install.log MAX_PATH_2016="C:\Program Files\Autodesk\3ds Max 2016" ENABLE_MAX_2014=0

 

Manual Archive Installation 

For advanced users, manual installation is an option.

  1. Download the compressed 7-Zip archive from our downloads page.
  2. Unzip the archive using 7-Zip.
  3. Follow the instructions in the Readme.txt file for a manual installation.
  4. If installing on a workstation, you will need to set up licensing manually.
 

Installing a Floating License Server 

A floating license server allows multiple workstations to share licenses. Workstations can connect to this license server via its IP or network address to obtain licenses temporarily and release them when they are no longer in use. This permits an arbitrary number of workstations to share licenses between them. Here's how to set it up:

To install a floating license server please make sure that all of your licenses are unassigned for the product in question. See Releasing your Licenses to see how to release all your licenses. If you never installed the license server for current product you do not need to worry about this.

  1. Go to the downloads page and look under the version which you are trying to install.
  2. Find the "Unassigned Licenses" text and check if all of your licenses are yet unassigned (the numbers should be equal). If that's true, you are ready to proceed.
 

Install License Server 

  1. Click on the link for you operating system under "Install license server only" and download the installer to your license server computer.
  2. Run the installer. It needs administrator rights, so if UAC is enabled you'll be asked for authorization.
 

Specify the Network Address of the License Server 

You can specify the license server's address in two ways:

  • Using a Text File
    By default, Ornatrix looks for the license server at localhost(127.0.0.1 IP) address, thus assuming that you installed it on the same computer as Ornatrix. If it's elsewhere, you'll be prompted to enter the IP or network name. The address(or network name) is stored in C:\Users\XXX\AppData\Local\Ornatrix3dsmaxLicenseServerIP.txt.
    You can change the location of this file or modify the address using the ORNATRIX3DSMAX_LICENSE_SERVER_IP_PATH environment variable. Alternatively, you can delete it and upon the next start of Ornatrix you will be prompted to add a different address.
  • Using an Environment Variable
    Manually set the IP or network name of the license server with the ORNATRIX3DSMAX_LICENSE_SERVER_IP environment variable.
 

Installing different Ornatrix versions on same computer 

While you can't have two Ornatrix versions within the same 3ds Max installation, you can install different versions in separate 3ds Max installations.

This cannot be done using the executable (.msi) installer. Instead, use the Manual Installation method.

Note: Some versions of Ornatrix provide assets and grooms which are not compatible with previous versions.

 

Uninstalling 

To remove Ornatrix for 3ds Max, follow these steps:

Open Programs and Features in Windows.
Locate "Ornatrix for 3ds Max" and select "Uninstall."

 

Uninstalling the License Server 

Uninstalling Ornatrix will leave the Ephere license server on your computer. It is a separate process which isn't linked to any host and can be reused for future installations. However, if you choose to uninstall it you can do it by following these OS-specific steps here .

Missing Something? Let us know if this page needs more information about the topic.