TAR File Installation¶

Introduction¶

At this time, an RPM file is the only artifact built into Kylo. An RPM installation is meant to be an opinionated way of installing an application, and it reduces the number of steps required to complete the installation. That said, some clients have strict requirements as to where they need to install Kylo, and the user that Kylo must be run under. These instructions will guide you through an alternative way to install Kylo, if that is required in your case.

Determine Service Account and Kylo Install Location¶

Let’s assume, for this example, that Kylo will run under an account name “kylo_user”, and it will be installed in /opt/apps/.

Step 1: Install the RPM and copy the /opt/kylo folder to a temporary location.¶

cp -R /opt/kylo /opt/tb-test

Step 2: Copy init.d scripts to the same temporary location.¶

cp /etc/init.d/kylo-services /opt/tb-test
cp /etc/init.d/kylo-spark-shell /opt/tb-test
cp /etc/init.d/kylo-ui /opt/tb-test

Your temp location should look like this:

[root@sandbox tb-test]# ls -l /opt/tb-test
drwxr-xr-x 8 root root 4096 2016-10-27 20:13 kylo
-rwxr-xr-x 1 root root 1561 2016-10-27 20:20 kylo-services
-rwxr-xr-x 1 root root 1281 2016-10-27 20:21 kylo-spark-shell
-rwxr-xr-x 1 root root 1447 2016-10-27 20:21 kylo-ui

Step 3 (Optional): Tar up the folder and copy it to the edge node if you aren’t already on it.¶

Step 4: Install the files.¶

Copy the Kylo folder to /opt/apps.
Copy the 3 init.d scripts to /etc/init.d.

Step 5: Create Log Folders¶

[root@sandbox tb-test]# mkdir /var/log/kylo-services
[root@sandbox tb-test]# chown kylo_user:kylo_user
/var/log/kylo-services
[root@sandbox tb-test]# mkdir /var/log/kylo-ui
[root@sandbox tb-test]# chown kylo_user:kylo_user
/var/log/kylo-ui
[root@sandbox tb-test]# mkdir /var/log/kylo-spark-shell
[root@sandbox tb-test]# chown kylo_user:kylo_user
/var/log/kylo-spark-shell/

Step 6: Modify the user in the init.d scripts.¶

Set this line to be the correct user:

RUN_AS_USER=kylo_user

Also change any reference of /opt/kylo to /opt/apps/kylo.

Step 7: Modify the bin scripts for the 3 kylo apps.¶

Modify the following files and change /opt/kylo references to /opt/kylo/apps:

/opt/apps/kylo/kylo-ui/bin/run-kylo-ui.sh
/opt/apps/kylo/kylo-services/bin/run-kylo-services.sh
/opt/apps/kylo/kylo-spark-shell/bin/run-kylo-spark-shell.sh