Sahi Pro - Upgrade Sahi Pro

• Upgrading to Sahi Pro 6.1.0 is easier than before.
  When you upgrade, Sahi Pro installs the latest files and re-applies your existing configuration settings.
  
  The settings files which are modified by the upgrade, will be backed up in userdata_dd-MM-yyyy_HH-mm-ss.
  

1. Assuming you have Sahi Pro Installed at C:\SahiPro
   
2. To download latest version of Sahi Pro Click here
3. Install the latest version in the same folder where existing Sahi Pro was already installed (C:\SahiPro).
   
4. A confirmation window will popup. Click Yes on it.
5. Complete the installation process
   

Post Upgrade step for MySQL

MySQL database has to be upgraded manually.

Please follow these instructions.

1. It is recommended that you take a backup of your database before you perform the manual upgrade, if your data is valuable.
   
2. Open config/db/create_report_tables_mysql.sql
   
3. You will find sql queries grouped according to version. Copy all queries from versions that are after your current version, to a separate file.
   Examples:
   
   • If your current version is 6.0.0, copy all queries from /* VERSION 2015-02-09 14:38:51 # 6.1.0 */ onwards.
     
   • If your current version is 5.1.2, copy all queries from /* VERSION 2014-10-15 18:27:48 # 6.0.0 */ onwards.
     
4. Execute the queries copied in the previous step, on your MySQL database.
   

Post Upgrade step for MSSQL

MSSQL database has to be upgraded manually.

Please follow these instructions.

1. It is recommended that you take a backup of your database before you perform the manual upgrade, if your data is valuable.
   
2. Open config/db/create_report_tables_mssql.sql
   
3. You will find sql queries grouped according to version. Copy all queries from versions that are after your current version, to a separate file.
   Examples:
   
   • If your current version is 6.0.0, copy all queries from /* VERSION 2015-02-09 14:38:51 # 6.1.0 */ onwards.
     
   • If your current version is 5.1.2, copy all queries from /* VERSION 2014-10-15 18:27:48 # 6.0.0 */ onwards.
     
4. Execute the queries copied in the previous step, on your MSSQL database.
   

Post Upgrade steps for all installations

This section pertains to all types of database installations.
NOTE: Your existing configuration settings will be retained after the upgrade.
However you may need to do the following after an upgrade:

• In userdata/config/browser_types.xml copy over the following from the relevant xml file in config/browser_types/
  
  • Chrome settings <options ...> tag
  • PhantomJS full <browserType ...> tag
• Changes to userdata/config/user_extensions.js are not re-applied after upgrade. The upgrade fixes a lot of issues for which
  we issued patches via user_extensions.js. Reapply your code snippets to the new user_extensions.js only if needed. Contact Sahi Support if you have any doubts.
  
• The default report XSL files which are shipped with Sahi have now been moved into config/reports/xxx.
  The XSLs have been modified significantly to reflect database changes.
  If you have modified them, create a copy in userdata/config/reports/xxx folder and apply your changes in this copy.
  Refer to Modifying an existing reporting type section for details.
  
  info NOTE: If you have not customized any xsls in your previous version, no changes are required.
  
• accessors_metadata.txt, accessors_flex_metadata.txt and accessors_applet.metadata.txt have been removed from userdata/config.
  The default values for accessor identification have been moved in to config/accessor_metadata/ as .json files.
  To customize accessors, please refer to Tweaking Sahi APIs for details.
  
  • APIs declared via accessor metadata need not be defined again in normal_functions.txt.
    
    warningnormal_functions.txt should not be modified by end user.
  info NOTE: If you have not modified Accessor metadata in your previous version, no changes are required.
  
• Files in userdata/extlib folder are left as is. These files could include some Sahi jar files that were delivered as customized patches. It is likely that the bugs have been addressed in the upgrade. Hence, take a backup of these patch files to a safe location and remove them from userdata/extlib. If you run into problems, contact Sahi Support.
  
  info Please note that you should not remove genuine external library jars for database connections, etc.
  

That's it, you have successfully upgraded Sahi Pro!