Table of Contents
II. Why Are We Making This Change?
III. Current Installation Behavior (Before Version 8.35)
IV. New Installation Process (Starting from Version 8.35)
V. Multi-User Environments (e.g., Terminal Services)
VI. Step-by-Step Guide for System Administrators
VII. Transitioning from Older Versions
I. Introduction (Back to Table of Contents)
We want to inform you in advance about a key update to the Coresuite add-on installation process, which will be introduced with Coresuite version 8.35 (release date planned for December/January). This update is designed to improve security and simplify the installation process for system administrators. Additionally, the file coresuiteAuthorize.exe, which was part of the lightweight installer from version 7.30, will be removed.
These changes will streamline the installation process, reduce the need for elevated privileges, and follow best security practices. Going forward, you no longer require administrative rights to install or set up Coresuite into SAP Business One, making it easier and more secure for users and administrators to manage installations.
II. Why Are We Making This Change? (Back to Table of Contents)
In previous versions, installing or upgrading Coresuite required SAP Business One to be launched with administrative privileges. This was necessary to create database folders and install files in system directories. However, requiring elevated permissions poses potential security risks and can complicate the installation for administrators, especially in larger environments.
With the new approach, we aim to:
- Enhance security: The add-on installation no longer requires administrative privileges, reducing potential vulnerabilities.
- Simplify installation: Users will not need special permissions to install or update Coresuite.
By eliminating the need for elevated privileges and deploying Coresuite in user-specific directories, we also reduce the risk of conflicts in multi-user environments.
III. Current Installation Behavior (Before Version 8.35) (Back to Table of Contents)
When installing or upgrading Coresuite, SAP Business One must be launched with elevated privileges (run as administrator). This is needed to:
1. Create the necessary database folders.
2. Deploy add-on files to the SAP Business One AddOns folder.
For example, Coresuite files are typically installed in:
C:\Program Files\SAP Business One\AddOns\
IV. New Installation Process (Starting from Version 8.35) (Back to Table of Contents)
Starting with version 8.35, Coresuite will be deployed to the user-specific local AppData folder by default. This means that installation files will no longer require administrative rights and will be installed in a directory specific to each user, reducing security concerns.
Example Installation Path:
For a company named "SBODemoCH," the default path will be:
%localappdata%\Coresystems AG\coresuite\SBODemoCH
V. Multi-User Environments (e.g., Terminal Services) (Back to Table of Contents)
If you're working in a multi-user environment (like terminal services), the default installation path may lead to redundant file deployments for each user. To address this, you can set up a system environment variable to ensure that Coresuite is installed in a shared ProgramData folder. This avoids the need to deploy files for each individual user, and also saves space on the hard drive.
How to Configure for Multi-User Environments:
Set the environment variable:
Variable Name: CORESUITE_TERMINAL_SERVICE_MODE
Value: 1
New Installation Path Example:
For the company "SBODemoCH," the new path will be:
%ProgramData%\Coresystems AG\coresuite\SBODemoCH
If the environment variable is not set or has a different value, Coresuite will default to installing in the %localappdata% folder for each user.
VI. Step-by-Step Guide for System Administrators (Back to Table of Contents)
Upgrade Preparation:
- Ensure you are aware of the installation paths used in your environment.
- If you’re in a multi-user environment, consider configuring the CORESUITE_TERMINAL_SERVICE_MODE environment variable before installation.
New Installation:
- When installing Coresuite 8.35 on a new machine, the add-on will automatically install in the %localappdata% folder unless the multi-user environment variable is set.
Configuring Multi-User Mode:
- For terminal services, set the system variable to direct the installation to the shared %ProgramData% folder.
- You can create this variable in Windows by navigating to Control Panel -> System -> Advanced System Settings -> Environment Variables, and adding CORESUITE_TERMINAL_SERVICE_MODE with a value of 1.
VII. Transitioning from Older Versions (Back to Table of Contents)
If you're currently running an earlier version of Coresuite (e.g., 8.30), no special uninstallation process is required. When you upgrade to version 8.35, the current version of Coresuite will be uninstalled and the new installation path will be used automatically, and the coresuiteAuthorize.exe
file will be removed as part of the upgrade. There is no need to worry about conflicts with the previous installation.
If you have custom modules where the path to your DLL files is hardcoded, please check these paths to be aligned with the new Coresuite installation path.
Related documentation:
New feature in Coresuite (lightweight) Installer from Version 7.30 onwards
Comments
0 comments
Article is closed for comments.