Table Of Contents

Getting Started

Overview

Installation

API Prerequisites

Installing the Cisco License Manager SDK

Using the SDK

Getting Started

---

This chapter provides overview and installation information needed to use the Java application programming interface (API) with Cisco License Manager Release 2.1 and contains the following sections:

•Overview

•Installation

•Using the SDK

Overview

Cisco License Manager provides an object-oriented Java API for client programs to invoke functions implemented in the Cisco License Manager back-end server.

The API is a set of Java class libraries in a single Java archive (JAR) file. The top-level class License Manager contains all functions that can be invoked by client programs. This is the same class library set used by the Cisco License Manager graphical user interface (GUI). This guide provides the external Java API as seen by its client programs.

Installation

The Java API communicates with the Cisco License Manager Server using Java.

This section provides the following installation information:

•API Prerequisites

•Installing the Cisco License Manager SDK

API Prerequisites

The API requires Java Development Kit (JDK) Version 1.5.

The following table provides details of the recommended software and hardware requirements for the Cisco License Manager server. These recommended requirements support the maximum data capacity (30,000 Cisco devices in the network). Also use these requirements if you are installing the server and client on the same host.

Table 0-1 Server Recommended Software and Hardware Requirements

Requirement Type	Requirement	Recommended Requirements at Maximum Capacity (30,000 Devices)
Processor	x86-based processor, 500-MHz minimum SPARC platform-based processor, 250-MHz minimum	Intel Pentium 4 3.2 GHz or equivalent CPU-based Sun UltraSPARC IIIi or equivalent CPU-based
Software	Operating system •Windows XP with Service Pack 2 or later •Windows 2003 Server •Solaris 10 •Linux: RedHat 5.0	Same
RAM	1 GB	2 GB
Disk	200 MB	10 GB

The following table provides details of the recommended software and hardware requirements for the Cisco License Manager client workstation.

Table 0-2 Client Workstation Recommended Software and Hardware Requirements

Requirement Type	Minimum Requirements	Recommended Requirement
Processor	x86-based processor, 500-MHz minimum SPARC platform-based processor, 250-MHz minimum	Intel Pentium 4 3.2 GHz or equivalent CPU-based machine Sun UltraSPARC IIIi or equivalent CPU-based machine
Software	Operating system •Windows XP with Service Pack 2 or later •Windows 2003 Server •Solaris 10 •Linux: RedHat 5.0	Same as Minimum Requirements
RAM	512 MB	1 GB
Disk	100 MB	100 MB

Installing the Cisco License Manager SDK

Cisco recommends that you install the Cisco License Manager Software Developer Kit (SDK) on the same machine on which the server resides.

To install the Cisco License Manager SDK, complete the following steps:

---

Step 1 Copy clm_java_sdk.zip from the CD to a local drive.

Step 2 Unzip the file.

The folder "CiscoLicenseManager_JAVA_SDK" is created on the local drive. It contains these files:

clm-sdk.jar

clm_ssl_rmi.cert

conf, a folder containing the file ClmErrorMessages.properties.

---

Using the SDK

Complete the following steps to begin using the SDK:

---

Step 1 Add clm-sdk.jar to the Java classpath when compiling and running the client program.

javac -classpath <CLM_SDK_HOME>/clm-sdk.jar:<CLM_SDK_HOME>/conf MyProgram.java, where 
<CLM_SDK_HOME> is the directory that holds the CLM SDK files

Step 2 If the Cisco License Manager License Manager server is SSL enabled:

Run the following command to import the Cisco License Manager certificate file, clm_ssl_rmi.cer, to the trust store on your client system:

%JAVA_HOME%\bin\keytool -import -keystore <keystore_file_path> -alias 
ciscolicensemanagerca -file <clm_ssl_rmi_cer_file_path>   

where <keystore_file_path> is the trust store of your client system, for example, C:\jdk1.5\jre\lib\security\cacerts, and <clm_ssl_rmi_cer_file_path> is the fullpath of the clm_ssl_rmi.cer file, for example, C:\CLM2.1_SDK\clm_ssl_rmi.cer.

Step 3 Start the Cisco License Manager server. For details, refer to the User Guide for Cisco License Manager.

Step 4 Start the client program.

---