User guide#

Create a new solution by instantiating the solution template in your working directory.

Scaffold

Install the solution development environment using the saf install command.

Install

Run your solution locally using saf run or Docker Compose deployment options.

Run locally

Perform project management tasks like creating, sharing, upgrading, and deleting solution projects.

Manage projects

Explore techniques for debugging the backend, frontend, and telemetry issues in your solution.

Debug

Test your solution using fixtures for backend API testing, frontend Dash callbacks, and product instances.

Test

Add a new step to an existing solution using the saf add-step command.

Add steps

Package your solution as a distributable installer or archive for deployment.

Package

Deploy solutions on desktop or on-premises infrastructure via Windows services, Docker Compose, or K3s.

Deploy

Define your workflow, steps, transaction methods, and manage files and folders.

Backend development

Build the user interface using the Dash framework and client-side interaction patterns.

Frontend development

Configure the SAF runtime using environment variables for SAF GLOW Engine, SAF, OTel, and other components.

Environment variables

Learn about the servers in your solution stack and the roles they play in local development.

Solution servers

Use a Python script to control a SAF-based application and explore available APIs and configurations.

Script a solution

Review Ansys product and third-party tool integrations with version compatibility details.

Supported software

Explore the SAF components, their roles, relationships, and installation via the ansys-saf-sdk meta-package.

SAF components

Follow recommended patterns and guidelines for building robust, maintainable SAF solutions.

Best practices

Access migration instructions for upgrading SAF solutions across major versions.

Migration guide

Diagnose and resolve installation, dependency, deployment, backend, and network issues.

Troubleshooting guide