Oracle9iAS Containers for J2EE User's Guide -- Index

<ejb> element, 7-13

<ejb-ref> element, 8-16

<java> element, 7-13

<method-permission> element, 8-18

<module> element, 7-13

<security-role> element, 8-18

<security-role-mapping> element, 8-19

<sep-config> element, A-12

<web> element, 7-13

ACL

defined, 1-14

administration, 2-11

admin.jar tool

undeployment, 2-29

AJP, 1-16

overview, 2-5

ANT, 2-19

Apache

Oracle HTTP Server, 2-2

Apache JServ protocol, see AJP

application

deployment, 2-20

example, 2-14

undeployment, 2-29

ApplicationClientInitialContextFactory, 8-16

application-client.xml file

example, A-18

application.xml

designating data-sources.xml, 4-7

application.xml file, 7-13

example, 7-14, A-14

overview, 7-13

archiving

directions, 7-12

EAR file, 7-14

EJBs, 7-12

authentication, 8-2, 8-6

authorization, 8-2, 8-17

bean

creating, 7-4

implementation, 7-8

removal, 7-15

build.bat, 2-19

CGI, 5-3

CLASSPATH, 2-6

Cloudscape database, 2-18

clustered environment

dcmctl, B-5

clustering, 9-1 to 9-41

adding application server instance, 9-12

application server instance

role, 9-10

architecture, 9-8

configuration, 9-28

configure replication, 9-34

configuring islands, 9-33

configuring OC4J instance, 9-17

configuring OC4J processes, 9-33

creating a cluster, 9-28

DCM, 9-13, 9-14

deleting a cluster, 9-30

EJB applications, 9-20, 9-35

hardware load balancer, 9-9

OC4J instance, 9-19

OHS role, 9-16

removing application server instance, 9-33

replicating application state, 9-19

SSO, 9-37

tuning parameters, 9-23, 9-39

using infrastructure, 9-10

Web applications, 9-20, 9-34

clusters, 1-16

com.evermind.server.RMIInitialContextFactory class, 8-16

command-line options, 3-5

configuration

default, 2-2, 2-12

EJB deployment descriptor, 2-18

server.xml file, 2-22

Web context, 3-29

web.xml file, 2-18

connection pooling, 1-11

create method, 7-15

EJBHome interface, 7-4

createCluster, B-8

createComponent, B-8

CreateException, 7-5, 7-6

createUser method, 8-3

DAS, 8-4, 8-9

data source

default, 4-2

definition, 4-2

emulated, 4-2

introduction, 4-1

location of XML file, 4-7

retrieving connection, 4-8

database

retrieving connection, 4-8

DataSource interface, 4-9, 8-23

data-sources.xml

designating location, 4-7

data-sources.xml file

pre-installed definitions, 4-2

DataSourceUserManager class, 8-23

DCM

clustering, 9-15

overview, 2-4, B-1

role in clustering, 9-13, 9-14

DCM command-line utility, B-1

dcmctl, B-1

a app_name, B-4

administration, B-6

application, B-4

backup, B-11

cluster, B-4

cluster capabilities, B-5

clustered environment, B-5

command overview, B-3

commands and options, B-3

target options, B-3

universal options, B-4

component, B-4

componentType, B-4

createCluster, B-8

createComponent, B-8

DCM utility, 2-4, B-1

debug, B-4

deployApplication, B-10

deploying applications, B-10

destroyInstance, B-7

executing from command file, B-12

execution from a file, B-12

execution from a shell, B-12

getComponentTypes, B-8

getError, B-2

getError command, B-2

getReturnStatus, B-2

getstart, B-7

help, B-2

help command, B-2

instance, B-4

isClusterable, B-9

isCompatible, B-9

joinCluster, B-9

leaveCluster, B-9

listApplications, B-11

listClusters, B-8

listComponents, B-7

listComponentTypes, B-8

listInstances, B-7, B-8

logdir, B-4

managing

application server instances, B-7

clusters, B-8

components, B-8

managing clusters, B-8

managing components, B-8

managing instances, B-7

oraclehome, B-4

overview, B-2

passing parameters, B-6

passing parameters to JVM, B-6

redeployApplication, B-10

removeCluster, B-8

removeComponent, B-8

resetFileTransaction, B-11

restart, B-7

restoreInstance, B-11

resyncInstance, B-7, B-9

saveInstance, B-11

saving a backup, B-11

shutdown, B-7

start, B-6

starting, B-6

stop, B-6

stopping, B-6

target option list, B-3

timeout, B-4

undeployApplication, B-11

universal option list, B-4

updateConfig, B-8, B-9

using dcmctl shell, B-12

validateEarFile, B-11

verbose, B-5

whichCluster, B-9

whichInstance, B-7

dcmctl shell, B-12

debug, B-4

debugging

OC4J, 9-41

default-web-site.xml file, 3-28

example, A-17

Delegated Administrative Service, see DAS

deployApplication, B-10

deployment

applications, 2-20

error recovery, 2-29

example, 2-17

deployment descriptor, 7-11

destroy method, 5-10

destroyInstance, B-7

development

recommendations, 2-13

Distributed Configuration Management, see DCM

DTD file, 7-11

EAR file, 7-1

creation, 2-21, 7-14

structure, 2-20

used in deployment, 2-20

EJB

archive, 7-12

creating, 7-2, 7-4, 7-8

definition, 1-7

deployment, 2-20

deployment descriptor, 7-11

development suggestions, 7-2

entity bean, 1-8

home interface, 7-4

interact with JSPs, 6-2

local interface, 7-7

remote interface, 7-6

replication, 9-36

session bean, 1-7

ejbCreate method, 7-4

EJBException, 7-5, 7-6, 7-7

EJBHome interface, 7-4, 7-5

ejb-jar.xml file, 7-11

example, A-15

EJBLocalHome interface, 7-4, 7-6

EJBLocalObject interface, 7-4, 7-7

EJBObject interface, 7-4, 7-6

ejb.xml file, 2-18

Enterprise Archive file, see EAR file

Enterprise JavaBeans, see EJB

EntityBean interface, 7-4

environment

modifications, 2-18

failover, 1-16

fault tolerance, 1-16

firewall tunneling, 1-14

front-end listener

Oracle HTTP Server, 2-2

getComponentTypes, B-8

getConnection method, 4-9

getError, B-2

getGroup method, 8-3

getReturnStatus, B-2

getstart, B-7

getUser method, 8-3

hashtable, A-19

home interface

creating, 7-4

lookup, 7-15

HTTP tunneling, 1-15

identities, 8-2

inCompatible, B-9

installation

requirements, 2-6

isClusterable, B-9

J2EE

capabilities, 1-2

definition, 1-1

version, 1-2

JAR

archiving command, 7-12

jar command, 7-12

JAR file

EJB, 7-12

Java

command-line options, 3-5

Java Messaging Service, see JMS

Java Transaction API, see JTA

JAVA_HOME variable, 2-18

JavaBeans

JSP code to call a JavaBean, 6-8

jazn-data.xml, 8-19

jazn-data.xml file, 8-3, 8-4, 8-12

JAZNUserManager class, 8-4

JDBC

defined, 1-10

drivers specified, 1-11

retrieving connection, 4-8

JDBC-OCI driver, 1-11

JDK, 1-1

Jikes, A-10

JMS, 1-16, A-4

defined, 1-13

JNDI

defined, 1-12

lookup, 7-15

lookup of data source, 4-8

joinCluster, B-9

JSP pages

caching tags, 1-6

code to call a JavaBean, 6-8

code to use a tag library, 6-11

definition, 1-5

deployment, 2-20

interact with EJBs, 6-2

overview, 6-2

overview of Oracle value-added features, 6-15

placing tag library files into OC4J directory structure, 6-12

running in OC4J, 6-6

simple example code, 6-2

steps in using a tag library, 6-11

JSP technology

overview, 6-2

JTA, 1-12, 1-13

JVM, 1-1, B-6

LDAP, 8-4

LDAP-based provider type, 8-4

leaveCluster, B-9

Lightweight Directory Access Protocol, see LDAP

listApplications, B-11

listClusters, B-8

listComponents, B-7

listComponentTypes, B-8

listInstances, B-7, B-8

local home interface

example, 7-6

local interface

creating, 7-7

example, 7-8

logdir, B-4

manifest file, 2-17, 2-21

creation, 2-18

MDB, 1-8

Message-Driven Bean, see MDB

mod_oc4j module, 2-5, 8-13

mod_ossl, 8-4

mod_osso, 8-4

narrowing, 7-15

OC4J

application example, 2-14

clustering role, 9-19

command-line options, 3-5

debugging, 9-41

installation requirements, 2-6

restarting, 2-11

setup, 2-2

startup, 2-11

stopping, 2-11

testing, 2-12

OC4J options, 2-29

Oc4jMount directive, 3-29

OCI driver, 1-11

ODBC, 1-10

OHS

clustering role, 9-16

Open Database Connectivity, see ODBC

OPMN

role in clustering, 9-15

Oracle HTTP Server

clustering role, 9-16

front-end listener, 2-2

Oracle HTTP Server (OHS), 3-29

Oracle Internet Directory, 8-2, 8-3, 8-4

Oracle JDBC-OCI driver, 1-11

Oracle Net Services protocol, 1-11

Oracle Process Management Notification, see OPMN

Oracle Thin JDBC driver, 1-11

oraclehome, B-4

orion-application-client.xml file

example, A-18

Out of Memory error, 2-29

Pet Store

example, 2-17

pooling

support, 1-11

PortableRemoteObject

narrow method, 7-15

principals.xml file, 8-3, 8-5, 8-13, 8-19, 8-23

query string, 5-6

RAR, 3-31

redeployApplication, B-10

remote home interface

example, 7-5

remote interface

business methods, 7-15

creating, 7-4, 7-6

example, 7-7

RemoteException, 7-5, 7-7

remove method, 7-15

removeCluster, B-8

removeComponent, B-8

requirements

software, 2-6

resetFileTransaction, B-11

Resource Adapter Achieve, see RAR

restart, B-7

restart OC4J, 2-11

restoreInstance, B-11

resyncInstance, B-7, B-9

RMI, A-4

roles, 8-2

run-as identity, 8-4

saveInstance, B-11

Secure Sockets Layer, see SSL

security

defined, 1-13, 8-1

mapping logical roles, 8-19

server.xml file, 2-22

example, A-17

servlets

definition, 1-3

deployment, 2-20

engine support, 1-4

failover, 1-5

session bean

local home interface, 7-6

remote home interface, 7-5

SessionBean interface

EJB, 7-4

setParent method, 8-23

shutdown, B-7

Single Sign-on, see SSO

SSL, 1-14

SSO, 8-4

starting

dcmctl, B-6

startup OC4J, 2-11

stop, B-6

stop OC4J, 2-11

stopping

dcmctl, B-6

tag libraries

JSP code to use, 6-11

placing support files in OC4J directory structure, 6-12

steps to use in a JSP page, 6-11

Thin JDBC driver, 1-11

timeout, B-4

Tomcat, 1-4

undateConfig, B-8

undeployApplication, B-11

undeployment, 2-29

updateConfig, B-9

user manager

definition, 8-2

user repository, 8-17

definition, 8-2

jazn-data.xml, 8-3, 8-4, 8-12, 8-19

Oracle Internet Directory, 8-3, 8-4

principals.xml, 8-3, 8-5, 8-13, 8-19, 8-23

UserManager interface, 8-20

validateEarFile, B-11

verbose, B-5

WAR

definition, 1-4

Web

application deployment, 2-20

mount points, 3-29

Web Application Archive, see WAR

Web context

customization, 3-29

web.xml file, 2-18

example, A-14

whichCluster, B-9

whichInstance, B-7

Windows Explorer, 2-19

XML-based provider type, 8-4

XMLUserManager class, 8-23

Index

Symbols

A

B

C

D

E

F

G

H

I

J

L

M

N

O

P

Q

R

S

T

U

V

W

X