Installation
Also available as:
PDF

Chapter 5. SmartSense Upgrade Scenarios

Depending on your current and target SmartSense versions, you can upgrade SmartSense in place (without uninstallation), or you can uninstall your current version and replace it with new SmartSense.

Current SmartSense VersionTarget SmartSense VersionUpgrade Path
1.01.4.x - Ambari ManagedUninstall, Install with Ambari
1.1 - Ambari Managed1.4.x - Ambari ManagedIn-Place Upgrade
1.2.x - Ambari Managed 1.4.x - Ambari ManagedIn-Place Upgrade
1.3.x - Ambari Managed 1.4.x - Ambari ManagedIn-Place Upgrade
1.4.x - Ambari Managed 1.4.x - Ambari ManagedIn-Place Upgrade

In-Place Upgrade

Your in-place upgrade method depends on whether you are working in an Ambari environment and, if so, what version of Ambari you are currently using:

In-Place Upgrade with Ambari 2.5 or Newer

You can upgrade to SmartSense 1.4.x without uninstalling SmartSense:

  1. Log in to Ambari web UI and stop the SmartSense service.

  2. Upgrade binaries on the HST server and all HST agents on every node in the cluster, assuming that the Ambari repository is configured on all nodes in the cluster:

    • RHEL or CentOS

      yum clean all
      yum info smartsense-hst

      In the info output, visually validate that there is an available version containing "1.4.x”:

      yum upgrade smartsense-hst
    • SLES

      zypper clean
      zypper info smartsense-hst

      In the info output, visually validate that there is an available version containing "1.4.x":

      zypper up smartsense-hst
    • Ubuntu or Debian

      apt-get clean all
      apt-get update 
      apt-cache show smartsense-hst | grep Version 

      In the info output, visually validate that there is an available version containing "1.4.x":

      apt-get install smartsense-hst 
  3. Upgrade Ambari service and Ambari view by running the hst upgrade-ambari-service command as the root user from the machine running the Ambari server. You can run the command in the interactive or non-interactive mode:

    Interactive mode example:

    # hst upgrade-ambari-service
    Please enter Ambari Server hostname (ambari-server.hortonworks.local): 
    Please enter Ambari Server port (8080): 
    Please enter Ambari admin user id (admin): 
    Please enter password for admin: 
    
    Un-installing old view ...
    Installing new view ...
    Removing deprecated alerts ...
    Updating SmartSense configurations in Ambari ...
    
    SmartSense service upgrade completed!
    NOTE: It is required to restart Ambari Server for changes to reflect. Please restart ambari using 'ambari-server restart'

    Non-interactive mode example:

    # hst upgrade-ambari-service -u admin -p 8080 -H ambari-server.hortonworks.local -P MySecurePassword123
    Un-installing old view ...
    Installing new view ...
    Removing deprecated alerts ...
    Updating SmartSense configurations in Ambari ...
    SmartSense service upgrade completed!
    NOTE: It is required to restart Ambari Server for changes to reflect. Please restart ambari using 'ambari-server restart'
  4. Restart the Ambari server:

    # ambari-server restart
  5. After the packages are upgraded and the HST upgrade is complete, log in to Ambari web UI and start all SmartSense services.

  6. Skip this step if your current version is 1.3 or higher: Since SmartSense 1.3.0 introduced two new components, Activity Analyzer and Activity Explorer, you need to add these components to Ambari. To do this:

    1. In Ambari web UI, click on Hosts and then navigate to the host on which you want to install the components.

      [Note]Note

      Refer to the Activity Analyzer Placement section for advice on which hosts to choose when placing the Activity Analyzer.

    2. Click on Add and add Activity Analyzer and then Activity Explorer component.

    3. Start Activity Analyzer and Activity Explorer components by selecting Start next to the component name.

  7. Ensure that all components are upgraded by triggering a SmartSense analysis capture, and ensure that the capture finishes successfully.

  8. If you have HST Gateway installed, you need to also upgrade your HST Gateway:

    • If the HST Gateway is installed on the same node as HST Server or HST Agent, then the HST Gateway will get upgraded along with them.

    • If the HST Gateway is a standalone node outside of the cluster, perform upgrade steps described in Upgrading SmartSense Gateway.

In-Place Upgrade with Ambari 2.4

When using SmartSense 1.1 or 1.2, you can upgrade to SmartSense 1.4.x without uninstalling SmartSense:

  1. Download the SmartSense 1.4.x binaries from the Tools tab of the Hortonworks support portal (https://support.hortonworks.com).

  2. Log in to Ambari web UI and stop the SmartSense service.

  3. The SmartSense 1.4.x binaries need to be manually copied to every node in the cluster.

  4. Once the binaries have been manually copied, they need to be used to upgrade the HST server and HST agents on every node in the cluster. To do so, follow the steps below:

    • RHEL, CentOS, or SLES

      rpm -Uvh smartsense-hst-HST_VERSION.rpm
    • Ubuntu or Debian

      dpkg -i smartsense-hst-HST_VERSION.deb
  5. Upgrade Ambari service and Ambari view by running the hst upgrade-ambari-service command as the root user from the machine running the Ambari server. You can run the command in the interactive or non-interactive mode:

    Interactive mode example:

    # hst upgrade-ambari-service
    Please enter Ambari Server hostname (ambari-server.hortonworks.local): 
    Please enter Ambari Server port (8080): 
    Please enter Ambari admin user id (admin): 
    Please enter password for admin: 
    
    Un-installing old view ...
    Installing new view ...
    Removing deprecated alerts ...
    Updating SmartSense configurations in Ambari ...
    
    SmartSense service upgrade completed!
    NOTE: It is required to restart Ambari Server for changes to reflect. Please restart ambari using 'ambari-server restart'

    Non-interactive mode example:

    # hst upgrade-ambari-service -u admin -p 8080 -H ambari-server.hortonworks.local -P MySecurePassword123
    Un-installing old view ...
    Installing new view ...
    Removing deprecated alerts ...
    Updating SmartSense configurations in Ambari ...
    SmartSense service upgrade completed!
    NOTE: It is required to restart Ambari Server for changes to reflect. Please restart ambari using 'ambari-server restart'
  6. Restart the Ambari server:

    # ambari-server restart
  7. After the packages are upgraded and the Ambari Service upgrade is complete, log in to Ambari web UI and start SmartSense service.

  8. Skip this step if your current version is 1.3 or higher: Since SmartSense 1.3.0 introduced two new components, Activity Analyzer and Activity Explorer, you need to add these components to Ambari. To do this:

    1. In Ambari web UI, click on Hosts and then navigate to the host on which you want to install the components.

      [Note]Note

      Refer to the Activity Analyzer Placement section for advice on which hosts to choose when placing the Activity Analyzer.

    2. Click on Add and add Activity Analyzer and then Activity Explorer component.

    3. Start Activity Analyzer and Activity Explorer components by selecting Start next to the component name.

  9. Ensure that all components are upgraded by triggering a SmartSense analysis capture, and ensure that the capture finishes successfully.

  10. If you have HST Gateway installed, upgrade your HST Gateway:

    • If the HST Gateway is installed on the same node as HST Server or HST Agent, then the HST Gateway will get upgraded along with them. This is true for Ambari managed and non-Ambari managed nodes.

    • If the HST Gateway is a standalone node, perform upgrade steps described in Upgrading SmartSense Gateway.

Upgrading SmartSense Gateway

To upgrade a standalone instance of SmartSense Gateway, perform the following upgrade steps:

[Note]Note

If you are running an SFTP-based gateway and SmartSense version 1.3.0 or newer, we recommend that you upgrade to HTTPS-based gateway. For instructions, refer to Upgrading to HTTPS Gateway.

If you are using SmartSense versions earlier than 1.3.0 with a SmartSense 1.4.x Gateway, in order to retain backwards compatibility with the older SmartSense versions using the gateway, ensure that only SFTP is used as the smartsense.upload.provider.type in the gateway configuration.

  1. On the host running the HST Gateway, stop the hst-gateway process:

    hst gateway stop
  2. Upgrade binaries on that node:

    • RHEL, CentOS, or SLES

      rpm -Uvh smartsense-hst-$HST_VERSION.x86_64.rpm
    • Ubuntu or Debian

      dpkg -i smartsense-hst-$HST_VERSION.deb
  3. Start the hst-gateway process:

    hst gateway start

Upgrading to HTTPS Gateway

If you are running an SFTP-based gateway and SmartSense version 1.3.0 or newer, we recommend that you upgrade to HTTPS-based gateway.

You can do this by setting the property smartsense.upload.provider.type to HTTPS in gateway configuration and refer to this Knowledge Base article for the HTTPS user name, password, host, and port details: https://hortonworks.secure.force.com/articles/en_US/How_To/SmartSense-Gateway-setup.