The main benefit of excluding a network license is to provide other users access to a module that you are not currently using. Several exclusion methods are available, as listed below
For STK 12.2 and olderOn the client, via an EXCLUDE file (*.exclude)1. LicenseUsage.htm UTILITY License Type: Network
The LicenseUsage Utility searches the modules available on the license server and enables you to select modules for exclusion.
- To access the LicenseUsage Utility, please go to: C:\Program Files (x86)\AGI\LicenseManager\LicenseUsage directory and click the LicenseUsage.htm
NOTE: The LicenseUsage Utility contains ActiveX controls, which you will need to enable its use. If you cannot change the security settings, then rename this file to have an *.hta extension. This will enable you to run it as a stand-along (trusted) application. The rename action may require admin rights, due to its location in the C:\Program Files (x86)\AGI\LicenseManager\LicenseUsage directory.
- Clicking on a module in the table will create the exclude file. Clicking additional modules will updated the file. The exclude file is saved to your User Config directory, typically at C:\Users\<YourUserName>\Documents\STK 12\Config\exclude.agilicex. STK will read this file upon startup.
- The exclusion takes effect for all future sessions of STK or until you make new changes. The exclude file will also exclude the chosen modules from any licenses available, from nodelocked and dongle licenses as well as networked licenses.
2. EXCLUDE FILE License Type: Network, Nodelock, Dongle
You can perform the exclude actions that the LicenseUsage.htm utility offers by creating the exclude file manually.
• The file must be ASCII and named 'exclude.agilicex'.
• The file must be located in User Config directory (typically at C:\Users\YourUserName>\Documents\STK 12\Config\exclude.agilicex). You cannot change this path. If you have set your User Config directory to be a different location, you can see it listed on the Help Menu > License Viewer page.
• Names of the excluded modules should conform with those found in the License Manager.
• You can place a comment symbol, #, in front of the module name to disable its exclusion.
The syntax in the exclude file is as follows:
# This file contains a list of STK Licenses to exclude.
ASTG
ATT
#CAT
#COMM
COV
DSIM
Open the attached exclude file to see a sample.
On the client, via /LicEx switch 3. COMMAND LINE
License Type: Network, Nodelock, Dongle
You can start STK via a command prompt or via a windows batch file (*.bat) and exclude modules using the -licex flag. This exclusion method will take effect for the current session of STK only, i.e., you must use this option every time you start up STK and want to exclude a module.
EXAMPLE
"C:\Program Files (x86)\AGI\STK <version>\bin\aguiapplication.exe" /pers STK -licex CAT,COMM,SatPro
Note: The element -licex specifies the license exclusion. Modules should be separated with commas without spaces in between.
Tip: Place the command line into your desktop STK Shortcut (Properties -> Shortcut -> Target) if you wish to avoid having to retype them every time.
4. SHORTCUT METHOD License Type: Network, Nodelock, Dongle
- Make a copy of your Desktop Shortcut and call it STK_No_Comm_Pro.
- Right-click and open the properties.
- Copy the contents of the "Target:" field and paste it into a text editor so you can see entire string. Edit the string as follows:
Before:
"C:\Program Files\AGI\STK <version>\bin\AgUiApplication.exe" /pers "STK"
After:
"C:\Program Files\AGI\STK <version>\bin\AgUiApplication.exe" /pers "STK" /LicEx Comm,STKProfessional
- Paste the After version into the Target: field; in this example, the excluded licenses are Comm and STKProfessional.
- Click OK to close the properties.
- Double-click STK_No_Comm_Pro to launch STK.
- Open Help > License Viewer and verify that you excluded Comm and Professional.
On the server5. OPTIONS FILE License Type: Network
This file enables the license administrator to:
- Allow the use of features
- Deny the use of features
- Reserve licenses
- Restrict the number of licenses available
- Control the amount of licenses available
- Enable license usage logging
Specific instructions are available in the FlexLM End User Manual. See the FAQ
What is an 'options' File (.opt)?For STK 12.4 and newerFor STK 12.4 and newer, the method is built right into the software. In STK 12.4,
AGI simplified the product licenses associated with STK into four main versions: STK Pro, STK Premium Air, STK Premium Space, and STK Enterprise.
With this simplification, AGI added the ability to choose which licenses you would like to use right when opening STK. You can choose to have this option only show up once, or every time you open STK. If you have turned it off, you can reincorporate it by going to Edit Menu > Preference > General and selecting the Product Configuration check box.
