Xcalar Quick Installation Guide
Xcalar Quick Installation Guide
This quick installation guide provides basic instructions for installing Xcalar.
- Your system meets the Xcalar hardware and software requirements and that the installation host and each cluster node is running the same Xcalar supported version of Linux OS.
- That the node0 node of your cluster contains enough storage space for an NFS export and is at least 1 terabyte in size.
- That you created a Xcalar Owner user on each cluster node who can run commands as root using SUDO on all the nodes within the cluster.
- That you can establish a SSH connection from the installation host to all the Xcalar cluster nodes as the Xcalar Owner user.
- That the Xcalar supported web browser can access the installation host on port 8543.
- That the SUDO program is installed on the installation host and each of Xcalar cluster nodes.
- That the information requirements form is completed and the values are accessible to the user installing Xcalar.
Running the Xcalar GUI installer on the installation host
This section describes the procedures for running the Xcalar GUI installer.
The following tasks can be run by any user on the installation host.
To run the Xcalar GUI installer on the Installation host:
- Log in to the installation host as any user.
- Verify that one of the recommended Linux operating systems is installed, by running one the following commands:
Download the Xcalar GUI Installer tar archive by doing the following:
On the Installation host, open a terminal.
Create a temporary directory (temp_dir).
Go to the Xcalar customer portal, by opening a browser window from the computer on which the Xcalar supported web browser is installed and entering the following:
Download the Xcalar GUI Installer
xcalar-gui-userinstaller-version-build.shshell archive to the temp_dir that was created in step b.
- version is the Xcalar version number.
- build is the Xcalar software build number.
Verify that the Xcalar GUI Installer has read, write, and execute permissions.
Run the Xcalar GUI Installer with the following command:
If successful, the command print output displays the following message:
Running installation shell archive, press Ctrl-C to stop
This section describes the procedures for Installing, deploying, and configuring Xcalar Compute Engine and Xcalar Design.
To install Xcalar:
From the supported browser on a computer with network connectivity to the installation host, open a browser window.
In the web browser URL field, enter the following URL:
Where ip_FQDN is the IP address or FQDN name of the Installation host on which the Xcalar GUI Installer is running.TIP: If the fully qualified domain name (FQDN) of the installation host is host1.mycompany.com, then enter https://host1.mycompany.com:8543.
Click Enter, which connects you to the Xcalar installer website.
The Xcalar Wizard MAKE A SELECTION page appears.
From the options provided, select INSTALL WIZARD.
Click NEXT. The ENTER LICENSE KEY page appears.
In the ENTER LICENSE KEY field, enter your Xcalar license key text exactly as provided and without trailing spaces.
Click NEXT. The Xcalar Wizard STEP 2 INSTALLATION TYPE page appears.
- Select The installing Linux user has admin privileges and I want the installer to complete all pre-install tasks for me.
- Click NEXT. The Xcalar Wizard STEP 3 SET UP XCALAR ROOT DIRECTORY page appears.
- Select Xcalar Deployed Shared Storage.
- Click NEXT. The Xcalar Wizard STEP 4 SET UP LDAP page appears.
- Select Xcalar Deployed and enter following:
- In the DOMAIN NAME field, enter your company’s web address.
- In the NEW PASSWORD field, enter the password for the Xcalar Admin user.
- In the CONFIRM PASSWORD field, re-enter the password of the Xcalar Admin user.
- In the COMPANY NAME field, enter the full name of your company.
During the Xcalar installation, the Xcalar GUI installer creates an LDAP environment and a Xcalar Admin for you from the provided values.
- Click NEXT. The Xcalar Wizard STEP 5A SET UP NODES page appears.
- In the Enter the number of nodes in your cluster and press Enter field, enter the number of nodes that reside in your computer cluster.
- Click NEXT. The Xcalar Wizard STEP 5A SET UP NODES page refreshes to display the connection requirements for each of the nodes within your Xcalar cluster.
- In the STEP 5A Hostnames section, enter the following for each node:
- In the PUBLIC field, enter the IP address or the FQDN.
- (Optional) In the PRIVATE field, enter the IP address or the FQDN.
- In the STEP 5B Installation Directory section, enter the path and directory name for the Xcalar Install Directory or choose the default.
- In the STEP 5C Serialization/Deserialization Directory section, enter the path and directory name of the Demand Paging area that will store temporary Xcalar tables when the memory swapping space is low.
- (Optional) To send daily support data to Xcalar, in the STEP 5D Support Bundles Generation section, select the Enable daily support bundles checkbox.
In the STEP 5E Credentials section, enter the following:
- In the USERNAME field, enter the Xcalar Owner user name (XCE_USER value).
- In the SSH PORT field, enter the secure shell (SSH) port number. By default, this number is 22.
In the Password Options section, do one of the following:
- For authenticating access to all cluster nodes by Xcalar with a password, select Password and in the PASSWORD field, enter the password for the Xcalar Owner user.
- For authenticating access to all cluster nodes by Xcalar with SSH using your SSL private key, select SSH Key and in the text field enter your SSL private key.
- For authenticating access to all cluster nodes by Xcalar with SSH using an existing SSH user, select SSH User Settings.
- Click INSTALL, which deploys Xcalar Compute Engine and Xcalar Design on all the nodes within the Xcalar cluster.
When the installation is completed, either click LAUNCH XD or connect to Xcalar Design on any of the Xcalar cluster nodes with the following URL:
Where node_name is the IP address or FQDN of the Xcalar cluster node on which you logged in to.
- To stop running the Xcalar GUI installer, in the terminal where you are running the Xcalar GUI installer, press Ctrl-C.