73
Installation Guide ®

Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

  • Upload
    others

  • View
    6

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Installation Guide

®

Page 2: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Noetix Search Installation GuideNoetix Search 1.4.3

This document was released on February 9, 2012. Please go to Answer ID 1769 (INFO:Documentation for Noetix Search) on the Noetix online knowledge base; an updatedversion of this document might be available.

Copyright 2010-2012 Noetix Corporation. All rights reserved.

No part of this publication may be reproduced, stored in a retrieval system, ortransmitted, in any form or by any means, electronic, mechanical, photocopying,recording, or otherwise, without prior written permission from Noetix Corporation.

The information in this document is subject to change without notice. NoetixCorporation strives to keep this information accurate but does not warrant that thisdocument is error-free.

Noetix, NoetixViews, Noetix QueryServer, Noetix WebQuery, and the Noetix logo areregistered trademarks of Noetix Corporation. Other “Noetix” marks are trademarks ofNoetix Corporation.

Page 3: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Oracle, JD Edwards, PeopleSoft, Retek, and Siebel are registered trademarks of OracleCorporation and/or its affiliates. Oracle E-Business Suite, Oracle Database, OracleDiscoverer, Oracle Business Intelligence, SQL*Plus, SQL*Net, SQL*Loader, PeopleSoftEnterprise, Siebel Business Applications, and other Oracle, PeopleSoft, and/or Siebelproduct names referenced herein are trademarks or registered trademarks of OracleCorporation. Sun, Java, Java Runtime Environment, and other Sun product namesreferenced herein are trademarks or registered trademarks of Sun Microsystems, Inc.Microsoft, Microsoft Excel, Microsoft Internet Explorer, Windows, Microsoft SQLServer, Microsoft SQL Server Reporting Services, Internet Information Services,Microsoft .NET Framework, Microsoft ASP.NET, Microsoft Data Access Components,and other Microsoft product names referenced herein are trademarks or registeredtrademarks of Microsoft Corporation. Adobe, Acrobat, the Adobe PDF logo, AdobeFlash Player, and Adobe Reader are trademarks or registered trademarks of AdobeSystems Incorporated. IBM, Cognos, Cognos Framework Manager, CognosConfiguration, Cognos Query Studio, Cognos Report Studio, Cognos Connection, andother Cognos server or modeling product names mentioned herein are trademarks orregistered trademarks of International Business Machines Corporation in the UnitedStates, other countries, or both. SAP is a registered trademark of SAP AG.BusinessObjects is a trademark of Business Objects, an SAP company. Web Intelligenceand Xcelsius are trademarks or registered trademarks of Business Objects, an SAPcompany. All other company and product names mentioned herein are used foridentification purposes only and may be trademarks or registered trademarks of theirrespective owners.

The Chart2D library and Swing classes are distributed with Noetix Search under theGNU Lesser General Public License. Noetix hereby offers to give any third party, for acharge no more than our cost of physically performing the distribution, a complete,machine-readable copy of the Chart2D library and Swing classes, which shall bedistributed under the GNU Lesser General Public License and supplied on a mediumcustomarily used for software interchange. Requests for source code must be submittedwithin three years of this offer and should be directed to Noetix Corporation, 5010148th Ave NE, Suite 100, Redmond, WA 98052-5119, USA.

Oracle JDBC is distributed with Noetix Search under the GNU General Public License.Noetix hereby offers to give any third party, for a charge no more than our cost ofphysically performing the distribution, a complete, machine-readable copy of OracleJDBC, which shall be distributed under the GNU General Public License and suppliedon a medium customarily used for software interchange. Requests for source code mustbe submitted within three years of this offer and should be directed to NoetixCorporation, 5010 148th Ave NE, Suite 100, Redmond, WA 98052-5119, USA.

Page 4: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

The Solr project files are distributed with Noetix Search under Apache License 2.0.Noetix hereby offers to give any third party, for a charge no more than our cost ofphysically performing the distribution, a complete, machine-readable copy of the Solrproject files, which shall be distributed under Apache License 2.0, with all legalcopyrights intact, and supplied on a medium customarily used for software interchange.Requests for source code must be submitted within three years of this offer and should bedirected to Noetix Corporation, 5010 148th Ave NE, Suite 100, Redmond, WA 98052-5119, USA.

Page 5: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Contents v

ContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiAbout This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiiNoetix Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

Chapter 1 Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Chapter 2 Pre-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Reviewing System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Configuring JAVA_HOME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

On Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8On Linux or Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Configuring Apache Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10On Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10On Linux or Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Grant Administrative Privileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Chapter 3 Installing Noetix Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

On Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17On Linux or Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Additional Installation Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Verifying the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Reinstalling the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

On Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30On Linux or Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Upgrading the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36On Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36On Linux or Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Uninstalling the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43On Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43On Linux or Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Chapter 4 Post-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Configuring ORACLE_HOME or TNS_ADMIN . . . . . . . . . . . . . . . . . . . . . 49

On Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Page 6: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

vi Noetix Search Installation Guide

On Linux or Solaris. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Appendix Legal Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51GNU Lesser General Public License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52GNU General Public License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Apache License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Page 7: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Preface

This preface is an introduction to the Noetix Search Installation Guide. It discusses theguide’s content and assumptions and how to contact Noetix Corporation.

Page 8: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

viii Noetix Search Installation Guide

About This GuideThe Noetix Search Installation Guide provides administrators with complete softwareinstallation instructions for Noetix Search. This guide assumes that you havepurchased this product from Noetix Corporation and that the reader is primarilyresponsible for the installation and maintenance of the Noetix solution.

Typically, a Noetix consultant will be available to assist you with your initial setup andconfiguration of this product. Administrators using this product and guide need tohave a general knowledge of the system environment, client/server architecture, andcommon graphical user interfaces.

An electronic copy of this guide can be found with the product software.

We welcome your input on the quality, accuracy, and usefulness of this document.Please send your comments and suggestions to Noetix Technical Support.

Noetix Technical SupportThe Noetix Technical Support Web site is available if you have any questions orencounter a problem during installation or operation of your Noetix software. This siteis updated regularly with the latest information on Noetix products.

Page 9: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 1

Product Overview

This chapter provides a brief overview about Noetix Search.

Page 10: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

2 Noetix Search Installation Guide

OverviewNoetix Search helps you to search or browse across one or several index repositories ofNoetixViews® and Noetix® Analytics to find the information you need to expeditereport development and optimize query performance.

It allows you to search by keywords and filter search results by selecting specific objects.The guided navigation also allows you to browse quickly and find relevant content,and you can refine your search query further by using advanced search.

Noetix Search works with all modules of NoetixViews for Oracle E-Business Suite,NoetixViews for PeopleSoft Enterprise, and Noetix Analytics for Oracle E-BusinessSuite and supports Web browsers such as Microsoft Internet Explorer, Mozilla Firefox,Google Chrome and Safari.

Using Noetix Search for NoetixViews, you can:

• See a detailed description of the Noetix view, along with examples and tips onhow to build reports with it.

• Sort quickly on view columns that can be used to filter data and join the view toother views.

• Learn which Oracle tables were used to develop the Noetix view, and see a list ofavailable columns in the Oracle tables used by the view.

• Find all views that use the same column.

• See which views are related to and can be joined to other views.

• Find all the views that extract information from the same Oracle table.

• See the related roles, columns, tables, and questions associated with a particularview.

• Print view, column, and table detail pages.

Page 11: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 1: Product Overview 3

Using Noetix Search for Noetix Analytics, you can:

• Search for specific relationship sets or fields.

• See a detailed description of each relationship set and field, along with examples ofthe types of reports they support.

• Identify fact and dimension tables used within each relationship set.

• View an entity relationship diagram (ERD) showing how the fact and dimensiontables are joined within a given relationship set.

• Identify key metrics for analysis.

• Identify dimensions and attributes that can be used to summarize and filter data.

• Search for specific data warehouse tables, table aliases, and columns.

• Learn which Oracle E-Business Suite table and column is the source for each field.If the field is calculated, the calculation is also documented.

• Search data source tables and columns to see which tables, columns, relationshipsets, and fields they are mapped to.

Page 12: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation
Page 13: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 2

Pre-InstallationTasks

This chapter deals with the tasks that you need to perform before installing NoetixSearch.

Page 14: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

6 Noetix Search Installation Guide

OverviewBefore beginning installation of Noetix Search, you need to perform certain pre-installation tasks. This chapter deals with these tasks such as configuringJAVA_HOME and Apache Tomcat that need to be performed.

We recommend that you get familiarized with the system requirements and other pre-installation considerations in this chapter before beginning the installation process.Each task involves gathering and preparing information or making decisions for asystem installation.

Page 15: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 2: Pre-Installation Tasks 7

Reviewing SystemRequirements

Before beginning an installation, ensure that your system meets the minimumrequirements for hard disk space, memory, operating systems, and application versions.These requirements vary depending on the product version that you are installing.

The Noetix Search System Requirements can be found in the release documentationavailable with the product software and on the Noetix online knowledge base.

NOTE: Noetix Search supports Windows 7. However, it is not recommended for hosting theNoetix Search web client in production.

Page 16: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

8 Noetix Search Installation Guide

Configuring JAVA_HOMEFor Noetix Search to operate properly, the JAVA_HOME environment variable mustbe set. This section explains how to configure the JAVA_HOME environment variableon a computer running Microsoft Windows, Linux, or Solaris and on which the JavaRuntime Environment (JRE) has been installed.

On WindowsYou must set the JAVA_HOME environment variable on the computer on which youintend to install Noetix Search.

To configure the JAVA_HOME environment variable

1. Click Start > Control Panel > System. The System Properties dialog box isdisplayed. Alternatively, to open the System Properties dialog box, right-click theMy Computer icon, and then click Properties.

2. Click the Advanced tab, and then click Environment Variables. TheEnvironment Variables dialog box is displayed.

3. In the System variables area, click New. The New System Variable dialog box willopen.

4. In the Variable name box, type JAVA_HOME.

5. In the Variable value box, type the path of the JRE folder on the computer (forexample, C:\Program Files\Java\jre1.6.0_05).

6. Click OK to save the changes, and close the dialog boxes.

Page 17: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 2: Pre-Installation Tasks 9

On Linux or SolarisYou must set the JAVA_HOME environment variable on the computer on which youintend to install Noetix Search.

To configure the JAVA_HOME environment variable

1. At the command prompt, type the following commands respectively:

JAVA_HOME=<path to JAVA_HOME> (for example, JAVA_HOME=/usr/jre/latest)

export JAVA_HOME

NOTE: To set the environment variable permanently, edit the user’s startup script (forexample, <user’s home directory>\.profile) or a system-wide startup script (forexample, /etc/profile) so that they run the commands mentioned in this step.

2. To verify that the JAVA_HOME environment variable has been set properly, atthe command prompt, type echo $JAVA_HOME. The path of the environmentvariable will be displayed.

Page 18: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

10 Noetix Search Installation Guide

Configuring Apache TomcatFor Noetix Search to operate properly, you must increase the memory for ApacheTomcat from the default value to 1,000 MB. This section explains how to configureApache Tomcat on a computer running Microsoft Windows, Linux, or Solaris.

On WindowsNOTE: Skip this section if you intend to install and configure Apache Tomcat using theNoetix Search setup.

You must configure the Apache Tomcat settings on the computer on which you intendto install Noetix Search.

To configure Apache Tomcat:

1. Click Start > All Programs > Apache Tomcat 6.0 > Configure Tomcat. TheApache Tomcat Properties dialog box is displayed.

2. Click the Java tab, and then type 1,000 in the Maximum memory pool box.

3. Click Apply to save the changes, and then click OK to close the dialog box.

Page 19: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 2: Pre-Installation Tasks 11

On Linux or SolarisYou must configure the Apache Tomcat settings on the computer on which you intendto install Noetix Search. To configure the memory for Apache Tomcat, the Java VirtualMachine (JVM) option – Xmx<size> should be added to the Apache Tomcat’s startupscript. The process you have followed to install and configure Apache Tomcat willdetermine how you specify the option. In a typical scenario, if you have created astartup script in /etc/init.d, you can set a JAVA_OPTS variable that will be picked upby the Apache Tomcat startup script. If you are not using this scenario, you can consultthe Tomcat documentation. Here is an example of an Apache Tomcat service startupscript that might exist in /etc/init.d with the JAVA_OPTS variable defined:

Page 20: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

12 Noetix Search Installation Guide

#!/bin/bash

#

# chkconfig: 345 91 16

# description: This is the Tomcat webservice

#

JAVA_HOME=/usr/java/latest; export JAVA_HOME

JAVA_OPTS=-Xmx1000m; export JAVA_OPTS

case "$1" in

start)

/usr/local/apache-tomcat-5.5.25/bin/startup.sh

;;

stop)

/usr/local/apache-tomcat-5.5.25/bin/shutdown.sh

;;

*)

echo $"Usage: $0 {start|stop}"

exit 1

esac

exit 0

Page 21: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 2: Pre-Installation Tasks 13

Grant AdministrativePrivileges

To install and set up Noetix Search, you must have administrative privileges for eachcomputer on which you plan to install the components of Noetix Search.

If you need assistance with this task, contact your system administrator.

Page 22: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation
Page 23: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3

Installing NoetixSearch

This chapter describes the steps to install, reinstall, upgrade, and uninstall NoetixSearch.

Page 24: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

16 Noetix Search Installation Guide

OverviewThis chapter tells you how to install, reinstall, upgrade and uninstall Noetix Search.Before beginning the installation process, you must read the system requirements andperform the pre-installation tasks. For information about the pre-installation tasks, seePre-Installation Tasks.

Page 25: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 17

Installing the SoftwareThis section explains how to install Noetix Search on a computer running MicrosoftWindows, Linux, or Solaris.

On WindowsThe procedure for installing Noetix Search on Windows is as follows:

To install Noetix Search

1. Double-click the NoetixSearch-<version>.exe file. The Noetix SearchSetup screen appears.

Page 26: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

18 Noetix Search Installation Guide

2. Review the information, and click Next to continue. The Software LicenseAgreement page appears.

Page 27: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 19

3. Read the license agreement and click I Agree. The Choose Components pageappears.

The following are the details of the components that will be installed:

• Noetix Search Builder: This component generates the search indexes forNoetix Search and can be installed on a client computer or server computer.The computer on which you install this component must be able to connectto the NoetixViews schema, the Noetix Analytics instance, and the servercomputer on which you have installed the Noetix Search Web Application.

Page 28: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

20 Noetix Search Installation Guide

• Noetix Search Web Application: When this component is selected, thewizard installs the enterprise search server (Solr) that develops indexes and/orattributes for content that will be delivered through a Web browser. Thiscomponent can be installed on the server computer only and must beselected if any component other than Noetix Search Builder is selected.

NOTE: In case of a distributed installation where the Noetix Search Builder andNoetix Search Web Application components are installed on two differentcomputers, the help file for the Noetix Search Builder component will be installedwith the Noetix Search Web Application component. In such a case, you need tomodify the help URL in the Noetix.Search.Builder.properties file as follows:DEFAULT_HELP_URL=http://<name of the computer where the NoetixSearch Web Application is installed>:<port number, if not 80>/noetixsearch/nsbhelp.

• Install Apache Tomcat: For Noetix Search to operate properly, you need aServlet container that needs to be installed on the same computer where youintend to install Noetix Search. Noetix Search, by default, provides you withthe Apache Tomcat Servlet container. Selecting the Install Apache Tomcatcheck box will install and configure Apache Tomcat Servlet container andApache Web server for you. However, if you do not select this check box,during step 7 you need to specify the home path of the Tomcat configurationdirectory, Tomcat webapps directory, and type the port number that ApacheTomcat is configured on.

IMPORTANT: If you do not select this component, you must also not select theIntegrate Apache Tomcat with IIS component.

Page 29: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 21

• Integrate Apache Tomcat with IIS: Selecting this check box integratesApache Tomcat with Internet Information Services (IIS) using InternetServer Application Programming Interface (ISAPI) filter and TomcatConnector. Integrating Search with IIS provides a seamless web experienceand a simpler security setup to limit access to the application. The wizardconfigures IIS to serve the Noetix Search Web Application and forwardsrequests for /solr and /export to Apache Tomcat. If you select this check box,you must also select the Install Apache Tomcat and Integrate Noetix Searchwith Apache Tomcat checkboxes to proceed with the installation.

NOTE: The check box for this component will be disabled if you do not have IISinstalled on the computer on which you intend to install Noetix Search. If you donot want to use IIS , you can use Apache, Jetty, or any other Web server or adaemon to serve the Web content.

• Integrate Noetix Search with Apache Tomcat: Selecting this check boxintegrates the Noetix Search Web Application with Apache Tomcat. Do notselect this component if you are using a servlet engine other than ApacheTomcat. If you do not select this component, you need to manually integrateNoetix Search Web Application with Apache Tomcat.

Page 30: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

22 Noetix Search Installation Guide

4. Select the components you want to install, and then click Next. The InstallationLocation page appears.

Page 31: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 23

5. Accept the default destination folder that is displayed or change the destinationfolder. To change the destination folder, click Browse, navigate to the folderlocation, select the destination folder, and then click Next. The Choose StartMenu Folder page appears.

Page 32: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

24 Noetix Search Installation Guide

6. Enter a Start menu folder name under which you want to create the shortcuts forNoetix Search. By default, it is Noetix Search. If you select a Start menu foldername from the list, the default name is added to the end of the selection. If you donot want to create the shortcuts for Noetix Search, select the Do not createshortcuts check box, and then click Next.

• If you selected the Install Apache Tomcat component in step 3, the NoetixSearch Setup page appears as shown under step 7.

• If you did not select the Install Apache Tomcat component in step 3, theApache Tomcat Information page appears..

Page 33: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 25

7. Specify the paths to the Tomcat configuration directory and Tomcat webappsdirectory and type the port that Apache Tomcat is configured on. You can acceptthe default path that is displayed or change the path. To change the path, click

, navigate to the folder location, select the destination folder, and then clickNext. The Noetix Search page appears.

Page 34: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

26 Noetix Search Installation Guide

8. Click Install to start the installation process. The progress of the installation isdisplayed. Click Show details to view the actions performed by the installationwizard. To copy the installation log, right-click the information, and then clickCopy Details To Clipboard. You can then paste and save the installation log inany text-editing program.

9. Click Next when the setup has successfully completed. The last page appears witha message that Noetix Search has been installed successfully.

Page 35: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 27

10. Click Finish to exit the Noetix Search Setup wizard.

On Linux or SolarisNOTE: Apache Tomcat needs to be manually installed before installing Noetix Search.

The procedure for installing Noetix Search on Linux or Solaris is as follows:

To install Noetix Search

1. Navigate to the directory where you have downloaded the NoetixSearch-<version>.tar.gz source file.

2. At the command prompt, type the following command, and press ENTER:

gunzip NoetixSearch-<version>.tar.gz

The NoetixSearch-<version>.tar file will be created.

3. At the command prompt, type the following command, and press ENTER:

tar xvf NoetixSearch-<version>.tar

The NoetixSearch-<version> directory will be created for Noetix Search.

4. At the command prompt, type cd NoetixSearch-<version>, andpress ENTER.

5. Type su to obtain administrative privileges, and press ENTER.

6. At the command prompt, type the super user password that has been assigned toyou as an administrator, and press ENTER.

7. At the command prompt, type ./install.sh to start the Noetix Searchinstaller.

8. When prompted for the Noetix Search installation location, press ENTER toaccept the default location or type a different location. If the location does notexist, type y to create the location, or type n if you want to specify a differentlocation.

Page 36: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

28 Noetix Search Installation Guide

9. When prompted whether to configure Noetix Search integration with ApacheTomcat, press ENTER to accept the default or type n if you are using a servletengine other than Apache Tomcat.

10. Press ENTER to accept the default path of the Tomcat home (Tomcat installationdirectory), or type a new path, and then press ENTER.

11. Press ENTER to accept the default location of the Tomcat configuration files, ortype a new location.

12. Press ENTER to accept the default location of the Tomcat webapps directory, ortype a new location.

13. Press ENTER to accept the default port number, or specify a new port number.

The installation process starts.

Additional InstallationScenarios

The following are the additional installation scenarios:

• Installing the Noetix Search Builder on a client computer to generate aSearch instance on a server computer: In this scenario, Noetix Search isalready installed on a server computer. On the client computer, run theNoetix Search setup and only select the Noetix Search Builder componentfor installation. After Noetix Search Builder is installed, run the applicationand point the Solr URL path on the Solr Connection page to the servercomputer.

• Generating a search instance on an alternate server computer or a clientcomputer apart from the search instance on a production computer togenerate search indexes offline: In this scenario, Noetix Search is alreadyinstalled on a server computer. On another server computer or a clientcomputer, run the Noetix Search setup and install the components (theIntegrate Apache Tomcat with IIS component is optional). Now, you have aseparate computer to generate search indexes. You can copy indexes from one

Page 37: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 29

computer to the other by stopping the Apache Tomcat service on thecomputer that the indexes are being copied to. The index files are locatedunder <Noetix Search Installation Folder>\Solr\solr\data.

Verifying the InstallationAfter you are done with the installation on Microsoft Windows, Linux, or Solaris,verify whether the installation is successful by going to http://<servername>:<portnumber, or 80>/noetixsearch. Noetix Search should open in your Web browser.

Alternatively, on Windows, you can access this URL by clicking Start > All Programs >Noetix Search > Noetix Search.

Page 38: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

30 Noetix Search Installation Guide

Reinstalling the SoftwareThis section explains how to reinstall Noetix Search on a computer running MicrosoftWindows, Linux, or Solaris.

On WindowsYou can reinstall the software using the same Noetix Search setup that was used for theinitial installation. Reinstallation of the software may be required in the followingscenarios:

• When a new component is to be added to the existing Noetix Search installation.

• When the initial installation is corrupted or could not be completed due totechnical problems.

To reinstall Noetix Search

1. Perform steps 1 through 3 provided under “On Windows” in the “Installing theSoftware” section. The Installation Found page appears.

Page 39: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 31

2. Click the Add/Reinstall components option on the page, and then click Next.The Choose Components page appears.

NOTE: The components that are already installed will be automatically reinstalledand unavailable for selection. The details of the components are provided in step 3under “On Windows” in the “Installing the Software” section.

Page 40: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

32 Noetix Search Installation Guide

3. Select the components you want to install, and then click Next.

• If you selected the Install Apache Tomcat component, the Noetix SearchSetup page appears as shown under step 4.

• If you did not select the Install Apache Tomcat component, the ApacheTomcat Information page appears.

Page 41: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 33

4. Specify the paths to the Tomcat configuration directory and Tomcat webappsdirectory and type the port that Apache Tomcat is configured on. You can acceptthe default path that is displayed or change the path. To change the path, click

, navigate to the folder location, select the destination folder, and then clickNext. The Noetix Search page appears.

NOTE: If you selected to reinstall the “Install Apache Tomcat” component in step 3,this step will be skipped by the Noetix Search setup.

Page 42: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

34 Noetix Search Installation Guide

5. Click Install to start the installation process. The progress of the installation isdisplayed. Click Show details to view the actions performed by the installationwizard. To copy the installation log, right-click the information, and then clickCopy Details To Clipboard. You can then paste and save the installation log inany text-editing program.

6. Click Next when the setup has successfully completed. The last page appears witha message that Noetix Search has been installed successfully.

Page 43: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 35

7. Click Finish to exit the Noetix Search Setup wizard.

On Linux or SolarisYou can reinstall the software on a computer running Linux or Solaris by performingthe steps provided under On Linux or Solaris in the “Installing the Software” section.

IMPORTANT: After the reinstallation is complete, you must restart the Apache Tomcatservice so that any of the previous installation’s files that are cached by Apache Tomcat arerefreshed.

Page 44: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

36 Noetix Search Installation Guide

Upgrading the SoftwareThis section explains how to upgrade Noetix Search on a computer running MicrosoftWindows, Linux, or Solaris.

On WindowsThe procedure for upgrading Noetix Search on Windows is as follows:

To upgrade Noetix Search

1. Perform steps 1 through 3 provided under “On Windows” in the “Installing theSoftware” section. The Installation Found page appears.

Page 45: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 37

2. Click Next to proceed with the upgrade. The Choose Components page appears.

NOTE: The components that are already installed will be automatically selected forupgradation and unavailable for selection. The details of the components are providedin step 3 under “On Windows” in the “Installing the Software” section.

Page 46: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

38 Noetix Search Installation Guide

3. Select the components that you want to upgrade, and then click Next. The NoetixSearch page appears.

• If you selected the Install Apache Tomcat component, the Noetix SearchSetup page appears as shown under step 4.

• If you did not select the Install Apache Tomcat component, the ApacheTomcat Information page appears.

Page 47: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 39

4. Specify the paths to the Tomcat configuration directory and Tomcat webappsdirectory and type the port that Apache Tomcat is configured on. You can acceptthe default path that is displayed or change the path. To change the path, click

, navigate to the folder location, select the destination folder, and then clickNext. The Noetix Search page appears.

Page 48: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

40 Noetix Search Installation Guide

5. Click Install to start the installation process. The progress of the installation isdisplayed. You can click Show details to view the actions performed by theinstallation wizard. To copy the installation log, right-click the information, andthen click Copy Details To Clipboard. You can then paste and save theinstallation log in any text-editing program.

Page 49: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 41

6. Click Next when the setup has successfully completed. The last page appears witha message that Noetix Search has been installed successfully.

7. Click Finish to exit the Noetix Search Setup wizard.

Page 50: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

42 Noetix Search Installation Guide

On Linux or SolarisYou can upgrade the software on a computer running Linux or Solaris by performingthe steps provided under On Linux or Solaris in the “Installing the Software” section.

IMPORTANT: After the upgrade is complete, you must restart the Apache Tomcat service sothat any of the previous installation files cached by Apache Tomcat are refreshed.

Page 51: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 43

Uninstalling the SoftwareThis section explains how to uninstall Noetix Search on a computer running MicrosoftWindows, Linux, or Solaris.

On WindowsThe procedure for uninstalling Noetix Search on Windows is as follows:

To uninstall Noetix Search

1. Click Start > All Programs > Noetix Search <version> > Uninstall. Alternatively,you can uninstall the software using Add or Remove Programs in Control Panel.The Welcome to the Noetix Search Unistall Wizard page appears.

Page 52: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

44 Noetix Search Installation Guide

2. Review the information provided on this page, and then click Next to continue.The Uninstall Noetix Search page appears.

3. Click Uninstall. The uninstall process starts, and the next page displays theprogress of the uninstallation. You can click Show details to view the actionsperformed by the uninstallation wizard. To copy the uninstallation log, right-clickthe information, and then click Copy Details To Clipboard. You can then pasteand save the uninstallation log in any text-editing program.

Page 53: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 3: Installing Noetix Search 45

4. Click Next when the setup has successfully completed. The last page appears witha message that Noetix Search has been uninstalled successfully.

5. Click Finish to exit the Noetix Search Setup wizard.

NOTE: After the uninstallation process, all generated content is removed. Apache Tomcatwill also be removed if it was installed as a part of the Noetix Search installation.

On Linux or SolarisThe procedure for uninstalling Noetix Search on Linux or Solaris is as follows:

To uninstall Noetix Search

1. Stop the Apache Tomcat service.

2. At the command prompt, delete the directory where Noetix Search is installed (forexample, rm –rf /usr/local/noetixsearch) to uninstall NoetixSearch.

3. Restart the Apache Tomcat service.

Page 54: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation
Page 55: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 4

Post-InstallationTasks

This chapter explains the tasks that must be completed after installation of NoetixSearch.

Page 56: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

48 Noetix Search Installation Guide

OverviewAfter installation of Noetix Search, you need to perform certain post-installation tasks.This chapter deals with the specific configuration steps that you must perform.

Page 57: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Chapter 4: Post-Installation Tasks 49

Configuring ORACLE_HOME orTNS_ADMIN

To work with Noetix Search Builder, the ORACLE_HOME or TNS_ADMINenvironment variable must be configured. Configuring the ORACLE_HOME orTNS_ADMIN environment variable enables the Oracle client to access the Oracledatabase.

This section explains how to configure the ORACLE_HOME or TNS_ADMINenvironment variable on a computer running Microsoft Windows, Linux, or Solarisand on which the Oracle client tools have been installed.

On WindowsYou must configure the ORACLE_HOME or TNS_ADMIN environment variableon the computer where you have installed Noetix Search Builder.

To configure the ORACLE_HOME or TNS_ADMIN environment variable

1. In Control Panel, double-click System. The System Properties dialog box isdisplayed.

2. Click the Advanced tab, and then click Environment Variables. TheEnvironment Variables dialog box is displayed.

3. In the System variables area, click New. The New System Variable dialog box isdisplayed.

4. In the Variable name box, type ORACLE_HOME or TNS_ADMIN.

5. In the Variable value box, type the path of the Oracle Home folder or the OracleTNS ADMIN folder where the tnsnames.ora file is located (for example,C:\oracle\ora92\network\ADMIN).

6. Click OK to close the dialog boxes.

Page 58: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

50 Noetix Search Installation Guide

On Linux or SolarisYou must configure the ORACLE_HOME or TNS_ADMIN environment variableon the computer where you have installed Noetix Search Builder.

To configure the ORACLE_HOME environment variable

1. At the command prompt, press ENTER after you type the following commandsin the order in which they are specified:

• ORACLE_HOME=<path of the Oracle Home folder> (for example,ORACLE_HOME=/usr/oracle/ora92)

• export ORACLE_HOME

NOTE: To set the ORACLE_HOME environment variable permanently, edit the userstartup script (for example, /home/user/.profile) or a system-wide startup script (for example,/etc/profile) so that the script runs the commands that are mentioned in this step.

2. To verify that the ORACLE_HOME environment variable has been set correctly,type echo $ ORACLE_HOME at the command prompt, and then pressENTER. The path of the ORACLE_HOME environment variable will bedisplayed.

To configure the TNS_ADMIN environment variable

1. At the command prompt, press ENTER after you type the following commandsin the order in which they are specified:

• TNS_ADMIN=<path of the Oracle TNS ADMIN folder> (for example,TNS_ADMIN=/usr/oracle/ora92/network/ADMIN)

• export TNS_ADMIN

NOTE: To set the TNS_ADMIN environment variable permanently, edit the user startupscript (for example, /home/user/.profile) or a system-wide startup script (for example, /etc/profile) so that the script runs the commands that are mentioned in this step.

2. To verify that the TNS_ADMIN environment variable has been set correctly, typeecho $ TNS_ADMIN at the command prompt, and then press ENTER. Thepath of the TNS_ADMIN environment variable will be displayed.

Page 59: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Appendix

Legal Notices

Page 60: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

52 Noetix Search Installation Guide

GNU Lesser General PublicLicense

Version 3, 29 June 2007

Copyright (C) 2007 Free Software Foundation, Inc.

Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.

This version of the GNU Lesser General Public License incorporates the terms and conditions of version 3 of the GNU General Public License, supplemented by the additional permissions listed below.

0. Additional Definitions.

As used herein, “this License” refers to version 3 of the GNU Lesser General Public License, and the “GNU GPL” refers to version 3 of the GNU General Public License.

“The Library” refers to a covered work governed by this License, other than an Application or a Combined Work as defined below.

An “Application” is any work that makes use of an interface provided by the Library, but which is not otherwise based on the Library. Defining a subclass of a class defined by the Library is deemed a mode of using an interface provided by the Library.

A “Combined Work” is a work produced by combining or linking an Application with the Library. The particular version of the Library with which the Combined Work was made is also called the “Linked Version”.

The “Minimal Corresponding Source” for a Combined Work means the Corresponding Source for the Combined Work, excluding any source code for portions of the Combined Work that, considered in isolation, are based on the Application, and not on the Linked Version.

The “Corresponding Application Code” for a Combined Work means the object code and/or source code for the Application, including any data and utility programs needed for reproducing the Combined Work from the Application, but excluding the System Libraries of the Combined Work.

1. Exception to Section 3 of the GNU GPL.

You may convey a covered work under sections 3 and 4 of this License without being bound by section 3 of the GNU GPL.

Page 61: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Appendix: Legal Notices 53

2. Conveying Modified Versions.

If you modify a copy of the Library, and, in your modifications, a facility refers to a function or data to be supplied by an Application that uses the facility (other than as an argument passed when the facility is invoked), then you may convey a copy of the modified version:

a) Under this License, provided that you make a good faith effort to ensure that, in the event an Application does not supply the function or data, the facility still operates, and performs whatever part of its purpose remains meaningful, or

b) Under the GNU GPL, with none of the additional permissions of this License applicable to that copy.

3. Object Code Incorporating Material from Library Header Files.

The object code form of an Application may incorporate material from a header file that is part of the Library. You may convey such object code under terms of your choice, provided that, if the incorporated material is not limited to numerical parameters, data structure layouts and accessors, or small macros, inline functions and templates (ten or fewer lines in length), you do both of the following:

a) Give prominent notice with each copy of the object code that the Library is used in it and that the Library and its use are covered by this License.

b) Accompany the object code with a copy of the GNU GPL and this license document.

4. Combined Works.

You may convey a Combined Work under terms of your choice that, taken together, effectively do not restrict modification of the portions of the Library contained in the Combined Work and reverse engineering for debugging such modifications, if you also do each of the following:

a) Give prominent notice with each copy of the Combined Work that the Library is used in it and that the Library and its use are covered by this License.

b) Accompany the Combined Work with a copy of the GNU GPL and this license document.

c) For a Combined Work that displays copyright notices during execution, include the copyright notice for the Library among these notices, as well as a reference directing the user to the copies of the GNU GPL and this license document.

Page 62: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

54 Noetix Search Installation Guide

d) Do one of the following:

0) Convey the Minimal Corresponding Source under the terms of this License, and the Corresponding Application Code in a form suitable for, and under terms that permit, the user to recombine or relink the Application with a modified version of the Linked Version to produce a modified Combined Work, in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source.

1) Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (a) uses at run time a copy of the Library already present on the user's computer system, and (b) will operate properly with a modified version of the Library that is interface-compatible with the Linked Version.

e) Provide Installation Information, but only if you would otherwise be required to provide such information under section 6 of the GNU GPL, and only to the extent that such information is necessary to install and execute a modified version of the Combined Work produced by recombining or relinking the Application with a modified version of the Linked Version. (If you use option 4d0, the Installation Information must accompany the Minimal Corresponding Source and Corresponding Application Code. If you use option 4d1, you must provide the Installation Information in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source.)

5. Combined Libraries.

You may place library facilities that are a work based on the Library side by side in a single library together with other library facilities that are not Applications and are not covered by this License, and convey such a combined library under terms of your choice, if you do both of the following:

a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities, conveyed under the terms of this License.

b) Give prominent notice with the combined library that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work.

Page 63: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Appendix: Legal Notices 55

6. Revised Versions of the GNU Lesser General Public License.

The Free Software Foundation may publish revised and/or new versions of the GNU Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.

Each version is given a distinguishing version number. If the Library as you received it specifies that a certain numbered version of the GNU Lesser General Public License “or any later version” applies to it, you have the option of following the terms and conditions either of that published version or of any later version published by the Free Software Foundation. If the Library as you received it does not specify a version number of the GNU Lesser General Public License, you may choose any version of the GNU Lesser General Public License ever published by the Free Software Foundation.

If the Library as you received it specifies that a proxy can decide whether future versions of the GNU Lesser General Public License shall apply, that proxy's public statement of acceptance of any version is permanent authorization for you to choose that version for the Library.

Page 64: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

56 Noetix Search Installation Guide

GNU General Public LicenseVersion 2, June 1991

Copyright (C) 1989, 1991 Free Software Foundation, Inc.

675 Mass Ave, Cambridge, MA 02139, USA

Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.

Preamble

The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to ensure that the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) You can apply it to your programs, too.

When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to ensure that you have the freedom to distribute copies of free software (and charge for this service if you want), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things.

To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it.

For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must ensure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.

We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software.

Page 65: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Appendix: Legal Notices 57

Also, for each author’s protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations.

Finally, any free program is threatened constantly by software patents. We want to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all.

The precise terms and conditions for copying, distribution and modification follow.

GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The “Program”, below, refers to any such program or work, and a “work based on the Program” means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term “modification”.) Each licensee is addressed as “you”.

Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does.

1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program.

You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee.

Page 66: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

58 Noetix Search Installation Guide

2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions:

1. You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change.

2. You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License.

3. If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.)

These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it.

Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program.

In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License.

Page 67: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Appendix: Legal Notices 59

3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following:

1. Accompany it with the complete corresponding computer-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,

2. Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete computer-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,

3. Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.)

The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable.

If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code.

4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.

5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it.

Page 68: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

60 Noetix Search Installation Guide

6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License.

7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program.

If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances.

It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice.

This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License.

8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License.

Page 69: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Appendix: Legal Notices 61

9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.

Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and “any later version”, you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation.

10. If you want to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally.

NO WARRANTY

11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

END OF TERMS AND CONDITIONS

Page 70: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

62 Noetix Search Installation Guide

Apache LicenseVersion 2.0, January 2004

http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

“License” shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.

“Licensor” shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.

“Legal Entity” shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, “control” means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.

“You” (or “Your”) shall mean an individual or Legal Entity exercising permissions granted by this License.

“Source” form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.

“Object” form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.

“Work” shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).

“Derivative Works” shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.

Page 71: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Appendix: Legal Notices 63

“Contribution” shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, “submitted” means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as “Not a Contribution.”

“Contributor” shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.

2. Grant of Copyright License.

Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.

3. Grant of Patent License.

Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.

4. Redistribution.

You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:

a) You must give any other recipients of the Work or Derivative Works a copy of this License; and

b) You must cause any modified files to carry prominent notices stating that You changed the files; and

Page 72: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

64 Noetix Search Installation Guide

c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and

d) If the Work includes a “NOTICE” text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.

You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.

5. Submission of Contributions.

Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.

6. Trademarks.

This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.

Page 73: Noetix Search Installation Guidesupport.noetix.com/docs/1769/143/NoetixSearchInstallationGuide.pdf · viii Noetix Search Installation Guide About This Guide The Noetix Search Installation

Appendix: Legal Notices 65

7. Disclaimer of Warranty.

Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.

8. Limitation of Liability.

In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability.

While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS