Pre-Upgrade Steps for MapR Monitoring

Complete the following steps before you upgrade MapR Monitoring Components with or without the MapR Installer.

About this task

During an upgrade, a script backs up many of the configuration files. However, it is a best practice to manually backup the files in case an error occurs or if the specific file you customized is not automatically backed up by the script.

Procedure

  1. Before you upgrade metric monitoring components, create a backup of the configuration files to a location outside your MapR installation directory. The following configuration file lists include files that are commonly used for configuration and may not include every file that you may have customized.
    • Collectd configuration files:
      • /opt/mapr/conf/conf.d/warden.collectd.conf
      • /opt/mapr/collectd/collectd-<version>/etc/collectd.conf
      • /etc/logrotate.d/collectd
    • Grafana configuration files:
      • /opt/mapr/conf/conf.d/warden.grafana.conf
      • /opt/mapr/grafana/grafana-<version>/etc/grafana/grafana.ini
      • /opt/mapr/grafana/grafana- <version>/etc/grafana/ldap.toml
    • OpenTSDB configuration files:
      • /opt/mapr/conf/conf.d/warden.opentsdb.conf
      • /opt/mapr/opentsdb/opentsdb-<version>/etc/opentsdb/opentsdb.conf
      • /opt/mapr/opentsdb/opentsdb-<version>/etc/opentsdb/logback.xml
      • opt/mapr/opentsdb/opentsdb-<version>/bin/tsdb_cluster_mgmt.sh (This file is not automatically backed up.)
    • For Elasticsearch:
      • /opt/mapr/conf/conf.d/warden.elasticsearch.conf
      • /opt/mapr/elasticsearch/elasticsearch-<version>/etc/elasticsearch/elasticsearch.yml
      • /opt/mapr/elasticsearch/elasticsearch-<version>/etc/elasticsearch/logging.yml
      • /opt/mapr/elasticsearch/elasticsearch-<version>/etc/elasticsearch/curator.yml
      • /opt/mapr/elasticsearch/elasticsearch-<version>/etc/elasticsearch/curator_actions/delete_indices.yml (This file is not automatically backed up.)
    • For OpenTSDB:
      • /opt/mapr/conf/conf.d/warden.opentsdb.conf
      • /opt/mapr/opentsdb/opentsdb-<version>/etc/opentsdb/opentsdb.conf
      • /opt/mapr/opentsdb/opentsdb-<version>/etc/opentsdb/logback.xml
      • opt/mapr/opentsdb/opentsdb-<version>/bin/tsdb_cluster_mgmt.sh (This file is not automatically backed up.)
  2. Before you upgrade log monitoring components, create a backup of the following files to a location outside your MapR installation directory. The following configuration file lists include files that are commonly used for configuration and may not include every file that you may have customized.
    • Kibana configuration files:
      • /opt/mapr/conf/conf.d/warden.kibana.conf
      • /opt/mapr/kibana/kibana-<version>/etc/conf/kibana.js
    • fluentd configuration files:
      • /opt/mapr/conf/conf.d/warden.fluentd.conf
      • /opt/mapr/fluentd/fluentd-<version>/etc/fluentd/fluentd.conf
      • /opt/mapr/fluentd/fluentd-<version>/etc/fluentd/es_config.conf
      • /opt/mapr/fluentd/fluentd-<version>/etc/fluentd/maprfs_config.conf
      • /opt/mapr/fluentd/fluentd-<version>/etc/fluentd/grok-patterns
      • /etc/logrotate/fluentd
    • Elasticsearch configuration files:
      • /opt/mapr/conf/conf.d/warden.elasticsearch.conf
      • /opt/mapr/elasticsearch/elasticsearch-<version>/etc/elasticsearch/elasticsearch.yml
      • /opt/mapr/elasticsearch/elasticsearch-<version>/etc/elasticsearch/logging.yml
      • /opt/mapr/elasticsearch/elasticsearch-<version>/etc/elasticsearch/curator.yml
      • /opt/mapr/elasticsearch/elasticsearch-<version>/etc/elasticsearch/curator_actions/delete_indices.yml (This file is not automatically backed up.)
  3. Stop all MapR Monitoring Services on the cluster.
    1. To stop collectd, run the following command: 
      maprcli node services -name collectd -nodes <space separated list of hostname/IPaddresses> -action stop
    2. To stop Grafana, run the following command: 
      maprcli node services -name grafana -nodes <space separated list of hostname/IPaddresses> -action stop
    3. To stop OpenTSDB, run the following command: 
      maprcli node services -name opentsdb -nodes <space separated list of hostname/IPaddresses> -action stop
    4. To stop Kibana, run the following command: 
      maprcli node services -name kibana -nodes <space separated list of hostname/IPaddresses> -action stop
    5. To stop fluentd, run the following command: 
      maprcli node services -name fluentd -nodes <space separated list of hostname/IPaddresses> -action stop
    6. To stop Elasticsearch, run the following command: 
      maprcli node services -name elasticsearch -nodes <space separated list of hostname/IPaddresses> -action stop