Preface
The Administration Server Administration Guide provides background information that system architects and administrators need to successfully manage Sun Java System servers in their enterprise. Read about Sun Java System server basics in this book before you begin installing and configuring Sun Java System servers.
This preface contains the following sections:
Before performing any of the tasks described in this guide, read the Administration Server Release Notes.
Who Should Read This Guide
This guide is intended for system architects and administrators.
The author of this guide assumes you are familiar with the following:
- Specifications for LDAP and related protocols
- Clustering model (if you are using Administration Server with Sun Cluster software)
- Internet and World Wide Web technologies
How This Guide Is Organized
This guide is divided into the following chapters:
Presents a high-level overview of Administration Server and Server Console, and indicates how you can use this system to work with resources across your network.
Describes how to log in to, customize, and use Sun Java System Server Console.
Explains how to perform basic server management using Server Console.
Describes how to use Server Console to create, locate, and manage user and group information.
Describes basic Administration Server operations, including restarting and stopping the server, and using the logging options.
Explains how to configure the network, access, encryption, and directory settings of Administration Server from Server Console.
Describes the command-line tools delivered with Administration Server, that can be used to configure an instance of Administration Server without launching Server Console.
Describes how you can use access control instructions to define who can manage and use Sun Java System servers. It includes an overview of access control, setting access permissions and working with access control instructions.
Describes how to set up support for the Secure Sockets Layer (SSL) and Transport Layer Security (TLS) protocols in Sun Java System servers.
Introduces the basic concepts of public-key cryptography, including an overview of internet security issues, encryption and decryption, digital signatures, certificates, and authentication.
Introduces the Secure Sockets Layer (SSL) protocol, including an overview of the ciphers used with SSL, and the SSL handshake.
Using the Documentation
The Administration Server manuals are available as online files in Portable Document Format (PDF) and Hypertext Markup Language (HTML) formats. Both formats are readable by assistive technologies for users with disabilities. The Sun documentation web site can be accessed here:
http://docs.sun.com
The Administration Server documentation set can be accessed here:
http://docs.sun.com/coll/AdministrationServer_04q2
Table 1 briefly describes each document in the set. The left column provides the name and Web location of each document. The right column describes the general contents of the document.
Table 1 Administration Server Documentation
Document
|
Contents
|
Administration Server Release Notes
http://docs.sun.com/doc/817-5214
|
Contains the latest information about Administration Server, including known problems.
|
Administration Server Administration Guide
http://docs.sun.com/doc/817-5215
|
Gives the procedures for using the console and command-line to manage and configure every feature of Administration Server.
|
Conventions
Table 2 describes the typeface conventions used in this guide.
Table 2 Typeface Conventions
Typeface
|
Meaning
|
Examples
|
AaBbCc123
(Monospace)
|
API and language elements, HTML tags, web site URLs, command names, file names, directory path names, on-screen computer output, sample code.
|
Edit your .login file.
Use ls -a to list all files.
% You have mail.
|
AaBbCc123
(Monospace bold)
|
What you type, as contrasted with on-screen computer output.
|
% su
Password:
|
AaBbCc123
(Italic)
|
Book titles.
New words or terms.
Words to be emphasized.
Command-line variables to be replaced by real names or values.
|
Read Chapter 6 in the Developer’s Guide.
These are called class options.
You must be superuser to do this.
The file is located in the ServerRoot directory.
|
Table 3 describes placeholder conventions used in this guide.
Table 3 Placeholder Conventions
Item
|
Meaning
|
Examples
|
install-dir
|
Placeholder for the directory prefix under which software binaries reside after installation.
|
The default install-dir prefix on Solaris systems is /.
|
ServerRoot
|
Placeholder for the directory where server instances and data reside.
You can manage each server under a ServerRoot remotely through your client-side Server Console. The Server Console uses the server-side Administration Server to perform tasks that must execute directly on the server-side system.
|
The default ServerRoot directory is /var/opt/mps/serverroot.
|
slapd-serverID
|
Placeholder for the directory where a specific server instance resides under the ServerRoot and its associated data resides by default.
|
The default serverID is the host name.
|
Table 4 describes the symbol conventions used in this book.
Table 4 Symbol Conventions
Symbol
|
Meaning
|
Notation
|
Example
|
[ ]
|
Contain optional command options.
|
O[n]
|
�O4, �O
|
{ }
|
|
Contain a set of choices for a required command option.
Separates command option choices.
|
d{y|n}
|
�dy
|
+
|
Joins simultaneous keystrokes in keyboard shortcuts that are used in a graphical user interface.
|
|
Ctrl+A
|
-
|
Joins consecutive keystrokes in keyboard shortcuts that are used in a graphical user interface.
|
|
Esc-S
|
>
|
Indicates menu selection in a graphical user interface.
|
|
File > New
File > New > Templates
|
Table 5 describes the shell prompt conventions used in this book.
Table 5 Shell Prompts
Shell
|
Prompt
|
C shell
|
machine-name%
|
C shell superuser
|
machine-name#
|
Bourne shell and Korn shell
|
$
|
Bourne shell and Korn shell superuser
|
#
|
Input and output of Administration Server commands are usually expressed using the LDAP Data Interchange Format (LDIF) [RFC 2849] . Lines are wrapped for readability.
Resources and Tools on the Web
The following location contains information about Java Enterprise System and its component products such as Administration Server:
http://wwws.sun.com/software/learnabout/enterprisesystem/index.html
Third-party URLs are included in this document to 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 by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.
|
|
How to Report Problems
If you have problems with Administration Server, contact Sun customer support using one of the following mechanisms:
This site has links to the Online Support Center and ProductTracker, as well as to maintenance programs and support contact numbers.
This site includes patches, support documents, security information, and the Sun System Handbook.
So that we can best assist you in resolving problems, please have the following information available when you contact support:
- Description of the problem, including the situation where the problem occurs and its impact on your operation
- Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem
- Detailed steps on the methods you have used to reproduce the problem
- Any error logs or core dumps
Sun Welcomes Your Comments
Sun is interested in improving its documentation and welcomes your comments and suggestions. Use the web-based form to provide feedback to Sun:
Please provide the full document title and part number in the appropriate fields. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the part number of this Administration Guide is 817-5215-10.