coresuite onPremise products, Upgrade/Installation for SAP Business One 9.1 (and 9.2, if upgrading from lower than 9.1)

Introduction

As per SAP Note 2056808 - New addition SAPBusinessOneSDK.dll in Business One version 9.1, SAP introduced a new dll (SAPBusinessOneSDK.dll) which is a combination of SAPbobsCOM.dll and SAPbouiCOM.dll.

Due to this change we had to recompile all our modules to reference to the new dll instead of the two old ones. In order to be able to use coresuite onPremise products on SAP Business One 9.1, a special procedure needs to be followed when

  1. upgrading an existing SAP Buiness One installation to version 9.1 where coresuite onPremise products are installed
  2. installing coresuite onPremise Products on a new SAP Buiness One 9.1 installation

This also means that from version SAP Business One 9.1 the coresuiteSAPDlls are no longer needed. 

We strongly recommend to follow the steps below exactly to ensure a smooth and happy transition!

 

Prerequisites

onPremise Products

  • Ensure that you have at least 9.1 PL04 (the GA version!) installed – previous Patchlevels are NOT be supported
  • When running the On Premise products on 64-bit SAP Business One Clients Applications, the 32-bit DI-API has to be installed also

  • Ensure that your own/custom modules are recompiled as described in section "Compatibility with own/custom modules" at the end of this very FAQ 

    (Warnung) in case you were still using a coresuite version lower than 4.00 on your SAP Business One installation prior to your upgrade to 9.1, please ensure that you also compile your modules against Microsoft® .NET Framework 4.0 (https://helpdesk.coresystems.ch/entries/25162907-coresuite-onPremise-products-Upgrade-to-version-4-00/)

 

Recommended Upgrade Procedure

(Warnung) We recommend to backup your company database, backup the coresuite database (SQL only!), export your customize rules and layouts as good practice before performing any upgrade.

A) upgrading an existing SAP Buiness One installation to version 9.1 where coresuite onPremise products are already installed

(Warnung) If you are working with 32-bit and 64-bit SAP Business One Client Applications on the same workstation(server), you will need to perform Step 3 through to Step 5 (HANA: Step 2 to Step 4) first via the 64-bit SAP Business One Client Applications, then with the 32-bit SAP Business One Client Applications. Only after you have performed the removal procedure on both Client Applications, you can proceed with Step 6!

SQL environment

1.  Backup coresuite database

2.  Stop the coresuite add-on (double-check via Taskmanager that NO coresuite process is still running!)

3.  Remove the coresuite add-on via Administration->Add-Ons->Add-On Administration=>"Remove Add-On"

4.  Restart SAP Business One via right-click->Run as Administrator to complete the uninstall process

5.  Verify the coresuite application is fully removed from your SAP Business One Client application

(Warnung) Check %Program Files (x86)%\SAP\SAP Business One\AddOns\ (%ProgramFiles%\SAP\SAP Business One\Addons\) for remaining COR and or coresuite folders; should they still exists, please delete

6.  Delete coresuite database

7.  Download the installer version for SAP Business One 9.1/9.2 from helpdesk.coresystems.ch/home, register and install

    • if you are installing on 32-bit SAP Business One applications, use the "Installer for SAP Business One 9.1 32 Bit Client"
    • if you are installing on 64-bit SAP Business One applications, use the "Installer for SAP Business One 9.1 64 Bit Client" 

8.  Start the coresuite add-on

9.  Download and install the latest available versions of each module sip via Administration->Add-ons->coresuite administration->Administration->Sip Management

 

HANA environment

1.  Stop the coresuite add-on (double-check via Taskmanager that NO coresuite process is still running!)

2.  Remove the coresuite add-on via Administration->Add-Ons->Add-On Administration=>"Remove Add-On"

3.  Restart SAP Business One via right-click->Run as Administrator to complete the uninstall process

4.  Verify the coresuite application is fully removed from your SAP Business One Client application

(Warnung) Check %Program Files (x86)%\SAP\SAP Business One\AddOns\ (%ProgramFiles%\SAP\SAP Business One\Addons\) for remaining COR and or coresuite folders; should they still exists, please delete

5.  Remove the @SWA_MODULES table via Tools->Customisation Tools->User-Defined Table - Setup

6.  Download the installer version for SAP Business One 9.1/9.2 from helpdesk.coresystems.ch/home, register and install

    • if you are installing on 32-bit SAP Business One applications, use the "Installer for SAP Business One 9.1 32 Bit Client"
    • if you are installing on 64-bit SAP Business One applications, use the "Installer for SAP Business One 9.1 64 Bit Client" 

7.  Start the coresuite add-on

8.  Download and install the latest available versions of each module sip via Administration->Add-ons->coresuite administration->Administration->Sip Management

 

B) Installing coresuite onPremise Products on a new SAP Buiness One 9.1 installation

1.  Download the installer version for SAP Business One 9.1/9.2 from helpdesk.coresystems.ch/home, register and install

    • if you are installing on 32-bit SAP Business One applications, use the "Installer for SAP Business One 9.1 32 Bit Client"
    • if you are installing on 64-bit SAP Business One applications, use the "Installer for SAP Business One 9.1 64 Bit Client" 

C) Upgrading coresuite modules AFTER following initial installation/upgrade on 9.1/9.2

Only once coresuite has been installed with the correct installer for SAP Business One 9.1, the modules can updated to newer versions. The correct sip versions for each module can be automatically downloaded and installed via the coresuite administration.

(Warnung) In case you need to download newer sips manually (e.g. due to Network restrictions in your environment), remember to ensure that you select the correct SAP Business One version on the top of download page (helpdesk.coresystems.ch/home) - DO NOT try to import the sips that are compiled for use with 8.82/9.0

 ___________________________________________________________________

(Warnung) Uninstalling the add-on will have no impact on your current settings (e.g. your layouts and customize rules).

(Warnung) The coresuite uninstall process can be performed before but also after the SAP Business One Upgrade to 9.1/9.2; the install process with the special installer can only be performed after the SAP Business One Upgrade to 9.1/9.2

(Warnung) Please note that if you do not follow the above procedure step by step, you will encounter coresuite customize compiler errors and layouts containing Hyperlinks will fail to print/preview

(Warnung) After replacing the coresuite installer as described above, each SAP Business One Client application of each workstation will need to be started once via right-click run as Administrator, so the installer can be automatically replaced on each SAP Business One Client application. The uninstall and new install will run automatically.

 

What to do in case something goes wrong

(e.g. system still looking for "coresuiteSAPDlls", or strange behaviour when printing, unexplained error messages, error message in only one of a number of databases in the same environment etc)

(Warnung) We recommend to backup your company database, backup the coresuite database (SQL only!), export your customize rules and layouts as good practice before performing any upgrade or fix.

(Warnung) on Terminal Servers, please remember to switch to install mode, before attempting either of the options below

(Warnung) We have listed two options each for SQL and HANA environments. No matter which option you choose, you need to ensure that you perform ALL steps from the chosen option! If you leave out a step, you need to repeat the chosen option until the issue is resolved. Option 1 is always the prefered option. If neither options helped to solve the issue (especially in cases where the system might still be looking for "coresuiteSAPDlls") considered reinstalling your SAP Business One Client Application.

 

SQL environment

Option 1

  1. Backup coresuite Database

  2. Start SAP Business One via right-click->Run as Administrator

  3. Uninstall the coresuite add-On (double-check via Taskmanager that NO coresuite process is still running!)

  4. Connect to SQL Server and run the following query: DELETE FROM [coresuite].[dbo].[modules] => this will empty the modules table in the coresuite database

  5. Verify that the coresuite application is fully removed from your SAP Business One Client application

    (Warnung) check %Program Files (x86)%\SAP\SAP Business One\AddOns\(%ProgramFiles%\SAP\SAP Business One\Addons\) for remaining COR and or coresuite folders; should they still exists, please delete

  6. Register and install the special coresuite installer version for SAP Business One 9.1 which can be downloaded from here (ensure that use the correct installer for your SAP Business One Client Application - please refer to https://helpdesk.coresystems.ch/entries/23208737-SAP-Business-One-9-0 => Understanding 32-bit and 64-bit installations)

  7. Start the coresuite add-on

  8. Download and install the latest available versions of each module sip via Administration->Add-ons->coresuite administration->Administration->Sip Management

  9. If the above steps do not solve the issue for you, please contact support via helpdesk.coresystems.ch

Option 2 (recommended for advanced users only)

If you are certain that you used the correct installer, you can simply follow the steps below:

  1. Backup coresuite Database

  2. Close SAP Business One

  3. Open SQL Management Studio, go to the coresuite db and right-click on the module table selecting "Edit Top 200 Rows"

  4. Highlight all rows of modules version < 4.6x; ensure that you include any rows with the "coresuiteSAPDlls"

  5. Delete the selected rows

  6. Go to %Program Files (x86)%\SAP\SAP Business One\ (%ProgramFiles%\SAP\SAP Business One\) and modify the AddOnsLocalRegistration.sbo by removing all coresuite entries

  7. Go to %Program Files (x86)%\SAP\SAP Business One\AddOns (%ProgramFiles%\SAP\SAP Business One\AddOns) and remove the COR folder

  8. Start SAP Business One via right-click->run as Administrator

  9. Download and install the latest available versions of each module sip via Administration->Add-ons->coresuite administration->Administration->Sip Management

  10. If the above steps do not solve the issue for you, please contact support via helpdesk.coresystems.ch

 

HANA environment

Option 1

  1. Start SAP Business One via right-click->Run as Administrator

  2. Uninstall the coresuite add-On (double-check via Taskmanager that NO coresuite process is still running!)

  3. Remove the @SWA_MODULES table via Tools->Customisation Tools->User-Defined Table - Setup

  4. Verify that the coresuite application is fully removed from your SAP Business One Client application

    (Warnung) check %Program Files (x86)%\SAP\SAP Business One\AddOns\(%ProgramFiles%\SAP\SAP Business One\Addons\) for remaining COR and or coresuite folders; should they still exists, please delete

  5. Register and install the special coresuite installer version for SAP Business One 9.1 which can be downloaded from here (ensure that use the correct installer for your SAP Business One Client Application - please refer to https://helpdesk.coresystems.ch/entries/23208737-SAP-Business-One-9-0 => Understanding 32-bit and 64-bit installations)

  6. Start the coresuite add-on

  7. Download and install the latest available versions of each module sip via Administration->Add-ons->coresuite administration->Administration->Sip Management

  8. if the above steps do not solve the issue for you, please contact support via helpdesk.coresystems.ch

Option 2 (recommended for advanced users only)

If you are certain that you used the correct installer, you can simply follow the steps below:

  1. Remove the @SWA_MODULES table via Tools->Customisation Tools->User-Defined Table - Setup

  2. Go to %Program Files (x86)%\SAP\SAP Business One\ (%ProgramFiles%\SAP\SAP Business One\) and modify the AddOnsLocalRegistration.sbo by removing the coresuite entries

  3. Go to %Program Files (x86)%\SAP\SAP Business One\AddOns (%ProgramFiles%\SAP\SAP Business One\AddOns) and remove either the whole COR folder OR the <YourCompany>folder within %Program Files (x86)%\SAP\SAP Business One\AddOns\COR\coresuite (%ProgramFiles%\SAP\SAP Business One\AddOns\COR\coresuite)

  4. Start SAP Business One via right-click->Run as Administrator

  5. Start the coresuite add-on

  6. Download and install the latest available versions of each module sip via Administration->Add-ons->coresuite administration->Administration->Sip Management

  7. if the above steps do not solve the issue for you, please contact support via helpdesk.coresystems.ch

Compatibility with own/custom modules

Own/custom modules which were compiled for SAP Business One versions prior 9.1 will not work with SAP Business One 9.1/9.2.

Before upgrading your Productive systems to SAP Business One 9.1/9.2, please ensure that all your own/custom modules are recompiled.

To recompile your own/custom modules, you will need to

    1. remove the reference to SAPbobsCOM.dll and SAPbouiCOM.dll in your project and reference to SAPBusinessOneSDK.dll instead
    2. use the development version of the framework dlls for running coresuite onPremise products on SAP Business One 9.1/9.2 which can downloaded from here.
Was this article helpful?
5 out of 6 found this helpful
Have more questions? Submit a request

Comments

0 comments

Article is closed for comments.