Jive Software Jive Connector

Installation and Configuration

Mindbreeze GmbH, A-4020 Linz, 2017.

These documents are strictly confidential. The submission and presentation of these documents does not confer any rights to our software, our services and service outcomes or other protected rights.

The dissemination, publication or reproduction hereof is prohibited.

For ease of readability, gender differentiation has been waived. Corresponding terms and definitions apply within the meaning and intent of the equal treatment principle for both sexes.

Installation

Before installing the Jive connector plugin, make sure that the Mindbreeze server is installed and that this connector is also included in the Mindbreeze license.

Installing Jive software Jive connectors

The Jive connector is available as a ZIP file. This file must be registered as follows using mesextension on the Fabasoft Mindbreeze InSite server:

mesextension --interface=plugin --type=archive --file=JiveConnector<version>.zip install

PLEASE NOTE: An update of the connector can be performed via the same mesextension command. Fabasoft Mindbreeze InSite automatically performs the required update.

Uninstalling Jive software Jive connectors

To uninstall the Web connector, all Jive crawlers must first be deleted, then the following command must be executed:

mesextension --interface=plugin --type=archive --file=JiveConnector<version>.zip uninstall

Configuration of Mindbreeze

Configuration of index and crawler

When selecting the installation method, select “Advanced”.

Click on the “Indices” tab and then click the “Add new index” icon to create a new index.

Enter the index path, for example, “C:\Index”. If necessary, adjust the Display Name of the index service and the associated filter service.

The Option “Use ACL References” has to be activated.

Add a new data source with the symbol “Add new custom source” on the lower right.

If not already selected, select “Jive Software Jive” with the “Category” button.

Using the setting “Crawler Interval” you can configure the amount of time that should elapse between two indexing runs.

Web page

In the field Crawling Root, you can specify a URL where a Jive sitemap is accessible. If the Mindbreeze sitemap generator add-on is installed on your Jive server and a sitemap is generated, the URL <Jive URL>/rpc/rest/mindbreeze/sitemap?jobid=full should be here.

In the field “URL regex” you can define a regular expression, which sets a pattern for the links that should be indexed.

If certain URLs are excluded from the crawl, they can be configured using a regular expression in “URL Exclude Pattern”.

If the DNS resolution of certain Web servers doesn’t work due to network-related reasons, you can specify the Ips using the “Additional Hosts File”.

If you want to add specific HTTP headers (for example, Accept-Language), you can adjust this using “Accept headers”.

With the “Use Stream Parser” option, a stream parser for processing the sitemaps is used. This option is suitable for sitemaps with a lot of URLs.

Resource parameters

In this section (available only when “Advanced Settings” is selected) the crawl speed can be adjusted.

With the number of crawler threads (“Number Of Crawler Threads”) you can define how many threads should simultaneously pick sites from the web server.

“Request Interval” defines the number of milliseconds that the crawler (crawler thread) should wait between the individual requests. However, a “crawl-delay” robots instruction is always taken into consideration and overrides this value.

Proxy

In the “Proxy” section you can enter a proxy server if your infrastructure requires it. Enter the computer name and the port of the proxy server in “Proxy host” and “Proxy Port”.

The Jive Connector can also log in to the proxy using HTTP-BASIC. Enter the user into the “Proxy User” and the corresponding password in “Proxy Password” if the connections should be made through a proxy with authentication.

Jive login

In the section “Basic access authentication”, a “credential” can be selected, which is used in the basic authentication for HTTP requests. A credential of the type “Username/Password” should be entered here.

If the Jive sitemap is accessible with HTTP form authentication, the login parameters in section “Form Based Login” can be configured as follows:

Login URL: the Jive URL to which the login form is to be sent: for instance,
Form Elements: An element with the name “username” must be added here. The value
should be the user who is authorized to download the sitemap.
Form Password Elements: An element with the name “password” must be added here. The value should be the password for the previously specified user.
In section “Jive URL”, the base URL of the Jive server must be specified.

3 Jive Principal Resolution

In the Mindbreeze configuration, open the “Indices” tab and add a caching Jive principal resolution service.

Specify the “Jive server URL”.

Enable the setting “Jive Guest Access enabled” if Jive allows access for not-logged-in users.
The necessary credentials to access the “Jive Server URL” need to be configured in the tab “Network”, and mapped to the “Jive Server URL” endpoint.

Specify the directory path for the cache and change the “Cache In Memory Items Size” if necessary, depending on the available space of the JVM.

The service will be available at the specified “Webservice Port”. If multiple principal resolution services are configured, make sure that the ““Webservice Port”” parameters are different and the configured ports are available.