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

 Name                               Last modified      Size  Description
 Parent Directory                                        -   
 CHANGELOG.html                     25-Feb-2005 14:57  7.6K  
 DEPENDENCIES.html                  07-Mar-2005 09:10  1.8K  
 DOCUMENTATION.html                 24-Jan-2005 00:00  132   
 LICENSE.txt                        02-Dec-2004 00:00   11K  
 README.html                        16-Dec-2004 00:00   20K  
 SAMPLECODE.html                    24-Jan-2005 00:00  132   
 builds/                            27-Aug-2008 02:05    -

SMS Developer Components

1.0 Introduction

2.0 What's New

2.1 On NetWare

2.2 On Linux

3.0 Setting Up the Developer Kit on Linux

3.1 Starting SMS

4.0 Documentation

4.1 Viewable and Downloadable Documentation

4.2 News Groups

5.0 Dependencies

6.0 Sample Programs

6.1 Demonstration Engine (DE)

6.2 TSATEST

7.0 Legal Notices

1.0 Introduction

Storage Management Services^TM (SMS) is an API framework that applications consume in order to provide a complete backup solution on NetWare^® and SUSE^TM Linux Enterprise Server (SLES). Some important properties of this framework include:

SMS exposes a single consistent interface across all file systems and applications on NetWare and SLES.
SMS ensures backward compatibility at all times even while adding new features or interfaces.
Backup applications developed using the SMS framework that successfully meet the Novell Labs testing criteria, qualify to use the YES, Tested & Approved^TM certification mark.

The SMS framework is implemented by two main components - Storage Management Data Requestor (SMDR) and Target Service Agent (TSA). SMDR defines the API framework and the TSA provides an implementation of the API for a particular target.

2.0 What's New

2.1 On NetWare

SMS has been enhanced to provide path names in UTF-8 format in addition to MBCS.
TSATEST and DE have been updated to use path names in UTF-8 format.
The SMS utility library has been converted to a NLM on NetWare.

2.2 On Linux

SMS has been enhanced to backup file systems using the VFS interface on SLES. This includes NSS on SLES 9.
SMS is also capable of backing up rich NSS meta data and data streams that are not available through the VFS interfaces.
Demonstration Engine (DE) and TSATEST are now available on SLES 9.
The API document (sms_docs.pdf) and the recommendations document (sms_reco.pdf) have been updated.

NOTE:

The SMS API framework is consistent for NetWare 4.x, 5.x, and 6.x and SLES 9 .Thus, a backup application can use the same API set to backup targets on any platform.
All binaries in this release are included for convenience of development. They are not meant for deployment in production environments.
The API documentation (sms_docs.pdf) and the recommendations document (sms_reco.pdf) have been updated.

3.0 Setting Up the Developer Kit on Linux

The SMS NDK package comprises of:

DE and TSATEST sample code: Located at /opt/novell/samples/sms/de and /opt/novell/samples/sms/tsatest respectively.
SMS API and recommendation documents: Located at /opt/novell/doc/sms
SMS include files : Located at /opt/novell/include/sms.
Licence and Readme : Located at /opt/novell/sms.

3.1 Starting SMS

SMS NDK has a dependancy on the SMS product rpm.

Download the novell-sms rpm from SMS Developer Components for SUSE LINUX and install it.

# rpm -ivh novell-sms-0.1.0-14.i586.rpm

Installing the rpm copies the binaries into /opt/novell/sms/bin, the libraries into /opt/novell/lib and the scripts into /etc/init.d.
Start the SMDR daemon by giving the following command:

# /etc/init.d/novell-smdrd start

The file system target service tsafs is autoloaded by smdrd, to load other TSAs or configure TSAs use options provided by smsconfig.

Any backup application that uses SMS can now be run.

NOTE:

Root privileges will be necessary to install the novell-sms rpm.
Refer smdrd, smsconfig and tsafs manpages for detailed information
To uninstall the August 2004 NDK, use the sms-config script provided in that release.
All binaries in this release are included for convenience of development. They are not meant for deployment in production environments.

4.0 Documentation

4.1 Viewable and Downloadable Documentation

Refer to sms_docs.pdf for a detailed description of the API.
Refer to sms_reco.pdf for recommendations to developers and a description of recent changes done in SMS. This document has relevant references to the API documentation and samples.
Refer to demoengine.html, for details on the Demo Engine sample for NetWare.
Refer to demoengine_linux.html, for details on the Demo Engine sample for Linux.
Refer to tsatest.html, for details on the TSATEST sample for NetWare.
Refer to tsatest_linux.html, for details on the TSATEST sample for Linux.
To read or print the documentation, Adobe Acrobat Reader 4.0 or later is required. For a free download, see the Adobe site.

4.2 News Groups

For a discussion on SMS, a newsgroup is available at: news://developer-forums.novell.com/novell.devsup.sms

5.0 Dependencies

All SMS binaries on NetWare are CLIB based and cannot be used with LibC based applications in this release.
In order to build the Demonstration Engine sample on NetWare, the CLIB developer kit has to be downloaded and installed.

6.0 Sample Programs

6.1 Demonstration Engine (DE)

The Demonstration Engine (DE) is a sample that demonstrates the uses SMS API to perform simple backup and restore operations. The sample provides a very primitive implementation of a backup application with a view to present concepts and familiarize the developer on usage of SMS API. It also provides an implementation of new features discussed in this developer release to supplement the documentation.

For more information, refer demoengine.html, (for NetWare) and demoengine_linux.html (for Linux) that ships in this developer release.

6.2 TSATEST

TSATEST is a utility that reads data sets from a target, and then discards them. This, in effect, is equivalent to a backup system that has an infinite capacity, high performing tape sub-system. TSATEST can thus be used to benchmark backup application performance. TSATEST can also be used to troubleshoot hardware and software bottlenecks.

TSATEST is available as part of the developer kit along with its source which can be treated as the recommended implementation for achieving high performance. For more information, refer tsatest.html (for NetWare) and tsatest_linux.html (for Linux) that ships in this developer release.

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 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 Kit License Agreement and Separate Limited Warranty, which can be found in the license.txt file provided in this download.

Copyright ^© 2003 - 2004 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.

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

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

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

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

Storage Management Services (SMS) is a trademark of Novell, Inc. in the United States and other countries.

SUSE is a registered Trademark of SUSE LINUX AG, a Novell company

YES, Tested, & Approved is a trademark of Novell, Inc. in the United States and other countries

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