SySAM Troubleshooting

This topic describes possible problems with SySAM licenses.

Read this topic if you experience problems with SySAM licensing. The information might help you resolve the issues, or to collect information that Technical Support can use to diagnose them. You can find more information about SySAM licensing on the SySAM Web site at http://www.sybase.com/sysam and in the SySAM Infocenter at http://infocenter.sybase.com/help/topic/com.sybase.infocenter.help.sysam/title.htm.

Logging SySAM information

To enable logging, add an entry to the PB.INI file with the following format:

[pb]
LogSySAM = N

N can be any of these values:

0 – No logging (default)
1 – Basic logging information
2 – Full information

The SySAM log file, PB125_sysam.log, contains status information from the development environment, the details of the current license, and information from the SySAM API, if you set the SySAMTrace value in PB.INI. Technical Support might ask you to set these values if you experience license problems.

The SySAM log file is saved in the same directory as other writeable files for individual users, such as initialization files. See What the Setup Program Does for the location of this directory on various Windows systems.

Two additional files, pb125_sysam.properties and PB125.lic, are installed in the directory for individual users. These files contain information that might be useful to Technical Support. Do not edit these files unless directed to do so by Technical Support.

Served license issue

If you enter an unqualified server name, such as myserver, as the license server name, the server name might not be found. Try a fully qualified name, such as myserver.mydomain.com.

Problem starting SySAM license server

When starting the SySAM license server, you may see this error:

lmgrd is not running: Cannot connect to license server 
system. (-15,570:10035 "WinSock: Operation would block")

This version of Sybase IQ includes Internet Protocol Version 4 (IPv4) and Internet Protocol Version 6 (IPv6) versions of the SySAM license server software. You can choose the version of the license server based on your environment using the sysam configure command. By default the IPv4 version of the license server is configured for use.

The IPv4 version of the license server cannot be used properly, if you have enabled IPv6 on the license server host. If this is the case, you can:

Disable IPv6 TCP/IP protocol on the license server host.
Use another Windows host that does not have IPv6 enabled.
Use a UNIX host for the license server. You can use the IPv4 version of the license, even if both IPv4 and IPv6 are enabled on UNIX.

If you are using the IPv6 version of the license server on a Windows host, then this license server can be accessed only through IPv6 protocol. Any host with an IPv4 only network stack will not be able to obtain licenses from this IPv6 license server. You can do one of the following to work around this issue:

Use a UNIX host for the license server. License Servers on UNIX are able to serve licenses to both IPv4 and IPv6 client hosts.
If you need to use a Windows host for the License Server and have both IPv4 and IPv6 clients to the license server, set up two License Servers, one serving the IPv4 network and the other serving the IPv6 network.

Note: Support for IPv6 is built into the latest versions of Microsoft Windows, and is available as part of service pack updates for earlier Windows releases. See http://technet.microsoft.com/en-us/network/bb530961.aspx.