Upgrade Pepperdata

Supported Pepperdata upgrade paths: from any earlier Pepperdata 6.x version

To upgrade Pepperdata on a cluster, begin with any host, stop the Pepperdata agents, remove the Pepperdata software, upgrade the Pepperdata software, and restart the Pepperdata agents. Repeat this process on every host in your cluster.

Run all commands as the root user.

Task 1: Stop the Pepperdata Agents

Procedure

1. Stop the PepAgent. You can use either the service (if provided by your OS) or systemctl command:

   • sudo service pepagentd stop
   • sudo systemctl stop pepagentd

2. Stop the Pepperdata Collector. You can use either the service (if provided by your OS) or systemctl command:

   • sudo service pepcollectd stop
   • sudo systemctl stop pepcollectd

3. (Only if running PepMetrics; otherwise not applicable.
   Do not restart PepMetrics because it is now unsupported and unneeded.)

   1. Stop the PepMetrics agent.

      You can use either the service (if provided by your OS) or systemctl command:

      • sudo service pepmetricsd stop
      • sudo systemctl stop pepmetricsd

   2. Disable the PepMetrics agent.

      You can use either the service (if provided by your OS) or systemctl command:

      • sudo chkconfig pepmetricsd off
      • sudo systemctl disable pepmetricsd

Task 2: Remove/Deactivate the Old Pepperdata Supervisor

If you are not upgrading your Hadoop distribution, or you are upgrading your Hadoop distribution to a version that is compatible with your current Pepperdata package, removing the Pepperdata package is optional. If you want the ability to quickly rollback to your previously installed Pepperdata version, you can skip this procedure and leave the original version installed. When you install the new Pepperdata package, it will not overwrite any existing Pepperdata packages.

Procedure

• Depending on the management of the cluster, remove the RPM/DEB package by running the appropriate command for your environment or by using site-specific administrative tools.

Task 3: Install the New Pepperdata Supervisor Package

A single RPM/DEB package contains all the Pepperdata products.

Procedure

1. Obtain the appropriate Pepperdata <supervisor-package-name> RPM/DEB package. There are version-specific Pepperdata packages for some Hadoop versions. In such cases, the Pepperdata package name includes the Hadoop version number. See the Downloads page.

2. Depending on the management of the cluster, install the RPM/DEB package by running the appropriate command for your environment or by using site-specific administrative tools.

   The table describes the locations of the Pepperdata files after you install the package. Except for the primary installation target, the locations are created by symlinks.

   Directory	Description
   /opt/pepperdata/supervisor-<your-version>	Primary installation target, containing many subdirectories and files
   /opt/pepperdata/lib/	JAR and library files
   /etc/init.d/	Initialization scripts
   /etc/pepperdata/	Configuration files, configuration templates, and site-specific configuration files

3. Merge the contents of the new Pepperdata configuration file template, /etc/pepperdata/pepperdata-config.sh-template, into your existing Pepperdata configuration file, /etc/pepperdata/pepperdata-config.sh.

If the installation fails on any host, contact Pepperdata Support.

Task 4: Restart Hadoop YARN Services

Procedure

1. Restart the affected YARN services:

   • YARN ResourceManager
   • YARN NodeManagers

2. (If using HBase) Restart the HBase RegionServers.

3. (If using Query Spotlight) On every Hive server, restart the hiveserver2 service.

Task 5: Restart the Pepperdata Agents

Procedure

1. Start the Pepperdata Collector.

   You can use either the service (if provided by your OS) or systemctl command:

   • sudo service pepcollectd start
   • sudo systemctl start pepcollectd

   If any of the process’s startup checks fail, an explanatory message appears and the process does not start. Address the issues and try again to start the process.

2. Start the PepAgent.

   You can use either the service (if provided by your OS) or systemctl command:

   • sudo service pepagentd start
   • sudo systemctl start pepagentd

   If the service successfully starts, the Pepperdata Version [VERSION-STRING] OK message appears in the /var/log/pepperdata/pepagent/pepagent.log file.

   If any of the process’s startup checks fail, an explanatory message appears and the process does not start. Address the issues and try again to start the process.