Differences

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

--- gui:upgrade_procedure [2020/01/27 16:32] – benjamin
+++ gui:upgrade_procedure [2023/12/04 11:28] (current) – emcodem
@@ Line 1: / Line 1: @@
-====Upgrade Procedure from FFAStrans 9.4 to 1.0====
+==== Upgrade Procedure  ====
-This is a manual for a typical upgrading procedure from ffastrans 9.4 to 1.0.
-You can also use this for testing the Beta of FFAStrans 1.0.0, just make sure you keep your current ffastrans install directory backed up and untouched so you can always go back.
+The following procedure is to //**upgrade**// the existing database with all it's settings, workflows and monitor history. If you're doing a //**fresh install**// . but want to have the //workflows only// from your previous installation, you can export them as XML and import into the new Version.
+\\
+//**Please note that you cannot have __two different__ versions of FFAStrans running on the same host simultaneously.**//
+\\
 __Preparation:__
   * Make sure no job is running in your current installation.
-  * Stop the "FFastrans REST API" windows service on all nodes that run ffastrans service or close the FFAStrans Worfklow Manager application if the windows service is not installed.
+  * If not already running, start the FFAStrans Workflow Manager and stop ALL running workflows.
-  * BACKUP the Current ffastrans installation directory, containing FFAStrans.exe, Workflows and Processors Folders - keep this backup safe.
+  * Stop the "FFAStrans REST API" windows service on all nodes that run FFAStrans service and close all running FFAStrans Worfklow Manager applications. This also includes the inbuilt status monitor.
-  * Extract the files from FFASTrans 1.0 download to some temporary directory - DO NOT START the ffastrans.exe, otherwise you must delete the whole directory and extract again.
+  * Open Task manager and make sure **no exe_manager.exe and ffastrans.exe** processes are running
+  * BACKUP the current FFAStrans installation directory, containing FFAStrans.exe, Workflows and Processors Folders - keep this backup safe.
+  * Extract the files from new FFAStrans.zip to some temporary directory - DO NOT START the FFAStrans.exe, otherwise you must delete the whole directory and extract again.
-From this point, you can always discard the upgraded installation and go back to your backup at any time.
+From this point and in case of unexpected errors, you can always discard the upgraded installation and go back to your backup at any time.
 __Upgrade:__
-  *Copy/Paste FFASTrans Version 1.0 files to the directory of your old installation. This must prompt you to overwrite FFASTrans.exe and several other files (339 files for me). Make sure all files are being replaced.
+  *Copy/Paste the new FFAStrans Version files to the directory of your old installation. This must prompt you to overwrite FFAStrans.exe and several other files. Make sure **all files are being replaced.**
-First start:
+__First start:__
   *Start FFAStrans.exe.
   *If the next step does not work for you, there is something wrong and you need to start over again with a fresh extraction of the 1.0 files and a new copy of your old FFAStrans directory you want to upgrade.
   *At the "Welcome to FFAStrans 1.0.0" Popup, click "OK". Your configuration and workflows should now be upgraded automatically.
-{{:gui:dbup.png?nolink&400 |}}
+{{ :gui:dbup.png?nolink&400 |}}
+__After the upgrade:__
+  *If you're running FFAStrans as a service, //please upgrade the service credentials.//
+  *Please make sure your workflows and nodes looks OK in the editor.
+  *Start your workflows one by one and test that they works as expected.
+   *Finally, please report any anomalies or bugs related to the upgrade.
 -------------------------
-<html>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</html>[[gui:upgrade_procedure|Back to top]] - [[gui:installation|Back to installation Page]]
+<html>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</html>[[gui:upgrade_procedure|Back to top]] - [[gui:installation|Back to installation Page]]