## On this page

  

 

 # DVS Server

 Last update: 16.07.2025 

DVS Server used to receive data from DVS Clients.

DVS Server used to receive data from DVS Clients.

DVS Servers receive data from the DVS Clients. A server can be ran as part of the postprocessing package (such as EnSight) or within any process as it is part of the DVS API. A server object is always used by the client to connect to a server (if starting a server locally it must be started before connecting with the client). However this server object is only a shell/proxy object unless it is started using [dvs\_server\_start()](dynamic__visualization__store__api_8h.html#aa5722a5316ee73bdd998c9a327e8cb3d "Start a Dynamic Visualization Store server in a separate thread to receive data from solver node.") or [DVS::IServer::startup()](class_d_v_s_1_1_i_server.html#a6699cf48b29583ab3391b9b8397e611c "Start the server."). If a server isn't started it is assumed another process/thread has started it and it is only used for connecting the client to the real server.

## <a class="anchor" id="dvs_server_options"></a>Server Options

Server options are specified by the C API call [dvs\_server\_set\_option()](dynamic__visualization__store__api_8h.html#ae8abdb8455cea44bbd9f509c1a063516 "Add an option to the server."), or the C++ API call [DVS::IServer::set\_option()](class_d_v_s_1_1_i_server.html#a1edb4dec67086f10bc0329b6adf9084c "Set a specific option on the server, these are used during startup See See Server Options.").

Server Option Default Description CACHE\_URI None A URI used to specify cache type, location and filtering options. See [Cache URIs](group__group__dvs__uri.html#dvs_cache_uri) for more information. SERVER\_PORT\_BASE 50051 The base port to use for a group of servers. Used with SERVER\_PORT\_MULT to determine the port to listen to. i.e. SERVER\_PORT\_BASE + (server\_num \* SERVER\_PORT\_MULT). SERVER\_PORT\_MULT 0 The multiplier to use with server number to increase SERVER\_PORT\_BASE by. i.e. SERVER\_PORT\_BASE + (server\_num \* SERVER\_PORT\_MULT). SERVER\_SECURITY\_SECRET None The secret string to use for a client to connect to this server. If none is specified no secret is needed by the client. ENABLE\_DYNAMIC\_SOURCE True Used to force the server into waiting for external data or not. If false only reads from the specified cache. VERBOSE 0 Verbosity level of the server, Min 0, Max 3. DVS\_FILE\_LOCATION Cache location Set the location for the dvs files created when creating datasets. This can be a fully qualified pathname or relative to the root of the cache specified by the CACHE\_URI. The internal link stored in the file pointing to the cache location is also controlled by if the DVS\_FILE\_LOCATION is a fully qualified pathname or relative. If it is fully qualified the link will be fully qualified. Allowing you to move the dvs file around with the cache staying in a static location. If the DVS\_FILE\_LOCATION is relative, then the internal link will be relative to the cache location. This will allow you to move the cache and dvs files around together and they will still work (recommended). GRPC\_MAX\_NUM\_RETRIES 3 Sets the maximum number of retries to use if using GRPC. This setting can help if having problems with too many clients going into a small number of servers. This should be used in conjunction with GRPC\_BACKOFF\_MIN\_MS and GRPC\_BACKOFF\_MAX\_MS GRPC\_BACKOFF\_MIN\_MS 100 The minimum time to wait before attempting a retry GRPC\_BACKOFF\_MAX\_MS 1000 The maximum time to wait before attempting a retry, the current algorithm is linear and increments each retry by GRPC\_BACKOFF\_LINEAR\_MS until reaching either the maximum number of retries \* GRPC\_BACKOFF\_LINEAR\_MS or GRPC\_BACKOFF\_MAX\_MS GRPC\_BACKOFF\_LINEAR\_MS 100 The linear amount to increment the backoff timer for each retry