Collections and the ColdFusion Verity architecture



ColdFusion includes Verity K2 Server search technology. Verity K2 Server is a high-performance search engine designed to process searches quickly in a high-performance, distributed system. The K2 search system has a client-server model. K2 client applications, such as ColdFusion server, provide users access to document indexes stored in Verity collections. K2 Server supports simultaneous indexing of distributed enterprise repositories, and handles hundreds of concurrent queries and users.

The Verity search system takes advantage of the latest advances in hardware and software technology, and provides the following features:

  • Multi-threaded architecture

  • Support for Verity knowledge retrieval features, including topics

  • Continuous operation support

  • High scalability

  • Category support (also called parametric indexes)

Note: ColdFusion no longer uses VDK mode and K2 mode. All Verity processing now uses the K2 architecture. Additionally, ColdFusion no longer uses the neo-verity.xml file.

Because, ColdFusion reads custom queries into memory, indexing a large query-result set can cause a Java out of memory error. If your ColdFusion Java Virtual Machine (JVM) memory allocation is too small, it can also lead to excessive disk use on your computer. Manage ColdFusion JVM memory settings as follows:

Server configuration
Through the ‑Xmx argument to the java.args parameter in the cf_root/runtime/bin/jvm.config file (for example, [Xmx512m]‑).

Multiserver configuration
Through the jrun_root/bin/jvm.config file.

J2EE configuration
Through application server-specific methods.

    Verity information storage

    Verity Search Server runs as a separate process from ColdFusion. This server controls all access to Verity collections, as the following figure shows:

    View full size graphic

    In the multiserver and J2EE configurations, multiple ColdFusion server instances all use the same Verity Search Server to access the same set of Collections.

    ColdFusion uses different processes for Windows and UNIX, as follows:

    Windows
    The ColdFusion Verity Search Server service manages and controls configuration and services of a Verity K2 domain. This service starts three processes: k2server.exe, k2index.exe, and k2admin.exe.

    UNIX
    The cf_root/bin/cfmxsearch control script (cf_webapp_root/WEB‑INF/cfusion/bin/cfmxsearch in the multiserver configurations) starts and stops Verity. When you call this script with the start argument, it calls verity_root/k2/platform_dir/bin/k2adminstart with the appropriate user context and environment, which in turn starts up three processes: k2server, k2index, and k2admin. Calling the script with the stop argument calls the Verity k2adminstop script, which kills those three processes.
    Note: When you use the J2EE configuration, install Verity separately. For more information, see “Installing the Verity search server separately” in Installing ColdFusion.

    You can install Verity Search Server on a separate computer from ColdFusion. For more information, see Administrator online Help.

    Note: If no Verity collections appear in the ColdFusion Administrator, it probably means that the Verity Search Server process isn’t running.