Skip to content

Commit 85e5adc

Browse files
authored
Merge pull request #99643 from swinarko/master
Advanced settings section
2 parents c43004c + 00f53bd commit 85e5adc

10 files changed

+312
-240
lines changed

articles/data-factory/create-azure-ssis-integration-runtime.md

Lines changed: 99 additions & 73 deletions
Large diffs are not rendered by default.

articles/data-factory/how-to-configure-azure-ssis-ir-custom-setup.md

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.author: sawinark
1111
manager: mflasko
1212
ms.reviewer: douglasl
1313
ms.custom: seo-lt-2019
14-
ms.date: 12/16/2019
14+
ms.date: 12/23/2019
1515
---
1616

1717
# Customize setup for the Azure-SSIS integration runtime
@@ -26,7 +26,7 @@ With express custom setups, you can run some common system configurations/Window
2626

2727
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.
2828

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).
3030

3131
> [!IMPORTANT]
3232
> 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
3535

3636
The following limitations applies only to standard custom setups:
3737

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.
3939

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" ...`.
4141

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.
4343

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.
4545

4646
## Prerequisites
4747

4848
[!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
4949

5050
To customize your Azure-SSIS IR, you need the following things:
5151

52-
- [Azure subscription](https://azure.microsoft.com/)
52+
- [Azure subscription](https://azure.microsoft.com/)
5353

54-
- [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)
5555

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.
5757

5858
## Instructions
5959

@@ -104,7 +104,7 @@ To customize your Azure-SSIS IR, you need the following things:
104104

105105
![Copy and save the Shared Access Signature](media/how-to-configure-azure-ssis-ir-custom-setup/custom-setup-image8.png)
106106

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.
108108

109109
If you want to add standard custom setups, enter the SAS URI of your container in the **Custom setup container SAS URI** field.
110110

@@ -122,9 +122,9 @@ To customize your Azure-SSIS IR, you need the following things:
122122

123123
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**.
124124

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**.
126126

127-
![Standard and express custom setups](media/how-to-configure-azure-ssis-ir-custom-setup/advanced-settings-custom.png)
127+
![Advanced settings with custom setups](./media/tutorial-create-azure-ssis-runtime-portal/advanced-settings-custom.png)
128128

129129
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.
130130

@@ -163,7 +163,7 @@ To customize your Azure-SSIS IR, you need the following things:
163163

164164
![Contents of the public preview container](media/how-to-configure-azure-ssis-ir-custom-setup/custom-setup-image11.png)
165165

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:
167167

168168
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.
169169

@@ -189,11 +189,13 @@ To customize your Azure-SSIS IR, you need the following things:
189189

190190
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.
191191

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+
192194
![Folders in the user scenarios folder](media/how-to-configure-azure-ssis-ir-custom-setup/custom-setup-image12.png)
193195

194196
1. To try these custom setup samples, copy and paste the content from selected folder into your container.
195197

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.
197199

198200
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.
199201

0 commit comments

Comments
 (0)