Startup Switches

-noproxy

Turns off image map caching to the local system. The proxy option is active by default. Proxy system fetches referenced texture maps (and other required image files), which cannot be directly found from the given search paths. The files are transferred in the native compressed form and saved to a temporary subfolder in the user's document folder. This has certain advantages:

Proxy feature checks file sizes and dates and updates the cache automatically if necessary.

[Note] Note
To utilize proxy feature maximally, remove all search paths from the rendering daemon. Then all textures will end up into the local temp folders.

-proxycleanup

This option controls the proxy cleanup system. The temp folder is checked frequently and files older than the given amount of days are removed. The default value is 30 - the average lifetime of image files in temp folder is one month.

[Note] Note
Do not place important files into the temp folder! Proxy cleanup will delete all outdated files.

-threads [num]

Specifies the number of rendering threads spawned for each rendering request. The default value is the number of processors in the workstation.

-clients [num]

Specifies the maximal amount of clients, which will be served simultaneously. The default amount 1 is suitable for single user network rendering. In a multi user network, the daemon stops spawning new rendering threads soon as the defined client count is reached. The clients attempting to get rendering service from the fully occupied daemon will receive a failure code (which normally just eliminates the server from that particular rendering job but does not stop rendering, provided that other vacant rendering threads will be available).

-help

Prints out brief instructions for use.

-plugins [foldername]

Specifies a custom plug-in folder for the rendering daemon. The default folder is 'Plugins' (in the program's home folder).

-xboxcount [num] -yboxcount [num]

In order to distribute a rendering task, rendering daemons must subdivide the image to a number of sub images. Each sub image is then rendered by a separate local thread or a sub daemon. When all sub images are ready, they are combined and returned back to the client. The box count parameters can be passed to override the automatic box count detection system.

Note that the sub image count should always be higher than the number of rendering threads and sub daemons available. For example, if -threads is 2 and 4 external workstations are used as sub daemons, then the recommended box count is 6 or more. A good choice could be 6 multiplied by 4, because rendering speed varies over the image area (an empty black corner renders instantaneously whereas a sub image including a glass object is much slower to render). A suitably high box count adapts better to such variations and keeps all processors busy. On the other hand, there is some overhead in managing the sub images - a very high number of boxes can start slowing down rendering.

If the user does not define any box count, the program estimates an optimal amount from the number of rendering threads and sub servers.

-paths [path1;path2;..]

This option allows you to define daemon side texture paths, which are used for resolving texture names.

[Note] Note
When using the texture proxy option, the texture paths should not refer to folders in external hard drives. An image is fetched to the proxy cache only if it is not found otherwise. Therefore, too extensive search paths may prevent proxy operations. The result is increase in network traffic. Search paths may safely include local texture libraries. For example, the local temp folder is automatically included in search paths.

-host [hostname] -port [port number]

These switches specify the host name and the port number used for connecting to this daemon. The default host name is the hostname of the workstation. However, sometimes you may need to override the default name, for example to make the daemon accessible through the internet.

The default port number is 10050. You may need to override the default port number in case the port is already used for something else.

-autodet

Enables the Automatic Sub Servers feature, which is useful when configuring hierarchical rendering farms. When enabled, the rendering daemon searches the network and automatically connects to all sub servers available.

-mem [bytes]

This switch is considered when the daemon is accessed by a client using Automatic Network Rendering. The value specifies how much memory this system can consume in rendering. All project files, which need more memory, will not be sent to the server. The default value for this parameter is the amount of the physical memory.