Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added warning to check for valid maintenance
Table of Contents
Note

Make sure your license is under a valid maintenance plan before upgrading to the latest version.
https://finproducts.atlassian.net/wiki/spaces/FINFramework/pages/879953605/Maintenance+Program#License-and-Software-Maintenance

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 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 if applicable from older FIN to latest FIN installation:

    • custom pods if any opt/fin/lib/fan (Substitute it with your specific installation path if different)

  4. Copy and replace the below folders under the var folder to the new installation (if applicable): opt/fin/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 

Warning

Before uninstalling old FIN
We recommend to make a copy of the following files from your old FIN installation before uninstalling old old FIN installation. Save them to an external location from the FIN directory such as on desktop, USB, or some other folder on the machine. Double check that you have enough space to do so, otherwise don’t uninstall the old FIN installation. If you’re confident the new FIN installation has everything, then you can skip this if not needed.

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

  2. Copy the below folders under the var folder (if applicable): C:\Program Files (x86)\FIN Framework\FIN Framework X.X.X.XXXX\var (Substitute it with your specific installation path if different)

    • 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