Skip to content

Upgrade Guides (Sequoia v5.41)


Upgrade Guides (not an installation guide) for plug-ins

Sequoia v5.41 includes enhancements to the status event writer plug-in which you can choose to upgrade. As a user who is already using this plug-in, you should be aware that it will not have been automatically upgraded by the Sequoia installer and will continue to work as it did before. If you would like to take advantage of the enhancements in this new plug-in, you will need to upgrade by following the guide below.

The process of upgrading Sequoia plug-ins is moderately technical but with care should be easily accomplished without technical assistance. To follow this guide, you should have appropriate access to the machine hosting the Sequoia Server software. You need to upgrade to Sequoia v5.41 and ensure that your installation is working as expected.

The file system path to the Sequoia Server installation folder is referred to as [SequoiaServerPath] in this guide, and is typically located in c:\Program Files (x86)\Sequoia Server, but this path may have been customised by your system administrator during the installation process. You will need to know where these services are located before continuing.

You must stop the 'Sequoia Service Monitor' and the 'Sequoia Event Processing services' (in that order).
- You can do this by browsing the Services using the Windows Services application.

Status Event Writer

Sequoia v5.41 Enhancement: Output the CDS declaration events to match the Sequoia API event schemas

  1. Within the [SequoiaServerPath]\EventProcessingService folder, locate the 'StatusEventWriter' sub-folder and backup this folder somewhere outside of the [SequoiaServerPath] parent directory (maybe in your documents folder, or another temporary location). You will need a copy of the original files later on.
    • To 'backup' the folder, you will need to copy it and paste it in another location as directed. This will create a copy of the folder and it's contained files, and will be used during the upgrade process, and also to repair your plug-in if the upgrade fails.
    • The backup is to ensure that you can continue working by rolling back in the eventuality that the upgrade fails.
    • If you do not perform a backup of this folder, it is likely that it will not be possible to roll your installation back, and the plug-in will need to be re-configured again which may take some time and require assistance from the ASM Service Desk.
  2. Delete the '[SequoiaServerPath]\EventProcessingService\StatusEventWriter' folder (again, you should have backed it up first).
  3. Download the new plug-in zip file from here.
  4. Extract the content of this zip file to the location of the original folder '[SequoiaServerPath]\EventProcessingService'.
    • This will have the effect of re-creating the folder '[SequoiaServerPath]\EventProcessingService\StatusEventWriter' which contains the new plug-in files.
  5. Copy the 'ASM.Sequoia.EP.Processor.Config.xml' config file from the backup folder and paste into the '[SequoiaServerPath]\EventProcessingService\StatusEventWriter' folder, overwriting the existing file.

After upgrade

Start the 'Sequoia Event Processing services' and then the 'Sequoia Service Monitor' (in that order).
- You can do this by browsing the Services using the Windows Services application.
Test that everything still works. If everything works to your satisfaction, remove the files in the backup folder.

My plug-in is no longer working - how do I rollback?

You must stop the 'Sequoia Service Monitor' and the 'Sequoia Event Processing services' (in that order).
- You can do this by browsing the Services using the Windows Services application.
Backup the folder you have been modifying (the sub-folder of [SequoiaServerPath]\EventProcessingService that you have been working on), remove this folder entirely and copy back the files from the backup you took at the start of this guide.
- If you did not take a backup, then you will need to have the plug-in re-installed. You will need to contact the ASM Service Desk to assist you.
Start the 'Sequoia Event Processing services' and then the 'Sequoia Service Monitor' (in that order).
In this instance, contact the ASM Service Desk to assist you with upgrading your plug-in.