Preface

This guide describes the Sun WBEM SDK and Solaris WBEM Services. The Sun WBEM SDK is a software developer's tool kit that software developers can use to create standards-based applications that manage WBEM-enabled objects. Developers can also use this software to write providers, programs that communicate with managed objects to access data.

Solaris WBEM Services software is Sun's implementation of WBEM on the Solaris(TM) operating environment. This software includes the Sun WBEM SDK and the core components needed to write WBEM-enabled management applications.

Who Should Use This Book

Two types of developers will use this book:

• System and Network Application Developers

  Programmers who write applications that manage the information stored in CIM classes and instances will find this guide useful. These developers typically use the Sun WBEM APIs to get and set the properties of predefined CIM instances and classes.

• Instrumentation Engineers

  Instrumentation engineers provide resources such as processors, memory, routers, and other manageable devices. These developers need to communicate device information in a standard CIM format to the CIM Object Manager, typically through a piece of software called a provider. These users use the WBEM APIs to create classes, instances, and properties.

  Instrumentation engineers might work with class and schema designers, who describe new groups of managed resources (CIM classes) or a collection of CIM classes, called schema. Schemas describe the managed objects in a particular system environment, for example, Microsoft Windows 32 or the Solaris operating environment.

Before You Read This Book

This book describes how to use the Sun WBEM applications and tools to write management applications.

This book requires knowledge of the following:

• Object-oriented programming concepts

• Java programming

• A solid understanding of Common Information Model (CIM) concepts.

If you are unfamiliar with these areas, you might find the following references useful:

• Java(TM) How to Program

  H. M. Deitel and P. J. Deitel, Prentice Hall, ISBN 0-13-263401-5

• The Java Class Libraries, Second Edition, Volume 1, Patrick Chan, Rosanna Lee, Douglas Kramer, Addison-Wesley, ISBN 0-201-31002-3

• CIM Tutorial, provided by the Distributed Management Task Force

The following Web sites are useful resources when working with WBEM technologies.

• Distributed Management Task Force (DMTF)

  See this site at www.dmtf.org for the latest developments on CIM, information about various working groups, and contact information for extending the CIM Schema.

• Rational Software

  See this site at www.rational.com/uml for documentation on the Unified Modeling Language (UML) and the Rose CASE tool.

How This Book is Organized

Part I introduces the Sun WBEM SDK and Solaris WBEM Services products.

Chapter 1, Overview of WBEM introduces Web-Based Enterprise Management (WBEM), the Common Information Model (CIM), Sun WBEM SDK, and Solaris WBEM Services.

Part II explains how to install and use the components in the Sun WBEM SDK.

Chapter 2, Installing the Sun WBEM SDK describes how to install the Sun WBEM SDK using the pkgadd command and how to remove the Sun WBEM SDK using the pkgrm command.

Chapter 3, MOF Compiler describes the command syntax for the mofc command and how to compile a .mof file.

Chapter 4, CIM WorkShop describes how to use CIM WorkShop to manipulate CIM classes, instances, methods, and properties.

Chapter 5, Application Programming Interfaces provides an overview of the client APIs and examples of how to use them to create and manipulate CIM objects.

Chapter 6, Writing Client Applications explains how to use the Client APIs to write client applications.

Chapter 7, Writing a Provider Program provides an overview of the provider APIs and explains how to write a provider, classes that mediate between managed objects and the CIM Object Manager.

Chapter 8, Using Sun WBEM SDK Examples explains how to run the code examples provided with the Sun WBEM SDK.

Chapter 9, Error Messages explains error messages returned by Sun WBEM SDK APIs.

Part III explains how to install and use Solaris WBEM Services, Sun's implementation of WBEM on the Solaris operating environment.

Chapter 10, Installing Solaris WBEM Services describes how to install Solaris WBEM Services using the pkgadd command and how to remove the software using the pkgrm command.

Chapter 11, CIM Object Manager describes the command syntax of the cimom command, and how to start and stop the CIM Object Manager.

Chapter 12, Administering Security describes security features and how to set access rights on namespaces and users.

Chapter 13, Logging Events describes the logging features.

Appendix A, Common Information Model (CIM) Terms and Concepts describes CIM terms and concepts.

Glossary presents a list of words and phrases found in this book and their definitions.

Ordering Sun Documents

The SunStore^SM stocks hundreds of manuals from Sun Microsystems, Inc. You can purchase both documentation sets and individual manuals.

For a list of documents and how to order them, visit the SunStore at http://sunstore.sun.com.

Accessing Sun Documentation Online

You can access Sun technical documentation online at the docs.sun.com^SM Web site. You can browse the archive or search for a specific book title or subject.

What Typographic Conventions Mean

The following table describes the typographic changes used in this book.

Table P-1 Typographic Conventions

Typeface or Symbol	Meaning	Example
AaBbCc123	The names of commands, files, and directories; on-screen computer output	Edit your .login file. Use ls -a to list all files. machine_name% you have mail.
AaBbCc123	What you type, contrasted with on-screen computer output	machine_name% su Password:
AaBbCc123	Command-line placeholder: replace with a real name or value	To delete a file, type rm filename.
AaBbCc123	Book titles, new words, or terms, or words to be emphasized.	Read Chapter 6 in User's Guide. These are called class options. You must be root to do this.

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P-2 Shell Prompts

Shell	Prompt
C shell prompt	machine_name%
C shell superuser prompt	machine_name#
Bourne shell and Korn shell prompt	$
Borne shell and Korn shell superuser prompt	#