EducationSoftwareStrategy.com
StrategyCommunity

Knowledge Base

Product

Community

Knowledge Base

TopicsBrowse ArticlesDeveloper Zone

Product

Download SoftwareProduct DocumentationSecurity Hub

Education

Tutorial VideosSolution GalleryEducation courses

Community

GuidelinesGrandmastersEvents
x_social-icon_white.svglinkedin_social-icon_white.svg
Strategy logoCommunity

© Strategy Inc. All Rights Reserved.

LegalTerms of UsePrivacy Policy
  1. Home
  2. Topics

KB42978: When testing a new DSN connection, using the Connectivity Wizard, running on UNIX/LINUX against a Microsoft SQL Server database the error message "General network error. Check your network documentation" pops up in MicroStrategy Universal 2021


Community Admin

Placeholder •


When testing a new DSN connection, using the Connectivity Wizard, running on UNIX/LINUX against a Microsoft SQL Server database the error message "General network error. Check your network documentation" pops up in MicroStrategy Universal 2021

SYMPTOM:
While creating a new DSN, using the Connectivity Wizard, in Strategy Universal 2021 running on UNIX/LINUX against a Microsoft SQL Server database the following error message can be seen when testing the connection. The same DSN connection information can be successfully connected to when running Connectivity Wizard on a Windows Operating system.
 

ka0PW0000002wpVYAQ_0EM440000002JDz.png

 
 


Connect failed.
Error Type: Odbc error. Odbc operation attempted: SQLDriverConnect.
General network error. Check your network
documentation. ConnectionOpen (Name or service not known()).
Driver's
SQLSetConnectAttr failed

 
 
STEPS TO REPRODUCE:
1. On a Windows operating system open Strategy Connectivity Wizard
2. Select the Microsoft SQL Server driver and select next
3. Provide the Data Source Name, Server Name, and Database Name. Include the port number after the Server name as shown below.
 

ka0PW0000002wpVYAQ_0EM440000002JDy.png

 
4. Select Test, enter the user name and password and click Connect. The connection should succeed.
 

ka0PW0000002wpVYAQ_0EM440000002JE0.png

 
5. On a UNIX/LINUX operating system open the Strategy Connectivity Wizard GUI by using the mstrconnectwiz command
6. Select the Microsoft SQL Server Driver and provide the same connection parameters as step 3.
7. Test the connection to the database by entering the user name and password and click Connect, the connection will fail.
 
 
CAUSE:
This is caused by the port number after the Server name. In the example above the port number 1433 is added after ServerName so that the Server name appears as ServerName,1433.  The port number does not need to be added after the server name when creating a DSN. If it is added it will successfully work in Windows but fails when used in UNIX/LINUX
 
ACTION:
Remove the port number from after the Server name when creating a DSN in UNIX/LINUX. In the example above the Server name just needs to be ServerName. The 1433 is not needed after the server name.
 
 


Comment

0 comments

Details

Knowledge Article

Published:

May 18, 2017

Last Updated:

August 12, 2024