Skip to content

Update / Patch Easit GO

Easit distinguishes an update (or patch) from an upgrade in that an update occurs within a release and an upgrade occurs between releases. Going from release 20xx.xx Patch 1 to release 20xx.xx Patch 2 is an update while going from release 20xx.xx to release 20yy.yy is an upgrade. This guide will help you upgrade your release of Easit GO.

The are several ways to perform the steps below, in this guide we will use PowerShell.

Releases prior to 2024.06

You can find instructions for how to migrate older releases here.

Preparations

Create a directory for backups, we suggest that you use the _Backup directory in Easits root directory (usually D:\Easit\_Backup), named something like todays date.

1
PS C:\Users\admin> $backupDirectory = New-Item -Path 'D:\Easit\_Backup' -Name (Get-Date -Format 'yyyyMMdd') -ItemType Directory

To know exactly where Easit GO we want to update "lives" we need to find its home directory. We do this by running a search for the Easit GO JAR file.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
PS C:\Users\admin> Set-Location 'D:\Easit'
PS D:\Easit> Get-ChildItem -Include 'easitgo.jar' -Recurse

    Directory: D:\Easit\Prod

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        4/22/2024   7:51 AM      292155574 easitgo.jar


    Directory: D:\Easit\Test


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        4/22/2024   7:51 AM      292155574 easitgo.jar

PS D:\Easit>

Note the value or save it to a variable.

1
2
3
PS D:\Easit> $systemHome = 'D:\Easit\Prod'
PS D:\Easit> # Create and set variable for jre directory
PS D:\Easit> $jreDirectory = Join-Path -Path (Join-Path -Path $systemHome -ChildPath 'bin') -ChildPath 'jre'

Find service

1
2
3
4
5
6
7
8
PS D:\Easit> Get-Service -Name *easit*

Status   Name               DisplayName
------   ----               -----------
Started  EasitGOProd        EasitGOProd
Started  EasitGOTest        EasitGOTest

PS D:\Easit>

Note the Name of the service that you wish to update or save it to a variable.

1
PS D:\Easit> $serviceName = 'EasitGOProd'

Stop service

1
PS D:\Easit> Get-Service -Name $serviceName | Stop-Service

Backup

We move the JAR file for Easit GO to the backup directory.

1
2
3
PS D:\Easit> Get-ChildItem -Path "$systemHome" -Recurse -Include "easitgo.jar" | Move-Item -Destination $backupDirectory
PS D:\Easit> Compress-Archive -Path "$jreDirectory" -DestinationPath "$backupDirectory\jre_backup.zip" -CompressionLevel Optimal -Force
PS D:\Easit> Remove-Item -Path "$jreDirectory" -Recurse -Confirm:$false

Backup of database

Take a backup of the database for Easit GO that can be used to roll back if anything happens during or after you update Easit GO.

Update

We copy the new JAR file to systemHome and then we can start Easit GO again.

1
2
PS D:\Easit> Get-ChildItem -Path "Path\To\newJarFile.jar" | Copy-Item -Destination (Join-Path -Path "$systemHome" -ChildPath "easitgo.jar")
PS D:\Easit> Copy-Item -Path "Path\To\newJreDirectory" -Destination "$jreDirectory" -Recurse

Properties

Before we start Easit GO, please verify that properties.xml has the following values:

  • \<entry key="hibernate.dialect">com.easit.util.hibernate.EasitMSSql2016Dialect\</entry>

Start Easit GO

Once you have verified that the settings and properties above is correct you can start Easit GO. This first time the start can take up to 15 minutes.

1
PS D:\Easit> Get-Service -Name $serviceName | Start-Service

That´s it. You have now successfully upgraded Easit GO.