Requesting and Installing Licenses

Note: this information applies to MULTI versions 4 and 5

Foreword

Many of the host-based tools (i.e. those which run on the host system as opposed to the target embedded system) from GHS require license keys to operate. The product documentation contains detailed information about the licensing models available, as well as how to request, install and use those licenses. This page provides a summary of that information for users that may not have easy access to that documentation. The GHS RTOSes INTEGRITY, velOSity, and μvelOSity require development-time licenses, and in some cases source-code decryption keys, but the information in this document is not relevant to those types of licenses/keys.

All licenses are locked to a “server code”, which is basically a hash of some identifying information about a machine or dongle. Typically, this is something like the hard drive’s volume serial number, an ethernet (MAC) address, or the serial number of a dongle. When the license keys are used, the tools will verify that the server code is valid for the machine loading the keys. In the networked licensing models, only the server validates the server code; for the other models, the tools each validate the server code before running. If the tools are not able to validate the correct server code, they will not run. Sometimes such failures are due to running on the wrong machine or forgetting to install the dongle; in other cases it is possible that the supporting hardware (e.g. ethernet card) is no longer installed or available.

Licensing Models

There are two types of licensing available with MULTI: Legacy and GHS. Most users should use GHS licenses unless they have a good reason to use Legacy licenses. Legacy licenses will normally only be used if support for older versions of MULTI (i.e. older than v4.0.0) is required. Note that Linux platforms do not support Legacy licenses, and all versions of MULTI on Linux use GHS licenses.

There are 4 licensing models available for MULTI:

Requesting Licenses

To request licenses for MULTI, either run the MULTI License Administration tool (which runs automatically if MULTI fails to get a license) or use the licensing site’s license request page. The license keys will be emailed to you, so be sure to provide valid contact information. Enter the information about the machine upon which you wish to use the license keys (be sure to use the license server machine for the networked license models).

If you are using this website, the server code may not be filled in automatically for you. To determine the proper server code, you should run the “servecode” executable from the MULTI installation. If you plan to use Legacy licenses, try running “servecode -l” to get the code; if you plan to use GHS licenses, try “servecode -g”. The alt server code would typically be the server code for the other type of license.

Enter information about the type of licenses you desire and any optional information you wish. A request will be prepared, and will normally be sent automatically to our licensing staff. Users preparing the request with the MULTI License Administrator will have the option of saving the request to a file for later emailing or faxing if desired.

Our licensing staff will review the request, contact you for further information only if necessary, and email you the license keys as quickly as possible. Requests for evaluation licenses from your corporate email account will typically be handled automatically and almost instantaneously.

Installing Licenses

The method for installing licenses depends on the platform and type of licenses.

GHS Licenses, all platforms

Normally, GHS licenses will be installed with the MULTI License Administration tool. From the starting screen, just go down the “Install a license from a file” or “Install a license which I already have” path.

Legacy Licenses, MS Windows

To install Legacy licenses on Windows, you will need to have the “Legacy Licensing Tools” installed. This is normally on the installation CD in the \licensing\legacy folder. Run the setup program to install the tools. Once the tools are installed, you may install the licenses by following the instructions for “GHS Licenses, all platforms” above.

Legacy Licenses, Solaris and HP-UX

To install Legacy licenses on these platforms, you should be able to just save the licenses as they were emailed to you, in the directory where MULTI is installed. The licenses were emailed embedded in a shell script, and you may just run that from a shell to install the licenses.

Finishing the Installation

After installing network-based licenses (i.e. Floating or Named-User), you may need to configure your clients to use the proper server. If you skip this step, the tools will try to do a network broadcast to find a server each time they are run. To eliminate this network traffic and increase reliability, you may set the GHS_LMHOST setting to point to the license server. Typically, you’ll want the value to be @<server hostname>, like @ghslm_server if your server is named ghslm_server. To simplify things, you may use the MULTI License Administration tool to select a server from those found on the network.

Using MULTI

Once the licenses are installed, you should be able to use MULTI normally. If you run into any problems, please contact GHS support.