Skip to main content

Install Noetix Search

Review System Requirements

ReviewthesystemrequirementsforNoetixSearch or Noetix Search Builder for Noetix Search Enterprise Managerinthereleasenotesthatareavailablewiththe productorinArticleNo.000008048(INFO:DocumentationforMagnitudeNoetixSearch/Noetix Search Builder for Noetix Enterprise Manager)onthe KnowledgeareaoftheMagnitudeSupportCommunity,andmakesurethattherequirementshave been met.

Install AdoptOpenJDK for Noetix Search on Windows

You must install AdoptOpenJDK(JDK or JRE) before installing or upgrading Noetix Search on Windows.

To install AdoptOpenJDK

Download the OpenJDK8U-jre|jdk x64 windows hotspot 8u265b01.msi file on the AdoptOpenJDK website by selecting the following options:

Version: OpenJDK 8 (LTS)

JVM: HotSpot

Operating System: Windows

Architecture: x64

Run the OpenJDK8U-jre|jdk x64 windows hotspot 8u265b01.msi file. The installation setup wizard appears.

Proceed with the default values in the setup wizard. However, on the Custom Setup page, select Entire feature will be installed on local hard drive for the following options:

SET Java Home variable

JavaSoft (Oracle) registry keys

The installation process is complete.

Configure an Environment Variable in Linux, AIX, or Solaris

The environment variable for Java needs to be configured for Noetix Search to operate properly on a computer that is running Linux, AIX, or Solaris. You need to verify that the Java Runtime Environment (JRE) is installed before you can configure the environment variable.

The environment variable is automatically detected by the Noetix Search Setup for a computer running Microsoft Windows on which you intend to install Noetix Search.

To configure the environment variable

At the command prompt, type JAVA HOME=<path of JAVA HOME>, and press ENTER. The JAVA HOME environment variable is set to the value that you have specified.

The <path of JAVA HOME> placeholder represents the location where the Java runtime environment (JRE) is installed on your computer. For example, JAVA HOME=/usr/jre/latest.

At the command prompt, type export JAVA HOME, and press ENTER. The environment variable is globally available within the current user shell.

To set the environment variable permanently, edit the user startup script (for example, <user home directory>\.profile) or a system startup script (for example, /etc/profile) so that the commands mentioned in step 1 and 2 are run.

To verify that the environment variable has been set properly, at the command prompt, type echo $<environment variable>, and press ENTER. The path of the environment variable is displayed.

Install Noetix Search on Windows

This section explains how to install Noetix Search on a computer running Microsoft Windows.

To install Noetix Search on Windows

Double-click Noetix.exe in the Noetix Search setup files. The Noetix Search splash screen appears.

 

Click Install Noetix Search. The welcome page of the Noetix Search Setup wizard appears.

Click Next. The Software License Agreement page appears.

 

Click I Agree. The Choose Componentspage appears.

The following components are available for installing:

Noetix Search Builder: By default, this check box is selected. This component generates the Noetix Search indexes for Noetix Search and can be installed on a client computer or server computer. The client computer on which you install this component must be able to connect to the NoetixViews schema, the Noetix Analytics instance, the RapidDecision instance, and the server computer on which you have installed the Noetix Search Server.

Noetix Search Builder Service: By default, this check box is cleared. If selected, this component is used to configure the Noetix Search Builder Service to integrate with the Noetix Enterprise Manager (Noetix Enterprise Manager) server.

Noetix Search Server: By default, this check box is selected. This component installs the enterprise search server that develops Noetix Search indexes and/or attributes for content that will be delivered through a web browser. It also installs and configures the Apache Tomcat Servlet container and Apache web server. This component can be installed on the server computer only and must be selected if any component other than Noetix Search Builder is selected.

Integrate Noetix Search Server with IIS: By default, this check box is selected. If you have Internet Information Services (IIS) installed on the computer, this component integrates Noetix Search Server with IIS by using Internet Server Application Programming Interface (ISAPI) filter and Tomcat Connector so that all web pages are served through the same port as the other web applications hosted in IIS. This component provides a seamless web experience and a simpler security setup to limit access to the application. The Noetix Search Setup wizard configures IIS to pass requests for Noetix Search pages to Noetix Search Server.

Click Next. The Installation Location page appears.

Accept the default destination folder path that is displayed or change the destination folder. To change the destination folder, click Browse, navigate to the folder location, select the destination folder, and click OK. Then, click Next. The Choose Start Menu Folder page appears.

Enter a Start menu folder name under which you want to create shortcuts for Noetix Search. The default folder name is Noetix Search. If you select a Start menu folder from the list, the default folder name is added to the end of the selection.

If you do not want to create the shortcuts for Noetix Search, select the Do not create shortcutscheck box.

Click Next. If you selected the Noetix Search Builder Service component in step 4, the Noetix Enterprise Manager Location page appears.

In the Server Name box, type the name of the server on which Noetix Enterprise Manager is installed.

Click Next. The Ready to Install message is displayed on the Noetix Search page.

Click Install to start the installation process. The progress of the installation is displayed.

(Optional.) Click Show details to view the installation log.

(Optional.) To copy the installation log, right-click the information, click Copy Details To Clipboard, and save the installation log in a text-editing program.

Click Nextin the Installation Complete page. The page appears with the message that Noetix Search has been installed.

Click Finish. The Noetix Search Setup wizard exits.

Click Exit. The Noetix Search splash screen exits.

Install Noetix Search on Linux, AIX, or Solaris

This section explains how to install Noetix Search on a computer running Linux, AIX, or Solaris.

Verify that Apache Tomcat is installed and note the port number on which it is running.

To install Noetix Search on Linux, AIX, or Solaris

At the command prompt, navigate to the directory where you have downloaded the NoetixSearch-<version>.tar.gz source file.

Type the following command, and press ENTER:

gunzip NoetixSearch-<version>.tar.gz

The NoetixSearch-<version>.tar file is created.

Type the following command, and press ENTER:

tar xvf NoetixSearch-<version>.tar

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

Type cd NoetixSearch-<version>, and press ENTER.

Type su,and press ENTER to obtain administrative privileges.

Type the super user password that has been assigned to you as an administrator, and press ENTER.

Type ./install.sh to start the Noetix Search installer.

When prompted for the Noetix Search installation location, press ENTER to accept the default location or type a different location. If the location does not exist, type y to create the location, or type n if you want to specify a different location.

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

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

Press ENTER to accept the default location of the Tomcat configuration files, or type a new location.

Press ENTER to accept the default location of the Tomcat webapps directory, or type a new location.

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

The installation process starts. After the process is complete, Noetix Search is installed on the computer.

Reinstall Noetix Search on Windows

This section explains how to reinstall Noetix Search on a computer running Microsoft Windows. You can reinstall the software using the same Noetix Search Setup that was used for the initial installation. Reinstallation of the software may be required in the following scenarios:

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 to technical problems.

To reinstall Noetix Search

Perform steps Double-click Noetix.exe in the Noetix Search setup files. The Noetix Search splash screen appears. through Click Next. The Software License Agreement page appears. provided under the “Install Noetix Search on Windows” section, and click I Agreein the Software License Agreement page. TheInstallation Found page appears.

Click Add/Reinstall components, and click Next. The Choose Components page appears.

The components that are already installed are automatically reinstalled and unavailable for selection. For more information about the components, see step Click I Agree. The Choose Components page appears. under the “Install Noetix Search on Windows” section.

Click Next. The Ready to Install message is displayed on the Noetix Search page.

Click Install to start the reinstallation process. The progress of the reinstallation is displayed. Click Show details to view the installation log. To copy the installation log, right-click the information, click Copy Details To Clipboard, and save the installation log in a text-editing program.

Click Nextin the Installation Complete page. The page appears with the message that Noetix Search has been installed.

Click Finish. The Noetix Search Setup wizard exits.

Click Exit on the Noetix Search splash screen to close it.

Reinstall Noetix Search on Linux, AIX, or Solaris

You can reinstall the software on a computer running Linux, AIX, or Solaris by performing the steps provided under Install Noetix Search on Linux, AIX, or Solaris.

Important: After the reinstallation process is complete, you must restart the Apache Tomcat service so that any files from the previous installation that are cached by Apache Tomcat are refreshed.

Upgrade Noetix Search on Windows

This section explains how to upgrade Noetix Search on a computer running Microsoft Windows.

To upgrade Noetix Search on Windows

Perform steps Double-click Noetix.exe in the Noetix Search setup files. The Noetix Search splash screen appears. through Click Next. The Software License Agreement page appears. provided under the “Install Noetix Search on Windows” section, and click I Agreein the Software License Agreement page. TheInstallation Found page appears.

Click Next. The Choose Components page appears.

The components that are already installed will be automatically selected and unavailable for selection. For more information about the components, see step Click I Agree. The Choose Components page appears. under the “Install Noetix Search on Windows” section.

Click Next. The Ready to Install message is displayed on the Noetix Search page.

Click Install to start the upgrade process. The progress of the upgrade is displayed. Click Show details to view the installation log. To copy the installation log, right-click the information, click Copy Details To Clipboard, and save the installation log in a text-editing program.

Click Nextin the Installation Complete page. The page appears with the message that Noetix Search has been installed.

Click Finish. The Noetix Search Setup wizard exits.

Click Exit on the Noetix Search splash screen to close it.

After you upgrade Noetix Search, you must regenerate all existing Noetix Search instances.

Upgrade Noetix Search on Linux, AIX, or Solaris

This section explains how to upgrade Noetix Search on a computer running Linux, AIX, or Solaris. For more information about upgrading the software on a computer running Linux, AIX, or Solaris, see Install Noetix Search on Linux, AIX, or Solaris.

Important: After the upgrade process is complete, you must restart the Apache Tomcat service so that any files from the previous installation that are cached by Apache Tomcat are refreshed. You must also regenerate all your existing Noetix Search instances to refresh the indexes.

Install Noetix Search on a Second Computer

This section explains how to install Noetix Search on a second computer by selecting only the Noetix Search Builder component and optionally, by selecting the Noetix Search Builder Service component. The computer on which you install this Noetix Search Builder component must be able to connect to the NoetixViews schema, the Noetix Analytics instance, the RapidDecision instance, and the server computer where the Noetix Search Server is installed. In the case of a distributed installation where the Noetix Search Builder and Noetix Search Server components are installed on two different computers, the help file for the Noetix Search Builder component will be installed with the Noetix Search Server component. In such a case, you need to modify the help URL in the Noetix.Search.Builder.properties file as follows: DEFAULT HELP URL=http://<name of the computer where the Noetix Search Server application is installed>:<port number>/noetixsearch/nsbhelp.

To install Noetix Search on a second computer

Perform steps Double-click Noetix.exe in the Noetix Search setup files. The Noetix Search splash screen appears. through Click Next. The Software License Agreement page appears. provided under the “Install Noetix Search on Windows” section, and click I Agreein the Software License Agreement page. TheInstallation Found page appears.

Click Add/Reinstall components, and click Next. The Choose Components page appears.

The components that are already installed are automatically reinstalled and unavailable for selection. For more information about the components, see step Click I Agree. The Choose Components page appears. under the “Install Noetix Search on Windows” section.

Select the Noetix Search Builder component, and optionally, the Noetix Search Builder Service component. Click Next. The Installation Location page appears.

Accept the default destination folder path that is displayed or change the destination folder. To change the destination folder, click Browse, navigate to the folder location, select the destination folder, and click OK. Then, click Next. The Choose Start Menu Folder page appears.

Enter a Start menu folder name under which you want to create shortcuts for Noetix Search. The default folder name is Noetix Search. If you select a Start menu folder from the list, the default folder name is added to the end of the selection.

If you do not want to create the shortcuts for Noetix Search, select the Do not create shortcuts check box.

Click Next, and do one of the following:

If you did not select the Noetix Search Builder Service component, the Ready to Install message appears on the Noetix Search page. Go to step 9.

If you selected the Noetix Search Builder Service component in step Select the Noetix Search Builder component, and optionally, the Noetix Search Builder Service component. Click Next. The Installation Location page appears., the Noetix Enterprise Manager Location page appears. Go to step 7.

In the Server Name box, type the name of the server on which Noetix Enterprise Manager is installed.

If more than one Noetix Search Builder Service component from different computers reference the same Noetix Enterprise Manager server, the server chooses between the available components when Noetix Search Builder for Noetix Enterprise Manager is run on the server. Therefore, if Noetix Search Builder uses customized scripts, these customizations must be identical on all the computers where Noetix Search Builder is installed to reference the same Noetix Enterprise Manager server.

Click Next. The Ready to Install message is displayed on the Noetix Search page.

Click Install to start the installation process. The progress of the installation is displayed. After the installation completes, the Installation Complete page appears.

Click Nextin the Installation Complete page. The page appears with the message that Noetix Search has been installed.

Click Finish. The Noetix Search Setup wizard exits.

Install Noetix Search Builder for Noetix Enterprise Manager

This section explains how to install the Noetix Search Builder for Noetix Enterprise Manager. Noetix Search must be installed with the Noetix Search Builder Service component selected and configured to be used with the Noetix Enterprise Manager server. If Noetix Search is already installed, verify that the component is selected and configured. If the component is not selected, reinstall Noetix Search to select and configure the Noetix Search Builder Service component. For more information about selecting and configuring the component, see
Install Noetix Search on Windows.

To install Noetix Search Builder for Noetix Enterprise Manager

Double-click SearchCartridge-<version>-windows-x64.exethat is located in the Noetix Enterprise Manager folder in the Noetix Search setup files. The welcome page of the Noetix Search Builder Cartridge Setup wizard appears.

Click Next. The Software License Agreement page appears.

Click I Agree. The Choose Start Menu Folder page appears.

Enter a Start menu folder name under which you want to create shortcuts for Noetix Search Builder for Noetix Enterprise Manager. By default, it is Noetix Search Builder Cartridge. If you select a Start menu folder name from the list, the default name is added to the end of the selection. If you do not want to create shortcuts, select the Do not create shortcuts check box, and then click Next. The Ready to Install message is displayed on the Noetix Search Builder Cartridge page.

Click Install. The Installing page appears displaying the progress of the installation.

When the installation is complete, the Installation Complete page appears.

Click Next. The Noetix Search Builder Cartridge Setup wizard displays a page stating that the application has been installed successfully.

Click Finish. The Noetix Search Builder Cartridge Setup wizard exits.

Repair Noetix Search Builder for Noetix Enterprise Manager

This section explains how to repair the Noetix Search Builder for Noetix Enterprise Manager.

To repair Noetix Search Builder for Noetix Enterprise Manager

Double-click SearchCartridge-<version>-windows-x64.exethat is located in the Noetix Enterprise Managerfolder in the Noetix Search setup files. The welcome page of the Noetix Search Builder Cartridge Setup wizard appears.

Click Next. The Software License Agreement page appears.

Click I Agree. The Installation Found page appears.

Select the Repair Noetix Search Builder Cartridge option, and click Next. The Ready to Install message is displayed on the Noetix Search Builder Cartridge page.

Verify the installation location, and click Install. The Installing page appears displaying the progress of the installation.

o

When the installation is complete, the Installation Complete page appears.

Click Next. The Noetix Search Builder Cartridge Setup wizard displays a page stating that the application has been installed successfully.

Click Finish. The Noetix Search Builder Cartridge Setup wizard exits.

Upgrade Noetix Search Builder for Noetix Enterprise Manager

This section explains how to upgrade the Noetix Search Builder for Noetix Enterprise Manager.

To upgrade Noetix Search Builder for Noetix Enterprise Manager

Perform steps Double-click SearchCartridge-<version>-windows-x64.exe that is located in the Noetix Enterprise Manager folder in the Noetix Search setup files. The welcome page of the Noetix Search Builder Cartridge Setup wizard appears. through Click I Agree. The Choose Start Menu Folder page appears. provided under the “Install Noetix Search Builder for Noetix Enterprise Manager” section, and click I Agree in the Software License Agreement page. The Installation Found page appears.

Select the Upgrade Noetix Search Builder Cartridge option, and click Next. The Ready to Install message is displayed on the Noetix Search Builder Cartridge page.

Click Install. The Installing page appears.

When the installation is complete, the Installation Complete page appears.

Click Next. The Noetix Search Builder Cartridge Setup wizard displays a page stating that the application has been installed successfully.

Click Finish. The Noetix Search Builder Cartridge Setup wizard exits.

Was this article helpful?

We're sorry to hear that.