Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Documentation Accessibility

Related Documents

1 Distributed Configuration Management Overview

1.1 What is Distributed Configuration Management?

1.1.1 Elements of a Distributed Configuration

1.1.1.1 What is an Oracle Application Server Instance?

1.1.1.2 What is a DCM-Managed Oracle Application Server Cluster?

1.1.1.3 What is an Oracle Application Server Farm?

1.1.1.4 Understanding the DCM Metadata Repository

1.1.1.5 Understanding Synchronization of the Metadata Repository and the Oracle Application Server Instance

1.2 Distributed Configuration Management Architecture

1.2.1 The Distributed Configuration Management Bootstrap Sequence

2 Using the dcmctl Utility

2.1 Managed Configuration Overview

2.2 Oracle Application Server Farm Creation and Maintenance Tasks

2.2.1 Designating the OracleAS File-based Farm Repository Host

2.2.2 Adding Instances to an OracleAS Farm

2.2.3 Creating a DCM-Managed OracleAS Cluster

2.2.4 Understanding DCM-Managed OracleAS Cluster Membership

2.2.4.1 How the Common Configuration is Established

2.2.4.2 Parameters Excluded from the Common Configuration: Instance-Specfic Parameters

2.2.4.3 Rules and Guidelines for Adding Instances to DCM-Managed OracleAS Clusters

2.2.4.4 Naming Restrictions For Instances and Applications

2.2.5 Adding an Instance to a DCM-Managed OracleAS Cluster

2.2.6 Removing an Oracle Application Server Instance From a DCM-Managed OracleAS Cluster

2.2.7 Exporting and Importing Configurations From a File-based Repository

2.2.8 Moving an Instance From One OracleAS File-based Farm to Another

2.2.9 Moving An Instance to a OracleAS Database-based Farm

2.2.10 Enabling SSL For Communication Between Instances in an OracleAS File-based Farm

2.2.10.1 Generating the Keystore

2.2.10.2 Stopping the Oracle Application Server Processes on Each Instance

2.2.10.3 Setting Up Keystore Information File on Each Instance in the OracleAS File-based Farm

2.2.10.4 Enabling SSL in the dcmCache.xml File

2.2.10.5 Verifying that Configuration Changes are Effected

2.2.10.6 Starting the Instances in the OracleAS File-based Farm

2.2.10.7 Adding a New Instance to a SSL-Enabled OracleAS File-based Farm

2.2.11 Improving Performance in a Large OracleAS File-based Farm

2.2.12 Removing an Instance From the Infrastructure After Executing the leaveFarm Command

2.2.12.1 J2EE and Web Cache Instance Using Identity Management (Oracle Internet Directory)

2.2.12.2 J2EE and Web Cache Installation with Database-based Repository

2.2.12.3 J2EE and Web Cache Installation Using Identity Management (Oracle Internet Directory) with Database-based Repository

2.3 Creating and Maintaining OC4J Instances In DCM-Managed OracleAS Clusters

2.3.1 Creating an OC4J Instance

2.3.2 Deleting an OC4J Instance

2.4 Managing DCM Log Files

2.4.1 Log File Location and Naming

2.4.2 Changing Log Size Parameters

2.5 Best Practices for DCM-Managed OracleAS Cluster Management

3 Archiving A Managed Configuration

3.1 DCM Archiving Commands

3.2 Initial Archive Creation

3.3 Archive and Instance Compatibility

3.4 Exporting and Importing Archives

3.5 Using Automatic Archiving

3.5.1 Tuning Automatic Archiving to Improve Performance

3.6 Preserving Configurations With Archive Commands

3.7 Importing and Applying an Archive to an Instance

3.8 Benefits of Archiving

A dcmctl Commands

A.1 Notes for Using dcmctl Commands

A.1.1 dcmctl Options

A.1.1.1 Notes on OracleAS Cluster, Instance, Component and Component Type Options

A.1.2 Using the dcmctl Shell

A.2 Types of dcmctl Commands

A.3 Alphabetical Listing of dcmctl Commands

A.3.2 addOPMNLink

A.3.3 applyArchiveTo

A.3.4 applyClusterTo

A.3.5 applyInstanceTo

A.3.6 configRepositorySSL

A.3.7 createArchive

A.3.8 createCluster

A.3.9 createComponent

A.3.10 deployApplication

A.3.11 destroyInstance

A.3.14 exportArchive

A.3.15 exportRepository

A.3.16 fileCleanUp

A.3.17 getComponentType

A.3.18 getError

A.3.19 getOPMNPort

A.3.20 getRepositoryId

A.3.21 getReturnStatus

A.3.22 getState

A.3.24 importArchive

A.3.25 importRepository

A.3.26 isClusterable

A.3.27 isCompatible

A.3.28 joinCluster

A.3.29 joinFarm

A.3.30 leaveCluster

A.3.31 leaveFarm

A.3.32 listApplications

A.3.33 listArchives

A.3.34 listClusters

A.3.35 listComponents

A.3.36 listComponentTypes

A.3.37 listInstances

A.3.38 listOPMNLinks

A.3.40 redeployApplication

A.3.41 removeArchive

A.3.42 removeCluster

A.3.43 removeComponent

A.3.44 removeOPMNLink

A.3.45 repositoryRelocated

A.3.46 resetDCMCachePort

A.3.47 resetFileTransaction

A.3.48 resetHostInformation

A.3.50 restoreInstance

A.3.51 resyncInstance

A.3.52 saveInstance

A.3.54 setLogLevel

A.3.56 shutdown

A.3.59 updateConfig

A.3.60 undeployApplication

A.3.61 validateEarFile

A.3.62 whichCluster

A.3.63 whichFarm

A.3.64 whichInstance

B Troubleshooting DCM

B.1 Problems and Solutions

B.1.1 OPMN Cannot Start

B.1.2 DCM Daemon Cannot Start

B.1.3 DCM Daemon Does Not Start As Expected

B.1.4 DCM Operations Fail

B.1.5 Invalid username/password

B.1.6 BOM (Bill of Materials) Not Updated

B.1.7 In Sync Status is False

B.1.8 Unable to Connect to the Directory

B.1.9 Cannot Access the Infrastructure Database

B.1.10 The dcm.conf File is Unreadable

B.1.11 The dcm.conf or dcmCache.xml File is Empty

B.1.12 dcmctl getState Hangs

B.1.13 getState Cannot Be Used With (9.0.2 or 9.0.3) Instances

B.1.14 dcmctl joinFarm Produces Error

B.1.15 repositoryRelocated Command Causes Repository to be Unreachable

B.1.16 Unreachable IP Address

B.1.17 resyncInstance Command Does Not Restore Properly

B.2 Diagnosing Problems with Components Related to DCM

B.2.1 Troubleshooting Oracle Process Manager and Notification Server

B.2.2 Troubleshooting Oracle Internet Directory

B.2.2.1 How DCM Uses Oracle Internet Directory

B.2.2.2 How to Troubleshoot Oracle Internet Directory Problems

B.2.3 Troubleshooting the Metadata Repository

B.2.3.1 How DCM Uses the Metadata Repository

B.2.3.2 How to Troubleshoot Problems with the Metadata Repository

B.2.4 Troubleshooting the File-based Repository

B.2.4.1 How DCM Uses the File-based Repository

B.2.4.2 How to Troubleshoot Problems with the File-based Repository

B.3 Diagnosing DCM Problems

B.4 Need More Help?

Index