Skip to content

Commit 51db8e6

Browse files
eblanco-ansyspyansys-ci-botgmalinve
authored
DOCS: update troubleshooting guide with extension troubleshooting (#6771)
Co-authored-by: pyansys-ci-bot <[email protected]> Co-authored-by: Giulia Malinverno <[email protected]>
1 parent fcfe97d commit 51db8e6

File tree

2 files changed

+20
-1
lines changed

2 files changed

+20
-1
lines changed
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Update troubleshooting guide with extension troubleshooting

doc/source/Getting_started/Troubleshooting.rst

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,11 @@ If the virtual environment was successfully created, you can first activate it,
7575
7676
If the issue persists, try installing all required dependencies, including the optional components, by running the following command:
7777

78+
.. code:: bash
79+
80+
uv pip install pyaedt[all]
81+
82+
Or if you prefer to use pip:
7883
.. code:: bash
7984
8085
pip install pyaedt[all]
@@ -247,4 +252,17 @@ If you encounter such issue, you can try patching it by importing PyAEDT or PyED
247252
248253
.. note::
249254

250-
If you use gRPC or previous Numpy releases, you shouldn't be impacted with this issue.
255+
If you use gRPC or previous Numpy releases, you shouldn't be impacted by this issue.
256+
257+
Extensions and panels
258+
~~~~~~~~~~~~~~~~~~~~~
259+
260+
If you update PyAEDT from version **≤ 0.18.0 to a newer version**, you may need to recreate the virtual environment.
261+
262+
The management of extensions in AEDT has changed. Previously, extensions were copied to the _PersonalLib_ folder, which led to inconsistencies when updating PyAEDT extensions. This was because old extensions were not replaced until panels were reset, at which point the extension were copied from the virtual environment back into the _PersonalLib_ folder. Now, Extensions are loaded directly from the virtual environment, ensuring they remain up to date when PyAEDT is updated.
263+
264+
If issues occur with the extensions, follow these steps:
265+
266+
- Delete the virtual environment folder. On Windows: located in your APPDATA directory. On Linux: located in your HOME directory.
267+
- Delete the Toolkits directory in your PersonalLib folder.
268+
- Reinstall PyAEDT from scratch, following the instructions in the `Installation <../Getting_started/Installation.rst>`_ section.

0 commit comments

Comments
 (0)