New Eagle Licensing in Automation Environment
The New Eagle License Viewer is a tool that controls the licensing for New Eagle software product, and is installed with anyone of our software products. A desktop application is available for typical use cases, and a CLI is available for automation environments. Typical use cases include refreshing a license and and requesting a license. The CLI is currently unable to activate a license.
For more information on using the GUI of the New Eagle License Viewer, please visit our Raptor Licensing page.
Command Line Interface
New Eagle License Viewer Editor can be interfaced via the windows command prompt or power-shell. This is useful for automation environments where it's beneficial to ensure proper New Eagle licensing for an automation server.
This program is available in the start menu in the NewEagle folder or can be found using the start menu search bar. The following figure shows the New Eagle License Viewer from the start menu search bar.
The following figure shows how to determine the installation location for the New Eagle License Viewer. Select Open file location. This will take you to the location of the shortcut for the start menu. Right click on the shortcut for New Eagle License Viewer, then select Open file location. This will take you to the installation folder for Raptor-Dev. This is the path by which you will need to execute the Raptor Configuration Editor in the command line.
Request Activation Code
The following figure shows the New Eagle License Viewer in the desktop application, without a valid license activated. In an automated environment the user can request an activation code through the CLI to populate the fields shown in Window 2 of the figure.
In an automation environment we can automate this request by performing the following in a command prompt or powershell. If the request is successful, meaning the request was able to be sent, then Success will print out to the console. However, this isn't valid to enough to determine if the operation was successful in an automation environment, so check the return code using %ERRORLEVEL% in your batch script logic.
C:\Program Files (x86)\NewEagle\Licensing>NewEagle.LicenseViewer.exe REQUEST MARSHAL NEWEAGLE mstewart@neweagle.net 123-456-7890 TEST
Success
C:\Program Files (x86)\NewEagle\Licensing>echo %ERRORLEVEL%
0Refresh Current License
The following figure shows the desktop application for the Raptor License Viewer with a valid license activated. In the desktop application, we can refresh the license by clicking Update License Online.
In an automation environment we can automate this refresh by performing the following in a command prompt or power-shell. If the refresh is successful, meaning the refresh was able to be sent, then Success will print out to the console. However, this isn't valid to enough to determine if the operation was successful in an automation environment, so check the return code using %ERRORLEVEL% in your batch script logic.
C:\Program Files (x86)\NewEagle\Licensing>>NewEagle.LicenseViewer.exe REFRESH
Success
C:\Program Files (x86)\NewEagle\Licensing>echo %ERRORLEVEL%
0CLI Help Printout
The following is the HELP string printout from Raptor_2024a_1.0.15384.
NewEagle.LicenseViewer is a tool that controls the licensing for New Eagle software products, and is installed with anyone of those
software products. A GUI is available for typical use cases, CLI is available for automation environments.Typical usecases include
refreshing a license and requesting a license. The CLI is currently unable to activate a license.
Usage: NewEagle.LicenseViewer.exe[REFRESH|REQUEST|HELP][<args>]
REFRESH:
Performs the same action as Update License Online, through the GUI. Retrieve an updated license from New Eagle servers.
Usage: >>NewEagle.LicenseViewer.exe REFRESH
REQUEST:
Performs the same action as Request License, through the GUI.Requests a license from New Eagle servers. Requires user information to complete the
request.The COMMENTS field is optional.
Usage: >>NewEagle.LicenseViewer.exe REQUEST NAME COMPANY EMAILADDR PHONE [COMMENTS]
HELP:
Prints this help message.
Usage: >>NewEagle.LicenseViewer.exe[HELP|/H|?]