Preface

The Sun N1 Service Provisioning System 5.2 XML Schema Reference Guide provides detailed information about the XML schemas used to define components, component types, plans, plug-ins, and plug-in user interfaces.

Who Should Use This Book

Anyone who develops components, plans, or plug-ins for the Sun N1^TM Service Provisioning System environment might need to use this book.

Before You Read This Book

You should already be familiar with the general concepts and tasks in the Sun N1 Service Provisioning System environment, as explained in these documents:

• Sun N1 Service Provisioning System 5.2 System Administration Guide

• Sun N1 Service Provisioning System 5.2 Operation and Provisioning Guide

• Sun N1 Service Provisioning System 5.2 Plan and Component Developer’s Guide

• Sun N1 Service Provisioning System 5.2 Plug-In Developer’s Guide

How This Book Is Organized

Chapter 1, XML Schema Overview provides an overview of the XML schemas in the Sun N1 Service Provisioning System product.

Chapter 2, Shared Schema Used by Components and Simple Plans provides detailed information about common elements.

Chapter 3, Component Schema provides detailed information about the elements and attributes that are used to define components and component types.

Chapter 5, Resource Descriptor Schema provides detailed information about the elements and attributes that are used to define resource descriptor files.

Chapter 4, Plan Schema provides detailed information about the elements and attributes that are used to define execution plans.

Chapter 6, Plug-In Descriptor Schema provides detailed information about the elements and attributes that are used to describe a plug-in.

Chapter 7, Plug-In User Interface Schema provides detailed information about the elements and attributes that are used to define an interface to a plug-in.

Appendix A, Component Change Compatibility provides detailed information about the compatibility of changes among components.

Documentation, Support, and Training

Sun Function	URL	Description
Documentation	http://www.sun.com/documentation/	Download PDF and HTML documents, and order printed documents
Support and Training	http://www.sun.com/supportraining/	Obtain technical support, download patches, and learn about Sun courses

Typographic Conventions

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

Table P–1 Typographic Conventions

Typeface or Symbol	Meaning	Example
AaBbCc123	The names of commands, files, and directories, and onscreen computer output	Edit your .login file. Use ls -a to list all files. machine_name% you have mail.
AaBbCc123	What you type, contrasted with onscreen computer output	machine_name% su Password:
aabbcc123	Placeholder: replace with a real name or value	The command to remove a file is rm filename.
AaBbCc123	Book titles, new terms, and terms to be emphasized	Read Chapter 6 in the User's Guide. Perform a patch analysis. Do not save the file. [Note that some emphasized items appear bold online.]

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	$
Bourne shell and Korn shell superuser prompt	#