System-wide

Install the package system-wide on the Granta MI application server for production use or for integration testing.

To install the latest release as a system-wide package, run this command as an administrator:

python -m pip install ansys-grantami-dataflow-extensions

Virtual environment

Install the package in a virtual environment:

• On a local development environment, for script development and debugging

• On the Granta MI application server, when it is not possible to install system-wide packages

To install the package in a virtual environment, first create a new virtual environment:

python -m venv C:\path\to\my\venv

Where C:\path\to\my\venv is the path to the location where you would like the venv to be located. This should be a location that all users can access.

Then activate the virtual environment and install the packages:

C:\path\to\my\venv\Scripts\activate
pip install ansys-grantami-dataflow-extensions

If installing in a virtual environment on the Granta MI application server, Data Flow must be configured with details of the virtual environment to be used:

1. Create a backup copy of the web.config file. By default, this file is located at C:\inetpub\wwwroot\mi_dataflow.

2. Open the web.config file in a text editor, and find the line <add key="PythonPath" value="python.exe" />

3. Replace the string python.exe with C:\path\to\my\venv\Scripts\python.exe, where C:\path\to\my\venv is the path to the virtual environment specified above.

4. Save the modified web.config file. If you see a permissions error, you may need to open the text editor with administrator privileges.

5. Reload the Data Flow worker process in IIS Manager. Warning: This stops any running Workflow processes.

Installing a development version

To install the latest release from the PyGranta Data Flow Extensions repository, run this command:

python -m pip install git+https://github.com/ansys/grantami-dataflow-extensions.git

To install a local development version with Git and Poetry, run these commands:

git clone https://github.com/ansys/grantami-dataflow-extensions
cd grantami-dataflow-extensions
poetry install

The preceding commands install the package in development mode so that you can modify it locally. Your changes are reflected in your Python setup after restarting the Python kernel. This option should only be used when making changes to this package, and should not be used when developing code based on this package.