Skip to content

Agent to this release

Upgrading from older versions

The following instructions assume that you are upgrading from Agent version 2021.1.0 or later. If you are running 2020.x or earlier please contact SAS Technical Support for instructions specific to your version.

Unix

  1. Modify !SASROOT/SASFoundation/9.x/bin/sasenv_local updating 
    export ESMACTIVE=1
    to: 
    export ESMACTIVE=0
  2. Stop the Agent
  3. Rename the existing esm-agent installation folder to esm-agent_old
  4. Perform an installation of the Agent using these instructions ensuring that you install the Agent into the same location as the previous version
  5. Redo any changes that were made to the configuration files in the old version1
  6. Start the Agent
  7. Modify !SASROOT/SASFoundation/9.x/bin/sasenv_local updating the line that has export ESMACTIVE=0 to: 
    export ESMACTIVE=1

Windows

  1. Modify !SASROOT\SASFoundation\9.x\autoexec.sas updating 
    options set = ESMACTIVE = 1;
    to: 
    options set = ESMACTIVE = 0;
  2. Stop the Agent
  3. Copy the existing esm-agent folder to esm-agent_old
  4. Perform an uninstall of the Agent using these instructions
  5. Perform an installation of the Agent using these instructions ensuring that you install the Agent into the same location as the previous version
  6. Redo any changes that were made to the configuration files in the old version1
  7. Start the Agent
  8. Modify !SASROOT\SASFoundation\9.x\autoexec.sas updating the line that has options set = ESMACTIVE = 0; to: 
    options set = ESMACTIVE = 1;

Kubernetes

By default, the Agent has an image update policy that will always pull the latest version of the application image available at the latest tag. Therefore, to get the latest version of the Agent, the pods within the DaemonSet just needs to be restarted.

  1. Restart the DaemonSet: 
    kubectl rollout restart daemonset sas-enterprise-session-monitor-agent -n default

  1. Typically modifications are made to esm-agent/bin/esm-bootstrap.sh but modifications specific for your environment may have been made to esm-agent/bin/config.properties. For assistance understanding or finding modifications that have been made in your environment, please contact SAS Technical Support. ↩↩

Last update: July 25, 2023
Created: April 24, 2023