Command Line Options
The following command-line options are supported by the ts3d_sc_server application:
Setting |
Description |
Notes |
---|---|---|
``–id `` |
This should be an identification string that can uniquely identify this invocation of the Stream Cache Server application. While the HOOPS Server application uses a standard UUID for this setting when it spawns a Stream Cache Server, no actual format for the string is enforced when not using the HOOPS Server. It is recommended that format be safe for URLs and filenames, especially if the liveliness reporting feature is used. |
Required: yes |
``–sc-port `` |
The port number that will be used for websocket communication with an associated HOOPS Web Viewer client. |
Required: yes |
|
A valid HOOPS Communicator license key must be specified. If this setting is omitted, then the |
One of either this setting or |
|
A filesystem path to a valid license file can be used in place of using the |
Required: One of either this setting or |
|
If set to true, then client-side rendering will be enabled. This setting is independent from |
Required: no, Default: true |
|
If set to true, then server-side rendering will be enabled. Note that if neither |
Required: no, Default: false |
|
For systems that have more than one GPU available, this value will indicate which GPU should be used if server-side rendering is enabled. The index value is zero-based, and should therefore be in the range 0 . If this setting is omitted, the system-defined default GPU will be used. |
Required: no, Default: system-defined |
|
When this option is enabled, EGL will be used to create the GL context if |
Required: no, Default: system-defined default |
|
Specifies a path to a file that will be used for diagnostic logging. The specified file should not be used simultaneously by any other Stream Cache Servers; therefore, we recommend using the unique identifier specified by the |
Required: no, Default: empty string |
|
Used to indicate which categories of logging information should be recorded into the log file as specified by |
Required: no, Default: info|error|warning |
|
Used to indicate which categories of logging information should be recorded to |
Required: no, Default: 0 (none) |
|
If true, log entries using delta time format, otherwise absolute time. |
Required: no, Default: true |
|
Specifies a time duration in floating-point seconds in which websocket activity from a HOOPS Web Viewer client is expected. If the duration is exceeded with no activity, then the Stream Cache Server will exit. Use ‘0’ to indicate no exiting due to inactivity. |
Required: no, Default: 15.0 |
|
Specifies one or more paths to directories that contain CAD models available for streaming. When more than one directory is specified, each directory should be separated by a single ‘;’ character. Example: ‘/models1;/data/models2;/models3’ |
Required: no, Default: empty string |
|
Path to a model file that will override any client-specified models. When specified, the Stream Cache Server will only stream the specified model regardless of any HOOPS Web Viewer model requests. |
Required: no, Default: empty string |
|
Specifies a path to a directory that will be used for any temporary files generated by the Stream Cache Server. |
Required: no, Default: empty string |
|
Specifies a token string that must match a token string supplied by any connected HOOPS Web Viewer, otherwise streaming will be disabled. There is no enforced format for this string, the server just requires it to simply match that provided by the HOOPS Web Viewer. An empty string for both the Stream Cache Server and HOOPS Web Viewer is the default and allows normal streaming. |
Required: no, Default: empty string |
|
Specifies a path to an SSL Certificate file, which is necessary to enable the secure websocket protocol (wss) with any connected HOOPS Web Viewer. To use SSL, a private key must also be specified with |
Required: no, Default: empty string |
|
Specifies a path to an SSL Private-Key file, which is necessary to enable the secure websocket protocol (wss) with any connected HOOPS Web Viewer. To use SSL, a certificate must also be specified with |
Required: no, Default: empty string |
|
Specifies a base URL indicating where to report liveliness. Liveliness updates will be sent as an empty HTTP POST request to /?liveliness= where the liveliness value can be |
Required: no, Default: empty string |
|
Determines how often (in seconds) the liveliness state will be reported when |
Required: no, Default: 5.5 |
|
When specified as ‘true’, the Stream Cache Server will automatically exit after the first requested model has finished streaming. |
Required: no, Default: false |
|
Specifies the amount of time in milliseconds that the Stream Cache Server will idle during its processing loop. A value of ‘0’ will cause no idling, which may help streaming performance slightly but will likely cause the application to continuously consume a high amount of CPU resource. Larger values will cause longer idling, which will reduce performance but also reduce overall CPU usage. |
Required: no, Default: 10 |
|
When set to |
Required: no, Default: false |
|
This setting is useful when running the stream-cache server as a Windows Service and needing SSR support. A process spawned normally by a Windows Service will not have access to the GPU, and thus for this application would not be able to support SSR mode. However, when this setting is |
Required: no, Default: false |
|
When |
Required: no, Default: empty string |