Only mokey prior to V3.0 was not compatible with inferno 5.0, flame/flint 8.0 and fire/smoke 5.2. If you have a previous version of mokey, please download V3.0.

To install the license server you must have root privileges.

1. Download the Imagineer Systems Licence Manager for IRIX.
2. Extract the archive and log in as root.
3. Execute ./install_isllmgrd.sh
4. Copy your licence file (isl_license.dat) into /usr/ISL/FLEXlm/. The licence file will have been sent to you as an email attachment.
5. Start the server by typing

   /etc/init.d/isllmgrd start

The server will start automatically at system startup, this can be controlled using the chkconfig system command. FLEXlm messages are logged to /var/sysadm/isllmgrd/isllmgrd.log. The init script accepts the usual start and stop commands, and also restart, status (which runs lmstat) and reread, which rereads the licence file. The daemon is run by default as the guest user, if this does not exist on your system either create it or edit the script to use a different non-root user.

To use the license server from Imagineer Systems products, open the file license.dat and copy & paste the contents into the application's licensing window, available through Help->View License

Please click one of the following links for instructions on installing a floating licence. Click on the link which corresponds to the platform of the licence server, not the client machine that will run the application. The page will open without our usual style for easier printing.

Windows
Mac OS X
IRIX
Linux

Floating licences 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 give us a call on +44 1483 685 585.

To install the license server you must have root privileges.

1. Download the Imagineer Systems Licence Manager for Linux.
2. Extract the archive and log in as root.
3. Execute ./install_isllmgrd.sh
4. Copy your licence file (isl_license.dat) into /usr/local/ISL/FLEXlm/. The licence file will have been sent to you as an email attachment.
5. Start the server by typing

   /etc/init.d/isllmgrd start

The server will start automatically at runlevels 2, 3, 4 and 5. FLEXlm messages are logged to

/var/log/isllmgrd.log

To use the license server from Imagineer Systems products, open the file license.dat and copy & paste the contents into the application's licensing window, available through Help->View License

To configure a license server as a service, you must have Administrator privileges.

For OS X 10.4 or higher

1. Download the Imagineer Licence Manager for Mac OS X 10.4 or higher.
2. If the disk image did not automatically mount, double-click the .dmg file to mount it.
3. Double-click on the package inside the disk image
4. Follow the instructions in the installer.
5. After installing the licence manager, unzip the license file you received and drop isl_license.dat file into:
• /Library/Application Support/Imagineer Systems/FLEXlm/Licenses
6. Any errors will be logged to:
• /Library/Logs/Imagineer Systems/lmgrd.log
7. Start the application in the client computer. If the license dialog does not automatically show, click Help | View License.
8. Open the file license.dat and copy & paste the contents into the application's licensing window

For OS X 10.3

1. Download the Imagineer Licence Manager for Mac OS X 10.3.
2. If the disk image did not automatically mount, you will need to double-click the .gz file, then double-click the .dmg file it contains.
3. Double-click on FLEXlm-ISL.pkg
4. Run through the installer
5. In the finder, select Go, then Go to folder...
6. Enter /usr/local/flexlm/licenses
7. Save isl_license.dat into the folder you just opened.
8. Open a terminal (/Applications/Utilities/Terminal)
9. Type: /System/Library/StartupItems/ISL_LicenseManager/ISL_LicenseManager and press enter.
10. Send the output to Technical Support if there are any errors or you want clarification of what's going on
11. The licence server will start automatically whenever you restart your computer
li>Start the application in the client computer. If the license dialog does not automatically show, click Help | View License.
12. Open the file license.dat and copy & paste the contents into the application's licensing window

1. Download the Imagineer Licence Manager for Windows
2. Extract all the files in this archive to the default location (C:\Program Files\Imagineer Systems Ltd\Licensing). Copy the file isl_license.dat, which was sent to you by email, into the same directory.
   
   
3. Run LMTOOLS.
4. Click the Configuration using Services radio button, then click the Config Services tab.
5. In the Service Name, type ISL License Manager, then click the Browse button next to 'Path to the lmgrd.exe'
6. Select the lmgrd.exe file in the folder C:\Program Files\Imagineer Systems Ltd\Licensing and click Open
7. Click the Browse button next to 'Path to the license file'
8. Change the 'Files of type' filter to *.dat' and select the isl_license.dat file and click Open
9. Click the Browse button next to 'Path to the debug log file'
10. Type 'debug.log' in the 'File name' field and click Open
11. Check the Use Services and Start Server at Power Up boxes. Then click the Save Service button.
12. Close the LMTools application
13. Start the application. If the license dialog does not automatically show, click Help | View License. In the license dialog window. Enter the following details into the license dialog: SERVER [server name] [server hostid] USE_SERVER Example:
14. Click OK in the license dialog and restart the application. Check that the application starts correctly and is not in 'Learning Edition' mode.
15. Repeat step 13 for all client machines

If you experience problems with the display of images please try the following

1. Download the latest driver for your graphics card:
   
   Matrox
   NVIDIA
   ATi
   3Dlabs
   
   
2. If updating the driver does not work, change to raster mode:
   
   Go to File | Preferences. Untick 'Use Textures' on the 'Cache Settings' page.

1. Download your Imagineer Products from our download section. By clicking, you hereby agree to our End User Licence Agreement.
2. Run your Imagineer product
3. Go to the Help | View License menu
4. Delete the text which appears in the dialogue
5. Copy and paste the license you received by e-mail from us
6. Alternatively you can drag and drop the attachment (license.dat) into the dialogue
7. It may be necessary to restart the application for your new licence to take effect

If you don't want to run the software as root or Administrator. Follow the next set of instructions:

Save the attachment from the email we sent you (license.dat) in the installation directory. The default locations are:

mokey:

• Windows: C:\Program Files\Imagineer Systems Ltd\Mokey Vx\
• IRIX: /usr/ISL/MokeyVx/
• Linux: /usr/local/ISL/MokeyVx/
• Mac: /Applications/Mokey.app/Contents/

monet:

• Windows: C:\Program Files\Imagineer Systems Ltd\Monet Vx\
• IRIX: /usr/ISL/MonetVx/
• Linux: /usr/local/ISL/MonetVx/
• Mac: /Applications/Monet.app/Contents/

mocha:

• Windows: C:\Program Files\Imagineer Systems Ltd\Mocha Vx\
• IRIX: /usr/ISL/MochaVx/
• Linux: /usr/local/ISL/MochaVx/
• Mac: /Applications/Mocha.app/Contents/

motor:

• Windows: C:\Program Files\Imagineer Systems Ltd\Motor Vx\
• IRIX: /usr/ISL/MotorVx/
• Linux: /usr/local/ISL/MotorVx/
• Mac: /Applications/Motor.app/Contents/

where Vx is the version number i.e. V1.

I get one of the following error messages:

• "Failed to save /Applications/Monet.app/Contents///license.dat"
• "Failed to save /Applications/Mokey.app/Contents///license.dat"

1. Make sure that the application is installed in the correct location, e.g. /Applications/Mokey.app or /Applications/Monet.app
2. Check that you have write permission to:
   • /Applications/Monet.app/Contents folder
   • /Applications/Mokey.app/Contents folder
   (try e.g. to create a file in the folder.) If you don't have write permission, make sure your user account is part of the Admin group.
3. An alternative way of installing the license is to copy the contents of the license file into a plain text file called 'license.dat' in the '/Applications/Mokey.app/Contents' or the '/Applications/Monet.app/Contents' folder

There is an incompatibility between some NVIDIA graphics drivers and mokey. This problem usually appears with GeForce 4 based products and Microsoft Windows 2000 or XP.

The solution is to switch to NVIDIA driver version 30.82, which is available from the NVIDIA website.

Q: My machine has a system drive and a disk array. Should I setup the file cache to the system drive or the disk array?

You should set the File Cache to use the disk array as it

1. is faster
2. has more space

Q: Should the file cache be the same as the file location?

The File Cache can be any drive attached to the system, or even a network drive. Ideally use the fastest drive available.

Q: I set the File Cache to the disk array, but I do not see any temp files created within the folder.

This may be because you have a lot of memory in the system. The application will only cache to disk once it runs out of RAM. Try it with a very long / high resolution clip to test this.

Q: In the C drive, there are MokeyTemp + MoTemp folders, what are they for?

They were created as default File Cache folders - you can delete them once you have changed the File Cache to use another drive / folder.

This will happen if you don't have permission to write the preferences file. Check that you have write access to

Windows:

• HKEY_LOCAL_MACHINE in the Windows Registry

Mac OS X:

• The file /Library/Preferences/com.Imagineer.plist

If you have received a dongle (FLEXID) from Imagineer for use with our products, please follow these instructions to install and configure it:

1. To allow the system to recognize the dongle you will need to download the driver software from the Acresso website.
2. When promted, enter the following user name and password:
   • Username: flexid
   • Password: flexdongles
3. Follow the download and installation instructions.
4. After installing the driver please restart your computer if instructed to do so.
5. Run the Imagineer product you would like to use the dongle with.
6. Plug in the dongle.
7. Go to Help | View License.
8. This window contains a line saying "Your hostid is:...". This should be followed by FLEXID=x-xxxxxxx (where the x's are replaced with numbers and letters). If you don't see the word FLEXID, please contact Technical Support for help.
9. If the hostid line is correct, please visit the following page to generate your license: USB Dongle License Generation.
10. If you already have your license, insert the licence file you have previously received.
11. Press OK, then restart the software. Confirm that the window title contains the name of the product you expect to have, e.g. Monet V2.0.4 Soho Edition

If you are receiving a FLEXlm licencing error, please refer to the list below for details of what may be causing the error.

FLEXLM-1

Cannot find License Files - You may have not correctly installed your license file

FLEXLM-3

No License Server System for this feature

FLEXLM-5

No such features exist

FLEXLM -8

Invalid Key or Signature. This usually occurs if the license file has been altered

FLEXLM -9

Invalid Host. The HostID on the system does not match the license. Please contact Sales Support for further assistance.

FLEXLM -29

Cannot Find Ethernet Device

FLEXLM -89

This Platform not authorized by the license.

FLEXLM -106

License server system out of Network Connections

FLEXLM -110

Cannot read Dongle : Check Dongle or driver. Refer to USB Dongle Installation Instructions if you are using an USB dongle.

FLEXLM -112

Missing Dongle Driver: Check if the correct driver is installed for the Dongle. Refer to USB Dongle Installation Instructions if you are using an USB dongle.

FLEXLM -503

Invalid Hostid supplied in the license.

If your error is not listed above, please contact Technical Support for further assistance.

FLEXlm codes - http://www.macrovision.com

It is easy to find the Host ID of your computer or server by first downloading and installing the Imagineer product.

Here's what you need to do:

1. Download the Learning Edition of your required product from our website.
2. Install it. You do not need your hostid to run the Learning Edition.
3. Run the product.
4. Dismiss the Welcome window and click 'No' when asked if you want to configure the product.
5. Click 'Help' in the menu bar, then 'View License'.
6. Your Host ID is shown in the top bar of the view license window. It will usually look like 000c36af30cd.

Alternatively:-

Windows:

1. Open a command prompt and type ipconfig /all
2. Look for the line starting with 'Physical Address. . .'
3. Remove the - characters from the value of the Physical Address line.
4. Your Host ID should look like this
   
   00e08101ab7d
   

Irix:

1. Open a shell and type sysinfo
2. Your Host ID should look like this
   
   69064C3C
   

Linux:

1. Open a shell and type /sbin/ifconfig | grep HWaddr
2. Your Host ID should look like this
   
   00e08101ab7d
   

OS X:

1. Open a shell and type ifconfig | grep ether
2. Your Host ID should look like this
   
   00e08101ab7d
   

If none of the above information helps, try the FLEXlm utility supplied by us:-

1. Download lmutil, the FLEXlm utilities:
   
   MS Windows
   Linux
   IRIX
   Mac OS X
   
   
2. Open a shell (command prompt on Windows) and change to the directory where you downloaded lmutil.
3. On Unix/Linux/Mac OS X, decompress lmutil by typing:
   
   uncompress lmutil.Z
   
   
4. Get the hostid by typing:
   
   lmutil lmhostid
   
   
5. Your hostid will look like:
   
   Windows: 00e08101ab7d
   Linux: 0000e22a9ab7
   Mac OS X: 0000e22a9ab7
   IRIX: 6909acd9 or 4b002324
   
   

It is easy to generate your licenses using our Host ID.

Here's what you need to do:

1. Go to the Host ID page located in our website
2. Insert your Order Number and Postal/Zip Code
3. Insert your Host ID for the licenses you want to generate. In case you purchased a floating-licence, also insert your Server Name.
   Your Host ID should look like this:
   00e08101ab7d



Example:

Node-locked License
Product		Host ID
motor on Mac OS X nodelocked license		00-01-4A-05-FF-EF

Floating License
Product		Host ID
mochaAE cross-platform floating license		00-01-4A-05-FF-EF
	Server Name	SERVER_NAME



4. Click the Submit button
5. Verify the the information you have submited
6. If the information is correct, click the Issue Permanent License button
7. Your licenses will be printed in the web page
8. Run your Imagineer product
9. Dismiss the Welcome window and click 'No' when asked if you want to configure the product
10. Click 'Help' in the menu bar, then 'View License'
11. Copy and paste the license text in the "View License" menu in our products

No, you can generate the licenses of your products whenever you want accessing the Host ID page.

Example:

Day 1

1. Go to the Host ID page located in our website
2. Insert your Order Number and Postal/Zip Code
3. Insert your Host ID / Server Name for one or more of our product
4. You will see an Awaiting Host ID status message for the products you have not yet provided information for

Product		Host ID
motor on Mac OS X nodelocked license		00-01-4A-05-FF-EF
mocha on Mac OS X nodelocked license		Awaiting Host ID

5. If the information is correct, click the Issue Permanent License button
6. Your licences will be printed in the web page
7. Run your Imagineer product
8. Dismiss the Welcome window and click 'No' when asked if you want to configure the product
9. Click 'Help' in the menu bar, then 'View License'
10. Copy and paste the license text in the "View License" menu in our products

Day 2

1. Go to the Host ID page located in our website
2. Insert your Order Number and Postal/Zip Code
3. Insert your Host ID / Server Name for the product you have not yet issued a license

Product		Host ID
motor on Mac OS X nodelocked license		00014A05FFEF
mocha on Mac OS X nodelocked license		00-01-4A-05-FF-EF

4. If the information is correct, click the Issue Permanent License button
5. Your licences will be printed in the web page
6. Run your Imagineer product
7. Dismiss the Welcome window and click 'No' when asked if you want to configure the product
8. Click 'Help' in the menu bar, then 'View License'
9. Copy and paste the license text in the "View License" menu in our products

Actually, the procedure for generating your license is the same as a normal license.

Here's what you need to do:

1. Go to the Host ID page located in our website
2. Insert your Order Number and Postal/Zip Code
3. Insert your FLEXlm USB Dongle ID located in the top of you dongle for the licenses you want to generate

Your FLEXlm USB Dongle ID should look like this:
FLEXID=9-57651D30



Example:

Node-locked License with FLEXlm USB Dongle
Product		Host ID
motor on Mac OS X nodelocked license		FLEXID=9-57651D30

4. Click the Submit button
5. Verify the the information you have submited
6. If the information is correct, click the Issue Permanent License button
7. Your licenses will be printed in the web page
8. The type of dongle we use is the Aladdin HASP4. Download and install the driver software from the Aladdin Website. Ensure you download drivers for the HASP4, not the HASP HL.
9. Plug in the b>FLEXlm USB Dongle to your computer
10. Run your Imagineer product
11. Go to Help | View License.
12. This window contains a line saying "Your hostid is:...". This should be followed by FLEXID=x-xxxxxxx (where the x's are replaced with numbers and letters). If you don't see the word FLEXID, please contact Technical Support for help.
13. If the hostid line is correct, please insert the licence file you have received in an e-mail. This should contain lines starting with FEATURE and PACKAGE.
14. Press OK, then restart the software. Confirm that the window title contains the name of the product you purchased, e.g. Monet V2.0.4 Soho Edition.

If the client is having any problems getting his software to run, follow these troubleshooting steps:

General

1. Confirm that the client is using the files came in the enclosed zip file in their license email. They should NOT be copying from the body of the email program as this can corrupt the license file they are using.
2. Confirm that the client has copied the correct file (license.dat) into the license window of the software.
3. If the license will not save, the client is still running the application from the DMG file. Have them copy the file over to their hard drive and then install the license.

Host ID and Hostname

1. Confirm that the isL_license.dat and the license.dat are edited correctly with the either the ip address or the name of the server.
2. If using the server name, be sure that the license includes the .local at the end of the server name. Also, no spaces are included in the name.
 
Example: computer is named “bob’s computer”. The correct server name for this system would be bobs_computer.local If you are ever unsure you can open the system preferences panel and select Sharing. There you select the edit button for the system name and it will list the name in the correct format.


3. If the client is receiving an error -15 or -96, the server is not running correctly. Follow these steps to fix most of these problems.
 

1. Open a terminal window
2. Type in this command (or copy and paste): cd /Library/Application\ Support/Imagineer\ Systems/FLEXlm 
3. Type or copy this command next: ./lmutil lmpath -override all /Library/Application\ Support/Imagineer\ Systems/FLEXlm/Licenses/isl_license.dat
4. You should see this reported back to you:
   
   lmutil - Copyright (c) 1989-2005 Macrovision Europe Ltd. and/or Macrovision Corporation. All Rights Reserved.
New path for LM_LICENSE_FILE: /Library/Application Support/Imagineer Systems/FLEXlm/Licenses/isl_license.dat
   
   
5. Start your license server by typing this: ./lmgrd
6. You should see a bunch of stuff printing in your terminal window. When it is done printing in the window, hit the return key to get the prompt back up.
7. Type this command to check the status: ./lmutil lmstat
8. You should see this: 
   
   lmutil - Copyright (c) 1989-2005 Macrovision Europe Ltd. and/or Macrovision Corporation. All Rights Reserved. Flexible License Manager status on Wed 11/14/2007 08:45
License server status: 27000forces1.local
License file(s) on forces1.local: /Library/Application Support/Imagineer Systems/FLEXlm/Licenses/isl_license.dat:
forces1.local: license server UP (MASTER) v10.8
Vendor daemon status (on forces1.local): isl: UP v10.8
 
   
   
9. At this point your license server should be up and running, Try launching your application on your client machine.
 
  
4. If the client is receiving an error -15 or -96, the server is not running correctly. Follow these steps to fix most of these problems.
 

1. Open a terminal window