I am not a daily user, nor developer of ISY and related items. However, I have been watching over the last few weeks with excitement of the migration of ISY to the Polisy (IoP). Unfortunately, while there are lots of excellent tips / guidance etc, many of them at first read are "over my head" and are very scattered throughout the forums. So after studying the many posts, I have collated and developed a Simple Person's Guide to making the migration.
For those of you that are the experts / daily users, please feel to suggest edits /corrections to this page for others to benefit from.
Disclaimer: I am still in the progress of this migration myself and will update with any corrections or new experiences. Lastly, many thanks to ALL the incredibly talented and smart people on these forums that I have "stolen" the information from. Here are a few: @Michel Kohanim @Javi @larryllix @bpwwer @tazman @lilyoyo1 @Jimbo @garybixler @kzboray
ISY on 994i Preparation:
Conduct a regular backup
Export a text copy of all programs: Go to programs and right click My Programs and select Copy Folder to Clipboard. Open text editor and paste, save.
All below are optional steps that are for protection and / or manual fix references:
UnderTab Programs / Summary, copy all cells and past into a spreadsheet. Add column header names, and save.
Under Main, click on My Lighting. On table, click on column header labeled Address to sort table by address. This will group all your Z-wave devices together, x10 devices together and your node servers together, etc. Take screen shots of all this information for reference if needed.
ELK: If you have ELK module, click on Elk / Areas/ All Areas / Zones. Highlight all cells in table and paste into a spreadsheet, add column titles, save. Repeat for each area. Repeat for Keypads. Repeat for Outputs * NOTE : Elk module is not available for ISY on Polisy. The Nodeserver will replace that. Currently there is no migration tool for this and the Elk module data will not transfer to ISY on Polisy. Having the text copy of all programs in first step will be critical to restoring all the programs.
Under Configuration / System tab, take a screenshot of all information
Under Configurations / Emails/Notifications / Settings/Groups, take screen shot of all information
Under Configurations / Emails/Notifications / Customizations, take screen shot of main screen. Labor intensive next step, do only if concerned: copy each name, past into text editor, open each Customized Content. Copy From, Subject and Body and paste into text editor. This will create a record of any system complex notifications you may have such as:
-Front: ${sys.node.ZW015_1.ST} and ${elk.zone.1.status}.
-Mud Room: ${sys.node.ZW020_1.ST} and ${elk.zone.15.status}.
Under Configuration / Elk / Configuration, if applicable, take screen shot of Elk Config.
Under Configuration / Networking / Network Resources, hit export and save
At top level menu, select Tools / Generate Topography. Save.
At top level menu, select Z-Wave / Backup
Portal Preparation:
If you use Alexa or Google or other voice systems, go to those tabs and Select Download (symbol) at the top and save a copy of the Spokens and their corresponding ISY programs / scenes etc.
Polyglot Cloud Preparation (PGC):
Log into above, and for any Nodeservers you have, go to Details / Configuration and save screenshots
Polyglot on Polisy Preparation (PG2):
Log into above, and for any Nodeservers you have, go to Details / Configuration and save screenshots
Go to System / Check for Polisy Updates.
Go to Settings / Polyglot Settings and select Download Backup, Save.
Hardware Preparation, Polisy:
Ensure latest version of ISY is on the Polisy. (IoP):
Most recent versions of Polisy come with isy service already installed. So, the question is how old is your unit. If you have doubts, click the button behind the little hole on the front only once. This will download and upgrade your Polisy (if not very old). Once you hear the beeps, then isy on Polisy can be accessed through the ISY Launcher.
If Polisy is old, you will need to SSH to the Polisy and update it manually. You will need the IP address of your Polisy.
Instructions for a PC can be found here: https://forum.universal-devices.com/topic/34348-very-simple-instructions-requested-to-get-isy-on-polisy/?do=findComment&comment=324026
For a Mac, the built in application Terminal can be used to do the above.
PLM Prep. The Polisy can use any of the PLMs available:
If using a serial PLM, you will need the original cable that came with the PLM to attach to the serial output of the PLM. This is the cable. https://smartenit.com/shop/plm-serial-cable/
USB PLMs require a USB cord.
Z-Wave: If you utilize Z-Wave, you will need a USB z-wave dongle to attach to the Polisy such as https://www.thesmartesthouse.com/collections/shop-by-brand/products/zooz-usb-700-series-z-wave-plus-s2-stick-zst10-700 . Attach this dongle to the back of the Polisy.
Connect to ISY on Polisy (IoP):
Ensure Polisy is running and updates above have been made. No need to connect to PLM at this point, still in preparation stage.
Open the ISY Finder and see if it finds Polisy. If not, Add the following IP addresses, one at a time: http://myPolisy:8080/desc and https://myPolisy:8443/desc, where myPolisy is your IP address of you Polisy.
Once the Polisy is found, open the Admin Console (Cloud or Lan):
Sign in for the first time with User ID and password as admin
Go to File / Set User ID/Password and change.
For isy to support INSTEON and/or Z-Wave, go to the Admin Console / Configuration and check INSTEON/Z-Wave support checkboxes, click on save, and then click on the reboot button.
Add Polyglot 3 (PG3) to Polisy. PG3 is the future development site for Nodeservers. Support for PG2 appears to be ending as developers look to move to PG3. To install PG3 on Polisy, create a SSH and enter the following:
sudo pkg install pg3
sudo service pg3 enable
sudo service pg3 start
Once it is installed, you can access it at https://<your polisy's IP>:3000/ . It has the standard default login of 'admin' / ‘admin’.
Change password by going to Settings / Profile.
This will not affect your current PGC or PG2.
Migration of ISY:
Unplug 994i and Polisy from power
Connect Polisy to PLM, and reboot Polisy. If PLM is new or has been reset to factory settings, you will need to restore it later the process
Open ISY Finder, and then the Admin console for ISY on Polisy. Once opened, select File / Restore ISY. Select the ISY backup you prepared earlier from the 994i..
Everything is migrated except Z-wave at this time. Recommended approach is to be sure to print Tools / Topography. Then, using the topology, exclude then include your Z-Wave devices in ZW order ie ZW_01. This way, whatever programs you already have will continue to work and whatever Alexa spokens you have will point to the same devices
(Network resources may need to be individually opened and re-saved, or can be deleted and reimported from file exported in prep stage if they are not working)
NOTE: my ISY immediately disappeared. Upon reloading into it, the user id and passwords had reset to admin/admin, even though I changed them up above. Also Programs become randomly Disabled or Enabled. Need to check. I also lost my Query All Program details.
If restoring or factory reseting or using a new PLM follow these directions Restore PLM
Migration of PG2 to PG3:
Both PG2 and PG3 can run at the same time and point to the same ISY. Since PG3 is still in development as is the nodeservers, it is unclear the best path forward, in this regards, but a migration / cleanup of duplicates between PG2 and PG3 may be best done prior to migrating either to the Polisy. User choice.
On PG3, go to Settings / Polyglot Settings and select Restore Backup from Polyglot v2 to ISY on Polisy xxxxxxxxx, where xxxxxxxxx is the UUID of the ISY on Polisy. Select the file you backup up earlier from the Polisy, PG2. However, there are things to note about this process.
The node server must exist in the PG3 store. It can't restore node servers that don't exist for PG3. Efforts are underway to create matches.
The node server in PG3 must have the same name as the node server in PG2. If the name has changed, it won't be able to find it under the new name.
If the node server in PG3 is not a free node server, you'll need a license for the PG3 version or it won't restore.
Configuration parameters will only carry over if they are the same. If the PG3 configuration is different, it can't translate.
Any node servers that exist in both can be deleted from PG2 at this time, prior to migration to ISY on Polisy.
Note: Time for integration took 20-30 minutes.
All, there was a big bug with migration which wiped out portal connectivity. A potential fix (which did not work for me. A ticket was required for UDI to restore):
1. sudo rm /var/isy/FILES/CONF/PORTALS.PSF
2. sudo service isy restart
Migration of Polyglot PG2 to new ISY on Polyglot:
Open Polyglot PG2 on Polisy and under Settings / Polyglot Settings, change ISY Settings to reflect the IP address of the ISY on Polisy. Should match the IP and port address used in the Admin Console to open ISY on Polisy, or host: localhost, port: 8080, uncheck HTTPS.
Migration of Polyglot PG3 to new ISY on Polyglot:
Open Polyglot PG2 on Polisy and under Settings / Polyglot Settings, change ISY Settings to reflect the IP address of the ISY on Polisy. Should match the IP and port address used in the Admin Console to open Isy on Polisy.
Migration of Portal:
Open your portal. Under ISY / Add ISY, add the UUID of the ISY on Polisy. This can be found either on the ISY Finder, or in the Admin Console / Help / About.
Once entered, you will be asked about a license. Select Free Trial.
Follow directions and back at ISY under Help / Manage Modules to add the Portal. ISY will reboot.
Once rebooting, re-open admin console and go to Configurations / Portals and approve access for the portal.
Go back to the Portal, refresh and you should see a green dot next to the UUID.
Do NOT delete your old ISY as it is required to be there for the next step.
To migrate Alexa or other commands, follow these directions while BOTH UUIDs are still in the portal. https://wiki.universal-devices.com/index.php?title=Main_Page#ISY_Portal_Migrate_configurations_to_a_new_ISY
Migration of Elk:
If you have the Elk module on the ISY994 you will need to install the ELK Node Server to restore ELK functionality. The node server version will have different node addresses and some slightly different naming.
Programs that used the ELK have to be reconfigured for the new ELK nodes.
After rebooting the ISY post migration and the ELK NS install, the programs that need attention will be highlighted in yellow as they show up on the programs/summary page. Refer to Program text file if backed up earlier for rebuilding.
At that point it is just a matter of restoring the new ELK nodes back into the programs.
Speak and query aren't available on version PG2 but will be added to PG3 in the future.
Migration of Z-Wave:
Currently there is no migration of z-wave, so the extra backup steps above will help you recreate your z-wave network. After all Z-wave devices were added, i notice many were in "different slots". Using the Find / Replace at the top My Programs worked like a charm for many of them. Saved me about an hour or two!.
Reboot:
Reboot your ISY and relaunch the Admin Console and begin any final work in the migration.
WIki 994i to Polisy.pdf