Media Server 25.1
Media Server Help

# ValidateProcessConfig

Checks whether a session configuration is valid, but does not start processing.

Type: synchronous

Parameter | Description | Required
--- | --- | ---
AdditionalData | Additional files to upload. If your session configuration requires a file, such as a Lua script or XSL transform, that is not available on the Media Server file system, you can upload it with the process action. Send files to Media Server using a multipart/form-data HTTP POST request. | No
AdditionalDataLabels | A comma-separated list of labels to identify the files uploaded using the `AdditionalData` parameter. Specify a label for each file that you upload. You can use these labels in your session configuration instead of file paths. | No
Config | A session configuration to validate (base64 encoded, unless you upload it as multipart/form-data). | Set `Config`, `ConfigName`, or `ConfigPath`.
ConfigName | The name of a session configuration file to validate, when the file is stored in the ConfigDirectory.
ConfigPath | The path of a session configuration file to validate. To strengthen security, Media Server can be configured to read files only from specified directories. For information about the directories that Media Server is permitted to read from, see the parameter AllowedInputDirectories.
`DatabaseChecks` | A Boolean value (default false) that specifies whether to fail validation when a trained model (for example an image classifier or object class recognizer) is specified in the configuration but does not exist in the database. | No

## Example

To validate the configuration `facedetect.cfg`, which is stored in the directory specified by the ConfigDirectory parameter:

       /action=ValidateProcessConfig&ConfigName=facedetect

## Response

An example response appears below.

The `processable` element contains a Boolean value that indicates whether the configuration could be used to start processing. The value `true` indicates that there were no fatal errors. If you have used deprecated configuration parameters or the configuration contains unused parameters these are listed in the `errors` element of the response but are not considered to be fatal errors.

A value of `true` does not guarantee that processing will succeed, because this might depend on the source media and whether resources (such as a Content component) are available. If the configuration sends records to another Media Server, the action does not validate configurations on the downstream server.

If errors are detected, they are described in the `errors` element of the response.

The `engines` element contains information that a user interface could use to draw the engine graph (the engines used in the session configuration and the connections between them). It also includes an XML schema for each output track. For more detailed information about the data types, use the action GetTypeSchemas.

    <autnresponse>
      <action>VALIDATEPROCESSCONFIG</action>
      <response>SUCCESS</response>
      <responsedata>
        <processable>false</processable>
        <errors>
          <autn:filepath>ConfigErrors.cfg</autn:filepath>
          <autn:section>
            <autn:sectionname>FaceDetect</autn:sectionname>
    	 <autn:comment></autn:comment>
    	 <autn:key>
    	   <autn:keyname>NUMPARALLEL</autn:keyname>
    	   <autn:keyvalue>NOTANINT</autn:keyvalue>
    	   <autn:comment>//Wrong type detected. Expected type: int</autn:comment>
    	 </autn:key>
          </autn:section>
        </errors>
        <validated_fields>
          <autn:filepath>ConfigValid.cfg</autn:filepath>
          <autn:section>
            <autn:sectionname>Ingest</autn:sectionname>
    	 <autn:comment></autn:comment>
    	 <autn:key>
    	   <autn:keyname>IngestEngine</autn:keyname>
    	   <autn:keyvalue>In</autn:keyvalue>
    	   <autn:comment>//Type: string</autn:comment>
    	 </autn:key>
          </autn:section>
          <autn:section>
            <autn:sectionname>In</autn:sectionname>
            <autn:comment></autn:comment>
            <autn:key>
              <autn:keyname>Type</autn:keyname>
              <autn:keyvalue>video</autn:keyvalue>
              <autn:comment>//Type: string</autn:comment>
            </autn:key>
          </autn:section>
          ...
          ...
        </validated_fields>
        <original_config>
          <autn:filepath>C:\mediaserver\configurations\facedetect.cfg</autn:filepath>
          <autn:section>
            <autn:sectionname>Ingest</autn:sectionname>
            <autn:comment></autn:comment>
            <autn:key>
              <autn:keyname>IngestEngine</autn:keyname>
              <autn:keyvalue>In</autn:keyvalue>
    	   <autn:comment></autn:comment>
            </autn:key>
          </autn:section>
          ...
          ...
        </original_config>
        <engines>
          <engine name="Source" type="Video" category="Ingest">
            <outputTrack trackName="Source.Proxy">
               ...
            </outputTrack>
            <outputTrack trackName="Default_Image">
               ...
            </outputTrack>
            <outputTrack trackName="Default_Audio">
               ...
            </outputTrack>
            <outputTrack trackName="Default_Closed_Caption">
               ...
            </outputTrack>
          </engine>
          <engine name="FaceDetection" type="FaceDetect" category="Analysis">
            <inputTrack input="Input" trackName="Default_Image" connectedEngine="Source"></inputTrack>
            <outputTrack trackName="FaceDetection.Data">
              <xs:schema>
                <xs:complexType name="FaceResult" mixed="false" abstract="false">
                  <xs:sequence>
                    <xs:element name="id" type="mediaserver:UUIDData"/>
                    <xs:element name="face" type="mediaserver:FaceData"/>
                  </xs:sequence>
                </xs:complexType>
              </xs:schema>
            </outputTrack>
            <outputTrack trackName="FaceDetection.DataWithSource">
              ...
            </outputTrack>
            ...
          </engine>
          ...
        </engines>
      </responsedata>
    </autnresponse>

## See Also

- You can start processing with the Process action.

Copyright 2024 Open Text
Version 25.1 | Last updated January 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.1

Topic Title: ValidateProcessConfig