How To: Set Up Satellite Rendering
| Table of contents |
On each satellite computer, install XSI
When you run the Setup:
- Select the Custom Install option, and then select Configure distributed rendering services. When you get to the "TCP/IP port configuration for distributed rendering" dialog box, select the Configure satellite distributed rendering check box, and then click OK.
- Make a note of the port number that will be used for satellite rendering.
- Select Using a license server running on another computer, and then enter the name of the computer where you have the License Manager and the dongle installed.
On the master computer, install the rendering services
If you installed the rendering services when you installed XSI, you can skip this section.
- Click Start > All Programs > Softimage Products > SOFTIMAGE XSI 6.5 > Setup.
- Click Modify and click Next.
- Select the "Configure distributed rendering services" check box. Leave the "Softimage XSI" check box selected.
- Click Next.
- The "TCP/IP port configuration for distributed rendering" dialog box appears.
- By default, "Configure satellite distributed rendering" should be selected.
- Make a note of the port number.
- Click OK
Check that the raysat services are running
The raysat services have to be running on the master and the satellites.
You can use the Services console to check whether the raysat service is running:
- Click Start, click Run, type services.msc, and click OK.
- Scroll down the list of services until you see the RaySat service.
You can start the service from the Services console, or from the command line.
If you don't see the raysat service, try installing it:
- Click Start > All Programs > Softimage Products > SOFTIMAGE XSI 6.5 > Command Prompt. - In the command prompt, run this command: raysat3_5_7_23server /install.
Create a .ray3hosts file on the master computer
Create the .ray3hosts file in your User folder (for example, in C:\users\burton\Softimage\XSI_6.5).
A .ray3hosts file lists the satellite computers in the format hostname:port. For example:
#Satellites suda:7003 kima:7003 tamu:7003
You can find the port numbers in C:\windows\system32\drivers\etc\services.
Scroll down to the bottom of the file and look for a line that looks like this:
mi-raysat3_5_7_23 7003/tcp #
Render something
In XSI, turn on Progress messages in the mental ray Diagnostics
- For the render region: click Regions > All Options, click the Diagnostics tab, and under Logged Messages, click Progress.
- For renders, click Render > Renderer Options and go to the Diagnostics tab.
Now render something.
If satellite rendering works, you'll see something like this in the history log:
// INFO : JOB 0.3 progr: 6.2% rendered on KIMA.3 // INFO : JOB 0.4 progr: 12.5% rendered on KIMA.4 // INFO : JOB 0.n progr: 18.7% rendered on TAMU.3 // INFO : JOB 0.n progr: 25.0% rendered on TAMU.1 // INFO : JOB 0.n progr: 31.2% rendered on TAMU.0 // INFO : JOB 0.n progr: 37.5% rendered on TAMU.2 // INFO : JOB 0.n progr: 43.7% rendered on TAMU.1 // INFO : JOB 0.4 progr: 50.0% rendered on KIMA.4 // INFO : JOB 0.5 progr: 56.2% rendered on KIMA.5 // INFO : JOB 0.n progr: 62.5% rendered on TAMU.0 // INFO : JOB 0.n progr: 68.7% rendered on TAMU.0 // INFO : JOB 0.6 progr: 75.0% rendered on KIMA.6 // INFO : JOB 0.4 progr: 81.2% rendered on KIMA.4 // INFO : JOB 0.n progr: 87.5% rendered on TAMU.1 // INFO : JOB 0.6 progr: 93.7% rendered on KIMA.6 // INFO : JOB 0.n progr: 100.0% rendered on TAMU.0
In the above, KIMA and TAMU are the names of the satellite computers. The .0 and .6 are threads.
Basic Troubleshooting
Check network connections between machines
Before you start, you want to check that the master can connect to the slaves. Open a command prompt and run the command
ping <hostname of slave>
or
ping <ip address of slave>
If you don't know the hostname or IP address of a slave, go to the slave and use the hostname and ipconfig commands to find out.
Check connections to the raysat service
The port used by the raysat service is specified in the services file:
C:\Windows\System32\drivers\etc\services
Scroll down to the bottom of the file and look for a line that looks like this:
mi-raysat3_4_6_18 7007/tcp #
To test that the master can connect to the satelliteon a port, run this command on the master:
telnet <satellite_hostname> <port>
If telnet can connect, you'll get a blank command window. Press Ctrl+] and then type quit. Otherwise, you'll get something like this:
C:\Softimage\XSI_5.11\Application\bin>telnet tamu 7009 Connecting To tamu...Could not open connection to the host, on port 7009: Connect failed
If the connection fails, it is often because of a firewall.
=Check Licensing
Check that the satellite computers can connect to the license. The easiest way to do this is to start XSI.
The location of the license server is specified by the SPM_HOST environment variable, which is set by setenv.bat.
