Release (March 2, 2018)


Upgrade Instructions from v0.9.0

  1. Backup any Kylo plugins
When Kylo is uninstalled it will backup configuration files, but not the /plugin jar files. If you have any custom plugins in either kylo-services/plugin or kylo-ui/plugin then you will want to manually back them up to a different location.
  1. Uninstall Kylo:
  1. Install the new RPM:
rpm –ivh <RPM_FILE>
  1. Restore previous files. If you have customized the the, copy the backup from the 0.8.3 install.

    4.1 Find the /bkup-config/TIMESTAMP/kylo-services/ file

    • Kylo will backup the file to the following location, /opt/kylo/bkup-config/YYYY_MM_DD_HH_MM_millis/kylo-services/, replacing the “YYYY_MM_DD_HH_MM_millis” with a valid time:

    4.2 Copy the backup file over to the /opt/kylo/kylo-services/conf folder

    ### move the shipped with the .rpm to a backup file
    mv /opt/kylo/kylo-services/conf/ /opt/kylo/kylo-services/conf/
    ### copy the backup properties  (Replace the YYYY_MM_DD_HH_MM_millis  with the valid timestamp)
    cp /opt/kylo/bkup-config/YYYY_MM_DD_HH_MM_millis/kylo-services/ /opt/kylo/kylo-services/conf

    4.3 Copy the /bkup-config/TIMESTAMP/kylo-ui/ file to /opt/kylo/kylo-ui/conf

    4.4 Ensure the property security.jwt.key in both kylo-services and kylo-ui file match. They property below needs to match in both of these files:

    • /opt/kylo/kylo-ui/conf/

    • /opt/kylo/kylo-services/conf/

  2. NOTE: Kylo no longer ships with the default dladmin user. You will need to re-add this user only if you’re using the default authentication configuration:

  • Uncomment the following line in /opt/kylo/kylo-services/conf/ and /opt/kylo/kylo-ui/conf/ :
  • Create a file called file that is owned by kylo and replace dladmin with a new username and thinkbig with a new password:
echo "dladmin=thinkbig" > /opt/kylo/
chown kylo:users /opt/kylo/
chmod 600 /opt/kylo/
  • Create a file called file that is owned by kylo and set the default groups:
vi /opt/kylo/
chown kylo:users /opt/kylo/
chmod 600 /opt/kylo/
  1. To enable reindexing of a feed’s historical data:

    1. Verify option in /opt/kylo/kylo-services/conf/ for Kylo services. This is true by default.
    2. If using Solr instead of Elasticsearch as the search engine, add one property to /opt/kylo/kylo-services/conf/ file.

  2. Update the NiFi nars.

    Stop NiFi

    service nifi stop

    Run the following shell script to copy over the new NiFi nars/jars to get new changes to NiFi processors and services.

    Example:  /opt/kylo/setup/nifi/ /opt/nifi /opt/kylo/setup nifi users

    Start NiFi

    service nifi start
  3. Start Kylo