Xtract IS is required when developing and running SSIS packages. Make sure to install Xtract IS on both types of machines:

  • On the development machine running Visual Studio / SQL Sever Data Tools. Development can be performed on several machines.
  • On the machine running the SQL server, which is used for deploying and running the packages.


Prerequisites #

  • SSIS / Visual Studio Extentions are installed

Note: administrator permissions are required to install Xtract IS.

To use Xtract IS, the file XtractISSetup.exe must be executed and installed both on the local development environment (Visual Studio or SSDT) and on the SSIS server. For more information, see section Licensing.

Interactive Installation #

Interactive installation is the standard procedure with GUI. Execute the XtractISSetup.exe file and follow the instructions of the setup program.


The Xtract IS Setup installs Xtract IS as a plug-in into SSIS.

The license installation procedure is described in the section Installing the license.

Installation Directory Files

The list below shows several most important files that are placed into the default directory C:\Program Files\XtractIS after installation:

Filename Description
ABAP Directory Directory with SAP function modules. Read the readme.txt within the directory for more information. See also SAP Customizing.
XtractISSetup.exe Application for installing and registering the Xtract IS components within SSIS.
XtractISConversionPreparer.exe Tool, which prepares older version of SSIS packages (containing Xtract IS components) for migration to newer versions of SSIS. See also section SSIS Migration.
xis_version.bat Starts the XtractISVerisonInfo.exe to display and read the currently installed version.
XtractLicenseManager.exe Application to manage and view licenses.
Uninstall Xtract IS Tool for uninstalling and removing Xtract IS with all its components from your machine.
gac-uninstall.bat For debugging only. Tool to clear the GAC of all Xtract IS related components in case of installation issues.
Eula_XtractIS.rtf Document containing the license agreement for the use of the software Xtract IS.
XtractISLicense.json License file with information about the server, the component and runtime.
UninstallDllLicense.bat For older license files. See Updating the Xtract.License.dll to XtractISLicense.json

Unattended Installation #

Note: All switches are case sensitive.

The setup program and the License Manager (installer) can also be started without the GUI in a non-interactive mode.


To execute the setup program in the unattended mode, use the switch –unattended .



To execute the License Manager in the unattended mode, pass the path to the license file as a command line argument.

Waiting Switch

As both programs XtractISSetup.exe and XtractLicenseManager.exe are Windows applications, so Windows Command Prompt does not wait until the installation is complete. To wait until the installation is complete, use the [start](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/start) command with the /wait switch.


start /wait XtractISSetup.exe --unattended
start /wait XtractLicenseManager.exe "C:\temp\Xtract IS\XtractIS.License.json"

Displaying the Xtract IS components within Visual Studio #

After a successful installation of the Xtract IS, the Xtract IS components are automatically available in the SSIS Toolbox of a Data Flow Task in your Visual Studio Integration Services project.