Known Issues for SySAM Licensing

Descriptions of known issues and workarounds for SySAM licensing. These issues affect users who generate the license file from either SPDC or SMP.

SySAM licensing issues
CR# Description
683936
  • Receiving e-mail notifications about SySAM licensing – When you configure SAP Sybase IQ to send an e-mail notifications about SySAM licensing failures, the e-mail messages do not contain HELO tokens, which some SMTP mail servers require to process messages correctly.
  • Workaround – If your SMTP server requires such a HELO token, append the email.helo.fqdn property to the SySAM property file. The property value should be the fully qualified domain name, such as:

    email.helo.fqdn=sybase.com

    The SySAM properties file is located in the $SYBASE/IQ-16_0/Sysam directory and is named servername.properties, where servername is the name of your server.
670991
  • An incorrect CPU count may occur on AIX servers – Client connections to an AIX server may occasionally fail when the server performs periodic CPU license checks. This can sometimes result in an incorrect CPU count.
  • Workaround – If you find that CPU counts are no longer correct, use this command to reset the SYBASE_SAM_CPUINFO environment variable that controls the license counting mechanism:

    Set SYBASE_SAM_CPUINFO=ORIGINAL

656959
  • CPU count incorrect on IBM AIX with POWER7 processors – SAP Sybase IQ may incorrectly count more cores than are actually present on AIX POWER7 systems when Simultaneous MultiThreading (SMT) is greater than 2 per core. This may result in the SAP Sybase IQ server not starting due to licensing problems or the server may start in grace mode.
  • Workaround – Turn off hyperthreading, configure SMT equal to 2 per core, or contact SAP Sybase Technical Support.
669653
  • License server reports wrong number of available licenses – When a product requires multiple licenses and the license server has insufficient licenses available to satisfy its needs, the failure message reported by the product does not show the correct amount that were available (that the product could obtain). For example, there are 5 license in a SySAM server, 3 are in use by other host, so only 2 licenses can be obtained. But SySAM will report wrong message "Insufficient IQ_CORE licenses. SAP Sybase IQ requires 4 IQ_CORE licenses but only 5 could be obtained."
  • Workaround – There is no current workaround. SAP Sybase is aware of the problem and will address the issue in a future release.
628596, 628403
  • Licensing behavior in a virtual environment – SAP Sybase IQ cannot be installed or fails to start in a virtual environment and reports an error similar to the following:
    Cannot determine the total number of processor cores on
    the machine from within this virtual system. The IQ_CORE
    ("DH") license type is restricted for use on a machine
    with a maximum of 4 processor cores regardless of
    whether the virtual system is limited to use fewer
    processor cores. You need to run 'sysamcap' on the
    physical machine (or virtual-machine/partition control
    domain) and set the reported environment variable prior
    to running Installer.
    This error is raised in the following circumstances:
    1. SAP Sybase IQ is running on a virtual system which doesn't have access to the processor counts of the physical machine (this applies to all virtual environments except AIX LPAR and HP-UX vPar).

      and

    2. SAP Sybase IQ is using a license type that is restricted for use to a machine with no more than a specific number of processors (for example, SAP Sybase IQ Single Application Server Edition cannot be used on a machine with more than 16 processor cores, ASE Small Business Edition cannot be used on a machine with more than 2 processor chips).

  • Workaround – Run the sysamcap DEFAULT command on the physical machine or control domain for the virtualization technology (for example, VMware ESX console, or XEN dom0), then set the environment variable reported prior to running the product or product installer. The process is described in the SySAM Sub-capacity Licensing section of the SySAM Users Guide.
628594
  • SySAM Licensing Checkout – If SAP Sybase IQ was licensed using a per-processor license type in previous releases, the license quantity was determined at startup. In this release, SAP Sybase IQ periodically checks for the number of processors it can use and attempts to check out additional licenses for any increase. SAP Sybase IQ shuts down after 30 days, if additional licenses are not made available within this period. See the SySAM Users Guide for details regarding license grace.
Related concepts
Known Issues for Installation and Configuration
Known Issues for SAP Sybase IQ Operations
Known Issues for Interactive SQL
Known Issues for Multiplex Environment
Related reference
Restrictions