You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/data-factory/how-to-configure-azure-ssis-ir-custom-setup.md
+16-14Lines changed: 16 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ ms.author: sawinark
11
11
manager: mflasko
12
12
ms.reviewer: douglasl
13
13
ms.custom: seo-lt-2019
14
-
ms.date: 12/16/2019
14
+
ms.date: 12/23/2019
15
15
---
16
16
17
17
# Customize setup for the Azure-SSIS integration runtime
@@ -26,7 +26,7 @@ With express custom setups, you can run some common system configurations/Window
26
26
27
27
With standard custom setups, you need to prepare a script and its associated files, and upload them all together into a blob container in your Azure Storage account. You then provide a Shared Access Signature (SAS) Uniform Resource Identifier (URI) for your container when you provision or reconfigure your Azure-SSIS IR. Each node of your Azure-SSIS IR will then download the script and its associated files from your container and run your custom setup with elevated privileges. When your custom setup is finished, each node will upload the standard output of execution and other logs into your container.
28
28
29
-
You can install both free/unlicensed and paid/licensed components with express/standard custom setups. If you're an ISV, see [How to develop paid or licensed components for the Azure-SSIS IR](how-to-develop-azure-ssis-ir-licensed-components.md).
29
+
You can install both free/unlicensed and paid/licensed components with express/standard custom setups. If you're an ISV, see our documentation on [how to develop paid or licensed components for Azure-SSIS IR](how-to-develop-azure-ssis-ir-licensed-components.md).
30
30
31
31
> [!IMPORTANT]
32
32
> The v2-series nodes of Azure-SSIS IR are not suitable for custom setup, so please use the v3-series nodes instead. If you already use the v2-series nodes, please switch to use the v3-series nodes as soon as possible.
@@ -35,25 +35,25 @@ You can install both free/unlicensed and paid/licensed components with express/s
35
35
36
36
The following limitations applies only to standard custom setups:
37
37
38
-
-If you want to use `gacutil.exe` in your script to install assemblies in the Global Assembly Cache (GAC), you need to provide `gacutil.exe` as part of your custom setup, or use the copy provided in our Public Preview container below.
38
+
- If you want to use `gacutil.exe` in your script to install assemblies in the Global Assembly Cache (GAC), you need to provide `gacutil.exe` as part of your custom setup, or use the copy provided in our Public Preview container below.
39
39
40
-
-If you want to reference a subfolder in your script, `msiexec.exe` does not support the `.\` notation to reference the root folder. Use a command like `msiexec /i "MySubfolder\MyInstallerx64.msi" ...` instead of `msiexec /i ".\MySubfolder\MyInstallerx64.msi" ...`.
40
+
- If you want to reference a subfolder in your script, `msiexec.exe` does not support the `.\` notation to reference the root folder. Use a command like `msiexec /i "MySubfolder\MyInstallerx64.msi" ...` instead of `msiexec /i ".\MySubfolder\MyInstallerx64.msi" ...`.
41
41
42
-
-Administrative shares, i.e. hidden network shares automatically created by Windows, are currently not supported on the Azure-SSIS IR.
42
+
- Administrative shares, i.e. hidden network shares automatically created by Windows, are currently not supported on the Azure-SSIS IR.
43
43
44
-
-IBM iSeries Access ODBC Driver is not supported on the Azure-SSIS IR. You may see installation errors during your custom setup. Please contact IBM support for assistance.
44
+
- IBM iSeries Access ODBC Driver is not supported on the Azure-SSIS IR. You may see installation errors during your custom setup. Please contact IBM support for assistance.
-[Provision your Azure-SSIS IR](https://docs.microsoft.com/azure/data-factory/tutorial-deploy-ssis-packages-azure)
54
+
-[Provisioning your Azure-SSIS IR](https://docs.microsoft.com/azure/data-factory/tutorial-deploy-ssis-packages-azure)
55
55
56
-
-[An Azure Storage account](https://azure.microsoft.com/services/storage/). Not required for express custom setups. For standard custom setups, you upload and store your custom setup script and its associated files in a blob container. The custom setup process also uploads its execution logs to the same blob container.
56
+
-[An Azure Storage account](https://azure.microsoft.com/services/storage/). Not required for express custom setups. For standard custom setups, you upload and store your custom setup script and its associated files in a blob container. The custom setup process also uploads its execution logs to the same blob container.
57
57
58
58
## Instructions
59
59
@@ -104,7 +104,7 @@ To customize your Azure-SSIS IR, you need the following things:
104
104
105
105

106
106
107
-
1. When you provision or reconfigure your Azure-SSIS IR with Data Factory UI, you can add/remove custom setups by selecting the **Customize your Azure-SSIS Integration Runtime with additional system configurations/component installations** check box on the **Advanced Settings** panel.
107
+
1. When you provision or reconfigure your Azure-SSIS IR with Data Factory UI, you can add/remove custom setups by selecting the **Customize your Azure-SSIS Integration Runtime with additional system configurations/component installations** check box on the **Advanced Settings**section of integration runtime setup panel.
108
108
109
109
If you want to add standard custom setups, enter the SAS URI of your container in the **Custom setup container SAS URI** field.
110
110
@@ -122,9 +122,9 @@ To customize your Azure-SSIS IR, you need the following things:
122
122
123
123
1. If you select the **oh22's SQLPhonetics.NET** component, you can install the [SQLPhonetics.NET](https://sqlphonetics.oh22.is/sqlphonetics-net-for-microsoft-ssis/) data quality/matching component from oh22 on your Azure-SSIS IR by entering the product license key that you purchased from them in the **License key** field. The current integrated version is **1.0.43**.
124
124
125
-
Your added express custom setups will appear on the **Advanced Settings**panel. To remove them, you can select their check boxes and then select **Delete**.
125
+
Your added express custom setups will appear on the **Advanced Settings**section. To remove them, you can select their check boxes and then select **Delete**.
126
126
127
-

127
+

128
128
129
129
When you provision or reconfigure your Azure-SSIS IR with PowerShell, you can add/remove custom setups by running the `Set-AzDataFactoryV2IntegrationRuntime` cmdlet before you start your Azure-SSIS IR.
130
130
@@ -163,7 +163,7 @@ To customize your Azure-SSIS IR, you need the following things:
163
163
164
164

165
165
166
-
1. Double-click the `UserScenarios` folder. In this folder are the following items:
166
+
1. Double-click the `UserScenarios` folder to find the following items:
167
167
168
168
1. A `.NET FRAMEWORK 3.5` folder, which contains a custom setup to install an earlier version of the .NET Framework that might be required for custom components on each node of your Azure-SSIS IR.
169
169
@@ -189,11 +189,13 @@ To customize your Azure-SSIS IR, you need the following things:
189
189
190
190
1. A `TERADATA` folder, which contains a custom setup script (`main.cmd`), its associated file (`install.cmd`), and installer packages (`.msi`). These files install the Teradata connectors, TPT API, and ODBC driver on each node of your Azure-SSIS IR Enterprise Edition. This setup lets you use the Teradata Connection Manager/Source/Destination to connect to Teradata server. First, download the Teradata Tools and Utilities 15.x zip file (for example, `TeradataToolsAndUtilitiesBase__windows_indep.15.10.22.00.zip`) from [Teradata](http://partnerintelligence.teradata.com), then upload it together with the above `.cmd` and `.msi` files into your container.
191
191
192
+
1. A `ZULU OPENJDK` folder, which contains a custom setup script (`main.cmd`) and PowerShell file (`install_openjdk.ps1`) to install Zulu OpenJDK on each node of your Azure-SSIS IR. This setup lets you use Azure Data Lake Store/Flexible File connectors to process ORC/Parquet files, see [here](https://docs.microsoft.com/sql/integration-services/azure-feature-pack-for-integration-services-ssis?view=sql-server-ver15#dependency-on-java) for more info. First, download the latest Zulu OpenJDK - for example, `zulu8.33.0.1-jdk8.0.192-win_x64.zip` - from [here](https://www.azul.com/downloads/zulu/zulu-windows/), then upload it together with `main.cmd` and `install_openjdk.ps1` into your container.
193
+
192
194

193
195
194
196
1. To try these custom setup samples, copy and paste the content from selected folder into your container.
195
197
196
-
When you provision or reconfigure your Azure-SSIS IR with Data Factory UI, select the **Customize your Azure-SSIS Integration Runtime with additional system configurations/component installations** check box on the **Advanced Settings**panel and enter the SAS URI of your container in the **Custom setup container SAS URI** field.
198
+
When you provision or reconfigure your Azure-SSIS IR with Data Factory UI, select the **Customize your Azure-SSIS Integration Runtime with additional system configurations/component installations** check box on the **Advanced Settings**section and enter the SAS URI of your container in the **Custom setup container SAS URI** field.
197
199
198
200
When you provision or reconfigure your Azure-SSIS IR with PowerShell, run the `Set-AzDataFactoryV2IntegrationRuntime` cmdlet with the SAS URI of your container as the value for `SetupScriptContainerSasUri` parameter.
0 commit comments