Problems and Solutions

If the product does not install or does not function after installation, contact SySAM Technical Support.

Error Possible Causes Solution
Installation Warning: Cannot Find a Valid License You may not have the required licenses installed. If there are installed licenses, the licenses may be incorrect for the product or feature you are trying to install.

See Installing for the First Time in the SySAM Users Guide.
Updating an Existing Installation If you are updating an existing installation, make sure your license authorizes you to install the update. See Installing Product Updates, EBFs, and Support Renewal in the SySAM Users Guide. If your license does not allow you to perform the update, the product may not be usable. If you are installing an update that is authorized by the license, see the solution for Product Cannot Checkout a License and Starts in Grace Period error below before you proceed with the update.
License Server Executables and Scripts not Installed When you installed your product, the license server was not installed. Some product installations offer the option to install a license server; however when available, this option is not selected, by default, for installation. You may need to explicitly install a license server. See your product’s installation guide and release bulletin to determine if the product installer offers this option.
Depending on the options provided by your Sybase product’s installation wizard, use one of the following solutions:

  • If your product offers this option, use the instructions in your product’s installation guide to install the license server.

  • If your product does not include the option to install a license server, go to http://www.sybase.com/sysam and click Download the SySAM Standalone License Server – Free!.
License Server Does not Start See Possible Causes of a License Server Failure in the SySAM Users Guide. Go to SPDC or SMP, generate a valid served license for your product, and copy it into the licenses directory on the machine where the license server is installed. See Generating Licenses at SPDC or Generating Licenses at SMP.
License Server Does not Recognize the License Files

  • The license was generated for a different machine or generated using an incorrect host ID.

  • The license has been altered. You cannot change any information in a generated license.

  • If the host ID for your platform is based on the network adapter identification, the most common problem occurs when you have used an ID associated with the address of a virtual network adaptor.

  • Verify that the host ID recorded in the license file matches the host ID of the actual machine for which the license was issued. If the host IDs do not match, go to SPDC or SMP, check in the license, then regenerate the license with the correct host ID.

  • If your license is being created by typing from a paper copy, verify whether errors occurred when the license information was entered. You can also download a new copy of the activated license from SPDC or SMP.

  • If the host ID for your platform is based on a network adapter, verify that the ID you are using is associated with a valid NIC and that the ID is not associated with loopback or virtual adapters. If the ID you are using is associated with a removable network adapter, verify that the adapter is actually attached to the computer.
Linux virtual machine does not appear to be part of the Microsoft Hyper-V host. /usr/sbin/dmidecode in Linux virtual machine cannot read from /dev/mem. Log in to Linux virtual machine as root, then execute chmod 4555 /usr/sbin/dmidecode.
Product Does not Start, License Checkout Error

  • You have not generated and deployed the valid licenses for the product requesting licenses.

  • The required license does not exist and the product does not award a license on grace.

  • The product is configured to use the wrong edition or license type.

  • You have the wrong host ID for an unserved license.

  • When multiple product editions include optional features, the features are offered as separately licensed items for each edition. Licensed optional features work only with the licensed base product of the same edition. For example, if you order Adaptive Server Enterprise, you cannot use a Small Business Edition optional feature license with an Enterprise Edition base product.

  • You are using an unserved Standalone Seat (SS) type license on a terminal server.

  • The license is for a different operating system.

  • The license is a Floating License (FL) but is currently in use elsewhere.

At a command prompt or in a terminal window, execute the following commands, where feature_name is the name of the feature for which SySAM failed to check out a license:

sysam diag feature_name

If the SySAM script is unavailable, enter:

lmutil lmdiag -c license_directory_location feature_name

Go to SPDC or SMP and generate your product’s required licenses. If you are trying to use a separately licensable optional feature you must have a license for both the base product and the option, and if the product has more than one edition, the edition of the base product and option must be the same.

If you generated an invalid license, check in the license at SPDC or SMP, and regenerate the license with the correct information.
Product Cannot Check Out a License and Starts in Grace Period
To help you determine the possible causes when your product cannot check out a license, execute the following command from the SYSAM-2_0/bin directory, at a Windows command prompt or in a UNIX system terminal window, where feature_name is the name of the feature license that could not be checked out. 
sysam diag feature_name
If the command output says that no licenses are available for checkout, this may be due to one of the reasons below, which are separated into served and unserved license deployment model causes and solutions.
 See Served License Deployment Models or Unserved License Deployment Models, both in the SySAM Users Guide.
Product Continues to Run in Grace Period After Fixing a License Problem The license status has not yet been updated. When the product periodically performs license checks, the license status is not immediately updated. Wait up to 6 hours for server products, and up to 1.5 hours for tool products.
Product Cannot Find Licenses for Optional Features You either have not installed the license for the optional feature, or the license exists, but cannot be checked out. See Solution for Problem: Product Cannot Find Licenses for Optional Features in the SySAM Users Guide.
Product Obtains the Wrong License
These locations are searched, in the order specified, until a suitable license is found. When a license directory is specified, license files in that directory are loaded in the directory sort order. When a product looks for a license, it looks in:

  • The locations that represent the values set for the SYBASE_LICENSE_FILE and LM_LICENSE_FILE variables. Sybase does not advocate using environmental variables and recommends that all licenses be located centrally in the expected licenses directory.

  • All files with a .lic extension in the licenses directory. This location is product specific, though typically the directory is $SYBASE/SYSAM-2_0/licenses.

The first license that matches the feature name, version, edition, and license type filter is used; however, this license may not be the intended license your product requested.

  • Configure your product to choose a license for a specific edition and license type.

  • If you are using served licenses, use the options file to ensure that the correct license is used.
License checkout problems with unserved license See Unserved License Deployment Models in the SySAM Users Guide.
License checkout problems with served license See Served License Deployment Models in the SySAM Users Guide.
Parent topic: Troubleshooting SySAM