Changing the Quick Find service port

You can change the port used by the Quick Find service if it's used by another application on the Sage CRM web server.

By default, the Quick Find service listens on port 8983 on localhost. The Quick Find service is bound to localhost so it does not respond to requests originating from a different Sage CRM web server. This is necessary because the filtering of Quick Find results is carried out in another part of Sage CRM.

To change the port:

  1. In Management Studio, configure the port and hostname in the SolrEngineUrl entry on the Custom_Sysparams table.
    Copy
    UPDATE Custom_SysParams SET Parm_Value = N 'http://<hostname>:<port>/solr/' WHERE Parm_Name = N 'SolrEngineUrl'

    This entry contains a URL endpoint for the Quick Find service, such as http://localhost:8983/solr/

    Do not bind the Quick Find service to any IP address that's accessible remotely. On a multi-server installation of Sage CRM, each CRM web server hosts its own instance of the Quick Find service.

  2. In Sage CRM, click <My Profile> | Administration | System | Metadata.
    • Select Refresh system parameters.
    • Click Execute Refresh.
  3. Use Notepad to open the Quick Find service installer file: \CRM\Services\QuickFind\bin\SageCRMQuickFind-install-svc.cmd. Configure the port and other options and save your changes.
    • The Quick Find port parameter is in the QUICKFIND_PORT parameter setting.
    • The host / IP address is in the QUICKFIND_HOST parameter.
    • It is strongly advised that you do not change the QUICKFIND_HOST variable from localhost to a port accessible remotely from the Sage CRM web server.
  4. Double-click SageCRMQuickFind-install-svc and run it as a local administrator. Alternatively, run it as a local administrator from a command prompt. The Quick Find service is stopped, uninstalled, and reinstalled with the new settings.
  5. If you encounter an error starting the service, check the logs in \CRM\Services\Logs\QuickFind.