How to use an alternate SQL Port for self-hosted Enterprise Insights for Jira Align

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

By default, SQL Server runs on port 1433 and hence while installing the self-hosted (on-premise) version of Enterprise Insights (EI) it expects to communicate with the SQL server on the default port.

This article discusses how to setup a SQL server on an alternate port and configure EI to communicate on a different port from the default port.

Environment

Jira Align self-hosted

Solution

(Auto-migrated image: description temporarily unavailable)

There is no documentation to confirm if such a configuration is officially supported.

An alternate port can be used for the ETL (SSIS), Data Warehouse or the Jira Align database servers.

  • When running Install.ps1 specify the port using a comma after the server name or IP address.

Examples (assuming the alternate port is configured to be 1435)

1 2 3 Please provide your data warehouse server name: mysqlsvr,1435 Jira Align Server Name: 10.1.0.5,1435 ETL Server Name: ssissvr,1435

Q & A:

Question: Is there an impact of changing the port on EI in both, daily runs and during the installation of an upgrade?

Answer: There is no impact on Enterprise Insights. During upgrading you will need to remember to specify the port when prompted for the server (see examples above).

Question: If changed, aside from the TCP port change on the SQL server, is there any other configuration change that has to be made?

Answer: Run Install.ps1 to re-create the SQL Agent Job with the correct port numbers.

Updated on April 15, 2025

Still need help?

The Atlassian Community is here for you.