The information on this page refers to License Statistics v6.5 or newer, which introduced Reservation reports. If you are using an earlier version of License Statistics, please refer to the documentation for releases prior to v6.5.

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 UTF-8 encoded XML file that License Statistics can read and understand. In this way, virtually any licensing system can communicate with the License Statistics graphing engine. 

See Adding and editing license servers for information about adding a custom license server to License Statistics.

License Statistics will read your XML file at each update interval. 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 Linux. 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: 

Important:

  1. USED_LICENSES and DENIED_LICENSES have to be located in separate USER entries.
  2. All dates and times must be in the format specified for the variable in the list above.
  3. Only one VENDOR name can be used.

An example of the content for a custom parser XML file is given below. 

<CUSTOM_STAT VENDOR="custom_testdev">
  <USAGE FEATURE="App1" VERSION="12.3" USED_LICENSES="2" TOTAL_LICENSES="100" BORROWED_LICENSES="1" RESERVED_LICENSES="10" SHARE="TEST" EXPIRES="2020-11-20">
    <USER USERNAME="user1" HOSTNAME="host1" IP="127.0.0.1" USED_LICENSES="1" CHECKOUT_TIME="2020-05-07 08:41"/>
    <USER USERNAME="user2" HOSTNAME="host2" IP="127.0.0.1" USED_LICENSES="1" BORROW_EXPIRE_TIME="2012-05-07 08:43" CHECKOUT_TIME="2012-05-07 08:41"/>
	<RESERVATION REMAINING="10"/>
  </USAGE>
  <USAGE FEATURE="App2" VERSION="1.0" USED_LICENSES="1" DENIED_LICENSES="1" TOTAL_LICENSES="UNLIMITED" RESERVED_LICENSES="4" EXPIRES="permanent">
    <USER USERNAME="user1" HOSTNAME="host1" IP="127.0.0.1" USED_LICENSES="1" CHECKOUT_TIME="2012-05-07 08:41"/>
    <USER USERNAME="user1" HOSTNAME="host1" IP="127.0.0.1" DENIED_LICENSES="1" CHECKOUT_TIME="2012-05-07 08:41"/>
	<RESERVATION TYPE="USER" PATTERN="user1" TOTAL="5" REMAINING="4"/>
    <RESERVATION TYPE="HOST" PATTERN="host1" TOTAL="1" REMAINING="0" EXPIRES_AT="2012-01-01 00:00" />
    <RESERVATION TYPE="IP" PATTERN="127.0.*.*" TOTAL="1" REMAINING="0" SINCE="2012-01-01 00:00" EXPIRES_AT="2013-01-01 00:00" />
  </USAGE>
</CUSTOM_STAT>

It is important to understand that you validate all XML structure against the following XSD schema:

<xs:schema elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:simpleType name="xfDate">
        <xs:restriction base="xs:string">
            <xs:pattern value="\d{4}-\d{2}-\d{2}"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="xfDateTime">
        <xs:restriction base="xs:string">
            <xs:pattern value="\d{4}-\d{2}-\d{2} \d{2}:\d{2}"/>
        </xs:restriction>
    </xs:simpleType>

    <xs:element name="CUSTOM_STAT">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="USAGE" minOccurs="0" maxOccurs="unbounded">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:sequence>
                                <xs:element name="USER" minOccurs="0" maxOccurs="unbounded">
                                    <xs:complexType>
                                        <xs:simpleContent>
                                            <xs:extension base="xs:string">
                                                <xs:attribute type="xs:string" name="USERNAME"/>
                                                <xs:attribute type="xs:string" name="HOSTNAME"/>
                                                <xs:attribute type="xs:string" name="IP"/>
                                                <xs:attribute type="xfDateTime" name="CHECKOUT_TIME" use="required"/>
                                                <xs:attribute type="xfDateTime" name="BORROW_EXPIRE_TIME"/>
                                                <xs:attribute type="xs:nonNegativeInteger" name="USED_LICENSES"/>
                                                <xs:attribute type="xs:nonNegativeInteger" name="DENIED_LICENSES"/>
                                            </xs:extension>
                                        </xs:simpleContent>
                                    </xs:complexType>
                                </xs:element>
                            </xs:sequence>
                            <xs:sequence>
                                <xs:element name="RESERVATION" minOccurs="0" maxOccurs="unbounded">
                                    <xs:complexType>
                                        <xs:simpleContent>
                                            <xs:extension base="xs:string">
                                                <xs:attribute type="xs:string" name="TYPE"/>
                                                <xs:attribute type="xs:string" name="PATTERN"/>
                                                <xs:attribute type="xs:nonNegativeInteger" name="TOTAL"/>
                                                <xs:attribute type="xs:nonNegativeInteger" name="REMAINING" use="required"/>
                                                <xs:attribute type="xfDateTime" name="SINCE"/>
                                                <xs:attribute type="xfDateTime" name="EXPIRES_AT"/>
                                            </xs:extension>
                                        </xs:simpleContent>
                                    </xs:complexType>
                                </xs:element>
                            </xs:sequence>
                        </xs:sequence>
                        <xs:attribute name="FEATURE" use="required">
                            <xs:simpleType>
                                <xs:restriction base="xs:string">
                                    <xs:minLength value="1"/>
                                </xs:restriction>
                            </xs:simpleType>
                        </xs:attribute>
                        <xs:attribute type="xs:float" name="VERSION"/>
                        <xs:attribute type="xs:nonNegativeInteger" name="USED_LICENSES"/>
                        <xs:attribute type="xs:nonNegativeInteger" name="DENIED_LICENSES"/>
                        <xs:attribute type="xs:nonNegativeInteger" name="RESERVED_LICENSES"/>
                        <xs:attribute type="xs:nonNegativeInteger" name="BORROWED_LICENSES"/>
                        <xs:attribute type="xs:string" name="TOTAL_LICENSES"/>
                        <xs:attribute type="xs:string" name="SHARE"/>
                        <xs:attribute name="EXPIRES">
                            <xs:simpleType>
                                <xs:union memberTypes="xfDate">
                                    <xs:simpleType>
                                        <xs:restriction base="xs:string">
                                            <xs:enumeration value="permanent"/>
                                            <xs:enumeration value=""/>
                                        </xs:restriction>
                                    </xs:simpleType>
                                </xs:union>
                            </xs:simpleType>
                        </xs:attribute>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
            <xs:attribute name="VENDOR" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:minLength value="1"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
        </xs:complexType>
    </xs:element>
</xs:schema>