AGI's Customer Licensing System (CLS) is an easy-to-use Web interface through which you can view and manage your active STK products (i.e. those with up-to-date Annual Support and Upgrade Agreements [UGA/UGR]) 24 hours a day, seven days a week. Using the CLS, a company’s CLS Account Administrator, or any Authorized User(s) designated by that Account Administrator, can perform many common license management tasks—such as issuing, reissuing, transferring, and upgrading—quickly and without the need to contact AGI Product Support. Most tasks take just a few minutes, and any resulting license files, along with installation instructions, are e-mailed directly to the CLS user.
To access AGI's Customer Licensing System (CLS), open your favorite Web browser and navigate to https://cls.agi.com. The welcome screen will present you with the options to either log-in to your CLS account or browse to the AGI product offerings displayed on our public Web site at www.agi.com/products. If you are the CLS Account Administrator, or an Authorized User designated by that Account Administrator, be sure to have your CLS login information handy before you begin. Then, click "Log-In to Your Account". Next, enter your e-mail address and CLS password (which can be reset if necessary by clicking “I’ve forgotten my password"). Finally, click the "Log-In" button.
The first time you access the CLS your account information will display, giving you a chance to review it for accuracy. For security purposes, the first time you access the CLS you will be prompted to change your password. This new password should adhere to the standard rules of secure password designation (minimum six characters, one numerical, one capitalized letter, no first/last names), and will be unique to each individual CLS user.
AGI's Customer Licensing System (CLS) is a secure Web site. Access is restricted initially to the CLS Account Administrator, and then to any Authorized User(s) designated by that Account Administrator to perform licensing tasks on his/her behalf. Note that only the CLS Account Administrator has the ability to add and remove Authorized Users as appropriate. On initial login, each user will set his/her own unique password, following standard rules of secure password designation (minimum six characters, one numerical, one capitalized letter, no first/last names).
AGI's Customer Licensing System (CLS) will display information about your active STK products (i.e. those with up-to-date Annual Support and Upgrade Agreements [UGA/UGR]) issued to any of the four standard license types: Nodelocked, Network (NT), Dongle, and Network Dongle (NTD). The CLS can interpret and process licensing requests, such as transfers, issues and upgrades, on products that reside on most license types, with the exception of NTDs and network licenses issued to Redundant Triad or Failover (Primary/Secondary) configurations. If your current licensing task involves either an NTD, or a Redundant Triad or Failover network configuration, please contact support@agi.com or call 1.800.924.7244.
AGI's Customer Licensing System (CLS) is a secure Web site and only the CLS Account Administrator has the ability to add or remove Authorized CLS Users, as appropriate. If that is you, then first be sure to have the e-mail addresses handy for each individual you wish to add and authorize.
Log in with your e-mail address, CLS password, and CLS account number.
Verify your account information for accuracy and change your password for security reasons.
On the screen that follows, click "Yes, I’d Like to Add More Users".
At the "Allow Additional Users" screen, enter each e-mail address in the "Add new authorized user" section that will display on the right.
Click "Add".
Repeat for each user you wish to authorize.
These names will then display in the "Showing all currently authorized users" list on the left, and an automated e-mail will be sent to the newly authorized CLS user containing the login information.
If this is not your first time logging in to the CLS:
Follow Steps 1 and 2 above.
Choose "Manage Account" "Allow Additional Users" from the black menu bar at the top of any screen.
Follow steps 4-7 above.
These names will then display in the "Showing all currently authorized users" list on the left, and an automated e-mail will be sent to the newly authorized CLS user(s) containing the login information.
To delete Authorized CLS Users:
Follow Steps 1-4 above if this is your first time logging in to the CLS, or:
Follow Steps 1 and 2, then choose "Manage Account" "Allow Additional Users" from the black menu bar at the top of any screen if this is not your first time logging in to the CLS.
Click the "Remove" link that displays to the right of all current Authorized CLS User names.
Follow the prompts to verify that deleting this user was your intent.
As long as your STK products have current maintenance (i.e. up-to-date Annual Support and Upgrade Agreements [UGA/UGR]), you can transfer STK licenses in one of two ways:
1. Online thru AGI’s Customer Licensing System (CLS):
AGI's Customer Licensing System (CLS) is a secure Web site accessible only by your organization’s CLS Account Administrator or any Authorized User(s) designated by that Account Administrator.
Log in with your e-mail address, CLS password and CLS account number.
Verify your account information for accuracy and change your password for security reasons.
On the screen that follows, click "No, Take Me to Licensing."
Click "Get Licenses".
Click "Transfer Licenses".
On Screen 1 – Select Licenses, the screen will present all STK licenses available to you for transfer via the CLS.
Click the checkbox next to each product you wish to transfer.
Note: Although you can transfer individual products separately off a given Host ID (for example, only the "Coverage" product off a Host ID that is currently running more than just Coverage), you can only transfer one given Host ID at a time. As an example, transferring the Coverage product from machine "A" and the Attitude product from machine "B" both to machine "C" would require two transfers, followed by a final "Reissue" of the license for machine "C".
Once your selections are complete, click "Transfer these [License Type] licenses".
On Screen 2 – Enter Information, from the drop-down boxes, choose your current STK version and Operating System (OS) platform. Enter your machine Host ID, scroll to the bottom of the screen, and click the checkboxes to accept the Software Transfer Agreement terms.
On Screen 3 – E-Mail Licenses, decide who should receive the e-mail containing the actual STK license set(s) and installation instructions and edit the default e-mail text if appropriate. When finished, click "Next".
On Screen 4 – Complete, verify that the information is correct, and then click the checkbox at the bottom of the screen to accept the Licensing Agreement.
Click "Transfer Licenses" to complete the process.
If this is not your first time logging in to the CLS:
Follow Steps 1 and 2 above
From the CLS "Home" page, choose "Get Licenses", or:
Choose "Get Licenses" "Transfer Licenses" from the black menu bar at the top of any screen.
Follow Steps 6 – 13 above.
2. Using a Software Transfer Agreement (STA) form:
If for whatever reason you cannot access the CLS to issue your licenses immediately, we can perform this for you the "old fashioned" way. To do so, please complete a Software Transfer Agreement (STA) form and fax it back to the number you’ll find at the bottom. Once reviewed and processed, AGI will issue the license for you.
The "Issue" workflow within AGI's Customer Licensing System (CLS) is where you need to be for first-time generation of a license file for "pending" products that are not yet tied to a machine, dongle or server. Once the purchase is complete and the products are entered into our records, the CLS Account Administrator or any Authorized User(s) designated by that Account Administrator should do the following:
Log in with your e-mail address, CLS password and CLS account number.
Verify your account information for accuracy and change your password for security reasons.
On the screen that follows, click "No, Take Me to Licensing".
Click "Get Licenses".
Click "Issue Licenses".
On Screen 1 – Select Licenses, the screen will present all STK licenses that are pending and ready to issue. Click the checkbox next to each product you wish to issue to a particular machine, network or dongle. If you are issuing products to more than one machine, network or dongle, each license set will need to be issued in separate workflows.
Once your selections are complete, click "Issue these [License Type] licenses".
On Screen 2 – Enter Information, from the drop-down boxes, choose your current STK version and Operating System (OS) platform. Enter your machine Host ID, scroll to the bottom of the screen, and click the checkboxes to accept the Software Transfer Agreement terms.
On Screen 3 – E-Mail Licenses, decide who should receive the e-mail containing the actual STK license set(s) and installation instructions and edit the default e-mail text if appropriate. When finished, click "Next".
On Screen 4 – Complete, verify that the information is correct, and then click the checkbox at the bottom of the screen to accept the Licensing Agreement.
Click "Issue Licenses" to complete the process.
If this is not your first time logging in to the CLS:
Follow Steps 1 and 2 above.
From the CLS "Home" page, choose "Get Licenses", or:
Choose "Get Licenses" "Issue Licenses" from the black menu bar at the top of any screen.
Lost or corrupted license files, or the dreaded hard drive crash and rebuild, are examples of situations that might require a user to request the same license file again. In this case, the "Reissue Licenses" workflow is where you want to be. As long as your STK products have current maintenance (i.e. up-to-date Annual Support and Upgrade Agreements [UGA/UGR]), reissuing a license takes just a minute or two and the resulting license file is then e-mailed promptly.
If you are the CLS Account Administrator or an Authorized User(s) designated by that Account Administrator, complete the following steps to reissue your STK license file.
Log in with your e-mail address, CLS password and CLS account number.
Verify your account information for accuracy and change your password for security reasons.
On the screen that follows, click "No, Take Me to Licensing".
Click "Get Licenses".
Click "Reissue Licenses".
On Screen 1 – Select Host ID, select the required Host ID from the drop-down menu, then click "Next".
On Screen 2 – Enter Information, all licenses that have been issued to that Host ID will be selected. You may exclude any of these licenses in your reissued license file by unchecking the selection box. Once finished, click "Next".
On Screen 3 – E-Mail Licenses, decide who should receive the e-mail containing the actual STK license set(s) and installation instructions and edit the default e-mail text if appropriate. When finished, click "Next".
On Screen 4 – Complete, verify that the information is correct, and then click the checkbox at the bottom of the screen to accept the Licensing Agreement.
Click "Reissue Licenses" to complete the process.
If this is not your first time logging in to the CLS:
Follow Steps 1 and 2 above
From the CLS "Home" page, choose "Get Licenses", or:
Choose "Get Licenses" "Reissue Licenses" from the black menu bar at the top of any screen.
STK products can be licensed to any of the following license types:
Nodelocked: A license tied to a specific machine based on that machine's Host ID (aka Physical or MAC Address). Nodelocked licenses will run only on the machine for which they were generated.
Network: Floating licenses that can be used by any machine that has access to a particular network server. STK network licenses are issued as a set of two (2) license files, including: a server license that will reside on the network server itself, and a client license that will be installed on each workstation that will then access that server.
Dongle: A license tied to the unique identifier (called a "FlexID") of a small, portable parallel port (PP) or USB hardware device. The dongle license file is installed onto any number of computers, but only the computer to which the physical dongle is actually connected can run the software at any given time.
Network-Dongle: A license similar to the dongle license type above; the difference being that the dongle is attached to a network server and the licenses tied to its FlexID are network licenses that can contain more than one product seat.
Your computer's Host ID (aka Physical or MAC Address) is a relatively unique identifier based on your computer’s network adapter (NIC) card. To locate your computer's Host ID, first open a command prompt ("Start" "Run", type "cmd" and press "Enter"). From that command prompt, type "ipconfig /all" (without the quotes), and press "Enter". Scroll through the data that displays and look for the "Ethernet Adapter Local Area Connection" section. There, locate the 12-digit Physical Address. This number, without the dashes, is your Host ID.
Note that especially with laptops that are often docked and undocked, STK licenses tied to Host IDs listed in the "Wireless Connection" section are generally less stable than licenses tied to Host IDs in the "Ethernet Adapter Local Area Connection" section. Therefore, and whenever possible, it is best to avoid using the Host ID found in the Wireless Connection section.
Actually, the shorter answer to that question is, what STK software products CAN’T I license using the CLS.
Because of their complexity and/or site-specific usage, among other things, the following is a list of products that cannot be licensed via the CLS. Some, however, will appear in CLS product reports, allowing you to view their current status (i.e., how many licenses are owned, where those licenses reside, etc.). Specifics on how to receive each of these licenses are included in the descriptions below as they differ, depending on the product.
AGI Components
For all AGI Components licensing requests, please visit our AGI Developer Network (ADN) at http://adn.agi.com. Once there, choose the “Licensing Center” tab and follow the on-screen instructions.
STKEngine (“4DX” in STK v8 and prior)
To license 4DX development and deployment products (version 8 and prior), as well as STK Engine Runtimes, please contact AGI Product Support at support@agi.com, or at 1-800-924-7244 and any of our Support Engineers will be happy to help.
Enterprise Licenses
Enterprise licenses are site-specific. When you are ready to receive your Enterprise license set, please contact AGI Product Support at support@agi.com or at 1-800-924-7244 and any of our Support Engineers will be happy to help.
Rental Licenses
Currently, the CLS can be used to license paid, permanent products only. Because Rental licenses are temporary licenses of a finite duration, they must be generated through AGI Product Support at support@agi.com, or at 1-800-924-7244.
Orbital Determination (“OD”) - Network versions prior to 6.0
Orbital Determination (“OD”) nodelocked, dongle, and network (versions 6.0 and up) licenses are available to license online. For OD network licenses prior to 6.0, please contact AGI Product Support at support@agi.com, or at 1-800-924-7244.
STK EDU (AGI Educational Alliance Program)
All Educational licensing requests are processed through the EDU section of our AGI website at http://www.agi.com/edu. Once there, choose the “Educational Licenses” tab and enter the information provided to you at the time of your contract renewal for the current academic year.
Older Version STK
Please contact AGI Product Support at support@agi.com, or at 1-800-924-7244, for all STK v4.x licensing requests.
SATSOFT
For single user (nodelocked) licenses, start SATSOFT and select Help / License Manager if the License Manager dialog does not open automatically. Click on Request Key, and then Register by e-mail. If you don't have a mail client on your machine, e-mail the Reference Code to support@satsoft.com. They will send you a key by e-mail. Be sure to include your name, organization, telephone number, and serial number in the body of the e-mail. You will find the serial number on written on the CD label.
Weather Sentinel
Please contact AGI Product Support at support@agi.com, or at 1-800-924-7244, for all Weather Sentinel licensing requests.
On active STK software products (i.e. those with up-to-date Annual Support and Upgrade Agreements [UGA/UGR]), AGI's Customer Licensing System (CLS) will allow you to perform the following license management tasks:
Issue: First-time generation of a license file for "pending" products that are not yet tied to a machine, dongle, or server.
Reissue: Subsequent generation of a license file issued at least once before. Reissues are common when a license file has been misplaced or corrupted, for example.
Transfer: Moving a license file from one computer or network server to another. AGI's Software Licensing Agreement (SLA) allows for a maximum of three (3) transfers for any given product, as long as all previously existing copies of the STK software, including associated license files(s), have been destroyed.
Upgrade: Generation of a license file incremented to a newer version. Note that STK licenses are generated at the #.0 version. So, for example, STK version 8.0 licenses will run STK version 8.1 or version 8.1.3, and so on.
Expired: Use this link to view your STK products that have fallen out of maintenance and are no longer active within the CLS.
The CLS allows you to view and manage your active STK products (i.e. those with up-to-date Annual Support and Upgrade Agreements [UGA/UGR]). If the CLS does not list products you expect to see when viewing your products by Host ID or by Product type, choose "View Products" from the black menu bar at the top of any CLS screen, and then choose "View Expired Products". It might be that the products you need have expired maintenance. If so, the AGI Renewal Team can work with you to get expired products active and available. Feel free to contact them at renewal@agi.com or at 1.800.731.0244.
If you are in a licensing workflow and the available products are not as you expect, first be certain you are in the correct workflow for the task you wish to perform. For example, the "Issue Licenses" workflow is used to issue pending licenses for the very first time. Once a license is generated and in use, it will no longer show through that path, but rather through the "Reissue Licenses" workflow. Also note that there are certain license types—such as network dongles and redundant triad or failover server configurations—and software products—such as 4DX, PODS, SATSOFT and Weather Sentinel—that can be viewed through "View Products" but cannot be issued through CLS workflows. Please feel free to contact AGI Product Support at support@agi.com, or at 1.800.924.7244 for these types of licensing questions.
Save your license file from your email to a temporary location that will be accessible to the workstation on which the AGI software will be run, such as your computer's "Desktop". Be certain that the license file extension remains ".lic" otherwise STK will not recognize the file as a license.
Open the License Manager tool.
License Manager is automatically launched if STK doesn't find a valid license.
License Manager may also be found under the AGI Support Tools from the Windows Start menu.
Select the "Install Licenses" tab and click on the ellipsis (...) button. Navigate to the saved license file. Select the file and click "Open".
Your licenses should automatically be placed into the Primary License folder. You may also optionally use the Manage tab to designate a different folder as the Primary, etc.
You may now exit the License Manager and begin using AGI software.
STK network licenses are issued as a set of two (2) license files, including: a server license that will reside on the network server itself, and a client license that will be installed on each workstation that will then access that server.
For the Network Server License (Version 7 and above)
On the intended license server, ensure that you have run the AGI License Server Setup. This installation is at the root level of the STK CD-ROM. If the CD-ROM uses drive letter D: then the file address would be D:\AGI_License_Server\Windows\setup.exe.
Save your network server license file from your email to the licenses directory on the server machine. The default location is C:\Program Files\AGI\AGI License Server\Licenses.
Start the AGI License Server Windows Service using LMTools.exe.
Run lmtools.exe from C:\Program Files\AGI\AGI License Server folder.
On the first tab, "Service/License File", click the "Using Services" radio button.
Go to the "Start/Stop/Reread" tab and click "Start Server".
Verify that the server is configured correctly as follows.
Run LMTools.exe.
Go to the "Service/License File" tab and click "Config using Services".
Go to the Server Status tab and click "Perform Status Enquiry".
For the network client license file
Save your network client license file (client.lic) into a default license directory.
PC: C:\Program Files\AGI\LicenseData or C:\Documents and Settings\All Users\Application Data\AGI\LicenseData
UNIX: \usr\agi\licenses
Note: PC Users may optionally use the License Manager to "Load" a license file from any file location. License Manager will automatically launch when STK is run without a license.
There are various reasons why an STK license may fail. The good news is that most are easily resolved. If your STK license is not behaving as expected, please check the following:
Does the license file end in the .lic extension? One of the most common reasons for an STK license to fail is when an unexpected license extension is inadvertently appended to the file. This is especially common when the license has been viewed in a text editor, such as WordPad, which can append the file with a .txt extension.
Are there old, outdated licenses in your license folder? Old or obsolete license files, such as expired evaluations or even client license files that point to servers no longer in use, can cause unexpected behavior and/or sluggish STK product launches. It is always wise to rename, or remove entirely, any outdated license files before installing the new ones.
Does your computer's Host ID match the Host ID in the license file? Nodelocked licenses will run only on the machine for which they were generated. From a Windows computer, choose "Start" "All Programs" "AGI Support Tools" "License Manager", and then highlight your product version and click "Select AGI Application". Next, click on the "Install Licenses" tab. Then, click once to highlight your license file which you will see in the "Installed Licenses" section of that screen. Your licensed products should now be listed in the "License Status" box. If they are red, rather than green and happy, the License Status window will also display a FlexLM error code. FlexLM error = -9 indicates a Host ID mismatch. The "Info" section at the bottom of the License Manager screen displays the Host ID STK expects.
There are various reasons why an STK network license may fail.
Have you installed the AGI License Server software on your network server? If this is a new network license install, be certain you have run the AGI License Server Setup. This installation is at the root level of the STK CD-ROM and must be performed on the server itself. If the CD-ROM uses drive letter D: then the file address would be D:\AGI_License_Server\Windows\setup.exe.
Have you altered the text of the license file(s)? STK network licenses are based on both the server’s Host ID (encrypted field) and either the server's IP Address or Hostname (unencrypted field). Because it is an unencrypted field, the IP Address / Hostname field in STK network license files is often generated with generic information which can then be edited on the user's end. Users may also add a port designation in the license file if appropriate. But even an extra space inadvertently added in the wrong place can corrupt a license file. So, double-check that the server line in the client license file matches exactly the server line in the server license file, and be certain that only the IP Address / Hostname field or ending port designation was altered.
Example (typical network license server line as issued by AGI with generic IP Address/Hostname field):
SERVER ipaddress.goes.here 123456789cae
Generic IP Addresses, such as above, must be edited to the true IP Address or Hostname before installation.
Example (network license server line now including true server Hostname field and with optional port designation):
SERVER aerolab 123456789cae 1026
Remember that if you edit an STK network license file, the server line must match exactly in both the server and the client license files.
Is your company's network server down? If possible, one way to quickly tell if a network client license is failing due to a communication block between your machine and your organization's network server is to "ping" your server's IP Address from a command prompt on your workstation. A successful response means back and forth communication is open and established between you and your network. If the response is unsuccessful, the problem may be internal, making it wise to contact your company's IT Department directly before contacting AGI Product Support.
Was your network license working yesterday, but does not work today? If your network license was working just fine, then one day stops working, chances are the problem is internal rather than a licensing issue. In such cases, again it is wise to contact your company's IT Department directly before contacting AGI Product Support.
"Run", type "cmd" and press "Enter"). From that command prompt, type "ipconfig /all" (without the quotes), and press "Enter". Scroll through the data that displays and look for the "Ethernet Adapter Local Area Connection" section. There, locate the 12-digit Physical Address. This number, without the dashes, is your Host ID.