Oracle9i Application Server Administrator's Guide -- Index

access file log, 6-7

access log properties

changing, 6-9

access.conf, E-3

active EJB methods, 9-9, 9-11

active requests, 9-8, 9-10

active sessions, 9-8, 9-10

active transactions, 9-8

adding

access file log, 6-7

additional documentation, 1-6

administering users, 12-11

in a new Oracle Internet Directory, 12-11

in an existing Oracle Internet Directory, 12-11

administration

concepts, 2-1

infrastructure, 2-7

overview, 2-2

introduction, 1-1, 7-1

tasks for Oracle9iAS administrator, 1-2, 4-2

administrative privileges, 12-16

administrator email, 6-4

admin.jar tool

undeployment, 8-13

agent.xml, E-5

AJP

port numbers, D-2

AJP port, 13-9

ApJServGroup, 6-14

ApJServGroupMount, 6-15

ApJServGroupSecretKey, 6-15

ApJServManual, 6-14

apologies pages served, 9-13

application

example, 8-10

undeployment, 8-13

application server

administration

overview, 1-1

priorities, 1-2

backup and restore, H-2

clustering, 14-1

install types, 2-3, 2-4

installation, 2-3

installing

infrastructure, 2-9

restarting, 5-4

starting, 5-4

stopping, 5-4

application server enterprise

designing, 2-18

installing, 2-21

coexistence with other products, 2-21

oracle home, 2-21

managing, 2-24

application server instances, 2-24

clusters, 2-29

component instances, 2-26

farms, 2-28

reconfiguring, 2-29

applications

deploying, 8-1

AsynchNotification.properties, E-4

AsynchRequest.properties, E-4

auto-restart, 13-4

availability, 14-3

backup and restore, H-1

application server and infrastructure oracle homes, H-2

customer databases, H-2

metadata repository, H-2

Oracle Internet Directory, H-2

BC4J

starting, 5-12

stopping, 5-12

BLEWIS, C-4

cache clusters, 9-13, 13-4

cache.conf, E-3

CDOUGLAS, C-4

cgicmd.dat, E-5

changing

access log properties, 6-9

error log properties, 6-6

click-apache.conf, E-5

click-app.properties, E-5

client request, 6-9

CLKANA, C-2

cluster configuration, 14-26

clustered environment

dcmctl, F-5

clustering, 14-1, 14-1 to 14-39

application server instance

adding, 14-11

role, 14-9

architecture, 14-7

benefits, 14-2

availability, 14-3

manageability, 14-4

scalability, 14-2

cluster configuration, 14-26

component instances, 14-14

OC4J instance, 14-15

OC4J process, 14-17

Oracle HTTP Server, 14-14

configuration, 14-26

stateful session bean replication, 14-34

configure replication, 14-32

configuring

EJB application state replication, 14-33

EJB replication configuration in application JAR, 14-34

entity bean replication, 14-34

instance-specific parameters, 14-37

islands, 14-31

Oracle9iAS Single Sign-On, 14-35

processes, 14-31

Web application state replication, 14-32

configuring islands, 14-31

configuring OC4J instance, 14-15

configuring OC4J processes, 14-31

creating a cluster, 14-26

DCM, 14-12

deleting a cluster, 14-28

EJB applications, 14-19, 14-33

hardware load balancer, 14-8

instance-specific parameters, 14-26

OC4J, 14-37, 14-38

Oracle HTTP Server, 14-38

islands, 14-18

J2EE applications, 14-20

managed, 14-2

management features, 14-12

managing

application server instances in a cluster, 14-29

Oracle9iAS clusters, 14-26

non-managed, 14-2

OC4J instance, 14-17

OC4J instance configuration, 14-31

Oracle Enterprise Manager, 14-4

Oracle Enterprise Manager configuration tree, 14-21

Oracle HTTP Server role, 14-15

Oracle9iAS Web Cache, 14-10

overview, 14-2

removing application server instance, 14-30

replicating application state, 14-18

SSO, 14-35

state replication request, 14-20

tuning parameters, 14-22, 14-37

using infrastructure, 14-9

Web applications, 14-19, 14-32

clusters, 2-29

collector-agent.properties, E-5

component configuration dependencies, 7-1

metadata repository, 7-24

OPMN, 7-10

Oracle HTTP Server, 7-2

Oracle Internet Directory, 7-21

Oracle9i AS Single Sign-On, 7-17

Portal, 7-11

provider groups, 7-15

Web Cache, 7-7

Web providers, 7-13

Wireless, 7-16

components

restarting, 5-9

starting, 5-9

stopping, 5-9

config-file, 13-8, 13-9

path, 13-8

start-mode, 13-8

configuration

OC4J, 6-21

configuration files, E-1

JServ, E-3

jserv.conf, E-3

jserv.properties, E-3

zone.properties, E-3

mod_oradav, E-3

moddav.conf, E-3

mod_plsql, E-3

cache.conf, E-3

dad.conf, E-3

OPMN, E-6

Oracle HTTP Server, E-3

access.conf, E-3

httpd.conf, E-3

magic, E-3

mime.types, E-3

mod_oc4j.conf, E-3

oracle_apache.conf, E-3

srm.conf, E-3

Oracle Process Manager and Notification

ons.conf, E-6

opmn.xml, E-6

Oracle9iAS Clickstream Intelligence, E-5

agent.xml, E-5

click-apache.conf, E-5

click-app.properties, E-5

collector-agant.properties, E-5

Oracle9iAS Discoverer, E-5

configuration.xml, E-5

plus_config.xml, E-5

portal_config.xml, E-5

pref.txt, E-5

.reg_key.dc, E-5

viewer_config.xml, E-5

Oracle9iAS Forms Services, E-5

default.env, E-5

formsweb.cfg, E-5

Oracle9iAS Personalization, E-6

web.xml, E-6

Oracle9iAS Portal, E-4

oracle_portal.xml, E-4

oracle_sso_server.xml, E-4

targets.xml, E-4

Oracle9iAS Reports Services, E-5

cgicmd.dat, E-5

jdbcpds.conf, E-5

proxyinfo.xml, E-5

reports_server_name.conf, E-5

rwbuilder.conf, E-5

rwserver.template, E-5

rwservlet.properties, E-5

textpds.conf, E-5

xmlpds.conf, E-5

Oracle9iAS Single Sign-On, E-6

dad.conf, E-6

plsql.conf, E-6

Oracle9iAS Unified Messaging, E-6

DBToLDAPMigrationTool.properties, E-6

mod_osso.conf, E-6

oc4j.properties, E-6

plsql.conf, E-6

toolkit.properties, E-6

Oracle9iAS Web Cache, E-3

internal_admin.xml, E-3

internal.xml, E-3

webcache.xml, E-3

Oracle9iAS Wireless

AsynchNotification.properties, E-4

AsynchRequest.properties, E-4

Cookies.properties, E-4

EncodingSets.properties, E-4

Ftp.properties, E-4

LocalToCharsetMap.properties, E-4

LocationMark_en_US.properties, E-4

LocationMark.properties, E-4

MimeTypes.properties, E-4

Notification.properties, E-4

persistent.properties, E-4

Provisioning.properties, E-4

ProxyFirewall.properties, E-4

System.properties, E-4

System.properties.templ, E-4

UserAgents.properties, E-4

WebBeanProperties.properties, E-4

XMLXSL.properties, E-4

YPCategories.xml, E-4

server.xml file, 8-5

configuration.xml, E-5

configuring, 6-1

infrastructure, 2-9

OC4J

manual editing, 6-2

Oracle HTTP Server, 6-3

adding access file log, 6-7

changing access log properties, 6-9

changing error log properties, 6-6

connection handling, 6-9

creating DAD, 6-11

editing server configuration files, 6-10

managing client request, 6-9

manual editing, 6-2

modifying document root, 6-4

modifying group, 6-4

modifying user, 6-4

specifying listener port, 6-5

Oracle Management Server, 3-21

Oracle9iAS Web Cache, 6-23

overview, 6-2

connection handling, 6-9

connection metrics, 9-4

connection rerouting, 13-3

Cookies.properties, E-4

CPU, B-2

usage, 9-8, 9-13

create users, 12-11

createCluster, F-10

createComponent, F-9

creating

Database Access Descriptor, 6-11

OC4J instance, 6-21

custom, 13-11

environment, 13-11

gid, 13-11

maxRetry, 13-11

num_of_proc, 13-11

prop, 13-12

start, 13-11

custom user manager, 8-8

customer database, 2-11

backup and restore, H-2

dad.conf, E-3, E-6

dafault.env, E-5

data served, 9-13

Database Access Descriptor

creating, 6-11

DBToLDAPMigrationTool.properties, E-6

DCM, 14-12, C-2

clustering, 14-13

command-line utility, F-1

metadata repository schemas, C-2

overview, F-1

role in clustering, 14-12

dcmctl, 14-13, F-1

a app_name, F-4

administration, F-7

application, F-4

backup, F-13

cluster, F-4

cluster capabilities, F-5

clustered environment, F-5

command overview, F-3

commands and options, F-3

target options, F-3

universal options, F-4

component, F-4

componentType, F-4

createCluster, F-10

createComponent, F-9

DCM utility, F-1

debug, F-4

deployApplication, F-12

deploying applications, F-12

destroyInstance, F-8

executing from command file, F-14

execution from a file, F-14

execution from a shell, F-14

getComponentTypes, F-9

getError, F-2

getError command, F-2

getReturnStatus, F-2

getstart, F-7

help, F-2

help command, F-2

instance, F-4

isClusterable, F-10

isCompatible, F-10

joinCluster, F-10

leaveCluster, F-11

listApplications, F-13

listClusters, F-10

listComponents, F-8

listComponentTypes, F-9

listInstances, F-8, F-10

logdir, F-4

managing

application server instances, F-8

clusters, F-10

components, F-9

managing clusters, F-10

managing components, F-9

managing instances, F-8

oraclehome, F-4

overview, F-2

passing parameters, F-6

passing parameters to JVM, F-6

redeployApplication, F-12

removeCluster, F-10

removeComponent, F-9

resetFileTransaction, F-13

restart, F-7

restoreInstance, F-13

resyncInstance, F-8, F-11

saveInstance, F-13

saving a backup, F-13

shutdown, F-7

start, F-7

starting, F-7

stop, F-7

stopping, F-7

target option list, F-3

timeout, F-4

undeployApplication, F-13

universal option list, F-4

updateConfig, F-9, F-11

using dcmctl shell, F-14

validateEarFile, F-13

verbose, F-5

whichCluster, F-10

whichInstance, F-8

dcmctl shell, F-14

death detection, 13-2

debug, F-4

debugging

OC4J, 14-38

delegated administrative service, 12-8

delete users, 12-11

deleting

OC4J instance, 6-22

deploy EAR file, 8-2

deploy WAR file, 8-2

deployApplication, F-12

deploying

applications, 8-1

J2EE applications, 8-2

basic deployment, 8-3

Petstore Web Application Demo, 8-10

recovering from deployment errors, 8-13

deployment

error recovery, 8-13

deployment errors, 8-13

designing

application server enterprise, 2-18

destroyInstance, F-8

developer kits

memory requirement, B-3

directives

ApJServGroup, 6-14

ApJServGroupMount, 6-15

ApJServGroupSercetKey, 6-15

ApJServManual, 6-14

port, 6-13

Discoverer

starting, 5-12

stopping, 5-12

DISCOVERER5, C-2

discovering targets, 3-26

disk space, B-2

DISPLAY, 3-9

Distributed Configuration Management, 14-12

Distributed Configuration Management, see DCM

document root, 6-4

DSGATEWAY, C-3

DSSYS, C-3

Dynamic Configuration Management, 14-7

dynamically generated content, 13-4

EAR file

creation, 8-3

structure, 8-3

used in deployment, 8-3

edit user properties, 12-11

editing

server configuration files, 6-10

EJB

deployment, 8-3

replication, 14-34

EJB application state replication, 14-33

EJB replication configuration in application JAR, 14-34

emctl, 3-10, G-1

authenticate password, G-2

gencertrequest, G-2

installcert, G-2

set password, G-2

set ssl password, G-2

ssl off, G-2

ssl test, G-2

start, 3-10, G-2

status, 3-10, G-2

stop, 3-10, G-2

EncodingSets.properties, E-4

end of call replication, 14-34

Enterprise JavaBeans, see EJB

entity bean replication

configuring, 14-34

error log properties

changing, 6-6

error metrics, 9-4

failover, 13-2, 13-3

farms, 2-28

fault tolerance, 13-2

files

configuration, E-1

log, E-1

Forms

starting, 5-12

stopping, 5-12

formsweb.cfg, E-5

Ftp.properties, E-4

getComponentTypes, F-9

getError, F-2

getReturnStatus, F-2

getstart, F-7

gid, 13-7, 13-8, 13-11

group, 6-5

hardware load balancer, 14-8

hardware requirements, B-2

CPU, B-2

disk space, B-2

monitor, B-2

swap space, B-2

TMP, B-2

heap

usage, 9-8

high availability, 13-1

architecture, 13-5

benefits, 13-2

connection rerouting, 13-3

death detection and restart, 13-2

failover, 13-2

fault tolerance, 13-2

failure scenarios, 13-17

OC4J, 13-19

OPMN, 13-20

Oracle HTTP Server, 13-17

introduction, 13-2

Oracle9iAS Web Cache, 13-3

auto-restart, 13-4

cache clusters, 13-4

dynamically generated content, 13-4

failover, 13-3

load balancing, 13-3

surge protection, 13-4

httpd.conf, E-3

IIOP

port numbers, D-2

inCompatible, F-10

Infrastructure

memory requirement, B-3

infrastructure, 2-7

basic administration, 11-2

backing up and restoring, 11-3

starting and stopping, 11-2

managing, 11-1

instance, 11-3

metadata repository, 11-7

Oracle Internet Directory, 11-7

Oracle9iAS Single Sign-On, 11-4

metadata repository

changing password, 11-8

installation and configuration, 11-7

starting and stopping, 11-8

Oracle Internet Directory

starting and stopping, 11-12

Oracle9iAS Single Sign-On

accessing single sign-on server, 11-6

administrators, 11-5

installation and configuration, 11-5

multilingual support, 11-6

starting, 5-20, 5-23

infrastructure oracle homes

backup and restore, H-2

install types, 2-3

Business Intelligence and Forms, 2-4

J2EE and Web Cache, 2-4

Portal and Wireless, 2-4

Unified Messaging, 2-4

installation

application server, 2-3

installing

application server enterprise, 2-21

Intelligent Agent, 3-19

Oracle Enterprise Manager Console, 3-20

Oracle Management Server, 3-20

instanceName, 13-8

instance-specific parameters, 14-26

Intelligent Agent

installing, 3-19

starting, 3-21

stopping, 3-21

internal_admin.xml, E-3

internal.xml, E-3

Internet File System

starting, 5-12

stopping, 5-12

isClusterable, F-10

island, 13-9

islands, 14-18

J2EE and Web Cache

memory requirement, B-3

restarting, 5-7

starting, 5-7

stopping, 5-7

J2EE applications

deployment, 8-2

undeploying, 8-13

java object cache

port numbers, D-3

java-bin, 13-9

java-option, 13-9

JAZN LDAP user manager, 8-7

JAZN xml user manager, 8-7

jdbcpds.conf, E-5

JMS

port numbers, D-2

JMS port, 13-9

joinCluster, F-10

JServ

automatic mode, 6-17

coexistence with OC4J, 6-19

configuration files, E-3

directive reference, 6-13

jserv.conf, 6-14

jserv.properties, 6-13

enabling, 6-12

manual mode, 6-18

mod_oprocmgr, 6-16

OC4J, 6-19

starting, 5-13

stopping, 5-13

jserv.conf, E-3

port, 6-14, 6-15

jserv.properties, E-3

port, 6-13

JSP pages

deployment, 8-3

JVM, F-6

KWALKER, C-4

leaveCluster, F-11

listApplications, F-13

listClusters, F-10

listComponents, F-8

listComponentTypes, F-9

listener port

specifying, 6-5

listInstances, F-8, F-10

load balancing, 13-3

LocalToCharsetMap.properties, E-4

LocationMark_en_US.properties, E-4

LocationMark.properties, E-4

log files, E-1

logdir, F-4

log-file, 13-7, 13-16

magic, E-3

manageability, 14-4

managing

application server enterprise, 2-24

application server instances in a cluster, 14-29

adding, 14-29

removing, 14-30

infrastructure, 11-1

Oracle9iAS clusters, 14-26

Oracle9iAS Single Sign-On, 11-4

security, 12-1

manifest file, 8-3

maxRetry, 13-7, 13-8, 13-11

memory

usage, 9-8, 9-13

memory requirements, B-3

developer kits, B-3

Infrastructure, B-3

J2EE and Web Cache, B-3

metadata repository, 2-7

backup and restore, H-2

changing password, 11-8

component configuration dependencies, 7-24

installation and configuration, 11-7

managing, 11-7

schemas, C-1

starting and stopping, 11-8

metadata repository schemas

DCM, C-2

Oracle Certificate Manager, C-2

OCM_DB_ADMIN, C-2

Oracle Enterprise Manager, C-3

OEM_REPOSITORY, C-3

Oracle Internet Directory, C-3

ODS, C-3

ODSCOMMON, C-3

Oracle Workflow, C-4

Oracle9iAS Clickstream Intelligence, C-2

CLKANA, C-2

CLKRT, C-2

Oracle9iAS Discoverer, C-2

DISCOVERER5, C-2

Oracle9iAS InterConnect, C-2

OAIHUB9020, C-2

Oracle9iAS Portal, C-3

PORTAL, C-3

PORTAL_APP, C-3

PORTAL_DEMO, C-3

PORTAL_PUBLIC, C-3

Oracle9iAS Single Sign-On, C-3

ORASSO, C-3

ORASSO_PA, C-3

ORASSO_PUBLIC, C-3

Oracle9iAS Syndication Server, C-3

DSGATEWAY, C-3

Oracle9iAS Web Services, C-3

DSSYS, C-3

UDDISYS, C-3

Oracle9iAS Wireless, C-4

BLEWIS, C-4

CDOUGLAS, C-4

KWALKER, C-4

OWF_MGR, C-4

SYSADMIN, C-4

WFADMIN, C-4

SCOTT, C-2

SYS, C-2

SYSTEM, C-2

method execution rate, 9-9, 9-11

metrics

connection, 9-4

error, 9-4

system usage, 9-3

mime.types, E-3

MimeTypes.properties, E-4

mod_oc4j, 13-5

mod_oc4j.conf, E-3

mod_oprocmgr, 6-16

mod_jserv, 6-16

mod_oradav

configuration files, E-3

mod_osso.conf, E-6

mod_plsql

configuration files, E-3

moddav.conf, E-3

modifying

document root setting, 6-4

group setting, 6-4

user settings, 6-4

monitoring

OC4J, 9-1, 9-6

application pages, 9-9

OC4J Home Page, 9-6

Oracle HTTP Server, 9-1, 9-2

metrics page, 9-3

module metrics page, 9-5

Oracle HTTP Server Home Page, 9-2

response and load metrics page, 9-5

Oracle9iAS Web Cache, 9-1, 9-11

activity page, 9-14

application Web servers page, 9-16

Oracle9iAS Web Cache Home Page, 9-12