Installation & Licensing

Contents

Installing Node-Locked Licenses for V5 and above

V5 Node-locked Installation

  1. Make sure you have downloaded the correct version of mocha for your operating system. The licensing system for this version is different from v4 and earlier.
  2. Make that your version of mocha is the product you have purchased (You will not be able to use a mocha Pro AVX Plugin activation code for mocha Pro standalone unless you have a multi-host license for example.).
  3. You will need to install the mocha package:
    • Apple OS: Double-click the dmg package and drag the application to your application folder
    • Windows: Double-click the exe package and follow the instructions
    • Linux: Double-click the installation rpm file and follow the on screen instructions. (64-bit versions of the software will not run on a 32-bit version of Linux).

Standard Node-Locked License Activation for mocha Pro V5 Standalone

When you purchase your license, you will be emailed a serial number. To activate:

  1. Make sure you are connected to the internet
  2. Open mocha and choose Activate from the welcome screen or Licensing from the help menu. http://static.imagineersystems.com/doc/5.0.0/user-guide/en_US/images/5.0.0_mochapro_activation_welcome_screen.jpg
  3. Fill out the registration details on the main page http://static.imagineersystems.com/doc/5.0.0/user-guide/en_US/images/5.0.0_mochapro_license_serial_dialog_page_01.jpg
  4. Paste the serial number into the available activation field and click Next
  5. Your details will appear on the next page. Click Activate to install the license. http://static.imagineersystems.com/doc/5.0.0/user-guide/en_US/images/5.0.0_mochapro_license_serial_dialog_page_02.jpg
  6. Your license should install automatically and mocha will close.
  7. Reopen mocha to start using your licensed version!

If your machine is not connected to the internet, or you are behind a firewall:

  1. Open mocha and choose Activate from the welcome screen or Licensing from the help menu.
  2. Fill out the registration details on the main page
  3. Paste the serial number into the available activation field and click Next
  4. Your details will appear on the next page.
  5. Click Alternative Activation to install the license.
  6. An Unique Product ID code will appear. Copy this code and send it to the customer support contacts listed in the dialog: http://static.imagineersystems.com/doc/5.0.0/user-guide/en_US/images/5.0.0_mochapro_license_serial_alternate_activation.jpg
  7. Your license should install automatically and mocha will close.
  8. Reopen mocha to start using your licensed version!

Standard Node-Locked License Activation for mocha Pro V5 Plugin

First locate the licensing button for your host plugin.

Adobe After Effects Plugin License

For After Effects this is called “License…” and sits on the bar of the effect title in your Effect Controls: http://static.imagineersystems.com/doc/5.0.0/user-guide/en_US/images/5.0.0_mochapro_ae_plugin_license_control.jpg

Adobe Premiere Plugin License

For Premiere, click the small icon next to the effect title:

http://static.imagineersystems.com/doc/5.0.0/user-guide/en_US/images/5.0.0_mochapro_premiere_plugin_license_control.jpg

Avid Media Composer

For Avid, click the License Control checkbox under the License and Registration section at the bottom of the plugin controls: http://static.imagineersystems.com/doc/5.0.0/user-guide/en_US/images/5.0.0_mochapro_avid_plugin_license_control.jpg

After that, the rest is the same as the process above for mocha standalone. See “Standard Node-Locked License Activation for mocha Pro Standalone” for more details.

We recommend restarting the host if you see any issues with licensing.

V5 Node-Locked License Troubleshooting

  1. It is important that your mocha software matches your activation code, so check your purchase order to make sure everything matches up version wise. It may be that you don’t have the correct version of mocha installed from our download section. This is especially important for legacy software before V5, where a different licensing method is used.
  2. If you are attempting to install via a terminal instead of directly on the machine itself and you are having trouble getting mocha to install, try installing directly on the machine.
  3. Check to make sure you are not restricted to using certain ports due to a firewall or other admin permissions. When in doubt, temporarily turn your firewalls off for the duration of the installation and then turn them back on when you are done.
  4. Troubleshoot your machine; try uninstalling all your mocha software, restarting your machine, and installing the software again from scratch, and make sure you follow installation directions off our website exactly. It sounds redundant, but sometimes it’s a great way to figure out what is going on inside your machine.
  5. If all else fails, our support team is happy to help you figure this out. Please contact support!

Installing Node-Locked Licenses for V4 and Earlier

All imagineer software is available from the download section of the website: http://www.imagineersystems.com/download/

Make sure you download the correct version for your system, as we offer both 64-bit and 32-bit versions for some operating systems. Make sure also that you have installed the correct type of mocha software; mocha AE, mocha Plus, or mocha Pro.

The most common licensing plan for mocha is node-locked, so unless you specifically purchased a floating license, follow the node-locked instructions to install your software. 

Node-locked Installation for V4 and Earlier

  1. Make sure you have downloaded the correct version of mocha for your operating system.
  2. Make that your version of mocha is the product you have purchased (You will not be able to use a mocha Pro activation code for mocha Plus or mocha AE, for example).
  3. You will need to install the mocha package:
    • Apple OS: Double-click the dmg package and drag the application to your application folder
    • Windows: Double-click the exe package and follow the instructions
    • Linux: Install the package with the command: rpm –Uvh [type the path to your mocha rpm file here] (64-bit versions of the software will not run on a 32-bit version of Linux).

Standard Node-Locked License Activation for V4 and Earlier

When you purchase your license, you will be emailed an activation code

  1. Make sure you are connected to the internet
  2. Open mocha and choose “Activate” from the welcome screen mocha V3 Splash Screen
  3. Paste the activation code into the available activation field and click Activate mocha V3 Activation field
  4. Your license should install automatically.
  5. The license will install to:
    • Licence Directory for OSX: /Library/Application Support/Imagineer Systems/FLEXlm/Licenses/
    • Licence Directory for Windows
      • Windows XP: C:\Documents and Settings\All Users\Application Data\Imagineer Systems Ltd\Licensing\
      • Windows Vista: C:\ProgramData\Imagineer Systems Ltd\Licensing\
      • Windows 7: C:\ProgramData\Imagineer Systems Ltd\Licensing\
      • (Legacy versions of Imagineer Software may still use the directory C:\Program Files\Imagineer Systems Ltd\Licensing\)
    • Licence Directory for Linux
      • /etc/opt/isl/licences/

V4 Node-Locked License Troubleshooting

  1. If your computer or server is not connected to the Internet (or you are running an older version of our software that does not use activation codes) you will not be able to activate your software using an activation code. Connect to the Internet or contact support for a manual license if connecting to the Internet is impossible. You will need to provide your Host ID. You will have to contact support to activate older, legacy versions of our software whether you have an Internet connection or not. Please follow the steps outlined in “Email Request Node-Locked Licenses” to get up and running as fast as possible.
  2. It is important that your mocha software matches your activation code, so check your purchase order to make sure everything matches up version wise. It may be that you don’t have the correct version of mocha installed from our download section. This is especially important for legacy software. The usual error for the wrong software or incorrect license for the software you are trying to run is “FLEXlm error: -15 No such feature exists.”
  3. If you are not running as the administrator of the machine, try running in admin mode and install again.
  4. If you are attempting to install via a terminal instead of directly on the machine itself and you are having trouble getting mocha to install, try installing directly on the machine.
  5. You may not have more than one license installed in your licensing folder. Make sure you only have one license installed on the machine. Licensing folders are as listed below:
    • Licence Directory for OSX: /Library/Application Support/Imagineer Systems/FLEXlm/Licenses/
    • Licence Directory for Windows
      • Windows XP: C:\Documents and Settings\All Users\Application Data\Imagineer Systems Ltd\Licensing\
      • Windows Vista: C:\ProgramData\Imagineer Systems Ltd\Licensing\
      • Windows 7: C:\ProgramData\Imagineer Systems Ltd\Licensing\
      • (Legacy versions of Imagineer Software may still use the directory C:\Program Files\Imagineer Systems Ltd\Licensing\)
    • Licence Directory for Linux
      • /etc/opt/isl/licences/
  6. Check to make sure you are not restricted to using certain ports due to a firewall or other admin permissions. When in doubt, temporarily turn your firewalls off for the duration of the installation and then turn them back on when you are done.
  7. Troubleshoot your machine; try uninstalling all your mocha software, restarting your machine, and installing the software again from scratch, and make sure you follow installation directions off our website exactly. It sounds redundant, but sometimes it’s a great way to figure out what is going on inside your machine.
  8. If all else fails, our support team is happy to help you figure this out. Please contact support here.

Email Request Node-Locked Licenses

If you are running older versions of the software or cannot connect to the internet, you have an alternate choice to activate your license.

  1. Run mocha and choose “Activate” from the welcome screen (See screen above). If you are running an older version you will need to choose “View License” from the Help menu.
  2. Go to http://imagineersystems.com/support/contact-support/
  3. Fill out your contact information correctly
  4. Enter your purchase order number and postcode
  5. Enter or paste the Host Id (your MAC address) from the mocha Activation screen
  6. Confirm your version of mocha (this will speed up our turnaround and any troubleshooting).
  7. Submit. You will then be sent an email containing your license within 24-48 hours from our support team. You will almost always receive your license sooner, but large volumes of support requests take time to process.
  8. Check your spam folder if you have not received your license within 24-48 hours.
  9. Save this license to the Imagineer Systems license directory. If the directory does not exist you will need to create it. See license directories below for further information.
    • Licence Directory for OSX: /Library/Application Support/Imagineer Systems/FLEXlm/Licenses/
    • Licence Directory for Windows
      • Windows XP: C:\Documents and Settings\All Users\Application Data\Imagineer Systems Ltd\Licensing\
      • Windows Vista: C:\ProgramData\Imagineer Systems Ltd\Licensing\
      • Windows 7: C:\ProgramData\Imagineer Systems Ltd\Licensing\
      • (Legacy versions of Imagineer Software may still use the directory C:\Program Files\Imagineer Systems Ltd\Licensing\)
    • Licence Directory for Linux
      • /etc/opt/isl/licences/

 

 


Installing Floating Licenses

This guide will walk you through the process of installing floating licenses. Installing node-locked licenses does not require the use of the license manager. See above.

Floating licenses – How it works

Because many work environments have a dynamic structure, Imagineer Systems offer floating licenses. This works by keeping the license file on a central server, which can then be used by multiple client machines. For example, if your studio has 20 machines but you only need 5 people using our software at a time, you could get a 5-machine floating license, which can then be used on any 5 machines in your network. The software can then be installed on all 20 machines without needing individual licenses for each computer. When someone stops using the software on one machine, it then frees up that license spot for another machine on the network to use.

Floating licenses - mocha Pro V5 vs mocha Pro FL V5

From mocha Pro 5.2.0 onwards, float support and node-locked support are in the same application. We encourage you to use the latest patch version where possible for floating licenses.

If for legacy reasons you need to use earlier versions of mocha Pro V5 ( mocha Pro 5.0.0 to mocha Pro 5.1.1), to operate floating licenses you need to use  mocha Pro (Floating License) from the legacy download page: http://www.imagineersystems.com/download/legacy-download/

The mocha Pro FL version is identical in every way to the standard version, with the exception being FLEX licensing support.

Users on a mocha Pro V4 license or earlier can just download their standard versions.

How do I install the floating license server?

Floating licenses can be complex to set up, and if you have no previous experience of configuring network services, the process can be quite daunting. If you need any help, please contact support (http://imagineersystems.com/support/contact-support/) However, you may find a solution to your problem faster if you scroll down to troubleshooting below. NOTE: To configure a license server you must have Administrator (or root) privileges

Installing Floating Licenses on Mac OS X

Mac OS X License Manager

Mac OSX License Manager Install

 

  • After installing the license manager, load it from your Applications folder and type or paste your activation code into the Activation Code field then press Activat
Note If you have received your license via email, please skip the rest of the section and go to “Mac OS X Server License (Manual Install)” below.

Mac OSX License Manager

 

  • Press the Install Server License button in the license manager to install the license to the server. The manager will install the file here: /Library/Application Support/Imagineer Systems/FLEXlm/Licenses

Mac OSX License Manager

 

  • The License Manager starts the managing service automatically. You can view this in the service section of the License Manager:

Mac OSX License Manager

 

  • The error log can be viewed by clicking Log File. This file is stored at: /Library/Logs/Imagineer Systems/lmgrd.log
  • If your license server does not start automatically, restart the computer to automatically start it

 

Mac OS X Server License (Manual Install)

In case where you cannot install the license via an Activation code (normally where the server is not connected to the internet) you can manually install your license to Mac OS X:

  1. If you haven’t already, install the License Manager as described above in the “Mac OS X License Manager” section.
  2. Copy your license file (e.g. mocha.lic) into /Library/Application Support/Imagineer Systems/FLEXlm/Licenses
  3. If your license server does not start automatically, restart the computer to automatically start it

Mac OS X Client Machine

Once you have the server license installed (see above), you can then install mocha on your client machine and activate.

  1. Click on Activate on the welcome screen in mocha
  2. Using the same activation code, paste this into the Activation field and click Activate
  3. The client license should now install to /Library/Application Support/Imagineer Systems/FLEXlm/Licenses
  4. If the installation is successful, you will now be able to use mocha

Mac OS X Client Machine (Manual Install)

Once you have the server license installed, you can then install mocha on your client machine.

  1. If you received your license by e-mail skip to point 5
  2. Open the OS X License Manager
  3. Submit your Activation Code and click on Show Detail
  4. Click Install Client License and the file will save as client_license.lic
  5. Drag and drop the client license file into /Library/Application Support/Imagineer Systems/FLEXlm/Licenses on the client machine
  6. If the installation is successful, you will now be able to use mocha

Installing Floating Licenses on Windows

Windows License Manager

Note To configure a license server you must have Administrator privileges. Either login as Administrator or right-click the installer and choose “Run as Administrator”.
  1. Download the Windows license manager from the download section: http://imagineersystems.com/download/current-version-downloads/
  • Double-click the MSI installation file and follow the prompts:

 

  • The installation process will also automatically start the License Manager services:

 

  • After installing the license manager, load it from the Start Menu and use your activation code to activate
Note If you have received your license via email, please skip the rest of the section and go to “Windows Server License (Manual Install)” below.

Windows License Manager

 

  • Press the Install Server License button in the license manager to install the license to the server. The manager will install the file here:
    • Windows XP – C:\Documents and Settings\All Users\Application Data\Imagineer Systems Ltd\Licensing
    • Windows Vista – C:\ProgramData\Imagineer Systems Ltd\Licensing
    • Windows 7 – C:\ProgramData\Imagineer Systems Ltd\Licensing

Windows License Manager

 

  • The License Manager starts the managing service automatically. You can view this in the service section of the License Manager:

 

  • The error log can be viewed by clicking Log File.
  • If your license server does not start automatically, restart the computer to automatically start it

Windows Server License (Manual Install)

In cases where you cannot install the license via an Activation code (normally where the server is not connected to the internet) you can manually install your license to Windows:

  1. You should have already installed the Windows License Manager in the steps outlined above. This also installs the FlexLM server software into the default location.
  2. If you have requested to receive your floating license by e-mail, copy the license server file (e.g. mocha_Pro_cross-platform_floating_license_v3.000_server.lic), into the proper system licensing directory:
    • Windows XP: C:\Documents and Settings\All Users\Application Data\Imagineer Systems Ltd\Licensing\
    • Windows Vista: C:\ProgramData\Imagineer Systems Ltd\Licensing\
    • Windows 7: C:\ProgramData\Imagineer Systems Ltd\Licensing\(Legacy versions of Imagineer Software may still use the directory C:\Program Files\Imagineer Systems Ltd\Licensing\)
  3. If your license server does not start automatically, restart the computer to automatically start it

Windows Client Machine

Once you have the server license installed (see above), you can then install mocha on your client machine and activate.

  1. Click on Activate on the welcome screen in mocha
  2. Using the same activation code, paste this into the Activation field and click Activate
  3. The client license should now install to:
    • Windows XP: C:\Documents and Settings\All Users\Application Data\Imagineer Systems Ltd\Licensing\
    • Windows Vista: C:\ProgramData\Imagineer Systems Ltd\Licensing\
    • Windows 7: C:\ProgramData\Imagineer Systems Ltd\Licensing\
  4. If the installation is successful, you will now be able to use mocha

Windows Client Machine (Manual Install)

Once you have the server license installed, you can then install mocha on your client machine.

  1. If you received your license by e-mail skip to point 5
  2. Open the Windows License Manager
  3. Submit your Activation Code and click on Show Detail
  4. Click generate client license and the file will save as client_license.lic
  5. The client license should now install to:
    • Windows XP: C:\Documents and Settings\All Users\Application Data\Imagineer Systems Ltd\Licensing\
    • Windows Vista: C:\ProgramData\Imagineer Systems Ltd\Licensing\
    • Windows 7: C:\ProgramData\Imagineer Systems Ltd\Licensing\
  6. If the installation is successful, you will now be able to use mocha

Installing Floating Licenses on Linux

Linux License Manager

If you have received an activation code you will need to use the license manager to activate your license. If you received your license file by e-mail, proceed to the “Linux License Server” section below.

  1. Download the Linux license manager from the download section: http://imagineersystems.com/download/current-version-downloads/
  2. Make sure you have downloaded the correct version for your system. 64-bit versions of the software will not run on a 32-bit version of Linux.
  3. Double-click the RPM file to begin installation or install it from the terminal using sudo rpm -Uvh [PACKAGE_FILE].rpm, where [PACKAGE_FILE] is the name of the License Manager RPM file you have downloaded.

Linux License Server

To configure a license server as a service, you must have root privileges. We support license server installation for Red Hat Enterprise Linux 4 32-bit systems, Red Hat Enterprise Linux 5 64 bit systems, and their equivalents.

  1. You should have already installed the Linux License Manager in the steps outlined above.
  2. After installing the License Manager, load it and use your activation code to activate
  3. Press the Install Server License button in the License Manager to install the license to the server.
  4. The manager will install the license file here: /etc/opt/isl/licences
  5. If you have requested to receive your license by e-mail, copy your License file (e.g. mocha.lic) into /etc/opt/isl/licences. Skip this step if you have used your activation code to install the server license instead.
  6. The server process should already be started automatically, but you can make sure by typing: /etc/init.d/isllmgrd start
  7. The server will start automatically at runlevels 2, 3, 4 and 5. FLEXlm messages are logged to: /var/log/isllmgrd.log
  8. The init script accepts start, stop, restart and status commands, and also reread, which rereads the License file. The daemon is run by default as the nobody user. If this does not exist on your system, either create it or edit the script to use a different non-root user.

Linux Client Machine

Once you have the server license installed, you can then install mocha on your client machine and activate.

  1. Click on Activate on the welcome screen in mocha
  2. Using the same activation code, paste this into the Activation field and click Activate
  3. The client license should now install to: /etc/opt/isl/licences
  4. If the installation is successful, you will now be able to use mocha

Linux Client Machine (Manual Install)

Once you have the server license installed, you can then install mocha on your client machine.

  1. If you received your license by e-mail skip to point 5
  2. Open the Linux License Manager
  3. Submit your Activation Code and click on Show Detail
  4. Click generate client license and the file will save as client_license.lic
  5. The client license should be installed to: /etc/opt/isl/licences
  6. If the installation is successful, you will now be able to use mocha

Troubleshooting Floating Licenses

As with any software, problems may arise during the installation process. Please take a moment to read our troubleshooting section and check for common errors. You may also want to check out the “License Administration Guide” FLEXlm documentation PDF here: http://www.globes.com/support/fnp_utilities_download.htm

If you continue to have issues installing, please contact support and we will be happy to help you. You may contact our support team here.

Verify your server license has been successfully installed

Check that your license actually exists on the Server

  • Mac OS X: /Library/Application Support/Imagineer Systems/FLEXlm/Licenses/mocha_Pro_cross_floating_license_v2.500_server.lic
  • Windows XP: C:\Documents and Settings\All Users\Application Data\Imagineer Systems Ltd\Licensing\mocha_Pro_cross_floating_license_v2.500_server.lic
  • Windows Vista: C:\ProgramData\Imagineer Systems Ltd\Licensing\mocha_Pro_cross_floating_license_v2.500_server.lic
  • Windows 7: C:\ProgramData\Imagineer Systems Ltd\Licensing\mocha_Pro_cross_floating_license_v2.500_server.lic
  • Linux: /etc/opt/isl/licences/mocha_Pro_cross-platform_floating_license_v2.500_server.lic

Verify your client license has been successfully installed

Check that your client license actually exists on the client machine

  • Mac OS X: /Library/Application Support/Imagineer Systems/FLEXlm/Licenses/mocha_Pro_v2_client.lic
  • Windows XP: C:\Documents and Settings\All Users\Application Data\Imagineer Systems Ltd\Licensing\mocha_Pro_v2_client.lic
  • Windows Vista: C:\ProgramData\Imagineer Systems Ltd\Licensing\mocha_Pro_v2_client.lic
  • Windows 7: C:\ProgramData\Imagineer Systems Ltd\Licensing\mocha_Pro_v2_client.lic
  • Linux: /etc/opt/isl/licences/mocha_Pro_v2_client.lic

Verify you are using the latest version of the license server software.

Check http://imagineersystems.com/download/current-version-downloads/to make sure your License Manager is up to date. Sometimes there can be issues where a 64-bit version of the server software has been installed on a 32-bit version of Windows. If this is the case, uninstall the License Manager then go to the downloads section of our website and download the correct bit version of the License Manager for your version of Windows. When in doubt, 32-bit should work.

Verify the SERVER port is not being used or blocked by another process

By default the license server runs in port 27000, but this can be blocked or used by other processes. You may see a TCP error in your server log file when it cannot read the port.

Check that ports 27000-27009 are open and not in use, or allocate a different port by editing the SERVER line in the license file:

 SERVER servername 000000000000

to

 SERVER servername 000000000000 12345

where 000000000000 is the host id and 12345 is a port chosen by the system administrator.

Verify there is not a firewall running between the server and the client computer

If your organization needs to run a firewall, you will need to open the ports of the license server manually. Normally the license server runs in port 27000, but if other FLEXnet license servers are present it may take a different port. To be safe, open ports 27000-27009. Also, the vendor daemon uses a port specified at run time. If a static port allocation is required, edit the license file and change:

 VENDOR isl

to

 VENDOR isl PORT=12345

The client is receiving an error of -15 or -96

This means the server is not running correctly or there is a network problem between two computers. Please follow the steps below:

  1. Open the License Manager
  2. Switch to the Server tab (the third button at the top of the License Manager window)
  3. Click on Log File. This will bring up the License Manager log file so you can review any errors
  4. Scroll to the bottom of the log to view the most recent errors. You may have to scroll up from the bottom to see complete errors
  5. If you receive a similar message to the one below (file paths may vary according to your system), the hostname of your license is not set correctly:
18:34:27 (lmgrd) "Rodrigo222": Not a valid server hostname, exiting.
18:34:27 (lmgrd) Valid license server system hosts are: "Rodrigo"
18:34:27 (lmgrd) Using license file
"Licenses//mocha_Pro_cross-platform_floating_license_v2.500_server.lic"

To fix this, edit the server host name in the server and client license by reactivating your license in the License Manager. This will affect these lines in the licenses:

SERVER Rodrigo 000000000000
VENDOR isl

You can also edit this manually in the license files themselves, but it is easier to just load License Manager and change the host name, then reactivate.

Don’t forget to click the Install Server License after you reactivate! If you receive a similar message to the one below (file paths may vary according to your system), the Host ID of your computer and your license does not match. Please contact support to resolve the issue:

18:50:51 (isl) Wrong hostid on SERVER line for license file:
 18:50:51 (isl) Licenses//mochapro_crossplatform_
 floating_license_v2.500.lic
 18:50:51 (isl) SERVER line says 000000000000, hostid is ffffffffffff
 18:50:51 (isl) Invalid hostid on SERVER line

In this case, you should contact support at http://imagineersystems.com/support/contact-support/ For Linux and Mac OS X, you can reset the default directory location of your license server by running the command below in terminal: rm ~/.flexlmrc

Restarting the license server to load a new configuration.

On Mac OS X you can stop and start the license server daemon by typing the 2 commands below inside the terminal and pressing return after each:

sudo launchctl stop com.imagineersystems.lmgrd

sudo launchctl start com.imagineersystems.lmgrd

On Linux you can stop and start the license server daemon by typing the 2 commands below inside the terminal and pressing return after each:

sudo /etc/init.d/isllmgrd stop

sudo /etc/init.d/isllmgrd start

For Windows (and Linux or Mac OS X) you can stop and start the system by doing the following: . Load the License Manager (if you are on Windows, you must right-click and choose “Run as Administrator”) . Switch to the Server tab (the third button at the top of the License Manager window) . Click the Stop button . Click the Start button If neither of these methods work, try restarting the server machine.

If your computer or server is not connected to the Internet

If you are not connect to the internet (or you are running an older version of our software that does not use activation codes) you will not be able to activate your software using an activation code: Connect to the Internet or contact support for a manual license if connecting to the Internet is impossible. You will need to provide your Host ID and if you are installing on a server you will need to provide the exact server name. Both of these can be retrieved via the License Manager in the System Info section.

You will have to contact support to activate older, legacy versions of our software whether you have an Internet connection or not. Please go to http://imagineersystems.com/support/contact-support/ to send your server details.

Check to make sure your mocha software matches your activation code

Check your purchase order to make sure everything matches up version wise. It may be that you don’t have the correct version of mocha installed from our download section. This is especially important for legacy software. The usual error for the wrong software or incorrect license for the software you are trying to run is “FLEXlm error: -5 No such feature exists.”

Administrator or root installation

If you are not running as root on Linux or are not logged in as administrator of the machine, try running in admin or root mode and install again.

Installing Remotely

If you are attempting to install via Remote Desktop instead of directly on the machine itself and you are having trouble getting mocha or the FlexNet software to install, try installing directly on the machine. This applies to both server and client machines.

Check for conflicting licenses installed in your licensing folder

If you have more than one mocha license installed on the server or client machine check to make sure they are not expired licenses. While rare, sometimes these licenses can conflict with any current ones you have on your system.

The client does not connect or see the server host name

If your client machine does not connect to the server based on the server name, try replacing the server name with the IP address of the server instead in the license file. You can easily do this via the License Manager or via a text editor.

When in doubt, check the logs!

Check logs and their paths: Read the logs from mocha and from your server, they will tell you all about what is happening to your machine. You can match FlexNet errors to the list of FlexNet error codes in the “License Administration Guide” FlexNet documentation PDF here: http://www.globes.com/support/fnp_utilities_download.htm

Check to see if the server process is actually running

You can check to see if the server process is running by opening your License Manager and switching to the Server tab:

You can also check if ISL Services are running in Windows task manager:

And the isl process in Mac OS X:

Install mocha on the server to test the license

If you get client license issues, see if the license works on the server by installing the version of mocha you are trying to set up on the server and opening it up. If it runs in LE mode, the license is not properly installed. If it runs without asking you to activate, the license has been installed correctly on the server and you will need to troubleshoot your client machines.

Check your firewall settings

Check to make sure you are not restricted to using certain ports due to a firewall or other admin permissions. When in doubt, temporarily turn your firewalls off for the duration of the installation and then turn them back on when you are done.

Check your host name settings

If your client machine is not able to connect to the server you may have a networking issue. Try changing the server name in the client license to the IP address of the server instead, or check to see if your host has “.local” appended to the end of it. You can do this by selecting IP address in the License Manager when you activate. You can also do this in any text editor by opening up the client license and server license and manually editing the server name.

Sometimes the best solution is to start again

You might roll your eyes at this one, but try uninstalling, restarting your machine, and installing the software again from scratch. Make sure you follow installation directions off our website exactly. It sounds redundant, but sometimes it’s a great way to troubleshoot what is going on inside your machine.

When all else fails…

Contact us! Our support team are more than happy to help you fix any floating license issues you may have. Please contact support here: http://imagineersystems.com/support/contact-support/

Installing Render Licenses

This section will discuss the installation of floating render licenses and how they differ from standard interactive floating licensed.

Render Floating Licenses vs Interactive Floating Licenses

A render license is a specific kind of floating license that only allows rendering of mocha project output, be it inside a plugin or in the standalone application.

When you are using a floating license, it is broken into two parts: The interactive portion and the rendering portion.

For plugins, this is separated like so:

  1. If you open the mocha GUI in the mocha Pro Plugin (and a license is available) you are entering the interactive portion.
  2. If you are back in the host and not using interactive elements such as layer choosing or opening the GUI, you are using the rendering portion of the license.

For the standalone, this is separated like so:

  1. If you open the mocha Pro standalone application (and a license is available) you are entering the interactive portion.
  2. If you have the mocha Pro standalone application closed and are using the mocharender.py render script, you are utilizing the rendering portion. (See the Python guide for more details on rendering with mocharender.py)

If the interactive license is in use elsewhere or missing, the mocha GUI will become unlicensed and attempting further work may encrypt your project if you choose to save. If you have no interactive floating licenses available to render with, additional render licenses can be helpful to let you free up interactive licenses elsewhere.

Workflow for Render Licenses: Example 1

To help illustrate the Render License workflow, let’s look at the following situation:

  • 5 floating licenses (interactive)
  • 10 render licenses (render only)
  • There is only 1 user

The license server is operating with both sets of licenses.

  • If only one person is using mocha on the network, there are 4 interactive and 10 render licenses still available to use.
  • If only that one person was using mocha on the network, they would have 15 render machines available for use including the one they were working with.
  • If another person started working and all machines were in use for rendering, their version of mocha would be unlicensed, as there would be no available seats.

Workflow for Render Licenses: Example 2

To help illustrate the Render License workflow, let’s look at another situation:

  • 5 floating licenses (interactive)
  • 10 render licenses (render only)
  • There are 5 users

The license server is operating with both sets of licenses.

  • There are 5 people working in mocha.
  • If another user tries to work on a 6th machine, they will open mocha unlicensed, because all interactive licenses are in use.
  • They open an existing project with mocha in it (or render from the command line), they will be able to render, because all render licenses are available.

Now, say one person wants to send off a render to the network:

  • If 5 people are using mocha on the network already, there would be 11 render machines available for use including the one the user was presently working with.
  • If another person stopped working in mocha, the interactive license would be released, and a new machine would then be free to either use for work (interactive) or render (non-interactive) by another user.

Installing Render Floating Licenses

The installation of a render license is exactly the same as that of a standard interactive floating license. See the Installing Floating Licenses for a complete guide.

File Management for Rendering on a Network

If you are planning to render either via the mocha render scripts, an Adobe watch folder or a render farm (for example in Nuke), there are some file workflows you need to adopt.

You will need to make sure the necessary source footage is available for all machines. This includes anything you have imported into the mocha GUI such as clean plates, insert clips and other imported files.

These files need to be managed by any of the following methods:

  • Placed in the same file structure on all machines
  • Relinked manually with an interactive license on all machines
  • Pointing to the same shared directory.

Failing to set this up may result in incorrect renders.

Important If you are using the plugin, you may have imported footage into the mocha GUI separate from the host source footage. Make sure any imported footage is also available.

Last updated 2016-11-10 12:29:46 AEDT

Newsletter

Need more mocha?
Sign up to receive the latest news, events, contests, and training videos.