Nimsoft Monitor Perl SDK Release Notes - Nimsoft Library
Nimsoft Monitor Perl SDK Release Notes - Nimsoft Library
Nimsoft Monitor Perl SDK Release Notes - Nimsoft Library
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
ContentsChapter 1: <strong>Perl</strong> <strong>SDK</strong> General Overview 7Chapter 2: Requirements 9Hardware Requirements .............................................................................................................................................. 9Software Requirements ............................................................................................................................................... 9Supported Platforms .................................................................................................................................................... 9Chapter 3: Considerations 11Installation Considerations ......................................................................................................................................... 11Chapter 4: Fixed Defects 13Revision History .......................................................................................................................................................... 13Contents 5
Chapter 1: <strong>Perl</strong> <strong>SDK</strong> General OverviewThe CA <strong>Nimsoft</strong> <strong>Perl</strong> <strong>SDK</strong> allows you to write and run probes in the <strong>Perl</strong> programminglanguage.The <strong>SDK</strong>_<strong>Perl</strong> package contains the <strong>Perl</strong> native modules that allow access to the CA<strong>Nimsoft</strong> <strong>Monitor</strong> product and its many capabilities.Chapter 1: <strong>Perl</strong> <strong>SDK</strong> General Overview 7
Chapter 2: RequirementsThis section contains the requirements for the <strong>Perl</strong> <strong>SDK</strong> package.Hardware RequirementsNoneSoftware RequirementsSupported Platforms■■Windows: <strong>Nimsoft</strong> Robot version >= 3.00, ActiveState <strong>Perl</strong> platform packagev5.14.2.Unix: <strong>Nimsoft</strong> Robot version >= 3.00, <strong>Perl</strong> platform package v5.14.2 required to beinstalled to the target robot prior to installing the <strong>SDK</strong>_<strong>Perl</strong> package.The <strong>Perl</strong> <strong>SDK</strong> package supports the same set of operating systems and databases assupported by the <strong>Nimsoft</strong> Server solution. Refer to the <strong>Nimsoft</strong> Compatibility SupportMatrix for the latest information on supported NMS platforms.See also the Support Matrix for <strong>Nimsoft</strong> Probes, for additional specific information onthe <strong>Perl</strong> <strong>SDK</strong> package.Chapter 2: Requirements 9
Chapter 3: ConsiderationsThis section contains the considerations for the <strong>Perl</strong> <strong>SDK</strong> package.Installation ConsiderationsFirst make sure you have the correct version of <strong>Perl</strong> runtime installed (specified in theSoftware Requirements above) by running the command perl -v.For Windows systems, the perl.exe binary must either exist in the system PATHenvironment variable in order for the controller to resolve perl.exe references for scriptexecution. If you have several versions of <strong>Perl</strong> installed make sure that you either specifythe full path to the correct version of <strong>Perl</strong> or set your PATH environment variable to findthe correct version of <strong>Perl</strong> first.For Unix, when the <strong>Perl</strong> runtime package is installed the appropriate <strong>Perl</strong> binaryreference is created in the <strong>Nimsoft</strong> /bin directory--no further action is required.If errors are encountered during script execution that reference an inability to locate the<strong>Nimsoft</strong> API library modules, modify the PERL5LIB environment variable in thecontroller's environment specification tab to specify the full path to the perllib directoryunder its installed location.Follow these steps:1. Open the controller probe configurator by double-clicking the probe2. Go to the Setup tab3. Select the Environment tab4. Right-click Edit the 'PERL5LIB' entry, changing the default path to match your setup5. Click OK and when queried for a restart of the controller answer YES.Chapter 3: Considerations 11
Chapter 4: Fixed DefectsRevision HistoryThis section describes the history of updates for this probe.Date Description State VersionMay 2013Patch release to fix minor defects; documentationupdated.GA 5.05Nov 2012 Support added for 64-bit Linux. 5.04Jul 2012Jun 2012Jun 102011Jun 1 2011 ■Supports Ubuntu10, Ubuntu12, Debian5 andDebian6.Package now <strong>Perl</strong> v5.14.2 compatible for Linux. ForWindows, ActiveState <strong>Perl</strong> 5.14.2 recommended. ForUnix, <strong>Perl</strong> 5.14.2 precompiled binaries available fromthe <strong>Nimsoft</strong> beta archive for some platforms.5.035.02Removed debug message from log. 4.16■■■Fixed potential crash when enabling stormprotection on Spooler (Robot)Fixed crash in nimlogin for HP platformsUpdated perldoc documentation forpdsGetTable and pdsGet functionsFixed pdsSearch function to return a PDS insteadof a scalar when that is what the key matches.Dec 2010 ■ Added support for new custom_[1-5] fieldsavailable in newer NAS■Added support for CI interfaces in the NISdatabase.Jun 2010 ■ Fixed memory leak in CFG.pm when re-readingconfig file■■Fixed problem with Session.pm which wouldcause a daemon probe to disconnect from therobotUpdated AUTOLOAD code in API.pm.4.144.114.06Chapter 4: Fixed Defects 13
Revision HistoryDate Description State VersionSep 2009Feb 2009pdsGetNext will now return a copy of a PDS if thenext element it finds is a PDS. Note that this meansthat you have to call pdsDelete() on the datareturned if the type is PDS_PDS. The PDS.pm file hasbeen modified to avoid calling pdsDelete on theobject's embedded PDS if it was supplied in the callto new(). This would cause a double call topdsDelete() crashing the script.Recompiled on Windows due to issues with definedconstants.4.054.03Jan 2009 Fixed library issue on 64-bit windows. 4.02Dec 2008 Updated with latest fixes to NimBus libraries. 4.0114 <strong>Perl</strong> <strong>SDK</strong> <strong>Release</strong> <strong>Notes</strong>
Revision HistoryDate Description State VersionSep 2008Feb 2006Note: This version requires perl 5.10.0. Packages withpre-compiled binaries are available for all supportedUnix systems. For Windows systems ActiveState perlis recommended.Support added for new platforms, including 64-bitplatformsUses the latest NimBUS libraryFixes a long-standing bug with calls to pdsDeletecausing crashesNew functions added:- nimsPort- nimChangeLogin- nimSessionAlarm- nimSessionAddCallbackPds- nimSessionGetLastError- nimSessionConnect- nimSessionIsConnected- nimSessionController- nimSessionSpooler- nimSessionHub- nimLogTruncate- nimLogTruncateSize- nimLogTruncateTime- nimQoSCreateAsynch- nimQoSSetSampletime- nimQoSGetSource- nimQoSSourceIsSet- nimQoSSendDefinition- nimQoSPostMessage- nimQoSHostname- nimTimerCreate- nimTimerFree- nimTimerStart- nimTimerStopFixed problem with probes not being notified about adropped connection to the Hub (attach or subscribe).CodeWizard has been removed from this packageand added as a separate package to the web archive.4.003.01Chapter 4: Fixed Defects 15
Revision HistoryDate Description State VersionJan 2004Package sets the PERL5LIB environment variable as$NIM_ROOT\perllib which the controller expands.2.0416 <strong>Perl</strong> <strong>SDK</strong> <strong>Release</strong> <strong>Notes</strong>
Change language