dcmctl Usage

In this section we'll cover the purpose, location, common usage, and syntax for the dcmctl utility.

Purpose

DCM works in conjunction with OPMN and has the primary responsibility of synchronization of the instance components (for example, OC4J and OHS) with the repository. Though OPMN works internally within the instance, DCM communicates instance updates externally to other instances and the infrastructure. This is especially important when the mid- tier instance is part of a farm (attached to an infrastructure) or part of a cluster. DCM makes sure that the configuration files on the file system are in sync with the repository, and any updates are propagated accordingly .

DCM is also used to deploy J2EE applications to the embedded OC4J instances within 10g AS.

The dcmctl utility is useful for several tasks such as the following:

Checking the status of the application server instance.
Starting and stopping individual components within the instance.
Synchronizing configuration files with the repository.
Making backups of the instance configuration.
Deploying applications to OC4J embedded 10g AS instances.
Redeploying applications to OC4J embedded 10g AS instances.
Undeploying applications from OC4J embedded 10g AS instances.

Location

Located in the 10g AS $ORACLE_HOME/dcm/bin directory.

Common Usages

Common usages for dcmctl are shown in the following sections.

Check status

 $ dcmctl getstate Current State for Instance:904mt1.mike.wessler.name     Component               Type          Up Status     In Sync Status ========================================================================= 1   home                    OC4J          Up            True 2   HTTP_Server             HTTP_Server   Up            True $

Start an individual process (OHS, for example)

 $ dcmctl start -co HTTP_Server Current State for Instance:904mt1.mike.wessler.name     Component               Type          Up Status     In Sync Status ============================================================================ 1   HTTP_Server             HTTP_Server   Up            True $

Stop an individual process (OHS, for example)

 $ dcmctl stop -co HTTP_Server Current State for Instance:904mt1.mike.wessler.name     Component               Type          Up Status     In Sync Status ============================================================================ 1   HTTP_Server             HTTP_Server   Down          True $

Restart an individual process (OHS, for example)

 $ dcmctl restart -co HTTP_Server Current State for Instance:904mt1.mike.wessler.name     Component               Type          Up Status     In Sync Status ============================================================================ 1   HTTP_Server             HTTP_Server   Up            True $

Verify autoarchiving

 $ dcmctl set Verbose: true Sort: false Warning: true Debug: true Default Timeout: 120 Auto Archive Count : 15 $

Create an archive

 $ dcmctl exportarchive -arch 904mt1bk-02012004_1 f  /home/oracle/archives/904mt1bk-02012004_1 $ ls -altr /home/oracle/archives/904mt1bk-02012004_1 -rw-r-----    1 oracle   dba        370770 Feb  1 11:53  /home/oracle/archives/904mt1bk-02012004_1 $

Import an archive from a specific file backup

 $ dcmctl importarchive -arch 904mt1restore-02012004_1 -f /home/oracle/archives/ 904mt1bk-02012004_1

Import an archive from the local repository

 $ dcmctl applyarchiveto -arch 904mt1bk-02012004_1

Deploying a J2EE application (ojspdemos) to an embedded 10g AS OC4J instance (webdev, for example)

 $ dcmctl deployapplication -file ./ojspdemos.ear -co webdev application ojspdemos

Redeploying a J2EE application (ojspdemos) to an embedded 10g AS OC4J instance (webdev, for example)

 $ dcmctl redeployapplication -file ./ojspdemos.ear -co webdev -application ojspdemos

Undeploying a J2EE application (ojspdemos) from an embedded 10g AS OC4J instance (webdev, for example)

 $ dcmctl undeployapplication -co webdev -application ojspdemos

Syntax

To get a list of available arguments, issue dcmctl help, as follows :

 $ dcmctl help DCMCTL Command Help !! 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 undeployapplication updateconfig validateearfile whichcluster whichfarm whichinstance $

To get usage for a particular command, issue dcmctl help argument_name , as follows:

 $ dcmctl help restart    restart    Restarts processes.    Type    Process Management    Syntax    restart [[-cl cluster_name]  [-i instance_name]  [-co    component_name]  [-ct component_type]]  [-admin]    Description    Restarts running processes in the specified scope. This command does    not restart OPMN or the DCM daemon, it leaves them running. Only the    processes that were running when the command was issued are restarted.    If the -admin option is used, then the DCM daemon is restarted.    Example    To restart the local instance:    restart    To restart a remote instance:    restart -i myInstance    To restart a component across a cluster:    restart -cl myCluster -co myComponent $