Configure SQL Server

December 21, 2023

Contributed by:

K C S

For connections to SQL Server from an on-premises XenMobile Server, you can use any of the following drivers:

The default driver
jTDS
Microsoft Java Database Connectivity (JDBC) driver

The jTDS driver is the default driver when you:

Install XenMobile Server on-premises.
Upgrade from a XenMobile Server that’s configured to use the jTDS driver.

For both drivers, XenMobile supports SQL Server authentication or Windows authentication. For those combinations of authentication and driver, SSL can be on or off.

When you use Windows authentication with the Microsoft JDBC driver, the driver uses integrated authentication with Kerberos. XenMobile contacts Kerberos to get the Kerberos Key Distribution Center (KDC) details. If the required details aren’t available, the XenMobile CLI prompts for the IP address of the Active Directory server.

To switch from the jTDS driver to the JDBC driver, SSH to all your XenMobile Server nodes and use the XenMobile CLI for configuration. The steps vary according to your current jTDS driver configuration, as follows.

Switch to Microsoft JDBC (SQL Server authentication)

To complete these steps, you need the SQL Server user name and password.

SSH to all XenMobile Server nodes.
In the XenMobile CLI main menu, type 2 to select the System Menu.
Type 12 to select Advanced Settings.
Type 7 to select Switch JDBC driver, and then type m for Microsoft.
When prompted, type y to choose SQL authentication and then type the SQL Server user name and password.
Repeat the steps for each XenMobile Server node.
Restart each XenMobile Server node.

Switch to Microsoft JDBC (SSL is off; Windows authentication)

To complete these steps, you need the Active Directory user name and password, the Kerberos KDC realm, and the KDC user name.

SSH to all XenMobile Server nodes.
In the XenMobile CLI main menu, type 2 to select the System Menu.
Type 12 to select Advanced Settings.
Type 7 to select Switch JDBC driver, and then type m.
When prompted whether to use SQL Server authentication, type n.
When prompted, type the Active Directory user name and password configured for the SQL server.
If XenMobile doesn’t auto-discover the Kerberos KDC realm, it prompts for the KDC details, including the SQL server FQDN.
When prompted whether to use SSL, type n. XenMobile saves the configuration. If XenMobile can’t save the configuration because of errors, it shows an error message and the details that you entered.
Repeat the steps for each XenMobile Server node.
Restart each XenMobile Server node.

To change the XenMobile database password

Follow this guidance to change the XenMobile database password, such as when Citrix Support directs you to make a password change.

If your SQL server uses Windows authentication, make database password changes in the Windows Active Directory. Then, refresh the database administrator account on the database server to synchronize the password change. You can then change the password in XenMobile, as follows.

Important:

Plan a scheduled maintenance window for changing the database password in XenMobile. A password change must occur during system downtime.

When you change the password, make sure that all XenMobile nodes are connected to the network. After you change the password, restart XenMobile.

If you don’t restart XenMobile after a password change, XenMobile goes into recovery mode. In that case, revert to the old password in the SQL server, restart XenMobile, and change the password again.

Verify that all XenMobile Server nodes are running. For a clustered environment, bring up all nodes.
Block the incoming device traffic to XenMobile at the Citrix ADC load balancer by disabling the virtual server.
To change the database password in an SQL server: Log in to the XenMobile CLI, navigate to Configuration > Database, and enter the changed password when prompted:
```
Server []: <ipAddress>
Port [1433]: 1433
Username [sa]: <userName>
Password: <****>

```
Choose Y to restart the server.
Repeat steps 3 and 4 for all the other nodes in the cluster.
Unblock the incoming device traffic by enabling the virtual server at the Citrix ADC load balancer.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Configure SQL Server

December 21, 2023

Contributed by:

K C S

December 21, 2023

Contributed by:

K C S

Configure SQL Server

Switch to Microsoft JDBC (SQL Server authentication)

Switch to Microsoft JDBC (SSL is off; Windows authentication)

To change the XenMobile database password

In this article