Index of /pub/mirrors/ftp.novell.com/forge/imgrsdk

Icon  Name                               Last modified      Size  Description
[DIR] Parent Directory                                        -   
[TXT] CHANGELOG.html                     18-Feb-2005 09:03  6.3K  
[TXT] DEPENDENCIES.html                  18-Feb-2005 16:19  1.6K  
[TXT] DOCUMENTATION.html                 24-Jan-2005 00:00  132   
[DIR] Developer Training Video/          27-Aug-2008 01:54    -   
[TXT] LICENSE.txt                        16-Nov-2004 00:00   11K  
[TXT] README.html                        23-Feb-2005 16:31   18K  
[TXT] SAMPLECODE.html                    24-Jan-2005 00:00  132   
[DIR] builds/                            27-Aug-2008 01:55    -   
[DIR] iManager 1.5 Migration Tool/       27-Aug-2008 01:55    -
iManager 2.x Developer Kit


iManager 2.x Developer Kit

1.0 Overview
2.0 What's New
3.0 Installation Instructions
4.0 Known Issues
4.1 Path Length Limit on Windows
4.2 The Developer Guide Has Outdated Instructions for Using iManager
4.3 The Developer Guide Shows Incorrect Directories for a Module File
4.4 Examples in the Migrating XSL Tasks to JSP Tasks Section of the Developer Guide Are Outdated
4.5 Developer Documentation Might Not Display in iManager
5.0 Documentation
6.0 Sample Code
7.0 Legal Notices


1.0 Overview

Novell® iManager is a Web-based application for managing, maintaining, and monitoring Novell products using wired and wireless devices.

The iManager 2.x Developer Kit provides tools to develop and test iManager tasks and other plug-ins. It includes sample plug-ins, documentation, and a version of the Tomcat HTTP server and servlet container that is configured for testing iManager 2.x plug-ins.


2.0 What's New

This SDK release includes the following new features:

To see what was changed in the software, sample code, and documentation for previous releases, see the What's New Archive.

To see the specific documentation changes that were made, see the Revision History.


3.0 Installation Instructions

For installation instructions and requirements, see the Getting Started section of the iManager 2.x SDK documentation.

Installing this SDK release using RPM requires root authentication. Following the RPM installation, access to the SDK directory also requires root authentication unless ownership of the SDK directory is modified to include additional users. Use the following command to change directory ownership:

chown -R OWNER:GROUP Directory

For example:

chown -R admin:admin imgr2sdk


4.0 Known Issues

This release of the iManager 2.x Developer Kit has the following known issues:


4.1 Path Length Limit on Windows

The iManager application has a deep directory structure, and the paths of some files include fully-qualified Java class names. As a result, many of the files in the SDK have long pathnames. Because Windows platforms allow only relatively short pathnames, to avoid problems we suggest that you install the SDK in a directory close to the root directory, such as C:\imgr2sdk.


4.2 The Developer Guide Has Outdated Instructions for Using iManager

The SDK now includes MobileiManager, which is a simple, self-contained version of iManager that launches in its own browser window. MobileiManager simplifies using the SDK. The startSDK scripts now automatically launch MobileiManager. At the login page, enter a user name, password, and tree name or IP address, then click Login. To stop MobileiManager, close the MobileiManager window.


4.3 The Developer Guide Shows Incorrect Directories for a Module File

The Creating a Module section of the Developer Guide contains a figure that shows the structure of a module file that includes all of the special directories of a Module. The figure should not include the packages and Resources directories. iManager requires only the currentwebapp and META-INF directories.


4.4 Examples in the Migrating XSL Tasks to JSP Tasks Section of the Developer Guide Are Outdated

The Migrating XSL Tasks to JSP Tasks section of the Developer Guide has examples that are outdated. The classes shown extend the BaseGadgetInstance class. Instead, tasks should extend the com.novell.emframe.dev.Task class and override the execute(TaskContext context, Properties resultStrings) method. Call context.getRequest() to get the HttpServletRequest object, and put your own attributes into the HttpServletRequest for use in the JSPs for the task. See the Creating a Task section of the Developer Guide for more information.


4.5 Developer Documentation Might Not Display in iManager

You can read developer documentation within iManager. The Developer view has a Developer Reference role with links to developer documentation. When you click a link the documentation appears in the content pane on the right side of the window. The first item is the Developer Guide, which is in PDF format and requires that the Adobe* Acrobat* plug-in be installed and configured for the iManager browser. If the plug-in is not available, the documentation will not be displayed. If this happens, you can view the Developer Guide by opening it in a separate PDF viewer program. It is installed to <SDK_HOME>/imgrsdk_doc/imgr2sdk/imgr_enu/imgr_enu.pdf.


5.0 Documentation

You can view or download the documentation at the iManager 2.x SDK Web site.

To read or print downloaded documentation, you need Adobe Acrobat Reader 4.0 or later, which is a free download.

The download contains PDF and HTML files in the install directory\doc directory. The documents in this download were created as standalone files; therefore, links between files in this download and links to files in other downloads will not resolve.


6.0 Sample Code

You can view or download the sample code at the iManager 2.x SDK Web site.


7.0 Legal Notices

Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.

Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.

You may not use, export, or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export regulations or the laws of the country in which you reside.

All files provided in this release are subject to the Novell Developer License Agreement, which can be found in the license.txt file provided in this download.

Copyright © 2002-2005 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.

Novell is a registered trademark of Novell, Inc. in the United States and other countries.

All third-party products are the property of their respective owners.