Licensing

From MPTK Documentation
Jump to: navigation, search

Two license files can be found in the licensing folder:

gs_mptk_floating_license.lic This file should be copied to the host server if you are using a floating license.

gs_mptk_local_license.lic This file should be copied to the client machine(s) whether you are using a floating or node-locked license.



Node-locked Licenses

If you purchased a node-locked license, you only need to update gs_mptk_local_license.lic If you purchased a floating license, skip to the Floating Licenses section below.


1) Open gs_mptk_local_license.lic in a text editor.


2) Replace the license key found in gs_mptk_local_license.lic with your license. Make sure to leave the first line as "localhost"


3) Save the changes, and copy gs_mptk_local_license.lic to:

    Windows Program Files\Autodesk\$MAYA_VERSION\modules
    OSX /Applications/Autodesk/$MAYA_VERSION/Maya.app/Contents/modules
    Linux /usr/autodesk/$MAYA_VERSION/modules


This is the default location the toolkit will search for the license file, but any path given by the environment variable MAYA_MODULE_PATH can also be used. To see a full list of paths given by MAYA_MODULE_PATH, you can run getenv MAYA_MODULE_PATH from the MEL Script Editor in Maya.

Alternatively, you can set the environment variable GSLIC to any path. The toolkit will first look to GSLIC to find gs_mptk_local_license.lic, and then fall back to MAYA_MODULE_PATH if GSLIC is not set.


Note the $MAYA_VERSION given in the paths above will depend on what you have installed.


An example gs_mptk_local_license.lic will look like this:

    localhost
    a51530bbfbb5dc4c2b38e5ec846ac7a86db7c3ad
    33ea5e8ac1c11d4780f1fec9a6c27c31a5579efa


Floating Licenses

Floating licenses use a server/client pair of files to validate the toolkit. These two files can be placed on the same computer, or on networked computers. When using these two files across a network, make sure that they are both accessible to each other using a file share, and that they both have full read/write privileges for all users.

gs_mptk_local_license.lic and gs_mptk_floating_license.licneed to be updated with your license key.

The gs_mptk_floating_license.lic file is placed on the server. The gs_mptk_local_license.lic file is placed on the client machine (artist workstation), and the path to the floating license file is supplied in the first line.

Follow these instructions:


1) Open gs_mptk_local_license.lic in a text editor.


2) Replace the license key found in gs_mptk_local_license.lic with your license key.


3) Replace the first line, "localhost" with the server location for the floating license file, e.g.:

    OSX /Volumes/My HD/licenses/gs_mptk_floating_license.lic  
    Windows \\192.168.0.155\my_license_location\gs_mptk_floating_license.lic
    Linux /192.168.0.155/my_license_location/gs_mptk_floating_license.lic

Note: Make sure to include the filename gs_mptk_floating_license.lic at the end of the path, as indicated above. For OSX, the path should follow the syntax given by the Finder (use Get Info on a folder for specific location syntax).


4) Save the changes, and copy gs_mptk_local_license.lic to the following locations on all client machines running the toolkit, or to the network install location:

    Windows Program Files\Autodesk\$MAYA_VERSION\modules
    OSX /Applications/Autodesk/$MAYA_VERSION/Maya.app/Contents/modules
    Linux /usr/autodesk/$MAYA_VERSION/modules


Any path given by the environment variable MAYA_MODULE_PATH can also be used in place of those above. To see a full list of paths given by MAYA_MODULE_PATH, you can run getenv MAYA_MODULE_PATH from the MEL Script Editor in Maya.

Alternatively, you can set the environment variable GSLIC to any path. The toolkit will first look to GSLIC to find gs_local_license.lic, and then fall back to MAYA_MODULE_PATH if GSLIC is not set. This may be preferable for custom network installations of Maya.


Note the $MAYA_VERSION given in the paths above will depend on what you have installed.


6) Open gs_mptk_floating_license.lic in a text editor.


7) Replace the contents of the first line of gs_mptk_floating_license.lic with the second line of your license key only.

For example, if your license is this:

    a51530bbfbb5dc4c2b38e5ec846ac7a86db7c3ad
    33ea5e8ac1c11d4780f1fec9a6c27c31a5579efa

gs_mptk_floating_license.lic should look like this:

    33ea5e8ac1c11d4780f1fec9a6c27c31a5579efa

8) Save the changes, and copy gs_mptk_floating_license.lic to the server location you specified on the first line of gs_mptk_local_license.lic above.


9) Share or mount the folder containing gs_mptk_floating_license.lic with all client machines running the toolkit. Make sure the floating license location is accessible from the machine you're running gs_mptk, or gs_mptk will revert to demo mode.


10) Make sure that both of the license files have read/write access, or gs_mptk will revert to demo mode.


An example floating license setup is given below. Note the actual IP Addresses and license files will depend on your setup.

An example gs_mptk_local_license.lic will look like this:

    \\192.168.0.155\licenses\gs_mptk_floating_license.lic
    a51530bbfbb5dc4c2b38e5ec846ac7a86db7c3ad
    33ea5e8ac1c11d4780f1fec9a6c27c31a5579efa

...and will be copied to the Resources folders of the Maya installation on all client machines running the toolkit.

An example gs_mptk_floating_license.lic will look like this:

    33ea5e8ac1c11d4780f1fec9a6c27c31a5579efa

...and will be copied to \\192.168.0.155\licenses


Troubleshooting Licenses

When you load the gs_mptk shaders, they will print info about the license status, either into the Output Window on Windows, or the shell you launched Maya from on OSX.

If you run into a licensing error, gs_mptk will run in demo mode, and you should refer to the status printouts for more information.

For nodelocked licenses, you can check the status of your MAC address by typing ipconfig (windows) or ifconfig (OSX and linux) in a shell or command prompt.

For floating licenses, make sure the location of the license server is accessible from your local machine. Try to connect to the location directly and map the network drive if the license error printouts indicates issues connecting to the license server.

You can test whether the license error has been corrected by simply closing the scene file that is using gs_mptk, and re-opening it; you do not need to exit Maya altogether.

gs_mptk will run in demo mode when a license error has occurred, or if the number of available licenses are all in use.

Personal tools
Namespaces

Variants
Actions
Navigation
Tools