Update FIN

To update FIN, follow below steps depending on operating system being used.

On WINDOWS OS

1. Look at current Java Memory Heap size. If has been changed from the default of 512 make a note of it.

2. Install latest FIN (here are the steps: How to install FIN) - check these 2 settings options and uncheck the last one:

   • [Check] Copy settings from the 'etc' and 'var' folders: if checked, will copy some of the settings and contents of those folders to the new installation

   • [Check] Copy database folder: if checked, will copy the database to the new installation

   • [Uncheck] Uninstall older version: if checked, will prompt to uninstall the previous version after installing latest (we strongly recommend creating a backup and saving somewhere outside the FIN directory before uninstalling any version)

3. Stop the FIN Service

4. Update the Java Memory Heap to what the old one was.

5. Copy the below files from main directory from older FIN to latest FIN installation (if applicable):

   • custom pods if any C:\Program Files (x86)\FIN Framework\FIN Framework X.X.X.XXXX\lib\fan (Substitute it with your specific installation path if different)

6. Copy and replace the below folders under the var folder to the new installation (if applicable): C:\Program Files (x86)\FIN Framework\FIN Framework X.X.X.XXXX\var

   • etc folder under var

   • log folder (if you prefer to retain older log files)

   • pub folder

7. Start the FIN Service

On WINDOWS OS, FIN Stack brand for 5.2.

In the latest update, the “FIN Stack” brand has been renamed to “FIN.” As a result, when performing an update, the new service installation will not automatically recognize the existing FIN Stack service to copy files to the new installation. This process must be completed manually. Please follow the steps below.

1. In the current installation, locate the current Java Memory Heap size. If has been changed from the default of 512 make a note of it.

2. Install the latest FIN (here are the steps: How to install FIN) as a clean installation.

3. Stop the FIN Service

4. Update the Java Memory Heap to what the old one was.

5. Navigate to the FIN directory of the new installation and delete the ‘var’ folder.

   • Example path: C:\Program Files (x86)\FIN\FIN X.X.X.XXXX\var

6. Navigate to the FIN directory of the old installation and either move or copy and replace the ‘var’ folder to the new installation.

   • Example old path: C:\Program Files (x86)\FIN Stack\FIN Stack X.X.X.XXXX\var - move/copy

   • Example new path: C:\Program Files (x86)\FIN\FIN X.X.X.XXXX\ - move/paste here
     Note: If you want to minimize the amount of files to move/copy, you can move out the snapshots from the project and maybe skip the logs files found in the var folder.
     The snapshots can be found under the project folder and moved outside the directory.
     Example path: C:\Program Files (x86)\FIN Stack\FIN Stack X.X.X.XXXX\var\proj\demo\backup - move out the ‘backup’ folder to reduce the file size

7. Start the FIN Service
   
   

On MAC OS with zip file

1. Stop the FIN Service

2. Install latest FIN (here are the steps: How to install FIN)

3. Copy and replace the below files from main directory from older FIN to latest FIN installation (if applicable):

   • custom pods if any HD:\Library\Application Support\FIN Framework\FIN Framework X.X.X.XXXX\lib\fan (Substitute it with your specific installation path if different)

   • config and/or units file or any other file in sys folder if modified HD:\Library\Application Support\FIN Framework\FIN Framework X.X.X.XXXX\etc\sys

4. Copy and replace the below folders under the var folder to the new installation (if applicable): HD:\Library\Application Support\FIN Framework\FIN Framework X.X.X.XXXX\var

   • crypto - contains trusted certificates if any were added.

   • etc - contains Edge2Cloud files and can contain Sedona Manifests or other custom files if added.

   • host - contains host settings

   • lic - contains license file(s)

   • log - (if you prefer to retain older log files)

   • proj - contains project(s). Note: If there are a lot of snapshots, we recommend to remove some so that you don’t copy all of those unless you have the space for it. They are found under each proj → backup folder.

   • pub - contains custom files

   • user - contains the users

5. Start the FIN Service 
   
   

On LINUX OS with zip file

1. Stop the FIN Service 

2. Install latest FIN (here are the steps: How to install FIN)

3. Copy the below files from main directory from older FIN to latest FIN installation (Substitute it with your specific installation path if different):

   • bacnetExt folder found in opt/fin/etc

   • custom pods if any opt/fin/lib/fan

   • BACnet bbs.conf file found in opt/fin/lib/java/ext/BBS_LIB/system

4. Copy or move the var folder to the new installation: opt/fin/var

   • Note: If there are a lot of snapshots, we recommend to remove some so that you don’t copy all of those unless you have the space for it. They are found under each proj → backup folder. Example path to our demo fin/var/proj/demo/backup.

   • You can also skip the log files if needed to reduce additional space usage. Path fin/var/proj/log

5. Start the FIN Service