.png)
docpush reference
Published: May 12, 2010
docpush is a test and diagnostics tool that you can use to feed a single item into a Microsoft FAST Search Server 2010 for SharePoint farm. You can also use the tool to delete single items from the index.
docpush has two modes of operation:
-
Redirect mode, enabled with the -r option
-
Direct mode, which is enabled by default
Use redirect mode (-r) to specify one or more relative file system references to have the DocumentRetriever item processing stage in the processor server download the items. Redirect mode assumes that all running processor servers have access to the specified file system reference, e.g. through a mounted share if the processor servers are running on a different network host.
You must specify one or more file references or URIs after the global options.
Note:
|
|---|
|
To use a command-line tool, verify that you meet the following minimum requirements: You are a member of the FASTSearchAdministrators local group on the computer where FAST Search Server 2010 for SharePoint is installed. |
<FASTSearchFolder>\bin\docpush [global options] <file or URI> ... <file or URI>
Parameters
| Parameter | Description |
|---|---|
|
<file or URI> ... <file or URI> |
Specifies the files or URIs to feed. |
|
<FASTSearchFolder> |
The path of the folder where you have installed FAST Search Server 2010 for SharePoint, for example C:\FASTSearch. |
docpush global options
| Option | Value | Required? | Description | ||
|---|---|---|---|---|---|
|
-h |
|
No |
Displays help information. |
||
|
-v |
|
No |
Displays version information. |
||
|
-c |
<collection> |
Yes |
Specifies the content collection name. A collection called sp is created when FAST Search Server 2010 for SharePoint is deployed. |
||
|
-r |
|
No |
Uses redirection instead of reading and submitting the file content directly. docpush will send a reference to the file or item as a URI instead of reading the content locally and submitting it directly.
|
||
|
-g |
|
No |
Redirection prefix. This specifies a common file prefix that is typically used when several file references are specified for submission. Default: file:/<current directory>/ |
||
|
-u |
<URI prefix> |
No |
Specifies a URI prefix that is prepended to a file name reference and used as the item ID when the file is submitted. Used with direct mode only. Default: http://cohowinery.com/
|
||
|
-U |
|
No |
Pushes URIs on the command line. Redirect mode (-r) is automatically enabled with this option. The URI specifies the item ID and the getpath item attribute for the operation that is fed to the system. No local content/files are required when this option is used. |
||
|
-d |
|
No |
Deletes an item, instead of pushing it. |
||
|
-b |
<number of documents> |
No |
When several items are pushed at the same time, sends them as a batch with the specified number of items in each batch. |
||
|
-C |
<callback> |
No |
Specifies the last callback in the feeding chain to wait for. The callbacks available in the default feeding chain are as follows:
|
||
|
-V |
|
No |
Enables verbose output. |
||
|
-l |
<debug level> |
No |
Sets the debug level. Valid options are as follows:
|
Examples
The following example submits the URI http://cohowinery.com to the sp collection (the DocumentRetriever item processing stage will download the item referenced by the URI):
<FASTSearchFolder>\bin\docpush -c sp -U http://cohowinery.com
This example feeds the file c:\test.txt to the sp collection:
<FASTSearchFolder>\bin\docpush -c sp c:\test.txt
The following example reads the file test.txt in the current directory and feeds it to the sp collection:
<FASTSearchFolder>\bin\docpush -c sp -r test.txt
To read the file c:\test.txt and feed it to the sp collection with an absolute prefix of file:///, follow this example:
<FASTSearchFolder>\bin\docpush -c sp -r -g file:/// C:\test.txt
