Prerequisites

Prerequisites

Before you proceed with upgrading StackLight LMA, perform the following prerequisite steps:

  1. Upgrade your MCP cluster as described in Upgrade DriveTrain to a newer release version.

    Note

    If you are performing a manitenance update, verify that you have updated your MCP cluster as described in Update DriveTrain instead.

  2. Log in to the Salt Master node.

  3. Verify that there are no uncommitted changes on the cluster and system levels of the Reclass model:

    1. For the cluster level:

      cd /srv/salt/reclass/classes/cluster/<cluster_name>/
      git status
      
    2. For the system level:

      cd /srv/salt/reclass/classes/system
      git status
      

    Example of system response:

    On branch <branch_name>
    Your branch is up-to-date with 'origin/<branch_name>'.
    
    nothing to commit, working tree clean
    

    In case of any uncommitted changes, solve the issue before proceeding with the upgrade.

  4. Verify that all Salt minions are available:

    salt '*' test.ping
    

    Example of system response:

    cmp0.<cluster_name>:
        True
    mon01.<cluster_name>:
        True
    gtw01.<cluster_name>:
        True
    mon02.<cluster_name>:
        True
    prx01.<cluster_name>:
        True
    cmp1.<cluster_name>:
        True
    mon03.<cluster_name>:
        True
    cfg01.<cluster_name>:
        True
    

    If any VM is not available, do not proceed before resolving the issue.

  5. Verify that no alerts are triggered in the Alertmanager web UI as described in Use the Alertmanager web UI.

    Caution

    If any alert is triggered, investigate the issue before proceeding with the upgrade. An alert may have a low severity and it is up to the system administrator to decide whether to proceed with the upgrade in this case.

  6. Specify the elasticsearch_version: 6 and kibana_version: 6 parameters in the classes/cluster/<cluster_name>/stacklight/log.yml file of your Reclass model to upgrade Elasticsearch and Kibana from v5 to v6. Otherwise, Elasticsearch and Kibana will be upgraded to the latest minor stable versions.

Once done, proceed to Upgrade StackLight LMA using the Jenkins job.