MacOS Installation

Install the SMA on a Windows machine

Install the Snowpark Migration Accelerator (SMA) by following the steps below. It's important to note that the SMA can be installed as an application or a CLI. Both installation instructions are given below.

If you do not have access to the application or the CLI, you can learn more about accessing them on the Download and Access page of this documentation.

MacOS Application

Follow the steps below to install the SMA on a Mac machine.

1. Click on the downloaded .dmg file.

2. Agree to the terms of use for this software by clicking Accept.

   

   SMA Terms of Use
3. Double-click on the SMA logo or drag it into the application's folder.

   

   SMA to the Applications Folder

And that's it! If your installation was successful, you can move on to the user guide that walks you through using the SMA.

If the version of the Snowpark Migration Accelerator you have installed is outdated, there will be a notification in the top right corner indicating updates are available. Click on "UPDATE NOW" to download the latest version. Once the download completes, you will get a prompt to install the update.

If you have an issue with installation, please reach out to [e-mail].

Instructions on setting up the CLI for Mac are next up on this page.

MacOS Command Line Interface (CLI)

NOTE: The SMA CLI and the SnowConvert CLI are currently a single combined CLI. You will see references to SnowConvert below and the name of the CLI will reflect that it is the SnowConvert CLI. This is expected. The CLI's for both products are planned to be separated.

To set up the Command Line Interface (CLI) for the Mac, follow the instructions below.

1. Verify that you have the correct corresponding installation file for the CLI version. (See more about downloading the SMA on the Download and Access page.) The file would look like this:

SMA Mac CLI File

1. The next step is to extract the contents of the installation file, and save them to a local directory on your machine. This is an example of where the extracted files could be saved: /Users/<User>/Documents/dotnet-artifacts

2. Next, you must run the following command in the terminal. Please consider replacing the location in the text below with the actual location where you extracted the files. Note that depending on the configuration of your machine, you might need to use the sudo command to use root privileges:

sudo ln -s /Users/<User>/Documents/dotnet-artifacts/orchestrator/snowct /usr/local/bin/snowct

1. If /usr/local/bin is in your PATH environment variable, then you will be able to use the snowct command to execute the SMA CLI. For example, you can execute this command to learn more about the CLI:

snowct --version

1. You should see the current installed version of your SMA CLI:

SMA CLI Information

If you've setup the Application or the CLI, you can move on to the user guide that walks you through using the SMA.

If you had an issue with installation, please reach out to [e-mail].