Contents 1 Overview 3 1.1 Features - Resin and Resin Professional . .3 2 Installation 11 2.1 Resin Installation Quick Start . 11 2.2 Resin Installation . 16 2.3 Resin Web Server . 16 2.4 Resin with Apache . 22 2.5 Resin with IIS . 34 2.6 How the Plugins Dispatch to Resin . 44 3 Command-Line 47 3.1 Command-Line Configuration . 47 4 Admin Guide 51 4.1 User Guide: Administration . 51 5 Watchdog 63 5.1 Resin Watchdog . 63 6 Virtual Hosts 73 6.1 Virtual Hosting . 73 7 Clustering 89 7.1 Resin Clustering . 89 8 Web Applications 109 8.1 An Overview of Web Applications . 109 9 Logging 137 9.1 Log . 137 10 Administration 163 10.1 Resin Administration . 163 1 CONTENTS 11 Deployment 177 11.1 Packaging/Deployment . 177 12 Proxy Caching 181 12.1 Server Caching . 181 13 Quercus 193 13.1 Quercus: PHP in Java . 193 14 Security 217 14.1 Resin Security . 217 15 Inversion of Control 271 15.1 Resin IoC . 271 15.2 Scheduled Task . 308 16 Amber 327 16.1 Amber . 327 17 Embedding Resin 355 17.1 Embedding Resin . 355 18 Filters 367 18.1 Filters . 367 19 BAM 379 19.1 BAM . 379 20 Comet 405 20.1 Comet/Server-Push Servlet . 405 21 Remoting 411 21.1 Resin Remoting . 411 21.2 Hessian . 417 22 Messaging 423 22.1 Resin Messaging . 423 23 JSF - Java Server Faces 435 23.1 JSF - Java Server Faces . 435 24 Configuration Tags 445 24.1 cluster: Cluster tag configuration . 445 24.1.1 <access-log> ......................... 445 24.1.2 <cache> ........................... 445 24.1.3 <cluster> ........................... 447 24.1.4 <cluster-default> ...................... 450 24.1.5 <connection-error-page> .................. 450 2 CONTENTS 24.1.6 <development-mode-error-page> .............. 451 24.1.7 <ear-default> ........................ 451 24.1.8 <error-page> ......................... 451 24.1.9 <host> ............................ 451 24.1.10 <host-default> ........................ 452 24.1.11 <host-deploy> ........................ 452 24.1.12 <ignore-client-disconnect> ................. 453 24.1.13 <invocation-cache-size> ................... 453 24.1.14 <invocation-cache-max-url-length> ............ 453 24.1.15 <persistent-store> ...................... 454 24.1.16 <ping> ............................ 457 24.1.17 Resource Tags . 459 24.1.18 <rewrite-dispatch> ..................... 459 24.1.19 <root-directory> ....................... 460 24.1.20 <server> ........................... 460 24.1.21 <server-default> ....................... 465 24.1.22 <server-header> ....................... 465 24.1.23 <session-cookie> ....................... 466 24.1.24 <session-sticky-disable> ................... 466 24.1.25 <session-url-prefix> ..................... 466 24.1.26 <ssl-session-cookie> ..................... 467 24.1.27 <url-character-encoding> .................. 467 24.1.28 <web-app-default> ..................... 467 24.2 database: Database tag configuration . 468 24.2.1 <connection-wait-time> ................... 468 24.2.2 <close-dangling-connections> ................ 468 24.2.3 <driver> ........................... 468 24.2.4 <database> .......................... 469 24.2.5 <max-active-time> ..................... 470 24.2.6 <max-close-statements> ................... 470 24.2.7 <max-connections> ..................... 470 24.2.8 <max-create-connections> ................. 471 24.2.9 <max-idle-time> ....................... 471 24.2.10 <max-pool-time> ...................... 471 24.2.11 <password> ......................... 471 24.2.12 <ping> ............................ 471 24.2.13 <ping-table> ......................... 472 24.2.14 <ping-query> ........................ 472 24.2.15 <ping-interval> ....................... 472 24.2.16 <prepared-statement-cache-size> .............. 472 24.2.17 <save-allocation-stack-trace> ................ 472 24.2.18 <spy> ............................. 473 24.2.19 <transaction-timeout> ................... 473 24.3 <host>: Virtual Host configuration . 473 24.3.1 <access-log> ......................... 473 24.3.2 <ear-deploy> ......................... 476 3 CONTENTS 24.3.3 <error-page> ......................... 477 24.3.4 <host> ............................ 477 24.3.5 <host-alias> ......................... 479 24.3.6 <host-alias-regexp> ..................... 479 24.3.7 <host-default> ........................ 480 24.3.8 <host-deploy> ........................ 480 24.3.9 <host-name> ......................... 481 24.3.10 <redeploy-mode> ...................... 481 24.3.11 Resources . 482 24.3.12 <rewrite-dispatch> ..................... 482 24.3.13 <root-directory> ....................... 483 24.3.14 <secure-host-name> ..................... 483 24.3.15 <startup-mode> ....................... 483 24.3.16 <web-app> .......................... 484 24.3.17 <web-app-default> ..................... 486 24.3.18 <web-app-deploy> ...................... 486 24.4 port: Port tag configuration . 489 24.4.1 <accept-listen-backlog> ................... 489 24.4.2 <accept-thread-max> .................... 489 24.4.3 <accept-thread-min> .................... 489 24.4.4 <address> .......................... 489 24.4.5 <ca-certificate-file> (OpenSSL) . 490 24.4.6 <ca-certificate-path> (OpenSSL) . 490 24.4.7 <ca-revocation-file> (OpenSSL) . 490 24.4.8 <ca-revocation-path> (OpenSSL) . 490 24.4.9 <certificate-file> (OpenSSL) . 490 24.4.10 <certificate-chain-file> (OpenSSL) . 490 24.4.11 <certificate-key-file> (OpenSSL) . 490 24.4.12 <cipher-suite> (OpenSSL) . 490 24.4.13 <cluster-port> ........................ 491 24.4.14 <connection-max> ...................... 491 24.4.15 <http> ............................ 491 24.4.16 <jsse-ssl> ........................... 492 24.4.17 <keepalive-max> ....................... 493 24.4.18 <openssl> .......................... 493 24.4.19 <password> (OpenSSL) . 494 24.4.20 <port> ............................ 494 24.4.21 <protocol> .......................... 494 24.4.22 <protocol> (OpenSSL) . 495 24.4.23 <session-cache> (OpenSSL) . 495 24.4.24 <session-cache-timeout> (OpenSSL) . 495 24.4.25 <socket-timeout> ...................... 495 24.4.26 <tcp-no-delay> ........................ 495 24.4.27 <unclean-shutdown> (OpenSSL) . 495 24.4.28 <verify-client> (OpenSSL) . 496 24.4.29 <verify-depth> (OpenSSL) . 496 4 CONTENTS 24.5 Resources: class loaders, environment and IoC . 496 24.5.1 <authenticator> ....................... 496 24.5.2 <bam-service> ........................ 498 24.5.3 <bean> ............................ 499 24.5.4 <case-insensitive> ...................... 500 24.5.5 <character-encoding> .................... 501 24.5.6 <class-loader> ........................ 502 24.5.7 <compiling-loader> ..................... 503 24.5.8 <component> ........................ 504 24.5.9 <connection-factory> .................... 505 24.5.10 <database> .......................... 507 24.5.11 <database-default> ..................... 512 24.5.12 <dependency> ........................ 513 24.5.13 <dependency-check-interval> ................ 514 24.5.14 <ejb-message-bean> ..................... 514 24.5.15 <ejb-server> ......................... 516 24.5.16 <ejb-stateful-bean> ..................... 517 24.5.17 <ejb-stateless-bean> ..................... 518 24.5.18 <env-entry> ......................... 519 24.5.19 <fileset> ........................... 521 24.5.20 <javac> ............................ 523 24.5.21 <jms-connection-factory> .................. 525 24.5.22 <jms-queue> ......................... 525 24.5.23 <jms-topic> ......................... 526 24.5.24 <jndi-link> .......................... 527 24.5.25 <jpa-persistence> ...................... 529 24.5.26 <library-loader> ....................... 530 24.5.27 <log> ............................. 531 24.5.28 <logger> ........................... 533 24.5.29 <mail> ............................ 533 24.5.30 <reference> .......................... 535 24.5.31 <remote-client> ....................... 536 24.5.32 <resin:choose> ........................ 537 24.5.33 <resin:if> ........................... 541 24.5.34 <resin:import> ........................ 541 24.5.35 <resin:message> ....................... 544 24.5.36 <resin:set> .......................... 544 24.5.37 <resource> .......................... 545 24.5.38 <resource-adapter> ..................... 546 24.5.39 <resource-deploy> ...................... 547 24.5.40 <resource-ref> ........................ 548 24.5.41 <scheduled-task> ...................... 549 24.5.42 <servlet-hack> ........................ 551 24.5.43 <simple-loader> ....................... 552 24.5.44 <stderr-log> ......................... 553 24.5.45 <stdout-log> ......................... 554 5 CONTENTS 24.5.46 <system-property> ..................... 555 24.5.47 <temp-dir> .......................... 556 24.5.48 <tree-loader> ........................ 557 24.5.49 <work-dir> .......................... 558 24.6 URL rewrite tags . 559 24.6.1 <and> ............................ 559 24.6.2 auth-type . 559 24.6.3 cookie . 559 24.6.4 disable-at . 560 24.6.5 <dispatch> .......................... 560 24.6.6 dispatch-type . 561 24.6.7 enable-at . 561 24.6.8 enabled . 561 24.6.9 <forbidden> ......................... 561 24.6.10 <forward> .......................... 562 24.6.11 header . 563 24.6.12 <gone> ............................ 563 24.6.13 <import> ........................... 564 24.6.14 <load-balance> ....................... 566 24.6.15 locale . 568 24.6.16 local-port . 568 24.6.17 method . 569 24.6.18 <match> ........................... 569 24.6.19 <moved-permanently> ................... 570 24.6.20 name . 571 24.6.21 <not> ............................. 571 24.6.22 <or> ............................. 571 24.6.23 <not-found> ........................