AGI Software Install and Local Licensing Instructions

This is an overview of how to download, install and configure local licenses for AGI (ANSYS) products on Windows. This includes STK, ODTK, and STK Scheduler. If you have any questions not answered by this document, please do not hesitate to submit a support ticket through our Freshdesk system.

We have also posted accompanying videos that follow along with these instructions on the LSAS YouTube page. The videos are linked below.

Download and installation: How to Install STK, ODTK, Scheduler, and Other AGI Software

License configuration: How to Configure Licenses for AGI Software - ANSYS License Manager and ANSYS Licensing Client

AGI products operate as network licenses, meaning there is typically a system in the network running the Ansys License Management Server with all the network's licenses. This allows any users connected to the network to share the server's licenses. The "local licensing" method is the process of running the license manager on the same device that is operating the software. In this tutorial, we cover the process of configuring a single license for a single device, which means you will configure the Ansys License Management Server, allowing your device to behave as the server and the client. To do this, you will link your license file to your Ansys License manager, then point your Ansys Client Licensing Settings to your device's Ansys License Management server. Once your local licenses are set up, you can simply run STK and STK will automatically be able to use your licenses, regardless of the network you’re connected to.

Overview: This tutorial is broken down into four steps.

1. Request and Download License.
2. Download your desired software from AGI.
3. Install Your Software.
4. Configure Your Local License.

1. Request and Download License: If you do not have your license file yet, you will need to request it from LSAS. This process is covered in the How to Get a License for LSAS-Tec Products article in our helpdesk, under the Submitting License Information to LSAS Section. You will simply need to send the Disk ID Number and Host Name of the device hosting your license to support@lsas-tec.com, and you will be provided with a license file. Download this license file to your computer and save it somewhere it will not be deleted.

2. Download desired software from AGI: To get the downloads, simply go to the downloads page, create an AGI account, and download the software you will need. If you are using SOLIS, you will need to request it directly from LSAS-Tec. You may need to temporarily disable your firewall to download the zip files.  

• Open the AGI Downloads page on your web browser. If you do not already have one, you will need to make an account with AGI to access the page.
• Download your desired zip files. Note that you will need to download all files in your desired product's table for a complete installation. That is, for STK Premium, you will need to download and install STK Pro, and STK Premium. For Enterprise, you will download and install STK Pro, Premium and Enterprise. 
• Download additional media as needed. STK Scheduler and ODTK are downloaded on the same webpage, and are installed separately. ODTK can run standalone without STK installed on your device.  

3. Install your software: You will now install the software you've downloaded. For STK Premium and Enterprise, start by installing STK Pro, then install any additional media. If you are only using ODTK, simply run the ODTK installer from the ODTK download in the same manner as the STK installation.

Install STK Pro: First, install STK Pro. You may need to temporarily disable your antivirus to run the installer. 

• Unzip STK Pro folder and open the unzipped folder. Navigate to the STK folder and run install.exe.
• Follow install wizard instructions and install all desired media. Be sure to select the option to install the ANSYS License Manager if you do not already have it, you will need it to run STK.
• If unsure of your computer's graphics capabilities, click test graphics to ensure your computer can run STK graphics.
• Install additional plugins as desired. For Jupyter Notebook, you will need to install Python separately if you do not already have it on your device.
• If you will be using STK Tirem or Urban Propagation, open their folders within the STK Pro install and run their setup executables.

Install additional software: Now you can install the STK Premium and Enterprise modules using the same method of unzipping, running the install executable, and following the install wizard instructions. If you are only installing ODTK and did not install STK Pro, be sure to install the Ansys License Manager. 

4. Configure Your Local License: Before running STK or ODTK, you will need to configure your license server. 

Open your .lic license file in notepad and confirm the hostname and port number. At the top of the license file, you will find a section formatted as such:

SERVER <Hostname or IPAddress> <Hostid> [TCP/IP port]

VENDOR ansyslmd [path to ansyslmd] [options="path to options file"] [port=daemon TCP/IP port]

• Write down the Hostname or IPAddress listed on the license file and write down the TCP/IP port. The port should be 1055 unless you have intentionally altered it to be a static port.

Point Ansys License Manager to your downloaded license file:

• Look up Ansys License Manager in your search bar and run as an administrator. This is the application you downloaded with STK/ODTK. 
  • If you missed this step during installation and cannot find the application, you can manually install it now. Go back to your installation folder, open the AnsysLicenseManager folder, and run the setup.exe installer in the winx64 folder for Windows, or linx64 for Linux.
    
• Navigate to License file options -> add a license file.
• Navigate to the folder where you saved your license file and select it.
• Set up your license in Ansys Client License Settings:
• Look up Ansys Client Licensing Settings in your searchbar and run as an administrator.
• Navigate to Flexnet Publisher -> License servers
• Enter the TCP/IP port you wrote down earlier (normally 1055) under Port
• Enter the Hostname or IPAddress that you wrote down earlier under Server 1.
• Click Test, if you get a green check mark, click save and you're done!
• Run STK! If you're having issues, please see the Troubleshooting and Common Fixes page below.

Troubleshooting, Additional Info and Common Fixes:

If you have any further questions or need assistance with your installation, we are here to help! Our dedicated Tec-Support team is ready to provide prompt and personalized assistance tailored to your needs. Please don't hesitate to submit a support ticket by visiting our website lsas-tec.com. We look forward to assisting you and ensuring a positive experience.

For more information on STK/ODTK installation and system requirements, or for ODTK install instructions for Linux:

Installing STK: Installing STK (agi.com) 

Installing ODTK: ODTK Installation (agi.com) 

Installing ODTK on Linux: ODTK Runtime Installation for Linux (agi.com) 

If you are having issues setting up STK Analyzer, take a look at our other Knowledge Article:

Resolving STK Analyzer Setup Issues (lsas-tec.freshdesk.com)

We have also provided a list of common troubleshooting fixes below to address any issues you may be having.

STK crashes after loading:

If STK is crashing upon starting a scenario, it may be a graphics issue. Check if STK uses a graphics card by starting STK then looking at Help -> Graphics Card Info. 

If your graphics card is being used, try updating the graphics card driver, and this should help. 

If you have a high-end graphics card but it is not being used by STK, try modifying your settings to use the graphics card by following this tutorial.

Crashing can also be caused by a bad install. Try uninstalling STK by going to your search bar and searching for the AGI Software Uninstaller application. Run as administrator, uninstall the software, and reinstall.

Your install may also be corrupted, and you can try uninstalling STK using the AGI Software Uninstaller application on your device, and re-downloading and installing STK, following the instructions of this tutorial.

If neither of these fixes help, try this more in-depth troubleshooting tutorial.

Antivirus is preventing installation:

You may need to temporarily disable your antivirus while you complete the installation. Remember to re-enable after completing installation. 

For McAffee, you can go to My Protection on the left, open Real Time Scanning, and Turn off (45 minutes should be plenty).

For other antivirus, navigate to the Disable or Turn Off option, and temporarily turn off your antivirus until you have completed installation.

Firewall is causing errors during licensing setup:

If your firewall is creating errors such as "lmgrd error" during setup or while running STK, you may need to create firewall exceptions on your computer. The fix will be dependent on the OS of your license server, so we recommend getting your IS/IT department involved. If you know your license server is running Windows, you may try whitelisting the license server as follows:

For Windows License Servers:

• Open Control panel -> System and Security -> Windows Defender Firewall -> Advanced Settings (open as administrator)
• Whitelist ports
  • Navigate to Inbound Rules, and select New Rule to create a new rule.
    • Rule type: Port
    • Protocol and Ports: TCP and Specific Local Ports: 1055, 2325 
    • Action: Allow the connection
    • Profile: Select all (Domain, Private and Public)
    • Name: name your rule whatever you like, ie: "port exception"
  • Repeat for ansyslmd.exe daemon - Select New Rule.
    • Rule Type: Program
    • Program: Browse -> C:\Program Files\ANSYS Inc\Shared Files\licensing\winx64\ansyslmd.exe
    • Action: Allow the connection
    • Profile: all
    • Name: name your rule whatever you like, ie: "daemon exception"
• See if the issue is resolved. If it still does not work, ensure the port listed in the Ansys Client Licensing Settings application is 1055. If not, ensure the port exception rule you set matches the port referenced by your licensing settings.

License not found:

There are a few reasons this may occur. Listed are some common issues that can cause this and their fixes.

Multiple Client Licensing Settings application versions:

Firstly, ensure that you only have one version of the Ansys Licensing Client Settings application installed. You can verify this by searching Ansys Licensing Client Settings in your search bar. If, for instance, you have the 2022 R1 version of Ansys Licensing Client Settings application installed from an older installation of ODTK, the new 2023 R2 licensing client settings you installed with STK could have issues. In this case, you can use the AGI Software Uninstaller to uninstall your old AGI software and reinstall the newest version. 

Check that you have licenses available on your server:

Look up Ansys Client Licensing Settings in your search bar and run the application. Navigate to Diagnostics -> Display Flexnet License Status. Here you will see the number of licenses you have for each Ansys application you have licenses to, and how many are currently in use. Ensure that you have fewer licenses in use than the number of licenses issued, and that you have licenses issued. 

Check that the license is correctly uploaded and referenced:

Look up Ansys License Management Center in your search bar and run the application. Check the following pages:

• View Status/Start/Stop License manager:  Ensure the license manager is running. If not, start the license manager.
• Get System Hostid Information: Take note of your Hostname and your Disk Serial Number. Ensure you provided the correct address and hostname to the support team when your license was generated.
• Display FlexNet License Status: Check the license file referenced for your device, and ensure it is the correct license file provided by support.

Find your .lic file (check that it is the same as the one referenced by the license manager in the previous step) and open on textedit or notepad. At the top of the file, you should see the file formatted as such. Do not edit the hostid value!

SERVER <Hostname or IPAddress> <Hostid> [TCP/IP port]

VENDOR ansyslmd [path to ansyslmd] [options="path to options file"] [port=daemon TCP/IP port]

• Record the <Hostname or IPAddress> value, and the [TCP/IP port] value. 

Finally, look up Ansys Client Licensing Settings in your search bar and run the application. Navigate to Flexnet Publisher -> License Servers and ensure that the Port matches [TCP/IP port] value from your license file and check that Server 1 matches the <Hostname or IPAddress> value from your license file.