Installing and Uninstalling STK

This topic provides step-by-step instructions for installing and uninstalling STK. If you are unable to install or uninstall STK on a computer using these instructions, please contact AGI Technical Support.

Install STK

Before you begin these instructions, make sure that you have the STK install media or the STK install download. You must also have permission to install software on your computer.

  1. Insert the STK install media or download the STK install.
  2. If AutoRun is not enabled, run install.exe on the STK install media. Otherwise, skip to the next step.
  3. In the Systems Tool Kit Installer dialog box, select the software that you want to install. For information on the Ansys License Manager option, see Network License Server.

    4. Installation of the STK Help is optional. By default, STK will use the STK Help on AGI's website for both the Desktop and Programming Help. If you want to install the desktop Help, select Install Desktop Help. If you also want to install the Programming Help, select the Install Programming Help check box.

  4. Click Install.
  5. The install wizard will prompt you through installing the software you have selected.
  6. Once you have completed all of the steps in the install wizard, you will be returned to the Systems Tool Kit Installer.
  7. Click Test Graphics if you want to verify that your computer can run STK's 3D graphics capabilities.
  8. Click Finish to close the Systems Tool Kit Installer.

The STK installation creates a log file that you can use for troubleshooting. The log file is located in the %temp% folder of the administrative user account of your system, and has one of the following formats:

  • STKInstallLog_YYYY-MM-DD_HH-MM-SS.txt
  • STKDvdInstallLog_YYYY-MM-DD_HH-MM-SS.txt
where YYYY-MM-DD and HH-MM-SS represent the date and time that the file was created.

STK plugin installation

If you choose to install STK plugins on the STK Installer dialog box, then the STK Plugins Installer dialog box will appear. You can make your plugin selections from there. If you select Jupyter Notebook, you must also install Python separately before using the plugin.

Python installation

The following procedure is one of several ways to install Python and the notebook package.

For devices with internet connectivity:

  1. Download Python (e.g., version 3.10.5) from https://python.org/downloads.
  2. Install Python. Select the option to add Python to your PATH. This is a recommendation, as it is possible to proceed without doing so.
  3. Open a Command prompt.
  4. Create a directory (e.g., mkdir%TEMP%\PythonPackages) into which you can copy additional required packages.
  5. Use pip to download the notebook package and all its dependent packages.
    1. If you chose not to add Python to your PATH, change directory to the Scripts directory where you installed Python.
    2. Enter the following at the command prompt:
      pip download -d %TEMP%\PythonPackages notebook

If you want to install Python on an offline machine, proceed as follows:

  1. Obtain the Python Installer and downloaded packages from a device with internet connectivity (see step 1 above).
  2. Install Python. Select the option to add Python to your PATH. This is a recommendation, as it is possible to proceed without doing so.
  3. Open a Command prompt.
  4. Use pip to install the notebook package and all its dependent packages.
    1. If you chose not to add Python to your PATH, change directory to the Scripts directory where you installed Python.
    2. Enter the following at the command prompt:
      pip install --no-index --find-links %TEMP%\PythonPackages notebook

Uninstall STK

You can uninstall AGI products using the AGI Software Uninstaller or AGI_CmdlineUnistaller.exe.

Before uninstalling STK, make sure to close all apps and scripts that could possibly be using an STK file. If you don't, the uninstall will not delete the file but will mark it for deletion at the next reboot. If you install a new version of STK before any reboot, you will eventually lose this file. Once you shut down the computer, a restart will trigger the deletion of the file, and it won't be there afterward for the new version of STK to use.

Using the AGI Software Uninstaller

The AGI Software Uninstaller is part of the AGI Support Tools package located in the installation disk/download folder at \STK_vX\AGI_Support_Tools\vY\, where X is the STK version and Y is the AGI Support Tools version. To use this tool to uninstall AGI products, take the following steps:

  1. From the Start Menu in Windows, under AGI Support Tools, open the AGI Software Uninstaller.
  2. In the Uninstaller window, click Select All if you want to uninstall all AGI products on the computer. Otherwise, select the check box next to each product that you want to uninstall.
  3. Click Uninstall.

Using the Windows command line uninstaller

  1. Open a command window and set the directory to: C:\Program Files\AGI\Support Tools\AGI_CmdLineUninstall.
  2. Use the AGI_CmdLineUninstaller.exe command to list the AGI products installed on the computer or to uninstall one or more of them. The following table describes the command options:

    3. Option Function Example
    /? Display Help for the command line format.
    AGI_CmdLineUninstaller.exe /?
    /L

    Display the names of all AGI products installed on the computer.

    /L > C:\Test.txt will write the list to a text file called Text.txt.
    AGI_CmdLineUninstaller.exe /L
    "uninstall =(<product name 1>;<product name 2>;<product name n>)"

    Uninstall only the products that you specify and in the order you specify them.

    AGI_CmdLineUninstaller.exe "uninstall=(STK Parallel Computing 12;STK MATLAB Connector 1.0.18)"

    In this example, STK Parallel Computing 12 would be uninstalled, then STK MATLAB Connector 1.0.18.
    "uninstall =()" Uninstall all AGI products.
    AGI_CmdLineUninstaller.exe "uninstall=()"
    "exclude=(<product name 1>;<product name 2>;<product name n>)"

    Uninstall all products except those that you specify.

    AGI_CmdLineUninstaller.exe "exclude=(STK 12;Ansys License Manager;STK Help System 12)"