# ViDi Suite Service Application – Command Line Arguments

There are several command line arguments that can be used with the ViDi Suite Service application. The following commands can be used to specify the location of workspaces, port numbers for training and runtime, and GPU usage:

Command | Description
--- | ---
--http-address=http://address:port | Specifies the HTTP address that the server will listen to for training requests. The default is http://localhost:8080.
--workspace-path=file path | Specifies the directory location where the workspace will be saved.
--training-image-cache-path=path | Specifies the path where training images are stored for use in multiple training passes, improving training performance and minimizing I/O incurred when opening images. Designating a specific path is especially helpful in these cases: If an image conversion is needed (for example, when JPG or PNG formats are used or color-to-greyscale conversion is needed). If the workspace directory is on a slow device or remote file system and the specified path is on a fast, local device, such as a solid state drive. Note: Ensure that the path you specify is located on a device with enough free storage to completely cache all of the training images. If a large number of PNG or JPG images are used, the needed storage space can be several times the size of the workspace directory.
--training-workspace-path=file path | Specifies the directory location in which to load and save workspace files.
--runtime-workspace-path=file path | Specifies the directory location in which to load and save runtime workspace files.
--enable-runtime=[0 or 1] | Specifies whether or not to start the runtime service and listen for runtime requests. This is disabled by default.
--runtime-only | Starts a runtime-only service that only listens for connections to the runtime API. Note: This option conflicts with the --workspace-path and --training-workspace-path commands. The auto-save feature does not apply to runtime workspaces. Therefore, if the --runtime-only command is activated while the --auto-save-internal command has been set, the auto-save feature will be ignored.
--optimized-gpu-memory=memory size, in MB | Specifies the size of the pre-allocated optimized memory buffer. This setting is activated by default, with the default size of ⅔ the available amount of GPU memory. To deactivate the feature, first issue the --optimized-gpu-memory-override=1 command, and then --optimized-gpu-memory=0 command. To use a memory buffer size other than the default setting, first issue the --optimized-gpu-memory-override=1 command, and then the --optimized-gpu-memory=<memory size in MB> command. Note: The GPU Memory Optimization setting is enabled by default. For more information about the functionality, see the GPU Memory Optimization topic.
--optimized-gpu-memory-override=[0 or 1] | If using the --optimized-gpu-memory setting, set to 1. If set to 0, the default amount of memory will be allocated.
--gpu-devices=comma separated indexed list of GPUs | Specifies the GPUs that will be used on initialization, via an indexed list. For example: --gpu-devices=0,1
--gpu-mode=NoSupport or SingleDevicePerTool or MultipleDevicesPerTool | Specifies the GPU mode that will be used by the ViDi Suite Service application.
SingleDevicePerTool | A single GPU is used for the analysis of the tool. When using multiple GPUs, the processing time of a single image remains the same, but multiple images can be processed concurrently on different devices.
MultipleDevicesPerTool | For use with the Red Analyze tool, this mode offers the potential of speed increases (in terms of single-image processing latency). Image analysis will be split among multiple GPUs.
NoSupport | Specifies that a GPU will not be used. Note: This option conflicts with --gpu-devices and/or --optimized-gpu-memory.
Note: See the Multithreading topic for more information about the GPU modes.
--auto-save-interval=duration in minutes | Specifies an amount of time between auto-saves of workspaces. The default is 5 minutes. Set to -1 to never auto-save. Note: The auto-save feature does not apply to runtime workspaces. Therefore, if the --runtime-only command is activated while the --auto-save-internal command has been set, the auto-save feature will be ignored.
--activate-debug-logs=[0 or 1] | Activates logging for debugging purposes.
--help | Used to return a list of command line options.
--version | Requests version information.