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
description: "This article provides troubleshooting guidance for management issues of SSIS Integration Runtime (SSIS IR)"
4
4
ms.subservice: integration-services
5
5
ms.topic: troubleshooting-general
6
-
author: chinadragon0515
7
-
ms.author: dashe
6
+
author: whhender
7
+
ms.author: whhender
8
8
ms.reviewer: chugugrace
9
9
ms.date: 05/15/2024
10
10
---
@@ -17,23 +17,23 @@ This article provides troubleshooting guidance for management issues in Azure-SQ
17
17
18
18
## Overview
19
19
20
-
If you run into any issue while provisioning or deprovisioning SSIS IR, you'll see an error message in the Microsoft Azure Data Factory portal or an error returned from a PowerShell cmdlet. The error always appears in the format of an error code with a detailed error message.
20
+
If you run into any issue while provisioning or deprovisioning SSIS IR, you see an error message in the Microsoft Azure Data Factory portal or an error returned from a PowerShell cmdlet. The error always appears in the format of an error code with a detailed error message.
21
21
22
22
If the error code is InternalServerError, the service has transient issues, and you should retry the operation later. If a retry doesn’t help, contact the Azure Data Factory support team.
23
23
24
24
Otherwise, three major external dependencies can cause errors: Azure SQL Database or Azure SQL Managed Instance, a custom setup script, and a virtual network configuration.
25
25
26
26
## SQL Database or SQL Managed Instance issues
27
27
28
-
SQL Database or SQL Managed Instance is required if you're provisioning SSIS IR with an SSIS catalog database. The SSIS IR must be able to access SQL Database or SQL Managed Instance. Also, the login account for SQL Database or SQL Managed Instance must have permission to create an SSIS catalog database (SSISDB). If there's an error, an error code with a detailed SQL exception message will be shown in the Data Factory portal. Use the information in the following list to troubleshoot the error codes.
28
+
SQL Database or SQL Managed Instance is required if you're provisioning SSIS IR with an SSIS catalog database. The SSIS IR must be able to access SQL Database or SQL Managed Instance. Also, the sign-in account for SQL Database or SQL Managed Instance must have permission to create an SSIS catalog database (SSISDB). If there's an error, an error code with a detailed SQL exception message will be shown in the Data Factory portal. Use the information in the following list to troubleshoot the error codes.
29
29
30
30
### AzureSqlConnectionFailure
31
31
32
32
You might see this issue when you're provisioning a new SSIS IR or while IR is running. If you experience this error during IR provisioning, you might get a detailed SqlException message in the error message that indicates one of the following problems:
33
33
34
34
* A network connection issue. Check whether the host name for SQL Database or SQL Managed Instance is accessible. Also verify that no firewall or network security group (NSG) is blocking SSIS IR access to the server.
35
-
*Login failed during SQL authentication. The account provided can't sign in to the SQL Server database. Make sure you provide the correct user account.
36
-
*Login failed during Microsoft Entra ID
35
+
*Sign in failed during SQL authentication. The account provided can't sign in to the SQL Server database. Make sure you provide the correct user account.
36
+
*Sign in failed during Microsoft Entra ID
37
37
authentication (managed identity). Add the managed identity of your factory to a Microsoft Entra group, and make sure the managed identity has access permissions to your catalog database server.
38
38
* Connection timeout. This error is always caused by a security-related configuration. We recommend that you:
39
39
1. Create a new VM.
@@ -78,13 +78,13 @@ Custom setup provides an interface to add your own setup steps during the provis
78
78
79
79
Make sure your container contains only the necessary custom setup files; all the files in the container will be downloaded onto the SSIS IR worker node. We recommend that you test the custom setup script on a local machine to fix any script execution issues before you run the script in SSIS IR.
80
80
81
-
The custom setup script container will be checked while IR is running, because SSIS IR is regularly updated. This updating requires access to the container to download the custom setup script and install it again. The process also checks whether the container is accessible and whether the main.cmd file exists.
81
+
The custom setup script container is checked while IR is running, because SSIS IR is regularly updated. This updating requires access to the container to download the custom setup script and install it again. The process also checks whether the container is accessible and whether the main.cmd file exists.
82
82
83
-
For any error that involves custom setup, you'll see a CustomSetupScriptFailure error code with sub code like CustomSetupScriptBlobContainerInaccessible or CustomSetupScriptNotFound.
83
+
For any error that involves custom setup, you see a CustomSetupScriptFailure error code with sub code like CustomSetupScriptBlobContainerInaccessible or CustomSetupScriptNotFound.
84
84
85
85
### CustomSetupScriptBlobContainerInaccessible
86
86
87
-
This error means that SSIS IR can't access your Azure blob container for custom setup. Make sure the SAS URI of the container is reachable and has not expired.
87
+
This error means that SSIS IR can't access your Azure blob container for custom setup. Make sure the SAS URI of the container is reachable and hasn't expired.
88
88
89
89
Stop the IR if it's running, reconfigure the IR with new custom setup container SAS URI, and then restart the IR.
90
90
@@ -98,11 +98,11 @@ This error means the execution of custom setup script (main.cmd) failed. Try the
98
98
99
99
### CustomSetupScriptTimeout
100
100
101
-
This error indicates an execute custom setup script timeout. Make sure that your script can be executed silently, and no interactive input needed, and make sure your blob container contains only the necessary custom setup files. It is recommended to test the script on local machine first. You should also check the custom setup execution logs in your blob container. The maximum period for custom setup is 45 minutes before it times out, and the maximum period includes the time to download all files from your container and install them on SSIS IR. If you need a longer period, raise a support ticket.
101
+
This error indicates an execute custom setup script timeout. Make sure that your script can be executed silently, and no interactive input needed, and make sure your blob container contains only the necessary custom setup files. It's recommended to test the script on local machine first. You should also check the custom setup execution logs in your blob container. The maximum period for custom setup is 45 minutes before it times out, and the maximum period includes the time to download all files from your container and install them on SSIS IR. If you need a longer period, raise a support ticket.
102
102
103
103
### CustomSetupScriptLogUploadFailure
104
104
105
-
This error means that the attempt to upload custom setup execution logs to your blob container failed. This problem occurs either because SSIS IR doesn't have write permissions to your blob container or because of storage or network issues. If custom setup is successful, this error won't affect any SSIS function, but the logs will be missing. If custom setup fails with another error, and the log isn't uploaded, we will report this error first so that the log can be uploaded for analysis. Also, after this issue is resolved, we will report any more specific issues. If this issue is not resolved after a retry, contact the Azure Data Factory support team.
105
+
This error means that the attempt to upload custom setup execution logs to your blob container failed. This problem occurs either because SSIS IR doesn't have write permissions to your blob container or because of storage or network issues. If custom setup is successful, this error won't affect any SSIS function, but the logs will be missing. If custom setup fails with another error, and the log isn't uploaded, we'll report this error first so that the log can be uploaded for analysis. Also, after this issue is resolved, we'll report any more specific issues. If this issue isn't resolved after a retry, contact the Azure Data Factory support team.
106
106
107
107
## Virtual network configuration
108
108
@@ -116,16 +116,16 @@ This error can occur for a variety of reasons. To troubleshoot it, see the [Forb
116
116
117
117
### Forbidden
118
118
119
-
This kind of error might resemble this: “SubnetId is not enabled for current account. Microsoft.Batch resource provider is not registered under the same subscription of VNet.”
119
+
This kind of error might resemble this: `SubnetId is not enabled for current account. Microsoft.Batch resource provider is not registered under the same subscription of VNet.`
120
120
121
121
These details mean that Azure Batch can't access your virtual network. Register the Microsoft.Batch resource provider under the same subscription as Virtual Network.
122
122
123
123
### InvalidPropertyValue
124
124
125
125
This kind of error might resemble one of the following:
126
126
127
-
- “Either the specified VNet does not exist, or the Batch service does not have access to it.”
128
-
- “The specified subnet xxx does not exist.”
127
+
- “Either the specified VNet doesn't exist, or the Batch service doesn't have access to it.”
128
+
- “The specified subnet xxx doesn't exist.”
129
129
130
130
These errors mean the virtual network doesn't exist, the Azure Batch service can't access it, or the subnet provided doesn't exist. Make sure the virtual network and subnet exist and that Azure Batch can access them.
131
131
@@ -137,11 +137,11 @@ In this situation, you probably have a customized configuration of DNS server or
137
137
138
138
### VNetResourceGroupLockedDuringUpgrade
139
139
140
-
SSIS IR will be automatically updated on a regular basis. A new Azure Batch pool is created during upgrade and the old Azure Batch pool is deleted. Also, Virtual Network-related resources for the old pool are deleted, and the new Virtual Network-related resources are created under your subscription. This error means that deleting Virtual Network-related resources for the old pool failed because of a delete lock at the subscription or resource group level. Because the customer controls and sets the delete lock, they must remove the delete lock in this situation.
140
+
SSIS IR will be automatically updated regularly. A new Azure Batch pool is created during upgrade and the old Azure Batch pool is deleted. Also, Virtual Network-related resources for the old pool are deleted, and the new Virtual Network-related resources are created under your subscription. This error means that deleting Virtual Network-related resources for the old pool failed because of a delete lock at the subscription or resource group level. Because the customer controls and sets the delete lock, they must remove the delete lock in this situation.
141
141
142
142
### VNetResourceGroupLockedDuringStart
143
143
144
-
If SSIS IR provisioning fails, all the resources that were created are deleted. However, if there's a resource delete lock at the subscription or resource group level, Virtual Network resources are not deleted as expected. To fix this error, remove the delete lock and restart the IR.
144
+
If SSIS IR provisioning fails, all the resources that were created are deleted. However, if there's a resource delete lock at the subscription or resource group level, Virtual Network resources aren't deleted as expected. To fix this error, remove the delete lock and restart the IR.
@@ -153,34 +153,34 @@ This error occurs when IR is running, and it means that IR has become unhealthy.
153
153
154
154
## Static public IP addresses configuration
155
155
156
-
When you join the Azure-SSIS IR to Azure Virtual Network, you are also able to bring your own static public IP addresses for the IR so that the IR can access data sources which limit access to specific IP addresses. For more information, see [Join an Azure-SSIS Integration Runtime to a virtual network](./join-azure-ssis-integration-runtime-virtual-network.md).
156
+
When you join the Azure-SSIS IR to Azure Virtual Network, you're also able to bring your own static public IP addresses for the IR so that the IR can access data sources, which limit access to specific IP addresses. For more information, see [Join an Azure-SSIS Integration Runtime to a virtual network](./join-azure-ssis-integration-runtime-virtual-network.md).
157
157
158
-
Besides the above virtual network issues, you may also meet static public IP addresses-related issue. Please check the following errors for help.
158
+
Besides the above virtual network issues, you could also meet static public IP addresses-related issue. Check the following errors for help.
This error can occur for a variety of reasons when you start the Azure-SSIS IR:
162
+
This error can occur for various reasons when you start the Azure-SSIS IR:
163
163
164
164
| Error message | Solution|
165
165
|:--- |:--- |
166
-
| The provided static public IP address is already used, please provide two unused ones for your Azure-SSIS Integration Runtime. | You should select two unused static public IP addresses or remove current references to the specified public IP address, and then restart the Azure-SSIS IR. |
167
-
| The provided static public IP address has no DNS name, please provide two of them with DNS name for your Azure-SSIS Integration Runtime. | You can setup the DNS name of the public IP address in Azure portal, as the picture below shows. Specific steps are as follows: (1) Open Azure portal and goto the resource page of this public IP address; (2) Select the **Configuration** section and set up the DNS name, then click**Save** button; (3) Restart your Azure-SSIS IR. |
168
-
| The provided VNet and static public IP addresses for your Azure-SSIS Integration Runtime must be in the same location. | According to the Azure Network's requirements, the static public IP address and the virtual network should be in the same location and subscription. Please provide two valid static public IP addresses and restart the Azure-SSIS IR. |
169
-
| The provided static public IP address is a basic one, please provide two standard ones for your Azure-SSIS Integration Runtime. | Refer to [SKUs of Public IP Address](../virtual-network/ip-services/public-ip-addresses.md#sku) for help. |
166
+
| The provided static public IP address is already used, provide two unused ones for your Azure-SSIS Integration Runtime. | You should select two unused static public IP addresses or remove current references to the specified public IP address, and then restart the Azure-SSIS IR. |
167
+
| The provided static public IP address has no DNS name, provide two of them with DNS name for your Azure-SSIS Integration Runtime. | You can set up the DNS name of the public IP address in Azure portal, as the picture below shows. Specific steps are as follows: (1) Open Azure portal and goto the resource page of this public IP address; (2) Select the **Configuration** section and set up the DNS name, then select the**Save** button; (3) Restart your Azure-SSIS IR. |
168
+
| The provided VNet and static public IP addresses for your Azure-SSIS Integration Runtime must be in the same location. | According to the Azure Network's requirements, the static public IP address and the virtual network should be in the same location and subscription. Provide two valid static public IP addresses and restart the Azure-SSIS IR. |
169
+
| The provided static public IP address is a basic one, provide two standard ones for your Azure-SSIS Integration Runtime. | Refer to [SKUs of Public IP Address](../virtual-network/ip-services/public-ip-addresses.md#sku) for help. |
If Azure-SSIS IR provisioning fails, all the resources that were created are deleted. However, if there's a resource delete lock at the subscription or resource group (which contains your static public IP address) level, the network resources are not deleted as expected. To fix the error, please remove the delete lock and restart the IR.
175
+
If Azure-SSIS IR provisioning fails, all the resources that were created are deleted. However, if there's a resource delete lock at the subscription or resource group (which contains your static public IP address) level, the network resources aren't deleted as expected. To fix the error, remove the deleted lock and restart the IR.
176
176
177
177
### PublicIPResourceGroupLockedDuringStop
178
178
179
179
When you stop Azure-SSIS IR, all the network resources created in the resource group containing your public IP address will be deleted. But deletion can fail if there's a resource delete lock at the subscription or resource group (which contains your static public IP address) level. Remove the delete lock and restart the IR.
180
180
181
181
### PublicIPResourceGroupLockedDuringUpgrade
182
182
183
-
Azure-SSIS IR is automatically updated on a regular basis. New IR nodes are created during upgrade and the old nodes will be deleted. Also, the created network resources (e.g., the load balancer and the network security group) for the old nodes are deleted, and the new network resources are created under your subscription. This error means that deleting the network resources for the old nodes failed due to a delete lock at the subscription or resource group (which contains your static public IP address) level. Remove the delete lock so that we can clean up the old nodes and release the static public IP address for the old nodes. Otherwise the static public IP address cannot be released and we will not be able to upgrade your IR further.
183
+
Azure-SSIS IR is automatically updated regularly. New IR nodes are created during upgrade and the old nodes will be deleted. Also, the created network resources (for example, the load balancer and the network security group) for the old nodes are deleted, and the new network resources are created under your subscription. This error means that deleting the network resources for the old nodes failed due to a delete lock at the subscription or resource group (which contains your static public IP address) level. Remove the delete lock so that we can clean up the old nodes and release the static public IP address for the old nodes. Otherwise the static public IP address can't be released and we won't be able to upgrade your IR further.
184
184
185
185
### PublicIPNotUsableDuringUpgrade
186
186
@@ -190,4 +190,4 @@ When you want to bring your own static public IP addresses, two public IP addres
190
190
191
191
### Resource tag not updated
192
192
193
-
You can apply [tags](../azure-resource-manager/management/tag-resources.md) to your Azure resources to logically organize them into a taxonomy. While the SSIS IR is running, changes to SSIS IR parent data factory tags will not take effective until SSIS IR is restarted.
193
+
You can apply [tags](../azure-resource-manager/management/tag-resources.md) to your Azure resources to logically organize them into a taxonomy. While the SSIS IR is running, changes to SSIS IR parent data factory tags won't take effective until SSIS IR is restarted.
![prmerger-automator[bot]](https://avatars.githubusercontent.com/u/22479449?v=4&size=40){kind=avatar}
0 commit comments