Installation
This section shows how to install and update Xtract Core. Xtract Core is distributed as a .zip
file.
Prerequisites
- Administrator rights are required to install Xtract Core.
- Download and install the .NET8.0 Desktop Runtime from Microsoft.
- Optional: Install the THEO/READ_TABLE function module in SAP to boost the capabilities of SAP table extractions.
For more information on system requirements and supported SAP systems, see Knowledge Base: Requirements.
Install Xtract Core
To install the Xtract Core Windows service:
- Extract all files from the
XtractCore.zip
archive into the directory where you want to install Xtract Core. - Open a command line tool with administrator rights and navigate to the installation directory.
- Run the following command to install the Xtract Core Windows service and to create a dedicated virtual user that runs the service:
- Make sure that the Xtract Core service "SAP Connector" is running on your Windows system and that the default port 1337 is not blocked by the firewall.
The Xtract Core Windows service can now receive HTTP requests. For information on how to change the default settings of the Xtract Core service, refer to the service settings and network-settings.
Note
To update Xtract Core replace the files in the installation directory with the new Xtract Core installation files.
Warning
Access is denied.
The virtual user that is created during the installation of Xtract Core has minimal access rights. If Xtract Core is installed in a user-specific directory (e.g., C:\Users\<username>\Documents
), the virtual user cannot access the files. To successfully run the Windows service, grant the virtual user access rights to the directory or install Xtract Core in a system-level directory, e.g., C:\XtractCore
.
Update Xtract Core
To install a new version of Xtract Core, replace the files in the existing installation directory with the files from the XtractCore.zip
archive. It is not necessary to uninstall the previous version.
Refer to Changelog for a list of latest updates and release notes.