roc-serve

Start a server for host remote access.

Calls either roc_start_floating_license_server, roc_start_gallery_server, roc_start_database_server or roc_start_template_pipe_server depending on the command line arguments.

See Floating License Server for details about this specific server.

Options

Option	Meaning	Default
-c <certificate>	Path to the certificate file for SSL/TLS encryption	Unencrypted connection
-f <log_file>	Log connection information and usage to the specified file	Don't log connection information and usage
-d <database_path>	Start a database server	Start a floating license server
-g <gallery_file>	Start a gallery server	Start a floating license server
-l	Log connection information and usage to stdout	Don't log connection information and usage
-n	Start a compute server	Start a floating license server
-p <private_key>	Path to the private key file for SSL/TLS encryption	Unencrypted connection
-t <gallery_file>	Start a template pipe server	Start a floating license server
-u	Gallery Updating	Don't monitor for updates
–http	Requests and responses are HTTP messages, see Web API	Requests and responses are size-prefixed ProtoBuf messages
--sender-id	Transmission identifier unique to this application	roc_uuid_get_random

Gallery Updating

When serving a gallery and update is enabled, a separate thread will monitor the parent folder of the current gallery file for new gallery files ending with the .t file extension. When a new gallery file is discovered, the new gallery is opened, and new connections operate against it. When all connections referencing the original gallery are closed, the original gallery file is deleted.

Note

Since it may take a while to copy the new gallery file, and this application may attempt to open it before the copy completes, users should first copy it elsewhere to the physical device, and then move it to the parent folder such that the transfer appears atomic.

Examples

Show help

Print application usage and supported arguments.

$ roc-serve -h 

Run an encrypted license server

Run the license server on port 1234 using private key my.key and certificate my.cert.

$ roc-serve 1234 --private-key my.key --certificate my.cert 

Run an unencrypted license server

Run the license server on port 1234 without encryption. Client license files must be configured without encryption for this to work.

$ roc-serve 1234 

Run a gallery server

Serve the gallery faces.t with logging for remote access via roc_open_gallery.

$ roc-serve 6688 --gallery faces.t --log-stdout