HPE RSS Connector Software Version: 10.11.0
RSS Connector (CFS) Release Notes
Document Release Date: November 2015 Software Release Date: November 2015 RSS Connector (CFS) Release Notes
Legal Notices
Warranty The only warranties for Hewlett Packard Enterprise Development LP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HPE shall not be liable for technical or editorial errors or omissions contained herein. The information contained herein is subject to change without notice. Restricted Rights Legend Confidential computer software. Valid license from HPE required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
Copyright Notice © Copyright 2015 Hewlett Packard Enterprise Development LP Trademark Notices Adobe™ is a trademark of Adobe Systems Incorporated. Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation. UNIX® is a registered trademark of The Open Group. This product includes an interface of the 'zlib' general purpose compression library, which is Copyright © 1995-2002 Jean-loup Gailly and Mark Adler. Documentation Updates
HPE Big Data Support provides prompt and accurate support to help you quickly and effectively resolve any issue you may encounter while using HPE Big Data products. Support services include access to the Customer Support Site (CSS) for online answers, expertise-based service by HPE Big Data support engineers, and software maintenance to ensure you have the most up-to-date technology.
To access the Customer Support Site
l go to https://customers.autonomy.com The Customer Support Site includes:
l Knowledge Base. An extensive library of end user documentation, FAQs, and technical articles that is easy to navigate and search. l Support Cases. A central location to create, monitor, and manage all your cases that are open with technical support. l Downloads. A location to download or request products and product updates. l Requests. A place to request products to download or product licenses.
To contact HPE Big Data Customer Support by email or phone
l go to http://www.autonomy.com/work/services/customer-support Support
The title page of this document contains the following identifying information:
HPE RSS Connector (10.11.0) Page 2 of 10 RSS Connector (CFS) Release Notes
l Software Version number, which indicates the software version. l Document Release Date, which changes each time the document is updated. l Software Release Date, which indicates the release date of this version of the software. To check for recent updates or to verify that you are using the most recent edition of a document, visit the Knowledge Base on the HPE Big Data Customer Support Site. To do so, go to https://customers.autonomy.com, and then click Knowledge Base. The Knowledge Base contains documents in PDF and HTML format as well as collections of related documents in ZIP packages. You can view PDF and HTML documents online or download ZIP packages and open PDF documents to your computer.
HPE RSS Connector (10.11.0) Page 3 of 10 RSS Connector (CFS) Release Notes
Contents
New in this Release 5
Resolved Issues 8
Supported Operating System Platforms 9
Documentation 10
HPE RSS Connector (10.11.0) Page 4 of 10 RSS Connector (CFS) Release Notes New in this Release
New in this Release
This section lists the enhancements to RSS Connector version 10.11.0.
l The configuration parameter MetadataStyle has been added. You can use this parameter to configure how the connector adds metadata from the RSS feed to documents. The default setting preserves the behavior of earlier versions of the connector.
l The connector supports additional configuration parameters that you can use to configure the connection to the HTTP server. You can configure authentication, time-outs, SSL settings, and the user agent used by the connector.
l The default configuration handles more date formats correctly.
l The connector supports document tracking.
l The connector supports the backupServer and restoreServer actions. The backupServer action creates a backup of the connector’s state. The restoreServer action restores the connector’s state from a backup.
l The connector can pause tasks if performance indicators, such as CPU or memory use, exceed certain limits. The connector resumes the tasks when the period of high load has passed. The connector can monitor performance indicators on the local machine or a remote machine. This feature is available only on Windows.
l The connector supports the PurgeDatastore action, which deletes the datastore for a fetch task. You might want to delete the datastore if you have modified your connector’s configuration and you need to synchronize all of the documents again, even though the documents in the repository have not changed.
l The connector supports the TaskList action. This action returns information about the fetch tasks that are configured in the connector's configuration file, or that ran when the connector received a fetch action with a configuration included in the config action parameter.
l The connector supports the IngestBatchActions configuration parameter. This parameter specifies actions to run on batches of documents after they are successfully sent to the ingestion server.
l When you request the status of a synchronize fetch action and the action is running, the response now includes approximate document counts. Previously, document counts were displayed only after an action had finished. To request the status of an action, use action=QueueInfo&QueueAction=getStatus&QueueName=fetch&Token=...
l The QueueInfo action has been improved:
l The QueueInfo action can return the action parameters that were passed to a pending or running action. You cannot retrieve the parameters passed to an action that has finished. To retrieve action parameters, use QueueAction=getActionParameters.
l The QueueInfo action supports parameters to filter and sort the actions that are returned when QueueAction=getStatus. For example, you can retrieve information about actions that have finished, and sort the actions by the time the connector finished processing them.
HPE RSS Connector (10.11.0) Page 5 of 10 RSS Connector (CFS) Release Notes New in this Release
l The QueueInfo action accepts a MaxResults parameter to restrict the number of results returned when QueueAction=getStatus. To page through the results, use the new parameter Start. For example: action=QueueInfo&QueueAction=getStatus&MaxResults=10&Start=1&QueueName=...
l The connector returns the priority of queued actions when you use action=QueueInfo&QueueAction=getStatus&QueueName=...
l The connector returns the status of a queue (paused or running) when you use action=QueueInfo&QueueAction=QueueStatus&QueueName=...
l The connector includes Lua 5.3.0.
l The connector supports the following Lua functions:
l addsection, getSection, and getSectionCount. You can call these methods on a LuaDocument object to manipulate document sections. The existing Lua methods appendContent, getContent, and setContent now take an optional number argument that specifies the document section to use.
l base64_decode, which decodes a base64-encoded string.
l base64_encode, which base64-encodes a string.
l doc_tracking, which raises a document tracking event for a document.
l extract_date, which searches a string for a date and returns the date.
l get_log. This function returns a LuaLog object that you can use to write messages to a log stream configured in the connector's configuration file. When you use a LuaLog object the log stream settings such as the log file name, log level, and maximum size of the log file are respected.
l get_task_config, which returns the configuration of the fetch task that called the script.
l get_task_name, which returns the name of the fetch task that called the script.
l getValueByPath and getValuesByPath. You can call these methods on a LuaDocument object or LuaField object. They return the value, or values, of a field or sub-field with a specified path.
l regex_replace_all, which searches a string for matches to a regular expression and replaces all of the matches.
l send_and_wait_for_async_aci_action. This function sends an action to an ACI server, polls the server until the action is complete, and then returns the response. This function is useful for sending asynchronous actions because it returns the action response instead of a token.
l to_idx, to_xml, and to_json. You can call these methods on a LuaDocument object. They return a string containing the document in IDX, XML, or JSON format.
l url_escape, which percent-encodes a string.
HPE RSS Connector (10.11.0) Page 6 of 10 RSS Connector (CFS) Release Notes New in this Release
l The Lua function get_config no longer requires a filename. If you do not specify the file to load, the function returns the configuration file with the same name as the ACI server executable file.
l The connector supports the LuaDebug action, which provides features for debugging your Lua scripts. The LuaDebug action can display the content of a script, and set and remove breakpoints in a script. When a script is paused at a breakpoint, it can return the values of the local variables, return the current call stack, and either step over lines of code or resume running the script.
l The connector includes an example XSL template that transforms the output of the LuaDebug action. The template is named LuaDebug and can be found in the acitemplates folder.
l The server requires less time to start when it is started for the first time and asynchronous action queues are stored in internal datastores.
l Asynchronous action queues can be stored in an external database hosted on a database server, so that several installations of the component can share action queues.
l The DeleteQueuedRequestsWhenServerStarts and DeleteProcessingRequestsWhenServerStarts configuration parameters have been added. These parameters specify whether to remove queued and processing requests from asynchronous action queues when the server starts.
l The connector can send documents to Haven OnDemand.
l The connector can index information directly into IDOL Server, a Vertica Database, or a MetaStore.
l The Windows service installation (-install) now accepts a -depend command line parameter, which allows you to specify a comma-separated list of services that the service depends on. Windows services starts these dependencies before your service. For more information about installing Windows services, refer to the IDOL Getting Started Guide.
l The SystemLimits action has been added. This action returns information about system limits, such as the maximum number of open file handles, and the maximum map count (on linux), which can affect the server.
l The server now logs the ActionID that it generates for an action that was sent without the ActionID parameter.
l You can now merge an external configuration file into the RSS Connector configuration file. You can merge in a whole external file, a section, or a single parameter.
HPE RSS Connector (10.11.0) Page 7 of 10 RSS Connector (CFS) Release Notes Resolved Issues
Resolved Issues
This section lists the resolved issues in RSS Connector version 10.11.0.
l The connector did not respond to stop requests in a timely manner.
l The connector did not attempt to ingest items from the RSS feed again if the download or ingestion failed.
l Items without dates were retrieved on every synchronize cycle.
l If the connector could not parse the dates in an RSS feed, each item was retrieved on every synchronize cycle. The connector now retrieves only new and modified items.
l If an RSS feed contained multiple entries for a single item, the item was downloaded and ingested multiple times. The connector now downloads and ingests the item one time, and uses the metadata from the latest entry.
l When an item in an RSS feed was updated, the connector did not send a delete command for the item before ingesting it again.
l When the connector was started, scheduled tasks did not run in the correct order.
l On Linux platforms, the connector did not stop correctly.
l The connector could terminate unexpectedly if a LuaField was assigned to a global variable.
l Asynchronous tokens were not always unique after a large number of requests, which could prevent scheduled tasks from starting.
l The Lua method renameField deleted the field when the old and new names were the same and the case argument was true, or the old and new names were the same (except for case) and the case argument was false.
l The service port configuration did not correctly convert host names to IPv6 addresses.
HPE RSS Connector (10.11.0) Page 8 of 10 RSS Connector (CFS) Release Notes Supported Operating System Platforms
Supported Operating System Platforms
The following operating system platforms are supported by RSS Connector 10.11.0.
l Windows x86
l Windows x86 64
l Linux x86
l Linux x86 64
l Solaris x86 64
l Solaris SPARC 64 The most fully tested versions of these platforms are: Windows
l Windows Server 2012 x86 64
l Windows 7 SP1 x86 64
l Windows Server 2008 R2
l Windows Server 2008 SP2 x86 64 Linux For Linux, the minimum recommended versions of particular distributions are:
l Red Hat Enterprise Linux (RHEL) 5
l CentOS 5
l SuSE Linux Enterprise Server (SLES) 10
l Ubuntu 12.04
l Debian 7 Solaris
l Solaris 10
l Solaris 11
HPE RSS Connector (10.11.0) Page 9 of 10 RSS Connector (CFS) Release Notes Documentation
Documentation
The following documentation was updated for this release.
l RSS Connector Administration Guide
l RSS Connector Reference
HPE RSS Connector (10.11.0) Page 10 of 10