Service Registry 3 2005Q4 User's Guide

Preface

The Service Registry 3 2005Q4 User's Guide describes how to use the Web Console utility provided with the Service Registry (“the Registry”). The Web Console allows users to search the Registry for data and to publish data to the Registry. The User's Guide also provides troubleshooting information.

Who Should Use This Book

The User's Guide is intended for administrators and end users who search the Registry and publish data to the Registry. This guide assumes you are familiar with the basic concepts of the ebXML Registry and Repository specifications.

Before You Read This Book

You should be familiar with the basic concepts of these specifications:

ebXML Registry Information Model Version 3.0
ebXML Registry Services and Protocols Version 3.0

You can find the latest public versions of these specifications by going to the OASIS web site and following the links to ebXML RIM V3.0 and ebXML RS V3.0.

Service Registry is available as part of the Java Web Services Developer Pack (http://java.sun.com/webservices/jwsdp/) or as a component of Sun Java Enterprise System, a software infrastructure that supports enterprise applications distributed across a network or Internet environment. If you purchased Service Registry as a component of Java Enterprise System, you should be familiar with the system documentation at http://docs.sun.com/coll/1286.1.

How This Book Is Organized

The contents of this book are as follows:

Chapter 1, Using the Service Registry Web Console describes how to use the Web Console to search the Registry and to publish data to the Registry. The chapter also contains troubleshooting information.

Service Registry Documentation Set

The Service Registry documentation set is available at http://docs.sun.com/app/docs/coll/1314.1. To learn about Service Registry, refer to the books listed in the following table.

Table P–1 Service Registry Documentation


Document Title	Contents
Service Registry 3 2005Q4 Release Notes	Contains the latest information about Service Registry, including known problems.
Service Registry 3 2005Q4 Administration Guide	Describes how to configure Service Registry after installation and how to use the administration tool provided with the Registry. It also describes how to perform other administrative tasks.
Service Registry 3 2005Q4 User’s Guide	Describes how to use the Service Registry Web Console to search Service Registry and to publish data to it.
Service Registry 3 2005Q4 Developer’s Guide	Describes how to use the Java API for XML Registries (JAXR) to search Service Registry and to publish data to it.

Related Books

When you install Service Registry, it is deployed to the Sun Java System Application Server. For information about administering Application Server, refer to Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Administration Guide.

The Java ES documentation set describes deployment planning and system installation. The URL for system documentation is http://docs.sun.com/coll/1286.1. For an introduction to Java ES, refer to the books in the order in which they are listed in the following table.

Table P–2 Java Enterprise System Documentation


Document Title	Contents
Sun Java Enterprise System 2005Q4 Release Notes	Contains the latest information about Java ES, including known problems. In addition, components have their own release notes.
Sun Java Enterprise System 2005Q4 Documentation Roadmap	Provides descriptions of all documentation related to Java ES, both as a system and for the individual components.
Sun Java Enterprise System 2005Q4 Technical Overview	Introduces the technical and conceptual foundations of Java ES. Describes components, the architecture, processes, and features.
Sun Java Enterprise System 2005Q4 Deployment Planning Guide	Provides an introduction to planning and designing enterprise deployment solutions based on Java ES. Presents basic concepts and principles of deployment planning and design, discusses the solution life cycle, and provides high-level examples and strategies to use when planning solutions based on Java ES.
Sun Java Enterprise System 2005Q4 Installation Planning Guide	Helps you develop the implementation specifications for the hardware, operating system, and network aspects of your Java ES deployment. Describes issues such as component dependencies to address in your installation and configuration plan.
Sun Java Enterprise System 2005Q4 Installation Guide for UNIX	Guides you through the process of installing Java ES on the Solaris Operating System or the Linux operating system. Also shows how to configure components after installation, and verify that they function properly.
Sun Java Enterprise System 2005Q4 Installation Reference	Gives additional information about configuration parameters, provides worksheets to use in your configuration planning, and lists reference material such as default directories and port numbers.
Sun Java Enterprise System 2005Q1 Deployment Example Series: Evaluation Scenario	Describes how to install Java ES on one system, establish a set of core, shared, and networked services, and set up user accounts that can access the services that you establish.
Sun Java Enterprise System 2005Q4 Upgrade Guide	Provides instructions for upgrading Java ES on the Solaris Operating System or the Linux operating environment.
Sun Java Enterprise System Glossary	Defines terms that are used in Java ES documentation.

The URL for all documentation about Java ES and its components is http://docs.sun.com/prod/entsys.05q4.

Default Paths and File Names

The following table describes the default paths and file names that are used in this book.

Table P–3 Default Paths and File Names


Placeholder	Description	Default Value
`ServiceRegistry-base`	Represents the base installation directory for Service Registry.	Solaris systems: `/opt/SUNWsoar` Linux systems: `/opt/sun/SUNWsoar`
`RegistryDomain-base`	Represents the directory where the Application Server domain for Service Registry is located and where the Service Registry database is located.	Solaris systems: `/var/opt/SUNWsoar` Linux systems: `/var/opt/sun/SUNWsoar`

Typographic Conventions

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

Table P–4 Typographic Conventions


Typeface	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`	A placeholder to be replaced 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 (note that some emphasized items appear bold online)	Read Chapter 6 in the User's Guide. A cache is a copy that is stored locally. Do not save the file.

Shell Prompts in Command Examples

The following table shows default system prompts and superuser prompts.

Table P–5 Shell Prompts


Shell	Prompt
C shell on UNIX and Linux systems	`machine_name%`
C shell superuser on UNIX and Linux systems	`machine_name#`
Bourne shell and Korn shell on UNIX and Linux systems	`$`
Bourne shell and Korn shell superuser on UNIX and Linux systems	`#`
Microsoft Windows command line	`C:\`

Symbol Conventions

The following table explains symbols that might be used in this book.

Table P–6 Symbol Conventions


Symbol	Description	Example	Meaning
`[ ]`	Contains optional arguments and command options.	`ls [-l]`	The `-l` option is not required.
`{ \| }`	Contains a set of choices for a required command option.	`-d {y\|n}`	The `-d` option requires that you use either the `y` argument or the `n` argument.
`${ }`	Indicates a variable reference.	`${com.sun.javaRoot}`	References the value of the `com.sun.javaRoot` variable.
-	Joins simultaneous multiple keystrokes.	Control-A	Press the Control key while you press the A key.
+	Joins consecutive multiple keystrokes.	Ctrl+A+N	Press the Control key, release it, and then press the subsequent keys.
->	Indicates menu item selection in a graphical user interface.	File -> New -> Templates	From the File menu, choose New. From the New submenu, choose Templates.

Accessing Sun Resources Online

The docs.sun.com^SM web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. Books are available as online files in PDF and HTML formats. Both formats are readable by assistive technologies for users with disabilities.

To access the following Sun resources, go to http://www.sun.com:

Downloads of Sun products
Services and solutions
Support (including patches and updates)
Training
Research
Communities (for example, Sun Developer Network)

Third-Party Web Site References

Third-party URLs are referenced in this document and provide additional, related information.

Note –

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the full document title and part number. The part number is a 7-digit or 9-digit number that can be found on the book's title page or in the document's URL. For example, the part number of this book is 819-2683.