HOME > SUPPORT > LICENSE INSTALLATION

License Installation

 

The ReportMill evaluation is a fully functional, never-expiring, final version of ReportMill. It simply adds a watermark to generated reports in its unlicensed form. To eliminate the watermark, simply install a valid license key.

License keys need to be installed for the user account that executes the deployed application. This is frequently different than the developer account and may be one of the common administrator accounts ("administrator", "root", "nobody"). If you are unsure which user is running the deployment application, you can find the ReportMill warning that is printed (to the console or standard out) for unlicensed frameworks:

  • Initializing ReportMill (Build Date: Feb-11-08, Version 11.0, JVM-1.5.2)
  • Warning: Unlicensed copy of ReportMill for host xxx and user yyy

To install the license key, simply log in as the appropriate user and execute the following command:

prompt> java -cp <jar_path>/ReportMillX.jar com.reportmill.Shell -license <license_key>

For example, for RM11:

prompt> java -cp /ProjectJars/ReportMill11.jar com.reportmill.Shell XXX-XXX-XXX

ReportMill should respond with "License is valid and has been installed on host xxx. for user yyy".

Licensing Programmatically

Alternatively, you can call the method ReportMill.setLicense("<license_key>"), before any other ReportMill code is used. This is the recommended approach for ISV applications, but not for enterprise deployment (where different keys may be required depending on individual deployments).

Similarly, you could call com.reportmill.Shell.main() with a String array, new String() { "-license", "<license_key>" }. This would only need to be called once for a given server, and is equivalent to the above java command.

Licensing the layout application

The developer license simply removes the demo alert panel which appears when you launch the layout application. You can enter your developer license, by selecting the menu Tools->Preferences and clicking the "License" tab. You can also conveniently add your deployment license here as an option to the above method (for cases when a GUI is available).

One Machine, One License

Note, since your license covers CPUs - you may install the license key for any number of users on a single machine. Also, you may re-use a single license key for testing and redundancy machines (ReportMill only charges for actual deployment CPUs).

Trouble Shooting

So far, these steps have worked for all customers. The most common problem is installing the license key for the wrong user account. Be sure and check the warning message discussed above to avoid or fix this. If you have other feedback, please send a note to [email protected].