OracleGlassFishServerAdministrationGuide.pdf资源-CSDN文库

Glassfish

需积分: 4 60 浏览量 2020-02-16 08:49:00 上传评论收藏 2.15MB PDF 举报

资源推荐

资源详情

资源评论

Oracle GlassFish Server

Administration Guide

Release 3.1.2

E24928-01

February 2012

Oracle GlassFish Server 3.1.2 Administration Guide provides

instructions for configuring and administering Oracle

GlassFish Server.

Oracle GlassFish Server Administration Guide, Release 3.1.2

E24928-01

This software and related documentation are provided under a license agreement containing restrictions on

use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your

license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,

transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse

engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is

prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If

you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it

on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data

delivered to U.S. Government customers are "commercial computer software" or "commercial technical data"

pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As

such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and

license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of

the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software

License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software or hardware is developed for general use in a variety of information management

applications. It is not developed or intended for use in any inherently dangerous applications, including

applications that may create a risk of personal injury. If you use this software or hardware in dangerous

applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other

measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages

caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of

their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks

are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD,

Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced

Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information on content, products,

and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly

disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle

Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your

access to or use of third-party content, products, or services.

iii

Contents

Preface ............................................................................................................................................................... xix

1 Overview of GlassFish Server Administration

Default Settings and Locations.............................................................................................................. 1-1

Configuration Tasks................................................................................................................................. 1-2

Initial Configuration Tasks............................................................................................................... 1-2

How Dotted Names Work for Configuration................................................................................ 1-4

Configuration Files ............................................................................................................................ 1-5

Impact of Configuration Changes ................................................................................................... 1-6

Administration Tools............................................................................................................................... 1-9

Administration Console.................................................................................................................... 1-9

asadmin

Utility................................................................................................................................. 1-10

REST Interfaces................................................................................................................................ 1-10

Update Tool...................................................................................................................................... 1-10

OSGi Module Management Subsystem....................................................................................... 1-11

keytool

Utility................................................................................................................................. 1-16

Java Monitoring and Management Console (JConsole) ............................................................ 1-16

Instructions for Administering GlassFish Server........................................................................... 1-16

Part I Runtime Administration

2 General Administration

Using the

asadmin

Utility........................................................................................................................ 2-1

Path to the

asadmin

Utility................................................................................................................ 2-1

asadmin

Utility Syntax....................................................................................................................... 2-1

To Run an

asadmin

Utility Subcommand in Single Mode ........................................................... 2-3

To Display Help Information for the

asadmin

Utility or a Subcommand ................................. 2-4

To Start a Multimode Session........................................................................................................... 2-4

To End a Multimode Session............................................................................................................ 2-5

To Run a Set of

asadmin

Subcommands From a File .................................................................... 2-6

Administering System Properties ......................................................................................................... 2-7

To Create System Properties............................................................................................................. 2-7

To List System Properties ................................................................................................................. 2-7

To Delete a System Property ............................................................................................................ 2-8

Administering Resources........................................................................................................................ 2-8

To Add Resources From an XML File............................................................................................. 2-8

Listing Various System Elements.......................................................................................................... 2-9

To Display the GlassFish Server Version........................................................................................ 2-9

To List Applications........................................................................................................................ 2-10

To List Containers........................................................................................................................... 2-10

To List Modules............................................................................................................................... 2-11

To List Subcommands .................................................................................................................... 2-12

To List Timers.................................................................................................................................. 2-12

To Show Component Status .......................................................................................................... 2-13

Using REST Interfaces to Administer GlassFish Server ............................................................... 2-13

Using REST URLs to Administer GlassFish Server ................................................................... 2-14

Using REST Resource Methods to Administer GlassFish Server............................................. 2-16

Resources for

asadmin

Subcommands That Perform Non-CRUD Operations...................... 2-25

Securing GlassFish Server REST Interfaces................................................................................. 2-26

Formats for Resource Representation of Configuration Objects.............................................. 2-27

Formats for Resource Representation of Monitoring Objects .................................................. 2-36

Formats for Resource Representation of Log File Details......................................................... 2-43

Supported Content Types in Requests to REST Resources....................................................... 2-47

3 Administering Domains

About Administering Domains............................................................................................................. 3-1

GlassFish Server Instances................................................................................................................ 3-1

Domains for Administering GlassFish Server ............................................................................... 3-2

Domain Administration Server (DAS)............................................................................................ 3-2

Creating, Logging In To, and Deleting a Domain.............................................................................. 3-3

To Create a Domain ........................................................................................................................... 3-3

To Create a Domain From a Custom Template............................................................................. 3-4

To List Domains ................................................................................................................................. 3-7

To Log In to a Domain....................................................................................................................... 3-7

To Delete a Domain ........................................................................................................................... 3-9

Starting and Stopping a Domain........................................................................................................... 3-9

To Start a Domain .............................................................................................................................. 3-9

To Stop a Domain............................................................................................................................ 3-10

To Restart a Domain ....................................................................................................................... 3-11

Configuring a DAS or a GlassFish Server Instance for Automatic Restart ............................... 3-12

To Configure a DAS or an Instance for Automatic Restart on Windows............................... 3-12

To Configure a DAS or an Instance for Automatic Restart on Linux...................................... 3-13

To Configure a DAS or an Instance for Automatic Restart on Oracle Solaris........................ 3-14

To Prevent Service Shutdown When a User Logs Out on Windows ...................................... 3-15

Suspending and Resuming a Domain .............................................................................................. 3-16

To Suspend a Domain .................................................................................................................... 3-16

To Resume a Domain...................................................................................................................... 3-17

Setting Up Automatic Backups of a Domain................................................................................... 3-17

To Create a Backup Configuration ............................................................................................... 3-18

To List Backup Configurations ..................................................................................................... 3-19

To Enable a Backup Configuration............................................................................................... 3-20

To Disable a Backup Configuration ............................................................................................. 3-21

To Delete a Backup Configuration ............................................................................................... 3-21

To Create a Schedule ...................................................................................................................... 3-22

To List Schedules............................................................................................................................. 3-22

To Delete a Schedule....................................................................................................................... 3-23

Backing Up and Restoring a Domain................................................................................................ 3-23

To Back Up a Domain..................................................................................................................... 3-24

To Restore a Domain ...................................................................................................................... 3-24

To List Domain Backups................................................................................................................ 3-25

Re-Creating the Domain Administration Server (DAS)................................................................ 3-25

To Migrate the DAS ........................................................................................................................ 3-26

Additional Domain Tasks.................................................................................................................... 3-27

To Display Domain Uptime........................................................................................................... 3-27

To Switch a Domain to Another Supported Java Version ........................................................ 3-28

To Change the Administration Port of a Domain ...................................................................... 3-28

4 Administering the Virtual Machine for the Java Platform

Administering JVM Options ................................................................................................................. 4-1

To Create JVM Options ..................................................................................................................... 4-1

To List JVM Options .......................................................................................................................... 4-2

To Delete JVM Options ..................................................................................................................... 4-3

To Generate a JVM Report................................................................................................................ 4-3

Administering the Profiler ..................................................................................................................... 4-4

To Create a Profiler ............................................................................................................................ 4-4

To Delete a Profiler ............................................................................................................................ 4-5

5 Administering Thread Pools

About Thread Pools ................................................................................................................................. 5-1

Configuring Thread Pools ...................................................................................................................... 5-1

To Create a Thread Pool.................................................................................................................... 5-1

To List Thread Pools.......................................................................................................................... 5-2

To Update a Thread Pool .................................................................................................................. 5-3

To Delete a Thread Pool.................................................................................................................... 5-3

6 Administering Web Applications

Invoking a Servlet by Alternate Means ............................................................................................... 6-1

Changing Log Output for a Servlet ...................................................................................................... 6-2

Defining Global Features for Web Applications .............................................................................. 6-2

To Use the

default-web.xml

File .................................................................................................... 6-3

Redirecting a URL .................................................................................................................................... 6-3

Administering

mod_jk

.............................................................................................................................. 6-3

To Enable

mod_jk

................................................................................................................................ 6-3

To Load Balance Using

mod_jk

and GlassFish Server .................................................................. 6-5

To Enable SSL Between the

mod_jk

Load Balancer and the Browser......................................... 6-6