TechNote (Archived)

ColdFusion MX 7: Additional files for using Verity Spider

Issue

Macromedia ColdFusion MX 7 creates Verity collections that can be indexed using cfindex or through the ColdFusion Administrator. These collections cannot be indexed by the Verity Spider utility (vspider).

This TechNote provides additional files needed to allow ColdFusion Verity collections to be indexed using the Verity Spider utility, along with instructions to create a collection suitable for indexing with Verity Spider.

Note: If ColdFusion MX 7.0.1 or 7.0.2 is installed, you do not need to download these files. The additional files are already included in ColdFusion MX 7.0.1 and 7.0.2. The remainder of the information in this TechNote applies to both ColdFusion MX, ColdFusion MX 7.0.1, and ColdFusion MX 7.0.2.

Solution

These instructions apply to both Windows and Unix platforms.

The specific examples are for ColdFusion MX 7 installed in the Server configuration to the default location on Windows. The directory where ColdFusion MX 7 is installed is cf_root. For example: C:\CFusionMX7

To prepare ColdFusion MX 7 to index collections using Verity Spider:

Download cf7_vspider_additional_files.zip (16K).
Unzip the file into thecf_root/verity/Data/stylesets directory.
You should preserve directory names when you unzip the file.

This will enable usage of the Verity Spider utility. The existing collections are not changed, and will work as before.

Do not create the new collection with the ColdFusion MX Administrator or with the cfcollection tag if it is to be indexed with vspider.
Use vspider to create the collection, using the-style switch.
vspider will create a collection if it doesn't exist.

For example, this command will create a new collection namedspidertest3 and index the files in the ColdFusion MX 7 HTML documents directory on localhost (the vspider command is entered as a single line):
```
 C:\> PATH=%PATH%;C:\CFusionMX7\verity\k2\_nti40\bin C:\> vspider.exe      -style C:\CFusionMX7\verity\Data\stylesets\ColdFusionVspider      -collection C:\CFusionMX7\verity\collections\spidertest3      -include "*/cfdocs/htmldocs*"      -start http://localhost/cfdocs/htmldocs/ 
```
After the collection has been created by vspider, add the new collection spidertest3 in the ColdFusion Administrator.
```
 Name        spidertest3     Path        C:\CFusionMX7\verity\collections     Language    Englishx (Advanced)     Enable Category Support     [unchecked] 
```
This will not overwrite the collection created with vspider. The data will be intact, and the collection will be added to the list of collections visible to ColdFusion MX 7.

VSpider can now index this collection.

The default language for vspider is Englishx (Advanced)
If the -language switch is used with vspider to select a different language, be sure to select the same language in the ColdFusion Administrator.
Note that arguments to the -language switch must be lowercase. For example, english orenglishx
English collections have better performance than Englishx collections.

If it is not desirable to let vspider create the collection, the mkvdk command line tool can create the collection, using the -style switch. For example:

 C:\> mkvdk.exe -create      -style C:\CFusionMX7\verity\Data\stylesets\ColdFusionVspider      -collection C:\CFusionMX7\verity\collections\spidertest3

Regular ColdFusion (filesystem) indexing will no longer work with these collections. Collections created usingvspider.exe cannot be indexed with the ColdFusion Administrator or with the cfindex tag. These collections can, however, be searched with thecfsearch tag.