Snowpark Migration Accelerator: Conversion Setup¶
When you initially start up the Snowpark Migration Accelerator (SMA), you have to create a project or open an existing one. A project can contain multiple executions of the SMA in both Assessment and Conversion. When you move past t[1]he Assessment in the SMA, you will be asked to setup the project for Conversion.
Conversion Setup Page¶
There is likely not much that is going to change for the conversion setup, but there are a few options:
Input Folder Path - The Input Folder Path and the Output Folder Path are the same as specified in the creating a new project step in the Project Creation. This is the directory where you have the code files you’d like scanned. All the same caveats apply, such as the fact that the tool will only analyze certain file extensions. But it’s important to note that this will run the SMA (including the assessment reporting) again. This is to ensure that the conversion results are correct even if there were changes in the codebase from when the Assessment was run. In fact, you could specify a different directory than what was specified in the Assessment.
Just like in the initial project setup, you have the option to choose a subdirectory to analyze if you would not like to analyze every folder in the chosen directory. Choosing one of the radial buttons next to the folder names will expand the folder to allow you to choose a specific subfolder or even a specific file.
Note: Hovering on the path label will show a tooltip with the full path, this applies to any field that contains a shortened path (input folder path, output folder path, etc.).
Output Folder Path - The directory where the output files (logs, reports, and code) will be placed.
Enter a New Access Code - This is where you would paste an access code if you have one available. You can also request one if you do not have one available. The next section will focus on the access code generation.
Entering and Requesting an Access Code¶
To run a Conversion in the SMA, an access code must be obtained. Access codes are usually connected to a specific user (or at least a specific email address), and can unlock different features of the SMA. To run an Assessment, an access code is not required and is not requested by the tool until you reach the Conversion Setup.
Requesting an Access Code¶
An access code can be requested through the help menu at any time, but one can also be requested by selecting Inquire about an access code on the Conversion Setup page:
This will bring up the access code request form:
Entering an Access Code¶
When you request an access code, one will be emailed to you at the email address you provide in the form. It will not be made available to you automatically in the SMA. The email will come from sma-notifications@snowflake.com, and will look something like this:
The access code will be a string of letters, dashes, and numbers. Enter the code in exactly as it appears in the email that is sent to you. In fact, it is recommended that you copy it from the email, and paste it into the Enter new access code or select one field in the Conversion Setup:
A couple of critical notes on validating your access code:
Ensure that you hit “Enter” (or “Return”) when you enter the access code. If you paste the code in, the tool will not acknowledge it until you hit “Enter”. There is an indicator that will let you know that an access code was successfully activated or if it failed to activate. If the indicator says nothing, click on the access code and hit “Enter”.
The SMA will verify the access code by calling out to the SMA Access API. If you are not connected to the internet, the access code will not be validated and conversion will not be available. If you’re connection requires you to whitelist the Access API, please reach out to sma-support@snowflake.com. We will help get your access code validated.
Once the SMA has validated the license, it will give you a quick summary of the parameters of that access code (as shown in the image above) including the expiration date and what email address the code is assigned to.
To learn more about the availability of access codes for the SMA, visit the section on Access in this documentation.
Setup Complete¶
Once you have setup the conversion, select Start Conversion at the bottom of the application. This will run the entire SMA Assessment and Conversion. You will see the same status screen as you saw when running the Assessment:
Select View Results to move on to the Conversion Output.