Differences

This shows you the differences between two versions of the page.

--- installing_transsecs [2020/05/12 18:58] – created wikiadmin
+++ installing_transsecs [2026/04/27 21:27] (current) – wikiadmin
@@ Line 1: / Line 1: @@
-[+Using the Installer+]
+**Installing TransSECS**
+**Using the Installer**
 Use the provided TransSECS installer for the distribution installation. See below for Linux installations. If you purchased TransSECS or requested a trial, the installer download URL was provided by email.
@@ Line 5: / Line 7: @@
 Except for trial TransSECS, licenses are not included and will be provided in a separate zip. Trial TransSECS includes limited time trial licenses.
-[+Installing on Linux+]
+**Starting TransSECS**
+The TransSECS executable installs in the MIStudioSuite\TransSECS\Builder folder.  If installed in the default location, this will be under C:\Users\Public\ErgoTech followed by the particular TransSECS type installed. For example, for TransSECSPlusReporting
+{{:pasted:20201123-180104.png}}
+and for TransSECSDevices
+{{:pasted:20201123-175456.png}}
+For TransSECS devices you start the TransSECSDevices.exe executable, for all others start the TransSECS.exe.
+**Tester**
+A copy of TransSECS is installed in MIStudioSuite\TransSECS\Tester .  this is used for testing tool application.  After you've built a tool, start the TransSECS.exe from the Tester folder and load the "GEMHost" test application.  This will allow you to connect and send messages.  The [[https://www.youtube.com/watch?v=MheNoWQf5vQ&list=PLG_fWk56fVRfsdQandoGJK9Hgb79OgmVJ|TransSECS Playlist]] videos guide you through this.
+**Installing on Linux**
 Linux installations do not contain a bundled JDK. Be sure your Linux system has JDK 8 installed. We recommend Amazon Corretto 8. The latest version for Linux and Windows can be downloaded from:
@@ Line 13: / Line 31: @@
 To check your JDK 8 installation, open a terminal and type "Java -version". It should report a JDK (not a JRE) and version 8. For example:
-[@openjdk version "1.8.0_242"
+''openjdk version "1.8.0_242"\\
-OpenJDK Runtime Environment Corretto-8.242.10.1 (build 1.8.0_242-b08)
+OpenJDK Runtime Environment Corretto-8.242.10.1 (build 1.8.0_242-b08)\\
-OpenJDK 64-Bit Server VM Corretto-8.242.10.1 (build 25.242-b08, mixed mode)
+OpenJDK 64-Bit Server VM Corretto-8.242.10.1 (build 25.242-b08, mixed mode)\\
-@]
+''
 (242 is the version number so you may see a different version.  We recommend the latest 1.8.0 version.  Later Java versions, eg JDK 11+ will not work.)
@@ Line 24: / Line 42: @@
-[+Installing Licenses on Windows+]
+**Installing Licenses on Windows**
 Note: Trial software includes a limited time license which will be already installed. If the license has expired you will be notified and should contact your supplier for a Trial update.
@@ Line 32: / Line 50: @@
 Run TransSECS "Builder" using the executable "TransSECS.exe" in your installation directory, under MIStudioSuite/TransSECS/Builder. You will be prompted for a license bundle. This is a zip of licenses which should have been emailed to you by your supplier. Be sure you have saved the zip from your email to a local directory such as "Downloads". When prompted, browse for this zip file.
-[+Installing Licenses on Linux+]
+{{:pasted:20201123-181741.png}}
+**Installing Licenses on Expired Trials**
+If the installation has expired, you will need to manually extract the zip into the MIStudioSuite folder.  Open the zip in your preferred application and drop the root "MIStudioSuite" folder directly into your installation directory - the one that already contains an MIStudioSuite folder.
+{{:pasted:20201101-173111.png}}
+You will get this warning:
+{{:pasted:20201101-173238.png}}
+Choose "Yes".  If you do not see this warning you are attempting to unzip in the wrong folder.  It's easy to accidentally drop the MIStudioSuite folder into the existing MIStudioSuite folder but this will not install the licenses.  Make sure that you have unzipped into the root folder and that you see the warning above.
+You will get another warning:
+{{:pasted:20201101-173333.png}}
+Check the box "Do this for all current items" and select "Yes".
+Finally this warning:
+{{:pasted:20201101-173506.png}}
+Chose the first option "Replace the files in the destination".
+After that, you can start TransSECS normally and you will see the new expiration date.
+{{:pasted:20201101-173806.png}}
+**Installing Licenses on Linux**
 You should have been provided a license bundle (zip file of licenses)by email. Be sure to save the zip to a convenient local directory. You need to unzip the provided licenses into the installation so that you extract the MIStudioSuite folder in the zip into the same location as the currently installed MIStudioSuite folder. To do this, open the zip and drill down until you see "MIStudioSuite". Drag this folder on top of the existing installation MIStudioSuite directory.
+**32 bit Windows installation**
+To run on a 32 bit version of Windows requires a 32 bit JDK.  We recommend Amazon Corretto : https://corretto.aws/downloads/latest/amazon-corretto-8-x86-windows-jdk.zip
+Download the file, and unzip it in the "MIStudioSuite folder, the same folder that has the 64bit jre. You'll have this: (you may have a different version of TransSECS, eg TransSECSDevices, but the folder structure is the same)
+{{:pasted:20240226-092209.png}}
+Rename the jre folder to jre.64
+{{:pasted:20240226-092334.png}}
+Inside the amazon-corretto folder, is a folder called JDK 1.8.0 and the version, here JDK 1.8.0_402
+{{:pasted:20240226-092410.png}}
+Move this folder to the MIStudioSuiteFolder and rename it to just jre:
+{{:pasted:20240226-092533.png}}
+TransSECS (or MIStudio) will then work as expected on a 32 bit Windows platform.
+==== Using Task Manager in Windows to kill a second copy of TransSECS ====
+If TransSECS isn't starting, it's often because a copy of TransSECS is already running.  If you can't find that running copy, you can force-kill it from the task manager.
+Right-click the Windows toolbar and choose "Task Manager"
+{{pasted:20260427-201927.png}}
+Select the "Details" tab
+{{pasted:20260427-202338.png}}
+Then scroll to the TransSECS entry and choose "End Process Tree"
+{{pasted:20260427-202315.png}}
+Confirm ending the process when prompted.