Usage of Verity's rcvdk commandline search utility

One of the lesser know Verity utilities that ships with ColdFusion MX 7, as well as CFMX 6 and CF 5, is the search tool rcvdk. Unlike other utilities such as mkvdk and vspider, rcvdk must be run interactively so you can't script it. Its useful for times when you want to test searching a Verity collection by doing simple and advanced searches, and can be useful to see if the results match the equivalent search pattern in your code with CFSEARCH.

For additional detail, check out the ColdFusion MX 7 Documentation for rcvdk, and didump too.

Usage is a little tricky, and I'll walk you through how to use it from the commandline. In this case, I'm using Linux, but it behaves (almost) the same on Windows.

First note that the default locale is Englishx, for English Advanced, so when creating collections on the commandline with mkvdk or vspider, if you don't specify a locate then the collection is created as Englishx. When creating a collection from the ColdFusion Administrator, the default option is English Basic, which is the equivalent of just English. On the commandline, these options ar specified as either (lowercase) englishx or english.

Here's the contents of a test server having 3 collections already.

  • bookclub - a sample collection shipped with cfdocs
  • macr_verity_test2 - a collection created from the CF Administrator (english)
  • vspidertest3 - a collection created with vspider (englishx)


Usage of Verity's vspider utility with CFMX 7 on Unix or Linux

An article was published today that provides a fix for the Verity spidering utility known as vspider when used with ColdFusion MX 7. That article provides some additional style files will help populate the appropriate metadata fields of a collection such as Title, URL, Size, etc... The article also comes with an example of using vspider on Windows.

ColdFusion MX 7: Additional files for using Verity Spider

It should be noted that when running vpsider on Unix or Linux, that the environmental variable for LD_LIBRARY_PATH must also be set to include the location of core Verity binary files. Its often useful to create a script to set up all the vspider commands, and in that script you can set the LD_LIBRARY_PATH to include the Verity bin directory.