Licensing and Installation

Tips & Tricks

Back to Tips & Tricks

Instrument Manager™ (IM) License Number

Every base Instrument Manager system has a license number tied to the system. The license number can be found in the bottom left hand corner of your Instrument Manager screen. It can also be found under the license report in the Reports Tab > License Information and the Help > About Instrument Manager. The license report contains valuable information such as licensed number of connections, End User Workstations, and features of IM. Your IM License number is required when logging tickets with Customer Support.


License Files and Installation

There are two license files required for an Instrument Manager system to launch after the installation is complete. License files are “shipped” virtually through the Data Innovations Production department and will arrive by email. Within the shipped files a customer will receive a License.cache file, Cache.key file, and IM-License.rpt file. Upon installation of the Instrument Manager software, the License.cache and Cache.key files are placed in specific folders. Instrument Manager will fail to start if license files are not placed in the appropriate directories.


Cache.key file is placed on the Instrument Manager server in the x:\Intersystems\Cache\mgr folder where the Intersystems Caché application is installed.

License.cache file is placed on the Instrument Manager server in the x:\Instrument Manager folder where the Instrument Manager application is installed. In both cases, x:\ indicates the installation drive for that directory, which is often C:\ or D:\.

With versions 8.16 and higher, no restart of Cache is necessary if no new features are added to the new license. This requires specific steps to accomplish and are documented in the Getting Started Setup Guide. Otherwise follow the proper shut down procedure for IM and restart Cache.

A customer will have separate license files for test and production systems. Customers with High Availability or Disaster Recovery system will share the same license files on each server.

NOTE: License files can be labeled expiring or perpetual in relation to financial milestones. You should contact your assigned implementation resource or sales representative if you receive a pop-up warning of an expiring Instrument Manager license.


IM Software Key

Once license files are in place, assuming that this system did not previously have a valid IM Software key and the license number has not changed between files, a customer must activate Instrument Manager using a software key. New or upgraded license files are shipped with a 90-day activation key in text file format that allows the application to run. A permanent key must be requested by the customer and requires 5 days to process, so plan accordingly. The permanent software keys tie together the installation of an Instrument Manager system with specified hardware and computer name. Temporary keys are installed, and permanent activation key requests are gathered using the “IM Security Key Installer.exe” found in the root Instrument Manager folder on the server where IM is installed. Each server where IM is installed must have its own individual permanent key requested.

For example, a customer with an IM Test System, Prod System, and High Availability without Disaster Recovery would request three permanent keys, one from each of the three servers.

An invalid or expired software key will prevent the QMGR connection inside of Instrument Manager from moving to an ON status. You may also see errors increment on the QMGR connection.


As a customer you may receive a pop up when launching Instrument Manager warning of an expiring software activation key if a valid permanent key is not in place.


Installation and request steps for the software activation key can be found in the Instrument Manager Installer’s Guide available for download on the Customer Web Portal.

NOTE: Laboratory Intelligence and Report servers do not require a software security key.

More Tips & Tricks Articles

Tips & Tricks

TCP/IP Keep-Alive

Data Innovations’ (DI’s) Instrument Manager (IM) offers connectivity that enables integration with virtually any instrument, LIS, or EMR/EHR regardless of...

Instrument Manager, Tips & Tricks

Following Driver Updates in My DI Community

Overview

Data Innovations (DI) provides ways to stay up to date on the latest driver updates.The first way is right through...

Instrument Manager, Tips & Tricks

Net Gateway Startup Issues (Error 5023)

Overview

When IRIS and Instrument Manager (IM) are starting after a server shuts down or restarts, the .NET gateway is not...

Tips & Tricks

How to Install Instrument Manager™ Core Software

NOTE These instructions apply for Data Innovations’ North American customers. If this is your first time installing IM, please contact Data...

Tips & Tricks

How to help Data Innovations help you when requesting Support

Data Innovations' Tips & Tricks are intended to promote the effective and productive use of Instrument Manager. Fortunately, Instrument Manager...

Tips & Tricks

Evaluation Rules for Clinical Ranges Precaution

When building an Autoverification Rule Set it's common to include evaluation rules for Clinical Ranges. These rules typically set test...

Tips & Tricks

Instrument Manager System Preventative Maintenance (volume 1)

Instrument Manager is a robust software application with a proven track record of operational stability. However, as with any software...

Tips & Tricks

Instrument Manager System Preventative Maintenance (volume 2)

This month's Tips & Tricks is the second installation of Preventative Maintenance recommendations intended to help you maintain a stable...

Ready to learn more?