New Tidal Patch Installer

The new Patch Installer has been designed to streamline and enhance the process of updating your Tidal installation, promising a seamless and efficient user experience.

Note: The new Patch Installer has been verified to upgrade to Tidal Automation versions 6.5.13, 6.5.14, 6.5.15, and 2024.2. Moreover, it is capable of upgrading any version of Tidal to another version seamlessly.

The new Patch Installer is a Java application that is run from the command line and will present the user with the option to update ClientManager, Master, BackupMaster or the FaultMonitor. The TESPatchInstaller project only exists within trunk and is not branched so it isn’t tied to any specific version of Tidal.

Running the Patch Install for Master, Client Manager, and Fault Monitor

Once you have the correct zip or tar file for the version that you are upgrading to, run the PatchInstall using this (this assumes the target environment is Windows):

  1. Copy the latest PatchInstall build folder to the local machine.

  2. Upzip the PatchInstall to a folder within the same file system as the Tidal system being updated.

  3. Extract the folder and check the bin folder. You should find the app.bat file.

  4. Check your system to ensure that Java 17 is installed.

  5. Ensure that the Master and Client Manager are stopped.

  6. Open the Command Prompt as an administrator.

  7. Navigate to the directory where the app.bat file is located.

    Example: cd C:\Users\User\Desktop\PatchInstaller_Tidal_Automation_6514\app\bin

  1. Run the command as app.bat. This will run the PatchInstaller.

    • Choose 1 to upgrade Master.

    • Type Y when prompted if Java 17 is installed on the machine.

    • Provide the path to the installed Java 17.

    • Provide the path to the existing directory where the Master is installed.

  2. Press Enter. At the end, a message will appear, for example, Master is successfully upgraded to 6.5.15. Type Q to end the script.

The PatchInstaller will create backups of every file that will be changed, updated or moved. In the event of an issue, restoring those files will revert to the previous version of Tidal. The folder where the files are backed up will be named “BKUP<timestamp>” where the timestamp is a number representing the current time in milliseconds. Additionally, the app/bin folder will contain a log that documents the output of the PatchInstaller execution. The log file is named “patchInstallerLog-<current date in milliseconds>”.txt.

Troubleshooting

If you are experiencing issues with PatchInstaller, follow these steps:

  1. Run CMD as Administrator.

  1. Navigate to the folder where app.bat is located:

    Example:
    cd C:\Users\Username\Downloads\PatchInstaller2_Tidal_Automation_2024.2.8\app\bin

  1. Run app.bat.

If the services don't launch after upgrading via PatchInstaller on Linux

Run this command for each of the configuration files to remove the carriage return character '\r' from the configuration files:

sudo sed -i 's/\r$//' master.props

Once done, you should be able to continue working without any issues.