Grace Licensing Monitor

Citrix.PresentationServer.GracePeriodLicensing.Monitor (UnitMonitor)

Monitors and reports when a Citrix server attempts to enter grace period licensing state due to a licensing error

Knowledge Base article:

Citrix^® Management Pack

Summary
A computer running Citrix Presentation Server has lost contact with a license server and has entered a licensing grace period. An alert is raised when a grace license has been requested due to a failure to obtain a valid license and this grace request has been rejected.

Causes
When contact with a license server is lost, the computer running Citrix Presentation Server lapses into a licensing grace period. Typically, the licensing grace period is 30 days. During this period, the Citrix Presentation Server software is fully functional and connections to the server work normally. Contact with the license server must be reestablished before the grace period ends, or the next licensing grace request will get rejected and software will be reduced automatically to single user mode and only the administrator can log on to the server.

Resolutions
Ensure the license server is running and operational. Use the License Management Console to check the licenses that are available. If your installation contains different products or servers with different product codes, for example Enterprise Edition and Advanced Edition, ensure that there are sufficient licenses available for the number of users of each type of server. If there are insufficient licenses available, consider the following. If you have assigned licenses to a specific server, consider unassigning them to increase the number of licenses available for other servers. If you have more than one license server installed in your enterprise, consider combining licenses on these license servers to make them available to all servers in your enterprise. Purchase more licenses and add them to your license server.

External Knowledge Sources
The following source of information can be helpful when dealing with this alert: Citrix Presentation Server Administrator's Guide - English Citrix Licensing Guide - English

Element properties:

Target

Citrix.PresentationServer.ManagedServer

Parent Monitor

Citrix.PresentationServer.Licensing.AvailabilityState

Category

AvailabilityHealth

Enabled

True

Alert Generate

True

Alert Severity

MatchMonitorHealth

Alert Priority

Normal

Alert Auto Resolve

True

Monitor Type

Microsoft.Windows.3SingleEventLog3StateUnitMonitorType

Remotable

True

Accessibility

Public

Alert Message

Grace license request has been rejected.

Error \%1 received while obtaining a license for a Citrix Presentation Server client connection. The license request has been rejected.

RunAs

Citrix.PresentationServer.CitrixAdministratorAccount

Source Code:

<UnitMonitor ID="Citrix.PresentationServer.GracePeriodLicensing.Monitor" Accessibility="Public" Enabled="true" Target="Citrix.PresentationServer.ManagedServer" ParentMonitorID="Citrix.PresentationServer.Licensing.AvailabilityState" Remotable="true" Priority="Normal" RunAs="CtxLibrary!Citrix.PresentationServer.CitrixAdministratorAccount" TypeID="Windows!Microsoft.Windows.3SingleEventLog3StateUnitMonitorType" ConfirmDelivery="false">

  <Category>AvailabilityHealth</Category>

  <AlertSettings AlertMessage="Citrix.PresentationServer.GracePeriodLicensing.Monitor.AlertMessage">

    <AlertOnState>Error</AlertOnState>

    <AutoResolve>true</AutoResolve>

    <AlertPriority>Normal</AlertPriority>

    <AlertSeverity>MatchMonitorHealth</AlertSeverity>

  </AlertSettings>

  <OperationalStates>

    <OperationalState ID="Error" MonitorTypeStateID="FirstEventRaised" HealthState="Error"/>

    <OperationalState ID="Warning" MonitorTypeStateID="SecondEventRaised" HealthState="Warning"/>

    <OperationalState ID="Success" MonitorTypeStateID="ThirdEventRaised" HealthState="Success"/>

  </OperationalStates>

  <Configuration>

    <FirstComputerName>$Target/Host/Property[Type='Windows!Microsoft.Windows.Computer']/PrincipalName$</FirstComputerName>

    <FirstLogName>System</FirstLogName>

    <FirstExpression>

      <And>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery>EventDisplayNumber</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value>9027</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery>PublisherName</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value>MetaFrame</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

      </And>

    </FirstExpression>

    <SecondComputerName>$Target/Host/Property[Type='Windows!Microsoft.Windows.Computer']/PrincipalName$</SecondComputerName>

    <SecondLogName>System</SecondLogName>

    <SecondExpression>

      <And>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery>EventDisplayNumber</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value>9026</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery>PublisherName</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value>MetaFrame</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

      </And>

    </SecondExpression>

    <ThirdComputerName>$Target/Host/Property[Type='Windows!Microsoft.Windows.Computer']/PrincipalName$</ThirdComputerName>

    <ThirdLogName>System</ThirdLogName>

    <ThirdExpression>

      <And>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery>EventDisplayNumber</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value>9016</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery>PublisherName</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value>MetaFrame</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

      </And>

    </ThirdExpression>

  </Configuration>

</UnitMonitor>