How to set up an RMI hostname for a censhare Render-Client and censhare Service-Client.


Introduction

In a multi-homed server environment, it might be necessary to configure an RMI hostname to bind censhare Render-/Service-Client to a specific interface.

Prerequisites

Properly installed censhare Render-/Service-Client

Steps

Windows

Edit censhare Render-Client.lap or censhare Service-Client.lap inside the client's program directory and add this line:

-Djava.rmi.server.hostname=<hostname>

Where <hostname> is the hostname or IP of the renderer.

Macintosh

Edit info.plist inside censhare Render-Client.app or censhare Service-Client.app and add or modify the following key/value pair in the Properties section.

For Java6 clients add it like this below dict tag:

<dict>
  <key>java.rmi.server.hostname</key>
  <string><hostname></string>
CODE

For Java8 clients add it like this below JVMOptions key in array :

<key>JVMOptions</key>
<array>
<string>-Djava.rmi.server.hostname=<hostname></string>
CODE

Where <hostname> is the hostname or IP of the renderer.

If you run the renderer as a service, the parameter java.rmi.server.hostname is transferred/entered automatically in the service on installation of the service. This means it must be defined already before installing the Renderer service.
Otherwise, you can add this later using RenderClient-ServiceManager.bat in tab "Java" within "Java Options".