4. SESM Agent

SESM-Agent is a console utility responsible for updating signatures on Outlook. Except for the debug mode, it does not have a graphical user interface by default. It is usually deployed to clients using the Active Directory GPO.

Running SESM-Agent

To run SESM-Agent on a computer, type the following command at a command prompt and press Enter.
(config-file-location is the location of the configuration file, sesm-config.conf)

sesm-agent.exe "config-file-location"

The SESM-Agent will immediately begin execution and renew the Outlook Signature if all requirements are met.

Running with GUI (debug mode)

If you want to run the SESM-Agent in GUI mode, execute the command using the debug parameter.

sesm-agent.exe "config-file-location" debug

For example, if the SESM-Agent.exe and sesm-config.conf files are stored in the ‘F:\SignatureFiles’ folder, the command will be as shown below.

When opened in debug mode, a GUI window is displayed. Click on the Start Test button. The signature update will start and the results will be displayed as shown below.

A log file named ‘SESM-Agent-Logs.log‘ will be created in the temporary directory of the current user. To review this log file, click on the View Logs button.

Signature Readiness Tests

Prior to updating the signature, the SESM-Agent will perform several checks to ensure that the Outlook is ready for the signature update.

  • Configuration file:
    A valid sesm-config.conf file must be located at the specified folder location. If the configuration file is missing or it is corrupted, the agent will exit.
  • Active Directory Fields Status:
    If the AD fields are disabled, the agent will not look at the AD connection and will not change any of the AD fields in the signature template.
  • Signature Templates:
    Uploaded signature templates will be checked and if there is any error, the agent will exit.
  • Outlook Profiles:
    If Outlook profile is not set, the agent will exit. If multiple profiles are configured, agent will generate the signature, but the Signature for each profile must be selected manually.
  • Active Directory Connection:
    Check the connectivity to the Active Directory server and if there is any error, the agent will exit. If the AD connection is successful, the AD fields in the signature will be updated according to the following conditions

    1. If the AD attribute name (LDAP name) is valid and the current user has a value, that field will be replaced with its value.
    2. If the AD attribute name is valid and the current user has no value, that field will be replaced with empty space.
    3. If the AD attribute name is invalid or there is an error retrieving its value, that field will be replaced with empty space.
    4. If the AD attribute name is not set correctly (such as missing a square bracket) that field will not be changed.
  • MS Office Application:
    A compatible MS Office version must be installed on the system, or the agent will exit.

  • Update Signature on Outlook:
    Finally, if all of the above tests are successfully completed, the SESM-Agent will attempt to update the signature on the Outlook.

    1.Two signatures named ‘New Message Signature‘ and ‘Reply Message Signature‘ will be generated. The first will be set up for New messages and the second for Reply / Forwarded messages.
    2. If the ‘Use New Signature to Reply‘ checkbox is enabled, reply signature will be generated from the new message template itself.
    3. If the ‘Use new signature to reply‘ checkbox is enabled and the reply signature template is not uploaded, reply signature will be generated from the new message template.