Xcalar installation overview

This section provides an overview of the Xcalar installation tasks.

Audience

This guide is intended for system administrators who install and configure analytics software and are familiar with Linux operating systems, networking, and computer cluster concepts.

Overview of the Xcalar installation tasks

The following is an overview of the installation procedure for Xcalar:

  1. Fill out the Questionnaire on the Xcalar customer portal at:

    http://myxcalar.zendesk.com/

  2. Review system requirements. For more information, see Xcalar system requirements.
  3. Perform the pre-installation tasks. For more information, see Planning your Xcalar installation and Xcalar pre-installation tasks.
  4. Install and deploy Xcalar. For more information, see Installing Xcalar.

Ensuring a successful Xcalar installation

Follow these guidelines for a successful Xcalar installation:

  • Read the Xcalar system requirements. This ensures that your system has the required base hardware and software.
  • Record all the required configuration values, such as host names, port numbers, user names, and passwords.
  • During the pre-installation tasks, record any new configuration values as you create them. You will be required to enter these configuration values later when you install Xcalar. For more information, see Information requirements.

  • After installing Xcalar, verify that the Xcalar software stack installed successfully.

If you have any issues during the installation and deployment of Xcalar, see Troubleshooting.

Terms used in this guide

Term

Description

Xcalar cluster

A group of two or more bare metal computers or Cloud virtual machines (called nodes) that run Xcalar Design and Xcalar Compute Engine on each node.

Xcalar Admin

The operating system username that is used on all the nodes of the Xcalar cluster, which owns the Xcalar software and runs the Xcalar Design and Xcalar Compute Engine processes.

Xcalar Root Directory

The network file system mount (NFS) that is shared between all nodes of the Xcalar cluster. Xcalar Design and Xcalar Compute Engine write configuration information and session data into this filesystem.

Xcalar Install Directory

The directory on each node in which the Xcalar software is installed.

LDAP Authentication server

Xcalar uses an LDAP server for authentication, such as Microsoft Active Directory. The Xcalar GUI Installer requires the following server information:

  • LDAP URI: the server’s name or IP address and the server’s port number. For example, ldap://xcalarad.int.xcalar.com:389.
  • USER DN: the location in the LDAP server in which to search for user entries. For example, dc=int,dc=xcalar,dc=net.
  • SEARCH FILTER: an LDAP filter that limits the returned number of user entries to one. For example, (&(objectclass=user)(userPrincipalName=%username%))
  • SERVER KEY FILE: The path to the LDAP security certificates that identify the server.
  • TLS usage: A true or false value that lets Xcalar know if the server accepts TLS requests. For example, true.
  • ActiveDirectory identity: A true or false value that lets Xcalar know if the server is an Active Directory server. For example, true.

Configuration Tarball

A tar archive containing software and script packages, which must be run with superuser privileges (run as root) prior to running the Xcalar Installer.

The Configuration Tarball with the Xcalar GUI Installer are downloaded from the Xcalar customer portal at:

https://myxcalar.zendesk.com/

Pre-Config script

A configuration script in the Configuration Tarball named pre-config.sh, which performs necessary operating system level configuration for each Xcalar cluster node. This script must be run by a superuser or with a su or sudo program.

Verification script

A script in the Configuration Tarball named verify.sh, which tests the Pre-Config Script's configuration steps. This script can be run by any user on the node.

Xcalar GUI Installer

A self-extracting shell archive file that contains a web server, a small web site, and software for installing Xcalar on all the Xcalar cluster nodes in parallel. The Xcalar GUI Installer can be run by any user on any host that has a Xcalar supported Linux operating system and that can connect to all the Xcalar cluster nodes with a secure network.

The Xcalar GUI Installer and the Configuration Tarball are downloaded from the Xcalar customer portal at:

https://myxcalar.zendesk.com/.

Installation host

The computer on which you run the Xcalar GUI Installer. This can be one of the nodes within the Xcalar cluster, or a host running the same version of the Xcalar supported Linux operating system that was installed on all the nodes within the Xcalar cluster.

Go to top