Before you install Adaptive Server, you should:
Decide which of these the SySAM license models to use:
The unserved license model – gets licenses directly from the license file. If you are using an unserved license, you should simply save the license to the machine on which you have installed RTDS.
The served license model – uses a license server to manage the allocation of your licenses to multiple machines. See the following steps for more information.
For information about served and unserved licenses, and which model is best suited for your environment, see Chapter 2, “Choosing a License Model” in the Sybase Software Asset Management User’s Guide version 2.0.
If you plan to use a served license, you need a license server. Decide whether it will be an existing license server or a new license server. The license server need not be on the same machine or running on the same operating system and architecture.
To use an existing license server, you must know the server host name and port number.
To create a new license server before installing RTDS, see “Installing a new license server”.
You can only have one instance of a SySAM license server running on
a given machine. To set up a SySAM 2.0
license server on a machine that is already running a SySAM 1.0 license server, you must
migrate the old license server to 2.0. A migrated license server
can serve licenses for products enabled for both SySAM 1.0 and 2.0.
Please see Appendix F of the Sybase Software Asset Management User's Guide version 2.0 for instructions on migrating a license server.
For information about:
Choosing a license server host, see the “Choosing a license server host” section in Chapter 2, “Choosing a License Model” of the Sybase Software Asset Management User’s Guide version 2.0.
License server administration, see Chapter 4, “License Server Administration” in the Sybase Software Asset Management User’s Guide version 2.0.
Sybase recommends that you get your license files from the Sybase Product Download Center (SPDC) before you begin installing RTDS. For information about accessing SPDC, see “Accessing SPDC”, and for information about generating your licenses at SPDC, see “Generating licenses for served and unserved license models at SPDC”.
Accessing SPDC
Once you have purchased a Sybase product, typically you are expected to download the product and generate its licenses from the online Web portal, the Sybase Product Download Center (SPDC).
To access SPDC when you have purchased Sybase products from Sybase:
Once you have ordered a Sybase product, you receive a welcome e-mail that contains a URL to the SPDC site, as well as a user name and password.
If you have purchased your Sybase software from a Sybase
reseller, you receive a Web key rather than an e-mail.
Click on the URL, and when prompted, enter the designated user name and password. Your login is typically your e-mail address. If you have forgotten your password, use the password finder on the SPDC login page.
Getting your host ID
Change your bin subdirectory:
On Windows – change to %SYBASE%\%SYBASE_SYSAM%\bin, where:
%SYBASE% – is the Sybase installation directory
%SYBASE_SYSAM% – is SYSAM-2_0.
On UNIX – change to $SYBASE/$SYBASE_SYSAM/bin, where:
$SYBASE is the Sybase installation directory
$SYBASE_SYSAM is $SYSAM-2_0
You can enter the command hostid from a command prompt.
Obtain your host ID:
On HP-UX,
IBM and Solaris, enter “./lmutil
lmhostid”
On Windows and Linux, enter “lmutil
lmhostid”
On some platforms, the host ID is derived from the network
adapter address. If your machine has multiple network adapters, lmutil
lmhostid returns one host ID for each network adapter.
The output may look similar to:
The FLEXlm host ID of this machine is ""0013023c8251 0015c507ea90"" Only use ONE from the list of hostids.
Choose one of these host IDs. Sybase recommends using the value associated with the primary wired Ethernet adapter. Do not use values associated with internal loop back adapters. If you cannot determine which host ID to use from the lmutil lmhostid output, use the native operating system command to get additional details to help make the determination. See to the SPDC FAQ titled “What’s my Host ID,” or “Appendix A” of the FLEXnet Licensing End User Guide for the exact commands for your platform.
Save the host ID so you can use it later at SPDC. Your host ID is platform-specific, but may be similar to the following:
On IBM AIX platforms – 02765131
On HP-UX PA-RISC platforms – 778DA450 or #2005771344
On Linux platforms – 00400516E525
On Solaris platforms – 170a3472
On Windows platforms – 00B0A9DF9A32
Generating licenses for
served and unserved license models at SPDC
To generate your license, regardless of license model:
At the Welcome screen at SPDC, where you can view all of the product families to which you have access, select the product family that contains the product for which you wish to generate a license.
When a list of available Sybase products displays, click the product with the appropriate edition and version. Make sure you select the product for the operating system you are using.
The license agreement displays. You must agree to the terms and conditions in the license in order to generate a license. To do so, click I Agree.
The license agreement only displays the first time you
attempt to download a product. Once you have agreed to the license,
you will not encounter the license agreement for all subsequent
downloads of that product.
At the product download page, click the License Keys link.
The License Information page displays. Select the license you wish to generate. When you are selecting the license you wish to generate, consider:
The license type for the license you wish to generate. For more information about license types, see the “License types” in Chapter 3 “Getting and Using your License” of the Sybase Software Asset Management User’s Guide.
If you are unsure what you have licensed, your company’s purchase order should have the product name, edition, and license type.
Once you’ve determined the license you wish to generate, select it via the Generate radio button on the left side of the screen. Scroll to the bottom of the page, and click Select to Generate.
Step one of the SySAM license generation wizard asks you to choose between a served license and an unserved license. If you choose a served license, continue with the steps in “Generating a served license”, and if you choose an unserved license, continue with the steps in “Generating an unserved license”.
Some Sybase products or specific license types do not
give you a choice of license model to use, and therefore do not
display this page. If this is the case, proceed with the SySAM license generation wizard
to generate your license.
Generating a served license
To generate a served license:
Select Served License and click Next.
Indicate the quantity of licenses you wish to generate and click Next.
Enter the License Server Host ID, and optionally, the host name and port number:
Sybase recommends that you provide the host name here to ease future license administration.
A port number is not required unless you are using a 3-node redundant cluster. A valid number is any unused port number between 0 and 64000. On UNIX, choose a port greater than 1024, since those less than 1024 are privileged port numbers. If no TCP/IP port number is specified, one of the default ports in the range of 27000 and 27009 is used.
If you want to generate a license for a 3-node redundant cluster, then you must specify the host ID, host name, and port number for the three nodes of the cluster. The port number is not optional for this configuration and should be outside of the 27,000 to 27,009 range.
For information about how to get the host ID, see “Getting your host ID”. You can specify redundant server information if you choose to configure your servers for three-server redundancy.
Click Generate.
Once you have generated the license, you can:
Click Download License File to download the license file
Click Print Friendly to print a paper copy of the license
Return to the license information page to generate additional licenses.
Once you have generated all the licenses you need, save them to the licenses directory in your license server installation.
SySAM 2.0 requires
that you save your license files with a .lic extension.
Sybase recommends that you set up the license server and required licenses before you install your SySAM 2.0-enabled Sybase product.
Generating an unserved
license
To generate an unserved license:
Select Un-served License and click Next.
Select the number of machines you want to license and click Next. You can generate licenses for up to 10 machines at a time.
Enter the host ID, and optionally, the host name for each machine for which you want to generate a license. For information on getting your host ID and host name, see “Getting your host ID”.
For some license types, you are asked to enter the number of CPUs or licenses for the machine where this license will be used.
Click Generate.
Once you have generated the license, you can:
Download the license file by clicking the Download License File button
Print a paper copy of the license by clicking the Print Friendly button
Return to the license information page to generate additional licenses
Once you have generated all the licenses you need, save them to the specific location required by your product.
SySAM 2.0 requires
that you save your license files with a .lic extension.
Installing a new license
server
Perform the following steps to install a new license server.
If you have selected a served license model,
you must install a license server.
On HP-UX – mount the CD:
mount -F cdfs -o ro,rr <CDROM device> /cdrom
Install the license server:
On Windows – insert the CD into the CD drive. The Installer should start automatically. If it does not, start the setup program manually by selecting Start | Run. Browse to setup.exe.
Launch the Sybase installer program:
On UNIX:
./setup
On Windows:
X:\setup
The Welcome Window displays. Click Next.
Accept the license agreement.
Enter or select the destination directory.
Select the Custom installation.
Select only “SySAM Network License Server” for installation.
Deselect other components, to install the license server only.
Click OK for the installer to install the license server.
You cannot start the license server until there is at
least one valid served license installed in the licenses directory.
Get the host ID for the machine on which you plan to run the license server. For information on how to generate the host ID, see “Getting your host ID”.
Go to the Sybase Product Download Center (SPDC).
Generate the licenses for the products you want to install. For instructions on generating your licenses, see “Generating licenses for served and unserved license models at SPDC”.
Copy the license file in the licenses directory on the network license server machine:
On UNIX – $SYBASE/$SYBASE_SYSAM/licenses
On Windows – %SYBASE%\%SYBASE_SYSAM%\licenses
Refresh or restart the license server:
Change to:
On Unix – $SYBASE/$SYBASE_SYSAM/bin
On Windows – %SYBASE%\%SYBASE_SYSAM%\bin
If the license server is not already started, start it by entering:
sysam start
If the license server is already started, use the reread command to make the license server read the new license files:
sysam reread
Validate that the license daemon is running by entering:
sysam status
On Windows, you can expect to see output for a running server that is similar to:
> sysam start
Starting the SYSAM service The SYSAM service is starting. The SYSAM service was started successfully.
On UNIX, you can expect to see output for a running server that is similar to:
lmutil - Copyright (c) 1989-2006 Macrovision Europe Ltd. and/or Macrovision Corporation. All Rights Reserved. Flexible License Manager status on Wed 5/24/2006 15:04 License server status: 27000@mysysamserver License file(s) on keyserver: /opt/sybase/SYSAM_0/licenses/mysysamserver_603020315.lic
For information about served and unserved licenses, and which model is best suited for your environment, see Chapter 2, “Choosing a License Model” in the Sybase Software Asset Management User’s Guide.
