The
startCrawl
task starts acquisition from a data source.
When you acquire from a data source, the CAS Server automatically determines which acquisition mode is necessary. By default, the CAS Server attempts incremental acquisition, and it switches to full acquisition if any of the following conditions are true:
A data source has not been acquired before, which means no crawl history exists.
A Record Store instance that stores record output does not contain at least one record generation. This applies to the default case in which the CAS Server is configured to output to a Record Store instance rather than a file on disk.
Seeds have been removed from the data source configuration (adding seeds does not require full acquisition).
Filters have been added, modified, or removed in the data source configuration.
Repository properties have changed, such as the
username
property setting for CMS data sources.
In all other cases, the CAS Server acquires incrementally. However,
you may force full acquisition of a data source by specifying the
-full
option.
The syntax for this task is:
cas-cmd startCrawl -id CrawlName [-full] [-h HostName] [-p PortNumber] [-l true|false]
Where:
-full
(or--full_crawl
) specifies whether to force a full crawl. If unspecified, CAS Server runs an incremental crawl. Optional-id
(or--crawl_id
) specifies the ID of the acquisition to start. Required.-h
(or--host
) specifies the host where the CAS Service is running. If the flag is omitted, the default is the value of thecom.endeca.itl.cas.server.host
property incommandline.properties
. If the property is not set, the value then defaults tolocalhost
. Optional.-p
(or--port
) specifies the port of the CAS Service. If the flag is omitted, the default is the value of thecom.endeca.itl.cas.server.port
property incommandline.properties
. If the property is not set, the value then defaults to8500
. Optional.-l
(or--isPortSsl
) specifies whether to communicate with the service using an HTTPS connection. A value oftrue
uses HTTPS and treats thecom.endeca.itl.cas.server.port
property as an SSL port. A value offalse
uses HTTP and treatscom.endeca.itl.cas.server.port
as a non-SSL port. Specifyfalse
if you enabled redirects from a non-SSL port to an SSL port. Optional.
To start acquisition from a data source:
Example 8. Example of starting data acquisition from a data source
C:\Endeca\CAS\<version>\bin>cas-cmd startCrawl -id FileCrawl