If you use a different license server than one of those currently supported by License Statistics (see Supported license servers), you can customize License Statistics to run with your specific license server. To run License Statistics with your license server, your parser must write an XML file that License Statistics can read and understand. In this way, virtually any licensing system can communicate with License Statistics' graphing engine.
After you create the custom parser, you must then specify the XML file in the CUSTOM_SERVER setting of the License Statistics configuration file, xflicstat.cfg. You may define multiple custom parser XML files in this section of the configuration file.
You should generate the XML files on a regular, scheduled basis. You can schedule the XML file generation using Windows scheduler for Windows or crontab for Unix. Note that the custom parser is a realtime parser that contains the current state of the license server. When regenerating the XML, replace (do not append to) the previous XML file.
The specifications for the XML file are as follows:
- CUSTOM_STAT, VENDOR, FEATURE and CHECKOUT_TIME specifications are required.
- The VENDOR name must start with "custom_".
- USED_LICENSES reports the total of number of licenses currently in use (including borrowed licenses).
All dates and times must be in the following format: YYYY-MM-DD [HH:MM].
- EXPIRES accepts only a date.
- CHECKOUT_TIME and BORROW_EXPIRE_TIME require both a date and time.
- USER NAME can be omitted if your licensing system does not deliver user names.
- SHARE is for informational purposes, to specify which type of license sharing is in use.
An example of a custom parser XML file is given below.
<CUSTOM_STAT VENDOR="custom_testdev">
<USAGE FEATURE="App1" USED_LICENSES="2" TOTAL_LICENSES="100" BORROWED_LICENSES="1" SHARE="TEST" EXPIRES="2010-11-20">
<USER USERNAME="user1" HOSTNAME="host1" USED_LICENSES="1" CHECKOUT_TIME="2007-03-07 08:41"/>
<USER USERNAME="user2" HOSTNAME="host2" USED_LICENSES="1" BORROW_EXPIRE_TIME="2007-03-07 08:43"/>
</USAGE>
<USAGE FEATURE="App2" USED_LICENSES="3" TOTAL_LICENSES="100">
<USER USERNAME="user1" HOSTNAME="host1" USED_LICENSES="1" CHECKOUT_TIME="2007-03-07 08:41"/>
<USER USERNAME="user2" HOSTNAME="host2" USED_LICENSES="1" CHECKOUT_TIME="2007-03-07 08:43"/>
<USER USERNAME="user3" HOSTNAME="host2" USED_LICENSES="1" CHECKOUT_TIME="2007-03-07 08:42"/>
</USAGE>
</CUSTOM_STAT>