Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  2. NetBackup™ Web UI Cloud Administrator's Guide
  3. Protecting PaaS assets
  4. Installing the native client utilities
  5. Installing the SqlPackage client utility
NetBackup™ Web UI Cloud Administrator's Guide

Installing the SqlPackage client utility

You need to install this utility to protect the following databases:

  • Azure SQL

  • Azure SQL Managed Instance

  • AWS RDS SQL server

  • GCP SQL server

The SqlPackage client utility recommended version is 19.2 (Build: 162.0.52).

Download locations

https://docs.microsoft.com/en-us/sql/tools//sqlpackage-download?view=sql-server-ver15

https://packages.microsoft.com/rhel/7/prod/msodbcsql17-17.9.1.1-1.x86_64.rpm

https://packages.microsoft.com/rhel/7/prod/unixODBC-2.3.7-1.rh.x86_64.rpm

To install, run the following commands in the terminal:

  1. cd ~
  2. mkdir sqlpackage
  3. unzip ~/Downloads/sqlpackage-linux-<version string>.zip -d ~/sqlpackage
  4. echo "export PATH=\"\$PATH:$HOME/sqlpackage\"">> ~/.bashrc
  5. chmod a+x ~/sqlpackage/sqlpackage
  6. source ~/.bashrc

    Note:

    Ensure that the sqlpackage is added as a default path variable. If you still get the: Cannot find sqlpackage error, restart the NetBackup services on the media server.

  7. sqlpackage
  8. rpm -ivh unixODBC-2.3.7-1.rh.x86_64.rpm
  9. rpm -ivh msodbcsql17-17.10.2.1-1.x86_64.rpm

If you still get the error: sqlpackage client utility does not exist on the given host, create a soft link for the sqlpackage to the path /usr/bin/sqlpackage.

For example:

If the sqlpackage is located at /root/sqlpackage/sqlpackage, create a soft link and then run the backup as:

ln -s /root/sqlpackage/sqlpackage/usr/bin/sqlpackage

RHEL 9 users perform the following additional steps:

  1. Download the Microsoft.NETCore.App.Runtime.linux-x64 from the link:

    https://www.nuget.org/api/v2/package/Microsoft.NETCore.App.Runtime.linux-x64/6.0.10

    Locate the file: microsoft.netcore.app.runtime.linux-x64.6.0.10.nupkg.

  2. Extract the file using a decompression tool like, 7zip.
  3. Navigate to:

    microsoft.netcore.app.runtime.linux-x64.6.0.10.nupkg\runtimes\linux-x64\lib\net6.0\

  4. Copy the file System.Security.Cryptography.X509Certificates.dll from there to the ~/sqlpackage folder created in step 2 of installing the sqlpackage client utility task.

If you are attaching the 10.1 media server as an external media server with 10.1.1 NetBackup setup, perform the following steps on the 10.1 media server.

For a BYO NetBackup setup:

  • Run the command:

    mkdir -p <backup and restore ushare export path>

  • Check the Defaultvers value of NFS in the /etc/nfsmount.conf file.

    • If the Defaultvers value is nfs3, then mount the backup and restore ushare path with the option nolock. For example: mount <ushare mount path> <ushare export path> -o nolock

    • If the Defaultvers is nfs4, mount the backup and restore ushare path without the nolock option.

For NetBackup deployed in AKS and EKS environments:

  • Run the command:

    mkdir -p <backup and restore ushare export path>

  • Check the Defaultvers value of NFS from the /etc/nfsmount.conf file.

    • If the Defaultvers value is nfs3, then mount the backup and restore ushare path with the option nolock For example: mount <ushare mount path> <ushare export path> -o nolock

    • If the Defaultvers value is nfs4, then mount the v4 version of backup and restore ushare path without the nolock option.

Feedback

Was this page helpful?
Previous

Installing the MySQL client utility

Next

Installing PostgreSQL client utility

Feedback

Was this page helpful?