Differences

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

Link to this comparison view

indigo_2022.1_documentation:upgrading_from_legacy_versions_of_indigo [2022/05/06 22:03] – created mattbindigo_2022.1_documentation:upgrading_from_legacy_versions_of_indigo [2025/02/18 20:36] (current) – external edit 127.0.0.1
Line 1: Line 1:
 +====== Upgrading from Legacy Versions of Indigo  ======
 +
 +==== Upgrading from Indigo 7.5 ====
 +
 +For this release, we've changed the server install path to:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 2022.1/
 +
 +and the Indigo Mac Client app is now named:
 +
 +    /Applications/Indigo 2022.1.app
 +
 +In addition to the automatic upgrade logic described below (for upgrades from Indigo 6 and earlier), the installer moves previously installed control page images and web server plugins to the new install location. Note the folder that contains Web server images, legacy Web plugins, etc. has been renamed from:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 7.5/IndigoWebServer/
 +
 +to:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 2022.1/Web Assets/
 +
 +If you experience the error ''**This version of the Indigo client application is not compatible with the Indigo Server**'' when trying to launch Indigo then that means the Indigo client version being launched doesn't match the version of Indigo Server currently being run. This can occur when an older version of Indigo Server is still running or an older version of Indigo Client was launched by mistake. To fix this follow these steps:
 +
 +  - Shut down the Indigo Server by selecting the ''**Indigo 7.5->Stop Server**'' menu item in the Mac client. This will shut down the Indigo Server regardless of which version is running.
 +  - Quit the Mac client via the ''**Indigo 7.5->Quit Indigo**'' menu item.
 +  - Open the ''/Applications'' folder on your Mac and launch the version of Indigo you wish to use. This will have it launch the correct version of the Indigo Server when it starts.
 +
 +Once you are sure you are ready to run the latest version of Indigo can delete (backup first!) the older Indigo Server install paths in ''/Library/Application Support/Perceptive Automation/'' and client applications in ''/Applications''.
 +
 +==== Upgrading from Indigo 7.4 ====
 +
 +For this release, we've changed the server install path to:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 2022.1/
 +
 +and the Indigo Mac Client app is now named:
 +
 +    /Applications/Indigo 2022.1.app
 +
 +In addition to the automatic upgrade logic described below (for upgrades from Indigo 6 and earlier), the installer moves previously installed control page images and web server plugins to the new install location. Note the folder that contains Web server images, legacy Web plugins, etc. has been renamed from:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 7.4/IndigoWebServer/
 +
 +to:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 2022.1/Web Assets/
 +
 +If you experience the error ''**This version of the Indigo client application is not compatible with the Indigo Server**'' when trying to launch Indigo then that means the Indigo client version being launched doesn't match the version of Indigo Server currently being run. This can occur when an older version of Indigo Server is still running or an older version of Indigo Client was launched by mistake. To fix this follow these steps:
 +
 +  - Shut down the Indigo Server by selecting the ''**Indigo 7.4->Stop Server**'' menu item in the Mac client. This will shut down the Indigo Server regardless of which version is running.
 +  - Quit the Mac client via the ''**Indigo 7.4->Quit Indigo**'' menu item.
 +  - Open the ''/Applications'' folder on your Mac and launch the version of Indigo you wish to use. This will have it launch the correct version of the Indigo Server when it starts.
 +
 +Once you are sure you are ready to run the latest version of Indigo can delete (backup first!) the older Indigo Server install paths in ''/Library/Application Support/Perceptive Automation/'' and client applications in ''/Applications''.
 +
 +==== Upgrading from Indigo 7.3 ====
 +
 +For this release, we've changed the server install path to:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 2022.1/
 +
 +and the Indigo Mac Client app is now named:
 +
 +    /Applications/Indigo 2022.1.app
 +
 +In addition to the automatic upgrade logic described below (for upgrades from Indigo 6 and earlier), the installer moves previously installed control page images and web server plugins to the new install location. Note the folder that contains Web server images, legacy Web plugins, etc. has been renamed from:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 7.3/IndigoWebServer/
 +
 +to:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 2022.1/Web Assets/
 +
 +If you experience the error ''**This version of the Indigo client application is not compatible with the Indigo Server**'' when trying to launch Indigo then that means the Indigo client version being launched doesn't match the version of Indigo Server currently being run. This can occur when an older version of Indigo Server is still running or an older version of Indigo Client was launched by mistake. To fix this follow these steps:
 +
 +  - Shut down the Indigo Server by selecting the ''**Indigo 7.3->Stop Server**'' menu item in the Mac client. This will shut down the Indigo Server regardless of which version is running.
 +  - Quit the Mac client via the ''**Indigo 7.3->Quit Indigo**'' menu item.
 +  - Open the ''/Applications'' folder on your Mac and launch the version of Indigo you wish to use. This will have it launch the correct version of the Indigo Server when it starts.
 +
 +Once you are sure you are ready to run the latest version of Indigo can delete (backup first!) the older Indigo Server install paths in ''/Library/Application Support/Perceptive Automation/'' and client applications in ''/Applications''.
 +
 +==== Upgrading from Indigo 7.2 ====
 +
 +For this release, we've changed the server install path to:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 2022.1/
 +
 +and the Indigo Mac Client app is now named:
 +
 +    /Applications/Indigo 2022.1.app
 +
 +In addition to the automatic upgrade logic described below (for upgrades from Indigo 6 and earlier), the installer moves previously installed control page images and web server plugins to the new install location. Note the folder that contains Web server images, legacy Web plugins, etc. has been renamed from:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 7.2/IndigoWebServer/
 +
 +to:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 2022.1/Web Assets/
 +
 +If you experience the error ''**This version of the Indigo client application is not compatible with the Indigo Server**'' when trying to launch Indigo then that means the Indigo client version being launched doesn't match the version of Indigo Server currently being run. This can occur when an older version of Indigo Server is still running or an older version of Indigo Client was launched by mistake. To fix this follow these steps:
 +
 +  - Shut down the Indigo Server by selecting the ''**Indigo 7.2->Stop Server**'' menu item in the Mac client. This will shut down the Indigo Server regardless of which version is running.
 +  - Quit the Mac client via the ''**Indigo 7.2->Quit Indigo**'' menu item.
 +  - Open the ''/Applications'' folder on your Mac and launch the version of Indigo you wish to use. This will have it launch the correct version of the Indigo Server when it starts.
 +
 +Once you are sure you are ready to run the latest version of Indigo can delete (backup first!) the older Indigo Server install paths in ''/Library/Application Support/Perceptive Automation/'' and client applications in ''/Applications''.
 +
 +==== Upgrading from Indigo 7, or 7.1 ====
 +
 +For this release, we've changed the server install path to:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 2022.1/
 +
 +and the Indigo Mac Client app is now named:
 +
 +    /Applications/Indigo 2022.1.app
 +
 +In addition to the automatic upgrade logic described below (for upgrades from Indigo 6 and earlier), the installer is now smarter and moves previously installed control page images and web server plugins to the new install location. Note the folder that contains Web server images, legacy Web plugins, etc. has been renamed from:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 7/IndigoWebServer/
 +
 +to:
 +
 +    /Library/Application Support/Perceptive Automation/Indigo 2022.1/Web Assets/
 +
 +If you experience the error ''**This version of the Indigo client application is not compatible with the Indigo Server**'' when trying to launch Indigo then that means the Indigo client version being launched doesn't match the version of Indigo Server currently being run. This can occur when an older version of Indigo Server is still running or an older version of Indigo Client was launched by mistake. To fix this follow these steps:
 +
 +  - Shut down the Indigo Server by selecting the ''**Indigo 7->Stop Server**'' menu item in the Mac client. This will shut down the Indigo Server regardless of which version is running.
 +  - Quit the Mac client via the ''**Indigo 7->Quit Indigo**'' menu item.
 +  - Open the ''/Applications'' folder on your Mac and launch the version of Indigo you wish to use. This will have it launch the correct version of the Indigo Server when it starts.
 +
 +Once you are sure you are ready to run the latest version of Indigo can delete (backup first!) the older Indigo Server install paths in ''/Library/Application Support/Perceptive Automation/'' and client applications in ''/Applications''.
 +
 +==== Upgrading from Indigo 6, 5, 4, 3, or 2 ====
 +First, run the Indigo 2022.1 installer. Then look through this list for any final actions.
 +
 +  * In Indigo 7, we moved to Python v2.7, so if you installed any shared scripts ([[https://wiki.indigodomo.com/doku.php?id=indigo_2022.1_documentation:plugin_scripting_tutorial#shared_classes_and_methods_in_python_files_python_modules|as outlined here]]) then you'll need to move them from: ''/Library/Python/2.6/site-packages/'' to ''/Library/Python/2.7/site-packages/''
 +  * Indigo will automatically copy your old preference file into the new location during the installation.
 +  * Indigo will also copy over any enabled and disabled Plugins from Indigo 6 or 5. If a newer version of a plugin is included in Indigo, then it will automatically be installed and used on launch.
 +  * Your old Indigo database file will automatically be converted to the new Indigo file format on first launch. A copy of your database will automatically be made before it is converted, but any changes made in Indigo to your database will not be available in older versions of Indigo.
 +  * If you are **upgrading from Indigo 6**, you'll need to manually copy over any custom scripts, web server plugins, and/or custom control page images that you may have added. They can be found in the following directories:
 +    * //Scripts//: ''/Library/Application Support/Perceptive Automation/Indigo 6/Scripts/''
 +    * //Control Page Images//: ''/Library/Application Support/Perceptive Automation/Indigo 6/IndigoWebServer/images/''
 +    * //Web Server Plugins//: ''/Library/Application Support/Perceptive Automation/Indigo 6/IndigoWebServer/plugins/''
 +  * If you are **upgrading from Indigo 5**, you'll need to manually copy over any custom scripts, web server plugins, and/or custom control page images that you may have added. They can be found in the following directories:
 +    * //Scripts//: ''/Library/Application Support/Perceptive Automation/Indigo 5/Scripts/''
 +    * //Control Page Images//: ''/Library/Application Support/Perceptive Automation/Indigo 5/IndigoWebServer/images/''
 +    * //Web Server Plugins//: ''/Library/Application Support/Perceptive Automation/Indigo 5/IndigoWebServer/plugins/''
 +  * If you are **upgrading from Indigo 4**, you'll need to manually copy over any custom scripts, web server plugins, and/or custom control page images that you may have added. They can be found in the following directories:
 +    * //Scripts//: ''/Library/Application Support/Perceptive Automation/Indigo 4/Scripts/''
 +    * //Control Page Images//: ''/Library/Application Support/Perceptive Automation/Indigo 4/IndigoWebServer/images/''
 +    * //Web Server Plugins//: ''/Library/Application Support/Perceptive Automation/Indigo 4/IndigoWebServer/plugins/''
 +  * If you are **upgrading from Indigo 3 or Indigo 2**, you'll need to manually copy over any custom scripts and/or custom control page images that you may have added. They can be found in the following directories:
 +    * //Scripts//: ''/Library/Application Support/Perceptive Automation/Indigo 2/Scripts/''
 +    * //Control Page Images//: ''/Library/Application Support/Perceptive Automation/Indigo 2/IndigoWebServer/images/''
 +
 +**<color red>NOTE</color>**: Do not replace the new Indigo versions of any file with your Indigo 6, 5, 4, 3, or 2 files. They have been modified to run optimally under the new version of Indigo.
 +
 +==== Upgrading from Indigo 1.x ====
 +
 +  * Indigo will automatically copy your old preference file into the new location on first launch.
 +  * Your old Indigo database file will automatically be converted to the new Indigo file format on first launch. You will be prompted to save the new copy of the Indigo database file. The new Indigo file format is not compatible with Indigo 1.x. You should not replace or delete your older Indigo 1.x database file. Any changes made in Indigo to your database settings will not be available in older versions of Indigo.
 +  * You will need to manually copy any of your custom script files. You only need to move the files from the Indigo 1.x location (''[~your user home folder]/Documents/Indigo User Data/Scripts/'') to the new folder specified above if you modified or added new script or script attachment files.
 +
 +**<color red>NOTE</color>**: Do not replace the new Indigo versions of any file with your Indigo 1.x files. They have been modified to run optimally under the new version of Indigo.
 +
 +==== AppleScript after Upgrading ====
 +
 +Indigo no longer supports AppleScripts that target the Indigo Server process. Check out the [[https://wiki.indigodomo.com/doku.php?id=developer:applescript_integration_strategies&#converting_indigo_applescripts_to_python|AppleScript Integration Strategies]] article for options on converting your AppleScripts.
 +
 +When Indigo first opens an Indigo 7.3 (or earlier) database, it will go through the database and identify items that will need changing and items you should look at to ensure that it will continue to function. The Event Log will contain the necessary information about where you can find those items. You can also select the ''**Help->Show AppleScript Usage in Event Log**'' menu item and Indigo will show you the list of those items in the Event Log window again.
 +
 +Embedded AppleScripts and AppleScript conditionals will need to be evaluated to best determine how to handle them. In those edit boxes in the UI, we've commented out the previous AppleScript for reference if you wish to convert them. Both of those script edit boxes now will only accept Python scripts.
 +
 +If you have [[indigo_2022.1_documentation:overview#execute_script|Execute Script]] actions that point to AppleScripts, those will continue to be run, though if the script contains a **tell "IndigoServer"** or **using terms from "IndigoServer"** they will fail.