Contents

Title and Copyright Information

Preface

• GlassFish Server Documentation Set
• Related Documentation
• Typographic Conventions
• Symbol Conventions
• Default Paths and File Names
• Documentation, Support, and Training
• Searching Oracle Product Documentation
• Documentation Accessibility

1 Overview of Oracle GlassFish Server Troubleshooting

• Identifying the Problem
  • First Steps
    • Verify System Requirements and Configuration
    • Review Known Issues
    • Search the Product Documentation
    • Search the GlassFish Mailing Lists and Forums
  • Gathering Information
    • When Does the Problem Occur?
    • What Is Your Environment?
    • What Is Your System Configuration?
    • What Is Different?
  • Examining Log Files
  • Monitoring the System
• Troubleshooting Tools
  • Operating System Utilities
  • Stack Traces and Thread Dumps
    • To Obtain a Server Thread Dump
  • VisualVM
  • JVM Command-Line Tools
• Where to Go for More Information
• Oracle GlassFish Server Support

2 Specific Issues

• Cannot Access Local Server (http://localhost:8080)
  • Did the Server Start?
    • Description
  • Was the Server Started at the Expected Port?
    • Description
  • Is a Personal Firewall Enabled?
• Cannot Access Remote Server
  • Is the Server Available Locally?
    • Description
    • Solution
  • Is the Proxy Setting Causing a Problem?
    • Description
    • Solution
• Cannot Access the Administration Console
  • Is the Application Server Running?
    • Description
    • Solution
  • Is the Administration Console Running on the Expected Port?
    • Description
    • Solution
• Cannot Access a Server Application
  • Is the Application Server Running?
    • Description
    • Solution
  • Was Application Deployment Successful?
    • Description
    • Solution
• Administrator User Name or Password Not Known
• Experience Issues Related to the JDK
  • Description
  • Solution
• Server Will Not Start on Windows (Port Conflict)
  • Is Another Application Running on the Server's Port?
  • Has an Ungraceful Shutdown Occurred on a Previously Running Server?
• Two Server Instances Bind to Same Port on Windows
  • Description
  • Solution
• Cannot Produce a JVM Thread Dump After Server Crash
  • Description
  • Solution
    • To Obtain a Server Thread Dump
• Issues Related to Applications
  • Cannot Undeploy or Redeploy Application With Open Streams to jar Files (Windows)
    • Description
    • Solution
  • MaxPermGen Exception
    • Description
    • Solution
• Issues Related to asadmin
  • asadmin start-domain Command Fails
    • Description
    • Solution
  • Cannot Stop Domain Using asadmin stop-domain
    • Description
    • Solution
• Issues Related to Installation
  • Installation Hangs During Update Tool Configuration
    • Description
    • Solution
  • GlassFish Server Components Not Removed During Uninstallation
    • Description
    • Solution
• Issues Related to Security
  • java.security.AccessControlException: Access Denied Error
    • Description
    • Solution
  • Mutual Authentication Not Working With the Application Client
    • Description
    • Solution

3 Frequently Asked Questions

• Administration FAQs
  • Which asadmin Commands are Supported?
• Application FAQs
  • How Do I Debug Applications?
  • How Do I Change Application Permissions?
  • What Are the Restrictions and Optimizations for Session Beans?
• Eclipse FAQs
  • Where Can I Find More Information About Eclipse and GlassFish Server Integration?
• Extensibility FAQs
  • How Do I Develop Add-On Components?
  • How Do I Add Containers?
  • How Do I Extend the Administration Console?
• Java Persistence FAQs
  • What Are the Restrictions and Optimizations for the Java Persistence API?
• Update Tool FAQs
  • How Do I Use Update Tool to Extend My GlassFish Server Installation?
  • How Do I Turn Off the Notifier?
    • To Turn Off the Notifier