Media Server 25.4
Media Server Help

# Start Processing

To start processing, send the Process action to Media Server.

Media Server adds your request to the `process` action queue. When the request reaches the top of the queue and a thread is available, Media Server starts to ingest the media and perform the configured tasks.

To start processing

- Send the `process` action to Media Server.

  From the following list of parameters, you must set either `Source` or `SourceData` to specify the source, and `Config`, `ConfigName`, or `ConfigPath` to specify the configuration to use.

  - - `Source` | The media source to process. Specify one of the following: a path to a file residing on a file system that Media Server can access. the URL of a stream. the name of a DirectShow video device (to ingest video from a DirectShow source, such as a capture card). to ingest video from Milestone XProtect: a camera name (not supported with XProtect Corporate when you set `MilestoneDirectory`). a camera UUID. (Milestone XProtect Corporate only) a camera UUID followed by a stream ID, in the following format:
          id:camera_uuid,streamid:stream_id
  If your camera produces multiple streams and you do not specify a stream ID, Media Server ingests the stream that is configured as the default in the Milestone XProtect system. to ingest video from Genetec Security Center, specify a camera logical ID.
  `SourceData` | The media file to process (as binary data). For information about sending data to Media Server, see Send Actions to Media Server.
  `Persist` | Specifies whether the action restarts in the event that processing stops for any reason. For example, if you are processing video from an RTSP camera which becomes unreachable and `persist=true`, Media Server will wait for the stream to become available again. Persistent actions only stop when you stop them using the `QueueInfo` action with `QueueAction=stop`, or when Media Server finishes processing the media.
  `Config` | A session configuration to use (base64 encoded, unless you upload it as multipart form data).
  `ConfigName` | The name of a session configuration file that defines the tasks to run. The file must be stored in the directory specified by the `ConfigDirectory` parameter in the `[Paths]` section of the configuration file.
  `ConfigPath` | The path of a session configuration file that defines the tasks to run. Specify an absolute path or a path relative to the Media Server executable file.

  For example,

      http://localhost:14000/action=Process&Source=.\video\broadcast.mpeg
                                           &ConfigName=broadcast

  This action is asynchronous, so Media Server returns a token for the request. You can use the `QueueInfo` action, with `QueueName=Process` to retrieve more information about the request.

Copyright 2025 Open Text
Version 25.4 | Last updated October 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Media Server 25.4

Topic Title: Start Processing