Table Of Contents

Getting Started

Overview

Installation

API Prerequisites

System Requirements

Installing the Cisco License Manager Perl SDK

Uninstalling Cisco License Manager Perl SDK

Getting Started

---

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

•Overview

•Installation

•Uninstalling Cisco License Manager Perl SDK

Overview

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

Cisco::CLM::SDK::LicenseManager

The API is provided as a set of Perl modules. The module CISCO::CLM::SDK::LicenseManager contains the core API that can be invoked by client programs to access the functions supported by the back-end server. This guide provides the external Perl API as seen by its client programs.

Installation

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

This section provides the following installation information:

•API Prerequisites

•System Requirements

•Installing the Cisco License Manager Perl SDK

API Prerequisites

The following prerequisites have been tested and certified for Perl API:

•ActivePerl Version 5.8

•Inline-Java-0.52 module installed

Inline-Java-0.52 can be downloaded and installed from the Comprehensive Perl Archive Network (CPAN) website (http://www.cpan.org).

---

Note Please make sure that the default J2SDK version 1.5 is used while installing Inline-Java-0.52.

---

System Requirements

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 1-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 1-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 Perl SDK

To install the Cisco::CLM module, unzip the module and run the following commands:

    cd Cisco-CLM-2.01

    perl Makefile.PL

    make

    make test

    make install

Alternatively, to install with Module::Build, use the following commands:

    perl Build.PL

    ./Build

    ./Build test

    ./Build install

On Windows XP, use the following commands:

perl Build.PL

Build

Build test

Build install

If you do not have root permission or you want to install the module in a non-standard place, please give the directory location during perl Makefile.PL as

•(For Windows) perl Makefile.PL PREFIX = C:\my\install\directory

•(For Solaris) perl Makefile.PL PREFIX = /home/clm/install/directory

Uninstalling Cisco License Manager Perl SDK

To uninstall the Cisco License Manager Perl SDK, navigate to the folder where you unzipped the module and run:

perl uninstall.pl Cisco::CLM

If you have installed the module in a non-standard location, please provide the full directory path in this form:

•(For Windows) perl uninstall.pl Cisco::CLM C:\my\install\directory

•(For Solaris) perl uninstall.pl Cisco::CLM /home/user/clm_directory