KeyShot Pro Floating - Troubleshooting Guide

This troubleshooting guide provides a comprehensive and informative approach to resolving issues that may arise with KeyShot Pro Floating licenses. It offers step-by-step instructions and helpful tips to ensure a smooth troubleshooting process.

This troubleshooting guide assumes that you have already set up your server software according to the setup guide. Otherwise, please install the server software and set up the service according to the setup guide. You may also follow along with the installation video.

Issue

If you are experiencing difficulties connecting KeyShot to the server or encountering errors during the setup of the license server, this troubleshooting guide will help you resolve the issue.

Environment Details 

  • KeyShot
    • Any Version 

Resolution

Step 1: Check that your license server software is up to date. 

The latest server software is Luxion License Server v1.6. If you are unable to find the version number in the bottom left corner of your license server application, then we recommend running the update installer.


1. Download the Keyshot License Server tool from the links below.

Luxion License Server (Windows)
Luxion License Server (Mac)
Luxion License Server (Linux)

2. Run the installer. Click Yes if prompted and confirm.

3. Click Finish to complete the installation.

4. Click Start to restart your license service. If you receive a FlexNet warning, click OK.

If you are unable to launch the KeyShot License Server successfully, then we recommend setting up your license service with LMTools instead. For instructions on how to set up your service with LMTools, click here.

5. Click Server Status to check the status of your server. The status output will tell you how many licenses are issued and how many licenses are in use. Look for the following line:

Users of keyshot2: (Total of X licenses issued; Total of Y licenses in use)

Here X is the number of licenses available, and Y is the number of licenses in use.

  • If you see this message, then your license is properly set up and you can continue Step 4 below.
  • If you don’t see this message, then your license has expired or is not properly set up. Proceed to Step 2.

Step 2: Check license expiration and version.

1. Launch Luxion License Server.

2. Go to the Install License tab.

3. Under the License Info, find the FEATURE line(s):

FEATURE keyshot2 LUXION x.0 expiration 1 GROUP=UHD BORROW=720 \

Here, "x.0" is your license version. Your license will work with all previous versions of KeyShot up to version "x.0". Your license will also work with KeyShot x.1, KeyShot x.2, etc...For example, version 8.0 in the license file will support KeyShot 7 and KeyShot 8.2.

Here, "expiration" is your license's expiration date. If your license has expired or is outdated, please find, request, or purchase a new KeyShot Floating product key and request a replacement.

You can always request a copy of your most recent KeyShot Floating license from your software administrator, reseller, sales representative, or our fulfillment team at sales@keyshot.com.


Step 3: Check that the MAC address in your license file matches the expected MAC address.

1. Launch License Server.

2. Go to the Request License tab.

3. Make a note of the "MAC:" field. This is the expected mac address.

4. Go to the Install License tab and make sure that the mac address on the SERVER line matches the mac address ("MAC:") from step 3. You can also open your .lic file in any text editor and find the SERVER line:

SERVER hostname mac_address

Here "mac_address" should match the mac address ("MAC:") from step 3. The mac address in the license file always follows your computer's hostname.

  • If the MAC address does not match, then you may send us a change request.

Note: Most computers nowadays can connect via ethernet or wifi. If you change how the server connects to the rest of your network (including the internet), then your KeShot license service will go down. The reason is that each device has its MAC address and your license is tied to only one mac address. To bring the KeyShot license service back up, you can revert to your original connection or request a license change.


Step 4: Use different Port numbers on your computer.

1. Start the  License Server application.

2. Go to the  Install License Tab.

3. Click  Set Server Ports.
  • FlexLM Port: Change this to avoid port conflicts If you have other License servers running on the same machine. You can set this port to, say 27005, but any open port will do.
     
  • Daemon Port: This is only used for network setups with a Firewall. If a Firewall is used, both ports need to be set and opened in the Firewall. You can set this port to, say 1700, but any open port will do.

4. Click  OK.

5. Click  Reread License File to make sure the Changes are applied.

6. You can restart the service by clicking the  Stop/Start button.

Step 5: Open up ports on your firewall. It is important to open up the ports on the server, the client, and on any physical firewalls in your office network. If you're not sure, please consult with your IT administrator.


1. Launch the Windows Control Panel.


2. Go to Control Panel > System and Security > Windows Defender Firewall.


3. Click Advanced settings. A new window appears: Windows Defender Firewall with Advanced Security.


4. Select Inbound Rules on the left-hand side and then click New Rule on the right margin.


5. Select Port and click Next.


6. Make sure TCP is selected and type in the port numbers from step 4 above separated by a comma. Then click Next.


7. Make sure Allow the connection is selected and click Next.


8. Make sure all checkboxes are checked: Domain, Private, and Public. Click Next.


9. Set your rule's name, say "KeyShot Ports." You can also add a description (optional). Then, click Finish.


10. Repeat this process once more for Outbound Rules.


Step 6: Check that you have 'read and write' permissions into the Program Data folder. This is where the Luxion License Server saves your license file.


1. Open Windows Explorer and browse to C:\ProgramData\Luxion


2. Right-click the License folder and go to Properties > Security.


3. Make sure every group has read and write permissions and click Apply then click OK.


4. Try to re-install your license file inside the License Server. You can do this by clicking New License or Install License.

Additional Resources 

Once you have completed all the steps in this troubleshooting guide, you can proceed with the setup process by following the instructions in the installation video for KeShot Pro Floating.

For better assistance, please provide your LUXION.log file (from the License Server) and/or debug.log file (from LMTools). These files will help us troubleshoot and resolve any issues more effectively.