7.3 Configuring Services Settings

Services Settings lets you control all new and existing virtual search servers. For example, when you disable a feature such as e-mail services, the e-mail services feature is removed from the virtual search server configuration pages, making it impossible for the virtual search server administrator to access it.

You can also perform other administrative tasks, such as checking for software updates and configuring QuickFinder synchronization.

Services Settings are meant for global QuickFinder server administrators, giving them global control of the QuickFinder server and all virtual search servers, including the ability to completely disable a virtual search server. Services Settings also let the administrator control the overall performance of the QuickFinder server.

Unlike the Default Settings, changes made here affect both new and existing virtual search servers. For example, if the e-mail feature is enabled from the Default General Settings page (accessed from the Global Settings page), and on the General Settings page of a virtual search server, the global administrator can disable it from General Services Settings. When that is done, the e-mail feature is disabled and its settings are removed from all other configuration pages.

7.3.1 Configuring General Services Settings

General Services Settings let you configure product update, error log, and e-mail settings. If you disable a feature here, it is disabled on all virtual search servers and removed from their configuration pages. If you re-enable the feature, it reappears on all configuration pages with the same settings used before it was disabled by the global administrator.

Modifying Product Update Settings

  1. On the QuickFinder Server Manager’s Global Settings page, click General under Services Settings.

  2. (Optional) Under Product Update Settings, click Yes next Check for product updates if you want QuickFinder to regularly check for software updates and notify you when updates are available.

    For more information, see Section 7.4, Updating QuickFinder Server Software.

  3. Click Apply Settings > Back to General Service Settings to save any changes you have made.

    Clicking Check Now causes any unsaved changes to be lost.

  4. To check for software updates immediately, click Check Now.

  5. Click Apply Settings.

Modifying Administrator Authentication Settings

  1. On the QuickFinder Server Manager’s Global Settings page, click General under Services Settings.

  2. Under Administrator Authentication Settings, choose from the following options:

    • Require authorization when administering QuickFinder Server: Click Yes to require a login name and password when accessing QuickFinder Server Manager.

    • Require HTTPS when administering QuickFinder Server: Click Yes to require the use of the secure HTTP protocol (HTTPS) when accessing QuickFinder Server Manager.

  3. Click Apply Settings.

Modifying Error Log Settings

  1. On the QuickFinder Server Manager’s Global Settings page, click General under Services Settings.

  2. Under Error Log Settings, select where you want log results displayed by choosing one of the following options from the Log errors to drop-down list:

    • File: When this option is selected, you can click View next to the Log Errors To drop-down list to display the log results in your browser.

    • Console: When this option is selected, the error log settings writes the logs to /var/opt/novell/tomcat5/logs/catalina.out file.

    • Both: Displays results in both your browser and at the system console.

    You can access the log file directly by going to /var/lib/qfsearch/Errors.log.

  3. To start a new log file each time you restart the QuickFinder server, click Yes next to New log when services load.

    You can also delete the log file at the path specified above. The log file is re-created on the first instance of a new error, statistics, etc.

  4. To limit the size of the log file, specify a file size (in bytes) in the Maximum log size field.

    The number you specify here is divided evenly between two log files. For example, if you specify 30000, each log file allows up to 15000 bytes of logged data. This ensures that you always have at least 15000 bytes of logged synchronization data.

  5. Click Apply Settings.

Modifying E-Mail Settings

  1. On the QuickFinder Server Manager’s Global Settings page, click General under Services Settings.

  2. Under E-mail Settings, click Yes next to Enable e-mail services if you want QuickFinder to generate an e-mail message whenever errors occur during the generation (or regeneration) of your virtual search server’s indexes, or when your indexes are being synchronized with other QuickFinder servers.

  3. In the Outgoing SMTP Host name field, specify the SMTP hostname of the mail server that handles e-mail requests (for example, mail.novell.com).

  4. In the Outgoing SMTP Port # field, specify the SMTP port number for the mail server specified above.

    Typically, the port number for mail servers is 25.

  5. (Optional) If your SMTP server requires authentication the, specify your user ID in the Outgoing SMTP User ID field.

  6. (Optional) Specify the matching password for your SMTP user account in the Outgoing SMTP Password field.

  7. (Optional) Specify an e-mail address in the From Address field.

  8. Click Apply Settings.

Modifying Server Management Settings

  1. On the QuickFinder Server Manager’s Global Settings page, click General under Services Settings.

  2. Under Server Management Settings, specify a number in the Maximum number of Active Index Jobs field to limit the number of indexing jobs that can run simultaneously.

    Any indexing jobs beyond the number you specify here are placed in a queue until one of the original indexing jobs is completed.

    Each server’s performance varies because of hardware configuration and the amount of user traffic, so you should experiment with how many indexing jobs you can run simultaneously without negatively affecting the performance of your server. Also, you might consider using the Index Scheduling feature to regenerate indexes after business hours. See Section 8.9, Automating Index and Server Maintenance for more information.

  3. In the Default location of virtual search servers field, specify the path where you want all virtual search server files to be stored, including index and configuration files.

    Changing this setting won’t move existing sites to the new default location, but all new virtual search servers are placed here.

  4. To direct QuickFinder to reload configuration files modified manually, outside of QuickFinder Server Manager, click Yes next to the Detect manual search server changes field.

    If you make changes outside of QuickFinder Server Manager, such as modifying configuration or properties files or any of the templates, QuickFinder re-reads those files as often as you indicate in the Seconds between checking for changes field.

    If you modify the adminservlet.properties file, you must reboot your server in order for the changes to take effect. This is the only file that cannot be re-read by using the Detect manual search server changes feature.

  5. In the Seconds between checking for changes field, specify how often QuickFinder should check for manual changes (changes made outside of QuickFinder Server Manager) to the configuration files.

  6. To direct QuickFinder to reload QuickFinder templates that have been modified, click Yes next to the Detect template changes field.

    After making a change to a template from within your HTML editing tool and saving it on your server, QuickFinder re-reads the template as often as you specify in the Seconds between template updates field. This means you can test your changes almost immediately.

  7. In the Seconds between checking for template changes field, specify how often QuickFinder should reload search, print, results, and error templates.

  8. Click Apply Settings.

7.3.2 Configuring Search Services Settings

Search Services Settings let you turn search capabilities on or off and manage debugging and statistics settings.

Modifying General Search Services Settings

  1. On the QuickFinder Server Manager’s Global Settings page, click Search under Services Settings.

  2. Under General Search Settings, click Yes next to Enable search service to enable search services for all virtual search servers on your QuickFinder server.

  3. To enable the highlighter, click Yes next to Enable highlighter service.

  4. Click Apply Settings.

Modifying Search Debug Settings

  1. On the QuickFinder Server Manager’s Global Settings page, click Search under Services Settings.

  2. Under Debug Settings, click Yes next to Enable search debugging if you want to keep a log of all searches and query results going to all virtual search servers.

    IMPORTANT:We recommend that you use this feature only while setting up or troubleshooting your search services because the log file can grow in size very quickly. In addition, logging query and response details can slow down searches.

  3. Specify where you want log results displayed by selecting one of the following options from the Log debug messages to drop-down list:

    • File: When this option is selected, you can click View Log next to the Log debug messages To drop-down list to display the log results in your browser.

    • Console: When this option is selected, the debug settings writes the logs to /var/opt/novell/tomcat5/logs/catalina.out file.

    • Both: Displays results in both your browser and at the system console.

  4. To start a new log file each time you restart the QuickFinder server, click Yes next to New log when servlet loads.

  5. To limit the size of the log file, specify a file size (in bytes) in the Maximum log size field.

    The number you specify here is divided evenly between two log files. For example, if you specify 30000, each log file allows up to 15000 bytes of logged data. This ensures that you always have at least 15000 bytes of logged synchronization data.

  6. Click Apply Settings.

Modifying Search Statistics Settings

  1. On the QuickFinder Server Manager’s Global Settings page, click Search under Services Settings.

  2. Under Statistics Settings, click Yes next to Enable search statistics logging if you want an updated log file containing statistics about searches performed against all virtual search servers on your QuickFinder server.

  3. In the Seconds between statistics updates field, specify a number (in seconds) that should elapse between updates of the statistics log file.

  4. Specify where you want log results displayed by selecting one of the following options from the Log statistics to drop-down list:

    • File: When this option is selected, you can click View Log next to the Log statistics to drop-down list to display the log results in your browser.

    • Console: When this option is selected, the statistics settings writes the logs to /var/opt/novell/tomcat5/logs/catalina.out file.

    • Both: Displays results in both your browser and at the system console.

  5. To limit the size of the log file, specify a file size (in bytes) in the Maximum log file size field.

    The number you specify here is divided evenly between two log files. For example, if you specify 30000, each log file allows up to 15000 bytes of logged data. This ensures that you always have at least 15000 bytes of logged synchronization data.

  6. To start a new log file each time you restart the QuickFinder server, click Yes next to New log when servlet loads.

  7. In the Log error if search time exceeds field, specify a number (in seconds) before QuickFinder should record the current search as exceeding the specified time limit on the statistics display.

    This appears as the Limit portion of the statistics display.

  8. Click Apply Settings.

7.3.3 Configuring Print Services Settings

Modifying General Print Services Settings

  1. On the QuickFinder Server Manager’s Global Settings page, click Print under Services Settings.

  2. Under General Print Settings, click Yes next to Enable print service to enable print services for all virtual search servers on your QuickFinder Server.

  3. Click Apply Settings.

Modifying Print Debug Settings

  1. On the QuickFinder Server Manager’s Global Settings page, click Print under Services Settings.

  2. Under Debug Settings, click Yes next to Enable print debugging if you want print debugging turned on.

    IMPORTANT:We recommend that you use this feature only while setting up or troubleshooting your search services because the log file can grow in size very quickly. In addition, logging query and response details can slow down searches.

  3. Specify where you want log results displayed by selecting one of the following options from the Log debug messages to drop-down list:

    • File: When this option is selected, you can click View Log next to the Log debug messages to drop-down list to display the log results in your browser.

    • Console: When this option is selected, the debug settings writes the logs to /var/opt/novell/tomcat5/logs/catalina.out file.

    • Both: Displays results in both your browser and at the system console.

  4. To start a new log file each time you restart the QuickFinder server, click Yes next to New log when servlet loads.

  5. To limit the size of the log file, specify a file size (in bytes) in the Maximum log size field.

    The number you specify here is divided evenly between two log files. For example, if you specify 30000, each log file allows up to 15000 bytes of logged data. This ensures that you always have at least 15000 bytes of logged synchronization data.

  6. Click Apply Settings.

Modifying Print Statistics Settings

  1. On the QuickFinder Server Manager’s Global Settings page, click Print under Services Settings.

  2. Under Statistics Settings, click Yes next to Enable print statistics logging if you want an updated log file containing statistics about print requests performed on your QuickFinder server.

  3. In the Seconds between statistics updates field, specify a number (in seconds) that should elapse between updates of the statistics log file.

  4. Specify where you want log results displayed by selecting one of the following options from the Log statistics to drop-down list:

    • File: When this option is selected, you can click View Log next to the Log statistics to drop-down list to display the log results in your browser.

    • Console: When this option is selected, the statistics settings writes the logs to /var/opt/novell/tomcat5/logs/catalina.out file.

    • Both: Displays results in both your browser and at the system console.

  5. To limit the size of the log file, specify a file size (in bytes) in the Maximum log file size field.

    The number you specify here is divided evenly between two log files. For example, if you specify 30000, each log file allows up to 15000 bytes of logged data. This ensures that you always have at least 15000 bytes of logged synchronization data.

  6. To start a new log file each time you restart the QuickFinder server, click Yes next to New log when servlet loads.

  7. In the Log error if print time exceeds field, specify a number (in seconds) before QuickFinder should record the current print job as exceeding the specified time limit on the statistics display.

    This appears as the Limit portion of the statistics display.

  8. Click Apply Settings.

7.3.4 Configuring Synchronization

QuickFinder Synchronization lets you designate one QuickFinder server as the search master from which updated indexes, templates, and configuration settings are systematically sent out to all other QuickFinder servers defined as part of a QuickFinder Synchronization cluster.

For more information about setting up and configuring QuickFinder Synchronization, see Synchronizing Data Across Multiple QuickFinder Servers.