********************************************************************************
*         ASFALIS TransServer Release Note                                     *
*                                                                November 2020 *
********************************************************************************

=======================================================================
[Important Notice]
ASFALIS TransServer EX8.3.2 supports the upgrade installation from EX8.1, EX8.1.x, EX8.2, EX8.2.x or EX8.3.
When upgrading from other than EX8.3, please make sure to confirm the section 9 below before running EX8.3.2 installer.
=======================================================================

1. Released Product
   ASFALIS TransServer

2. Version
   EX8.3.2

3. ASFALIS Slave Node Version
   EX8.3 or EX8.3.x

4. System Requirements
   Refer to the "Installation Guide".
   [Notice]
   Give "Full Control" permission of ASFALIS TransServer installation folder directly to users who execute the program, not through groups.
   Launching ASFALIS TransServer might fail if the permission is not sufficient.

5. Enhancements and Bug Fixes

  [Bug Fix]
   - Fixed some issues about scenario execution related to DFM Studio.

6. Known Issues
   N/A

7. Notes

   - ASFALIS TransServer system may not operate properly due to Web browser's cache when it is upgraded from the version before EX6.1. 
     Try clearing Web cache when it fails in limited operations only.

   - Folder monitoring function cannot be restarted if it is stopped when Job(s) are in the queue. 
     In such cases, stop and restart the process of "AutoRegisterService.exe" as a workaround.

   - Please note that the installer of ASFALIS TransServer EX8.3.2 supports the upgrade installation from EX8.1, EX8.1.x, EX8.2, EX8.2.x or EX8.3 only.
     Please upgrade to EX8.1 beforehand if you are currently using ASFALIS TransServer EX8.0.x or former.
   
   - Restriction on Component Templates
     Please note that it is not allowed to use the same Component template more than once within a single Scenario.
     
   - Restriction on File Extensions in File Uploads
     Please note that some files with non-standard file extensions will not be displayed in the file upload dialog. 
     Change the file type to "All Files" to upload those files.

   - 1-byte tilde (~) will be replaced with a hyphen (-) when downloading via Google Chrome.

   - Please ensure to use "ExportBlankedSolid" instead of "ConvertDisplaySolid" when translating Creo Parametric to ENF. 
     ("ConvertDisplaySolid" is replaced by "ExportBlankedSolid".)

8. Copyright and License
   Refer to the following folders and files to check the copyrights and licenses for third-party software products and open source software.

   - \doc\LICENSE\credits.txt
   - \doc\LICENSE\credits\

9. Upgrade Installation
   When upgrading from EX8.1(including EX8.1.x) or EX8.2(including EX8.2.x), please confirm the following before running EX8.3.2 installer.

   9-1. Check the following two resource folders for inconsistencies.
      A. "PrivateResourcePath" in k2server.ini
         <ATS Install Directory>\config\k2server.ini
      B. "vaults" table in PostgreSQL
         B1. Launch pgAdmin 4.
         B2. Select "PostgreSQL 10.*" on the object browser.
         B3. Select EX8.1 or EX8.2 database. (e.g., trans_server_ex8_2_0)
         B4. Check the values of "vaults" table. (Schemas -> public -> Tables -> vaults)
      
      If "PrivateResourcePath"(A) and "vaults"(B) are consistent, you do not have to check after 9-2.
      Run EX8.3.2 installer to upgrade ASFALIS TransServer to EX8.3.2.
      [Example of Consistent Configurations]
      - "PrivateResourcePath"(A)
        C:\ELYSIUM\ASFALIS_TransServer\EX8_2_0\data\noshare\resource
      - "vaults"(B)
        C:\ELYSIUM\ASFALIS_TransServer\EX8_2_0\data\noshare\resource/EX8.2.0/unprotected
        C:\ELYSIUM\ASFALIS_TransServer\EX8_2_0\data\noshare\resource/EX8.2.0/protected

      If "PrivateResourcePath"(A) and "vaults"(B) are not consistent, please follow the steps below before running EX8.3.2 installer.
      [Example of Inconsistent Configurations]
      - "PrivateResourcePath"(A)
        C:\ELYSIUM\ASFALIS_TransServer\EX8_2_0\data\noshare\resource
      - "vaults"(B)
        D:\Program Files\ELYSIUM\ASFALIS_TransServer\EX8_2_0\data\noshare\resource/EX8.2.0/unprotected
        D:\Program Files\ELYSIUM\ASFALIS_TransServer\EX8_2_0\data\noshare\resource/EX8.2.0/protected

   9-2. Stop ASFALIS TransServer EX8.2.

   9-3. Change "PrivateResourcePath" in k2server.ini to the value consistent with "vaults".
      Please keep a record of the previous value before you change it.
      In case of "Example of Inconsistent Configurations" above, change "PrivateResourcePath" as below.
      D:\Program Files\ELYSIUM\ASFALIS_TransServer\EX8_2_0\data\noshare\resource
      If the updated "PrivateResourcePath" folder does not exist, please create an empty folder so that it exists.

   9-4. Start ASFALIS TransServer EX8.2.

   9-5. Create a backup file.
      Please refer to the section "6.1 Back up the Database" in the administration manual "ASFALIS_TransServer_Admin_en.pdf" for instructions on how to create a backup file.
      When creating a backup file automatically, set "All" as the value of the server configuration "system.backup.backup_target".

   9-6. Stop ASFALIS TransServer EX8.2.

   9-7. Reset "PrivateResourcePath" in k2server.ini to its original value.
      Reset the value to what it was before changing it in step 9-3.
      (After resetting the value, "PrivateResourcePath" and "vaults" are not consistent.)

   9-8. Restore the database.
      Restore the backup file created in step 9-5.

   9-9. Change "vaults" to the value consistent with "PrivateResourcePath".
      In case of "Example of Inconsistent Configurations" above, change "vaults" as below.
      C:\ELYSIUM\ASFALIS_TransServer\EX8_2_0\data\noshare\resource/EX8.2.0/unprotected
      C:\ELYSIUM\ASFALIS_TransServer\EX8_2_0\data\noshare\resource/EX8.2.0/protected
      After changing "vault", make sure to save the changes of database by using save command on pgAdmin 4. 

   9-10. Upgrade to EX8.3.2 by running EX8.3.2 installer.

-----------------
Elysium Co. Ltd.