test

Sun Java System Application Server Platform Edition 8.2 Administration Guide

Conventions Used in This Book

The tables in this section describe the conventions used in this book.

Typographic Conventions

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

Table P–1 Typographic Conventions

Typeface  

Meaning 

Examples 

AaBbCc123(Monospace)

API and language elements, HTML tags, web site URLs, command names, file names, directory path names, onscreen computer output, sample code. 

Edit your.login file.

Use ls -a to list all files.

% You have mail.

AaBbCc123(Monospace bold)

What you type, when contrasted with onscreen computer output. 

% suPassword:

AaBbCc123(Italic)

Book titles, new terms, words to be emphasized. 

A placeholder in a command or path name to be replaced with a real name or value. 

Read Chapter 6 in the User’s Guide.

These are called class options.

Do not save the file.

The file is located in the install-dir/bin directory.

Symbols

The following table describes the symbol conventions used in this book.

Table P–2 Symbol Conventions

Symbol  

Description  

Example  

Meaning  

[ ]

Contains optional 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.

-

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. 

Default Paths and File Names

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

Table P–3 Default Paths and File Names

Term  

Description  

install-dir

By default, the Application Server installation directory is located here: 

  • Sun Java Enterprise System installations on the SolarisTM platform:

    /opt/SUNWappserver/appserver

  • Sun Java Enterprise System installations on the Linux platform:

    /opt/sun/appserver/

  • Other Solaris and Linux installations, non-root user:

    user’s home directory/SUNWappserver

  • Other Solaris and Linux installations, root user:

    /opt/SUNWappserver

  • Windows, all installations:

    SystemDrive:\Sun\AppServer

domain-root-dir

By default, the directory containing all domains is located here: 

  • Sun Java Enterprise System installations on the Solaris platform:

    /var/opt/SUNWappserver/domains/

  • Sun Java Enterprise System installations on the Linux platform:

    /var/opt/sun/appserver/domains/

  • All other installations:

    install-dir/domains/

domain-dir

By default, each domain directory is located here: 

domain-root-dir/domain-dir

In configuration files, you might see domain-dir represented as follows:

${com.sun.aas.instanceRoot}

Shell Prompts

The following table describes the shell prompts used in this book.

Table P–4 Shell Prompts

Shell  

Prompt  

C shell on UNIX or Linux 

machine-name%

C shell superuser on UNIX or Linux 

machine-name#

Bourne shell and Korn shell on UNIX or Linux 

$

Bourne shell and Korn shell superuser on UNIX or Linux 

#

Windows command line 

C:\

Symbols

The following table describes the symbol conventions used in this book.

Table P–5 Symbol Conventions

Symbol  

Description  

Example  

Meaning  

[ ]

Contains optional 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.

-

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. 

Default Paths and File Names

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

Table P–6 Default Paths and File Names

Term  

Description  

install-dir

By default, the Application Server installation directory is located here: 

  • Sun Java Enterprise System installations on the Solaris platform:

    /opt/SUNWappserver/appserver

  • Sun Java Enterprise System installations on the Linux platform:

    /opt/sun/appserver/

  • Other Solaris and Linux installations, non-root user:

    user’s home directory/SUNWappserver

  • Other Solaris and Linux installations, root user:

    /opt/SUNWappserver

  • Windows, all installations:

    SystemDrive:\Sun\AppServer

domain-root-dir

By default, the directory containing all domains is located here: 

  • Sun Java Enterprise System installations on the Solaris platform:

    /var/opt/SUNWappserver/domains/

  • Sun Java Enterprise System installations on the Linux platform:

    /var/opt/sun/appserver/domains/

  • All other installations:

    install-dir/domains/

domain-dir

By default, each domain directory is located here: 

domain-root-dir/domain-dir

In configuration files, you might see domain-dir represented as follows:

${com.sun.aas.instanceRoot}