iManager Developer Kit

January 13, 2009

This readme contains the following sections:

1.0 Overview

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

The iManager 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 servlet container that is configured for testing iManager plug-ins.

2.0 What's New

This SDK release includes the following new features:

  • Updated for compatibility with iManager 2.7.2

  • Developer view includes all developer documentation and sample tasks

  • Updated documentation

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

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 SDK.

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 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 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 SDK Web site.

To read or print downloaded documentation, use Adobe Acrobat reader. To download the latest version, see the Adobe Acrobat reader download site.

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 SDK sample code page.

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.

Any products or technical information provided under this Agreement may be subject to U.S. export controls and the trade laws of other countries. You agree to comply with all export control regulations and to obtain any required licenses or classification to export, re-export or import deliverables. You agree not to export or re-export to entities on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. See the Novell International Trade Services Web page for more information on exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary export approvals.

Copyright © 2009 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, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed on the Novell Legal Patents and one or more additional patents or pending patent applications in the U.S. and in other countries.

Novell Trademarks

For a list of Novell trademarks, see Trademarks.

Third-Party Materials