Installing on a Single Node

Overview

You will use an installation wizard to install a new instance of Incorta on a single node. Successful completion of the procedure results in the Cluster Management Console being ready for use. You will then be able to start up other services and set up Incorta to access your desired data sources.

You will need a copy of the Incorta installation package, incorta-package.zip. Please contact your customer support representative if you do not have this file.

You will need information about the available ports for your system as the installation defaults may not be appropriate for your host. It is recommended you construct a table of values for all of the Cluster Management Console (CMC) and Node Agent configuration screens before you begin. The following table shows the default parameters for both components. See Incorta Installation Wizard Default Values for guidance.

This procedure was written based on installing Incorta on a Mac Book Pro, running Catalina with 16 GiB of RAM.

Prerequisites

This can only be performed on a previously provisioned host. See Installation Requirements.

Procedure

If you have not already done so, gather all of the information necessary for configuring the CMC and Node Agent. See Incorta Installation Wizard Default Values for guidance.

1. Unpack the Incorta archive file, incorta-package.zip.

Get access to the command line by starting a terminal application. Navigate to the location of the Incorta archive file. The location of the file is not critical.

$ unzip incorta-package.zip -d incorta-package

This unpacks the Incorta elements into a directory called ~/incorta-package.

2. Start the Incorta installation wizard.

The wizard is found in incorta-package in this example. Run it by typing:

$ sh ~/incorta-package/install

3. Enter values for the License Agreement, Installation Type and Installation Set screens.

Accept the license agreement, Enter New Installation for the Installation Type and enter Typical (translates to single-node) for the Installation Set.

Click Next.

Note HA item on the wizards left panel is set transparently.

4. Set the Incorta installation directory.

In this example, the user id is incorta so the default value appears as /Users/incorta/IncortaAnalytics. Set the path as appropriate.

Click Next.

5. Configure Incorta

Enter values for the Node Agent Configuration, CMC Configuration - Step 1 and CMC Configuration - Step 2 according to the values you have researched and recorded above. You’ll need to click Next to advance through the screens.

At the Summary screen, note where the CMC and Incorta Node software components are installed.

If satisfied, click Install. Otherwise, use the Previous button to back through the wizard and make changes.

The installation process will proceed. It will take a few moments to complete. The installation wizard indicates a successful installation by bringing up the Start CMC screen

6. Indicate to the wizard that the CMC should be started.

Select both Start CMC and Open the application in a browser.

Click Next.

The Installation Status screen should appear and indicate success. If it does not, look for the Java icon for more information. Pay special attention to files mentioned have a .err extension.

Before attempting another installation, be sure to remove vestiges of the current failed installation by deleting, in this case, /Users/incorta/IncortaAnalytics.

Click Done on success and return to the terminal you used to start the wizard.

7. Confirm the CMC is running:

$ ps -ef | grep "cmc"

This should produce a long line of text (likely wrapped) where a portion of the string reads, for example, IncortaAnalytics/cmc.

If this line does appear, Incorta has been successfully installed and the CMC is running.

Troubleshooting: Installation

Issue: The CMC doesn’t open automatically after configuration.

Resolution: Check to ensure you have installed Java and identified the Java home path.

You can now use the CMC to set up an Incorta Cluster. See Starting Incorta Services.