Best practices for AWS SCT - AWS Schema Conversion Tool

Best practices for AWS SCT

Find information on best practices and options for using the AWS Schema Conversion Tool (AWS SCT).

Configuring conversion performance and memory consumption options

You can configure AWS SCT with different memory performance settings. Increasing memory speeds up the performance of your conversion, but uses more memory resources on your desktop.

To set your memory management option, choose Global settings from the Settings menu, and choose Performance and memory. For Performance and memory management policy, choose one of the following options:

  • Faster conversion, larger memory consumption – This option optimizes for speed of the conversion, but might require more memory for the object reference cache.

  • Slower conversion, lower memory consumption – This option minimizes the amount of memory used, but results in a slower conversion. Use this option if your desktop has a limited amount of memory.

  • Balance speed and memory consumption – This option optimizes a balance between memory use and conversion speed.

After you select an option, choose Apply, and then choose OK.

Configuring additional memory

For converting large database schemas, such as a database with 3,500 stored procedures, you can configure the amount of memory available to the AWS Schema Conversion Tool.

To modify the amount of memory that AWS SCT consumes
  1. On the Settings menu, choose Global settings, and then choose JVM options.

  2. Choose Edit config file and choose the text editor to open the configuration file.

  3. Edit the JavaOptions section to set the minimum and maximum memory available. The following example sets the minimum to 4 GB and the maximum to 40 GB.

    [JavaOptions] -Xmx40960M -Xms4096M
  4. Save the configuration file, choose OK, and restart AWS SCT to apply changes.

Configuring the default project folder

AWS SCT uses the project folder to store the project files, save assessment reports, and store converted code. By default, AWS SCT stores all files in the application folder. You can specify another folder as the default project folder.

To change the default project folder
  1. On the Settings menu, choose Global settings, and then choose File path.

  2. For Default project file path, enter the path to the default project folder.

  3. Choose Apply, and then choose OK.

Increasing logging information

You can increase the logging information produced by AWS SCT when converting your databases, scripts, and application SQL. Although increasing logging information might slow conversion, the changes can help you provide robust information to AWS Support if errors arise.

AWS SCT stores logs in your local environment. You can view these log files and share them with AWS Support or AWS SCT developers for troubleshooting.

To change logging settings
  1. On the Settings menu, choose Global settings, and then choose Logging.

  2. For Log folder path, enter the folder to store logs from the user interface.

  3. For Console log folder path, enter the folder to store logs of the AWS SCT command line interface (CLI).

  4. For Maximum log file size (MB), enter the size, in MB, of a single log file. After your file reaches this limit, AWS SCT creates a new log file.

  5. For Maximum number of log files, enter the number of log files to store. After the number of log files in the folder reaches this limit, AWS SCT deletes the oldest log file.

  6. For Extractors log download path, enter the folder to store data extraction agents logs.

  7. For Cassandra extractor log path, enter the folder to store Apache Cassandra data extraction agents logs.

  8. Select Ask for a path before loading to make sure that AWS SCT asks where to store logs every time you use data extraction agents.

  9. For Debug mode, choose True. Use this option to log additional information when standard AWS SCT logs don't include any issues.

  10. Choose key application modules to increase the logging information. You can increase the logging information for the following application modules:

    • General

    • Loader

    • Parser

    • Printer

    • Resolver

    • Telemetry

    • Converter

    • Type mapping

    • User interface

    • Controller

    • Compare schema

    • Clone data center

    • Application analyzer

    For each of the preceding application modules, choose one of the following logging levels:

    • Trace – Most detailed information.

    • Debug – Detailed information on the flow through the system.

    • Info – Runtime events, such as startup or shutdown.

    • Warning – Use of deprecated APIs, poor use of API, other runtime situations that are undesirable or unexpected.

    • Error – Runtime errors or unexpected conditions.

    • Critical – Errors that lead to the application shutting down.

    • Mandatory – The highest possible level of errors.

    By default, after you turn on Debug mode, AWS SCT sets the Info logging level for all application modules.

    For example, to help with key problem areas during conversion, set Parser, Type mapping, and User interface to Trace.

If information becomes too verbose for the file system where logs are streaming, change to a location with sufficient space to capture logs.

To transmit logs to AWS Support, go to the directory where the logs are stored, and compress all the files into a manageable single .zip file. Then upload the .zip file with your support case. When the initial analysis is completed and ongoing development resumes, return Debug mode to false to eliminate the verbose logging. Then increase conversion speed.


To manage the log size and streamline reporting issues, remove the logs or move them to another location after a successful conversion. Doing this task ensures that only the relevant errors and information are transmitted to AWS Support and keeps the log file system from filling.