Versions Compared

Version Old Version 13 New Version 14
Changes made by

Ricky Villa

Ricky Villa

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Version published after converting to the new editor

Table of Contents

...

Below is how to migrate a project using the FIN Migrate tool. If you have a FIN 4.5 project backup, but don't have FIN Stack 4.5 installed, look at step 2 below on how to migrate that without the FIN 4.5 service. It is recommended to do the Manual Migration over this tool as it is a lot quicker and provides logging information like errors and other useful information.


Warning
titleBrowser Cache, Bookmark, FIN desktop shortcut

Before migrating, the user should be prepared to let their customers know a few issues they may encounter after migration and how to resolve them if they do come across them. Those issues involve browser cache, bookmarks, and/or FIN desktop shortcut. If they don't come across them, it is still recommended to clear browser cache.

Browser Cache

To resolve the browser cache, they would have to follow the below steps to clear browser cache:

  1. On the Chrome browser, hit the F12 key on the keyboard (opens up the Developer tools)
    1. If F12 doesn't work, they can go to browser Settings (top right corner)
    2. Select "More tools"
    3. Then select "Developer tools"
  2. Then right-click on the browser refresh icon
  3. Select "Empty Cache and Hard Reload"
  4. Once the page reloads, they can close the Developer tools window and that's it for the browser cache

Bookmark and FIN desktop shortcut

To resolve this, they can follow this doc on how to Launch Specific Project.

...

Thats it, the whole migration process has been completed and can check out the project(s).

The funcs that were executed while migrating were below. If for some reason, things look off, they can be executed manually in folio with bacnetServerMigrate being optional if being used in project:

  • finMigrateFilterIds() - this would update the id's on certain filters such as graphicOn, programOn etc. If not updated, those records wouldn't appear or function without proper id format. For example a floor graphic usually only runs on a single floor so its graphicOn would be an id of a floor. They would have to be updated manually or using the function. If the user notices that the id's weren't updated, then can run the function in folio to update them. Then check to see if it worked. If not, contact your distributor.
    • Example use: finMigrateFilterIds()
  • finMigrateFinFile() - this would update the id's on virtualPoints, bindings, query tags inside graphics, programs etc. This however may not update id's in a program/event inside a graphic. Those would have to be updated manually if there are any hardcoded in there. This can also be ran in folio if they weren't updated.
    • Example use: readAll(fin5).each x => x.finMigrateFinFile() OR finMigrateFinFile(@record_Id)
  • bacnetServerMigrate() - this would update the below bacnet tag names to the new tag names in FIN 5.0. This would be for projects using bacnetServer in FIN 4.5. The ext needs to be enabled.
    • bacnetNetwork → bacnetServerNetwork
    • bacnetLocalAddress → bacnetServerLocalAddress
    • bacnetMacAddress → bacnetServerMacAddress
    • bacnetDevice → bacnetServerDevice
    • bacnetInstance → bacnetServerInstance
    • bacnetCovIncrement → bacnetServerCovIncrement
      • Example use: bacnetServerMigrate()

...

  1. Go to DB Builder and select the Tuning Policies tree
  2. Select the tuning policy that is applied to the Bacnet connectors (this is assuming the Bacnet connector(s) already have one. If not, create one and apply it to them)
  3. Then click on the 'i' icon next to it on the left side under the Essentials column
  4. Add the "bacnetDisableCov" marker tag and save it
  5. Then disable the Bacnet Connectors
  6. After disabling, re-enable a handful of Bacnet connectors at a time


Thats it, the project(s) should be good to go.