# Retrieve Documents from a CMIS Server

To automatically retrieve content from a CMIS server, create a new fetch task by following these steps. The connector runs each fetch task automatically, based on the schedule that is defined in the configuration file.

To create a new Fetch Task

1. Stop the connector.
2. Open the configuration file in a text editor.

3. In the `[FetchTasks]` section of the configuration file, specify the number of fetch tasks using the `Number` parameter. If you are configuring the first fetch task, type `Number=1`. If one or more fetch tasks have already been configured, increase the value of the `Number` parameter by one (1). Below the `Number` parameter, specify the names of the fetch tasks, starting from zero (0). For example:

       [FetchTasks]
       Number=1
       0=MyTask

4. Below the `[FetchTasks]` section, create a new TaskName section. The name of the section must match the name of the new fetch task. For example:

       [FetchTasks]
       Number=1
       0=MyTask

       [MyTask]

1. In the new section, set the following parameters:

   `CmisUrl` | The base URL for the CMIS server. This URL is used to construct the URLs to use to obtain information about repositories on the CMIS server.

2. Specify the information that the connector should use to authenticate:

   Basic authentication | To authenticate using basic authentication, set the parameters `BasicUsername` and `BasicPassword`.
   Digest authentication | To authenticate using digest authentication, set the parameters `DigestUsername` and `DigestPassword`.
   NTLM authentication | To authenticate using Windows authentication, set the parameters `NTLMUsername` and `NTLMPassword`.
   Kerberos | To authenticate using Kerberos, set the parameters `GssName`, `GssPath`, and `EnableKerberos`.

   For more information about these parameters, refer to the CMIS Connector Reference.

3. (Optional) To restrict the content that is retrieved by the connector, you can set the following parameters:

   `RepositoryNameMustHaveRegex` | A Perl-compatible regular expression to restrict the repositories that are ingested by the connector. The full name of a repository must match the regular expression, otherwise the repository is ignored.
   `RepositoryNameCantHaveRegex` | A Perl-compatible regular expression to restrict the repositories that are ingested by the connector. If the regular expression matches the full name of a repository, the repository is ignored.

4. (Optional) To enable mapped security, set the `MappedSecurity` parameter:

   `MappedSecurity` | A Boolean value that specifies whether to enable mapped security. If you want to extract security information from the repository and add an Access Control List (ACL) to each document, set this parameter to `TRUE`.

5. Save and close the configuration file.

_FT_HTML5_bannerTitle.htm