This troubleshooting guide assumes that you have already set up your KeyShot Network Rendering software according to the Getting Started Setup Guide. If not, please follow the step-by-step setup guide before you continue. You may also follow along with the KeyShot Network Rendering Installation video.
- The Monitor application on the end user's computer cannot connect to the Master service
- The Slave nodes cannot connect to the Master service
- Rendering jobs/requests are getting stuck or they are failing.
Step 1: Check that the Master is properly licensed.
1. Log into the computer acting as the network’s Master.
(According to the software manual, the Master is in charge of receiving rendering requests, delegating rendering tasks, and making sure that renderings are processed in the order received.)
2. Launch the Keyshot Network Configurator application and go the Master tab. Make sure that "Enable master mode" is checked.
3. At the bottom of the section titled “Master License” you should see the following message:
The current floating license can utilize X cores and will expire in Y days.
Here, X is the maximum core allowance and Y is the number of days before your license expires.
- If you see this message, then your license is properly set up and you can continue to the next step.
- If you don’t see this message, then your license has expired or is not properly set up. Find, request, or purchase a new KeyShot Network Rendering product key and register it according to the license registration instructions.
You can always request a copy of your most recent KeyShot Floating license from your software administrator, reseller, your sales representative, or our fulfillment team at email@example.com.
Step 2: Enable the Slave service on your Master and on your Slave nodes.
Enabling the Slave service on your Master is a quick way to check if the Slave-to-Master connection is set up properly. After all, the slave service should be able to see the master service running on the same computer.
1. Stay logged into the Master and keep KeyShot Network Configurator open. Click the Slave tab on the left and check the Enable slave mode checkbox.
2. Enter the Master’s IP Address in the field labeled Master hostname (empty for autodetection).
3. Make sure that the Slave port value in the Slave tab matches that Slave port value in the master’s configuration. This should be 4798 by default.
4. Click Close and restart services (bottom left). Save service changes if prompted.
5. Repeat this process on all your Slave nodes (these are computers that will be processing your rendering requests). Please note that there can only be one Master service in your entire network. Do NOT enable the master service on any other computer.
Step 3: Disable Monitor auto-detection on the Master and on all of your designers' computers
1. Staying logged into the Master computer, launch the KeyShot Network Monitor application.
2. Go to File > Connection Settings. The Connection Settings dialog appears.
3. Disable “Auto detect master” and type in the Master’s IP Address in the field labeled Master hostname.
4. Make sure that the Monitor port value is the same as on your Master configuration. This is your Monitor-to-Master connection. This port should be set to 4797 by default.
5. Click Apply and your Monitor will connect to your Master computer.
6. Disable auto-detection and set the Master’s IP Address for KeyShot Network Monitor on all of your designers’ computers.
Step 4: Make sure that Slave nodes are listed in the Slave Status window.
1. With KeyShot Network Monitor open on your Master (or any other computer, really), click Slave Status.
2. Make sure that your Slave nodes appear under the Slave Status list. They should be listed by their hostname and/or IP Address.
- As long as your Slave Status window contains at least one Slave node then your network is properly set up and should process your requests.
- If the Slave Status window is empty, then go back to Step 2 and Step 3. Make sure the slave service has been set up properly and that your monitors are pointing to your master's IP address.
- If the Slave Status window contains Slave nodes and you are still experiencing trouble, continue to the next step.
Step 5: Clear the queue and restart the master.
1. Access the computer acting as the network master.
2. Launch KeyShot Network Configurator and go to the Master tab. Then, click Stop to stop the Master service.
3. Open your file browser and browse to KeyShot Network Resources > Master. On windows, the resources folder is found here: C:\Users\Public\Public Documents\KeyShot Network Resources.
On a Mac it would be under Macintosh HD\Library\Application Support\KeyShot Network Resources.
4. Delete all subfolders and files under the Master folder except for the master.db file. These are all the jobs in the queue (done and in-progress).
5. Go back to the KeyShot Network Configurator application and click Close and restart services.
6. Try to render once more.
- Clearing the queue should allow you to render without a problem.
- If the problem continues, please submit a support case at firstname.lastname@example.org. Please be sure to attach the problem scene, saved as a KSP file (File > Save Package), to your email.
Below you will find the most common misconceptions associated with KeyShot Network Rendering.
- Users often confuse the Slave-to-Master connection with the Monitor-to-Master connection. These are two separate connection channels. The diagram on the About page better illustrates this concept. Click here to view this diagram.
- Users also confuse the KeyShot Network Monitor application with the Master or the Slave services. While the KeyShot Network Monitor does show you your job queue and allows to control certain aspects of your network, it is not the Master service itself. Instead, you should think of the Monitor application as a window that allows you to check on what your network is doing.
- Connecting the Monitor to your Master is not the same as connecting your Slave nodes to your master. The Monitor-to-Master connection is set within KeyShot Network Monitor while the Slave-to-Master connection is set within KeyShot Network Configurator.
If you are still confused about the different nodes within KeyShot Network Rendering, we suggest reading the "Install" section within the Getting Started Setup Guide. You may also send us your questions at email@example.com.