Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Documentation Accessibility

Structure

Related Documents

Conventions

1 Distributed Configuration Management Overview

What is Distributed Configuration Management?

Distributed Configuration Management Architecture

Distributed Configuration Management Functionality

Understanding the Distributed Configuration Management Tools and Scope

Understanding the Distributed Configuration Management Metadata Repository

Types of Distributed Configuration Management Repositories

Understanding Synchronization of the Metadata Repository and the Instance

Distributed Configuration Management Best Practices

Using Distributed Configuration Management Archiving

Using Automatic Archiving

Using Explicit Archiving

Managing Oracle Application Server Clusters with DCM

2 dcmctl Commands

Notes for Using dcmctl Commands

dcmctl Options

Notes on Cluster, Instance, Component and Component Type Options

Using the dcmctl Shell

Types of dcmctl Commands

Alphabetical Listing of dcmctl Commands

!!

addOPMNLink

applyArchiveTo

applyClusterTo

applyInstanceTo

configRepositorySSL

createArchive

createCluster

createComponent

deployApplication

destroyInstance

echo

exit

exportArchive

exportRepository

getComponentType

getError

getOPMNPort

getRepositoryId

getReturnStatus

getState

help

importArchive

importRepository

isClusterable

isCompatible

joinCluster

joinFarm

leaveCluster

leaveFarm

listApplications

listArchives

listClusters

listComponents

listComponentTypes

listInstances

listOPMNLinks

quit

redeployApplication

removeArchive

removeCluster

removeComponent

removeOPMNLink

repositoryRelocated

resetDCMCachePort

resetFileTransaction

resetHostInformation

restart

restoreInstance

resyncInstance

saveInstance

set

setLogLevel

shell

shutdown

start

stop

updateConfig

undeployApplication

validateEarFile

whichCluster

whichFarm

whichInstance

3 Troubleshooting

Troubleshooting Guidelines

DCM Problems and Solutions

OPMN is Unable to Start Due to Corrupted or Missing opmn.xml File

BOM (Bill of Materials) Not Updated

’In Sync’ Status is False

Unable to Connect to the Directory

Problem Accessing the Infrastructure Database

DCM Daemon Cannot Start

resyncInstance Command Does Not Restore Properly

Invalid username/password

dcmctl Takes a Long Time to Start a Component

dcmctl Returns a SubscriptionException

dcmctl getState Hangs

dcmctl joinFarm Produces Error

Repository Unreachable After repositoryRelocated Command

The dcm.conf or dcmCache.xml file is empty

Handling Unexpected Messages or Failures With a File Based Repository

resetHostInformation Workaround for Unreachable IP Address

DCM Repository Unavailable With Start Stop and Restart Commands

The getState Command Cannot Be Used With Older Instances (9.0.2 or 9.0.3)

Registered Plugin Named Discoverer Could Not Be Loaded Found in log.xml

Troubleshooting Problems with Related Components

Troubleshooting Oracle Process Manager and Notification Server

Troubleshooting Oracle Internet Directory

How DCM Uses Oracle Internet Directory

How to Troubleshoot Oracle Internet Directory Problems

Troubleshooting the Metadata Repository

How DCM Uses the Metadata Repository

How to Troubleshoot Problems with the Metadata Repository

Troubleshooting the File based Repository

How DCM Uses the File based Repository

How to Troubleshoot Problems with the File based Repository

4 Archiving Configurations

DCM Archiving Commands

Initial Archive Creation

Archive and Instance Compatibility

Exporting and Importing Archives

Using Automatic Archiving

Saving Configurations

Importing and Applying an Archive to an Instance

Index