TechNote

How to manually install missing Verity services

Issue

In certain situations, when running verity-install script, it fails to properly install all three necessary Verity services: Admin Service, Server Service and Indexing Service. This causes error messages when trying to create collections in the ColdFusion Administrator. One of the possible errors is:

An error occurred while creating the collection: com.verity.api.administration.ConfigurationException: Failed to retrieve style path. (-6044)

Reason

On Linux/Solaris, the most likely reasons for this are shell/permission problems. Please refer to TechNote kb400683 for additional information on how to resolve the issue.

On Windows, the cause for this issue is unknown, but is possibly related to the environment.

Solution

Before attempting to manually install missing Verity services, run Verity's rcadmin from the command line. The rcadmin tool is available under your cf_root/verity/k2/os_folder/bin directory.

Note: On Windows machines, running rcadmin is enough, while on Linux/Solaris you also need to provide alias, host and port number as arguments to rcadmin.

Once rcadmin is running, issue the hierarchyview command and press Enter twice to see which services are installed. If you see three services, then the cause of the problem is different from the one described in this TechNote.

If you only see the Admin Service, as in the example below, then proceed with further instructions to manually install other services.

 C:\CFusionMX7\verity\k2\_nti40\bin>rcadmin      K2Admin Server: localhost:9950 connected. Type ? for help.      RCADMIN - Verity, Inc. Version 5.5.0      rcadmin> hierarchyview      Service Type [(a)dmin|(b)roker|(s)erver|(t)icket|(i)ndexServer|press enter for all]:      Hierarchy Info:            Admin Services:      Admin(1/1):      Alias : ColdFusionK2      ServerSpec : localhost:9950      Description : ColdFusion MX 7 Search Server      Type : Master Administration Server

The following commands need to be run in steps. Refer to the example below on how to properly run them.

styleset 1 Def_FileSystem 1 1 default_value default_value filesys default_value "default File System style files" default_value y
styleset 1 Def_FileSystem_PushAPI 1 1 default_value default_value filesys default_value "Default File System style files to be used with ODK Collection Indexing API" default_value y
styleset 1 ColdFusionK2 1 1 default_value default_value filesys default_value "ColdFusion K2 Style Files" default_value y
styleset 1 ColdFusionVspider 1 1 default_value default_value filesys default_value "ColdFusion Vspider Style Files" default_value y
licenseupdate ColdFusionK2
trustedclientset ColdFusionK2 a 1 127.0.0.1 255.255.255.255 y
serverset 1 ColdFusionK2_server1 9920 "ColdFusion K2Server" y y y default_value ColdFusionK2 "C:\JRun4\verity\k2\common" default_value 200 2 n 300000 900000 default_value default_value y
trustedclientset ColdFusionK2_server1 s 1 127.0.0.1 255.255.255.255 y
servicesignal ColdFusionK2_server1 1 y
indexerset 1 ColdFusionK2_indexserver1 9960 "ColdFusion K2 Index Server" default_value ColdFusionK2 default_value 4 default_value 1 y
trustedclientset ColdFusionK2_indexserver1 i 1 127.0.0.1 255.255.255.255 y
servicesignal ColdFusionK2_indexserver1 1 y

Instructions for running the commands.

Consider the first command:

styleset 1 Def_FileSystem 1 1 default_value default_value filesys default_value "default File System style files" default_value y

Start by entering 'styleset' at the rcadmin prompt. Press Enter and you will see a question. The answer to the question would be the next parameter in the comand, which is 1. Press Enter again and you will see another question. Enter the next parameter and continue doing so until you reach the end of the command. See the complete example below.

 rcadmin> styleset      Modify Type (Update=0, Insert=1):1      Style Information:      Alias:Def_FileSystem      Style state (store=1,active=2):1      Style type (new=1,edit=2,clone=3):1      Admin Alias:      Clone Alias:      Gateway[(o)dbc|(n)otes|(e)xchange|(d)ocumentum|(f)ilesys|(w)eb|o(t)her]:filesys      Charmap:      Description:"default File System style files"      Path:      Save changes? [y|n]:y

Proceed with the next command in the list above. When finished running all the commands, try hierarchyview again. If everything worked, you will see all three Verity services.