Edit

Install SSMA for Oracle client (OracleToSQL)

The SQL Server Migration Assistant (SSMA) client migrates Oracle databases. Supported target versions include SQL Server 2019 (15.x) and later versions on Windows and Linux, Azure SQL Database, and Azure SQL Managed Instance. The client:

  • Connects to the Oracle source and the SQL Server Database Engine target.
  • Converts database objects for the target.
  • Loads the converted objects into the target.
  • Migrates the data.

This article provides the installation prerequisites and instructions for installing SSMA.

Prerequisites

SSMA is designed to work with Oracle 9 and later versions.

Before you install SSMA, make sure that the computer meets the following requirements:

  • Windows 11 or later versions, or Windows Server 2022 or later versions.
  • The .NET Framework version 4.7.2 or a later version. Download .NET Framework.
  • Connectivity to the Oracle databases that you want to migrate.
  • Access to and sufficient permissions on the computer that hosts the target instance of SQL Server or Azure SQL Database where you're migrating database objects and data. For more information, see Connecting to SQL Server (OracleToSQL).
  • 4 GB of RAM recommended.

Install the SSMA for Oracle client

SSMA is a Web download. To download the latest version, see the SQL Server Migration Assistant download page.

To install the SSMA client:

  1. Double-click SSMAforOracle_n.msi, where n is the build number.

  2. On the Welcome page, select Next.

    If you don't have the prerequisites installed, a message appears that indicates that you must first install required components. Make sure that you have installed all prerequisites, and then run the installation program again.

  3. Read the End-User License Agreement. If you agree, select I accept the agreement, and then select Next.

  4. On the Choose Setup Type page, select Typical.

  5. On the Ready to Install page, you can enable or disable telemetry and automatic update checks every time the tool starts. Select Install to start the installation.

Important

Please uninstall all prior versions of SSMA for Oracle before installing the new version.

The default installation location is C:\Program Files\Microsoft SQL Server Migration Assistant for Oracle.

In addition to the SSMA program files, you must also install the SSMA for Oracle Extension Pack on SQL Server. For more information, see Installing SSMA Components on SQL Server.

Related content

  • Last updated on