Skip Headers
Oracle® Enterprise Manager Administration
10g Release 5 (10.2.0.5)

Part Number E14586-03
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

9 Backup, Recovery, and Disaster Recovery

Enterprise Manager's distributed architecture necessitates a multi-pronged approach to backup, recovery and disaster recovery planning. This chapter covers practical approaches to implementing an efficient and robust backup and recovery environment and discusses the best practices for backup and recovery of different tiers of Enterprise Manager.

This chapter contains the following sections:

Backup and Recovery of Enterprise Manager

Although Enterprise Manager functions as a single entity, technically, it is built on a distributed, multi-tier software architecture composed of the following software components:

Each component, being uniquely different in composition and function, requires different approaches to backup and recovery. For this reason, the backup and recovery strategies are discussed on a per-tier basis in this chapter. For an overview of the Enterprise Manager Architecture, refer to Enterprise Manager Grid Control Installation and Basic Configuration 10g Release 5 (10.2)

Repository Backup and Recovery

The Repository is the storage location where all the information collected by the Agent gets stored. It consists of objects such as database jobs, packages, procedures, views, and tablespaces. Because it is configured in an Oracle Database, the backup and recovery strategies for the repository are essentially the same as those for the Oracle Database. Backup procedures for the database are well established standards and can be implemented using the RMAN backup utility, which can be accessed via the Enterprise Manager console.

Repository Backup

Oracle recommends using High Availability Best Practices for protecting the Repository database against unplanned outages. As such, use the following standard database backup strategies.

  • Database should be in archivelog mode. Not running the repository database in archivelog mode leaves the database vulnerable to being in an unrecoverable condition after a media failure.

  • Perform regular hot backups with RMAN using the Recommended Backup Strategy option via the Enterprise Manager console. Other utilities such as DataGuard and RAC can also be used as part of a comprehensive strategy to prevent data loss.

Adhering to these strategies will create a full backup and then create incremental backups on each subsequent run. The incremental changes will then be rolled up into the baseline, creating a new full backup baseline.

Using the Recommended Backup Strategy also takes advantage of the capabilities of Enterprise Manager to execute the backups: Jobs will be automatically scheduled through the Job sub-system of Enterprise Manager. The history of the backups will then be available for review and the status of the backup will be displayed on the repository database target home page. This backup job along with archiving and flashback technologies will provide a restore point in the event of the loss of any part of the repository. This type of backup, along with archive and online logs, allows the repository to be recovered to the last completed transaction.

Setting Up the Backup

First, navigate to the Enterprise Manager Recovery Settings page (Target-->Database--><Repository Database Target>-->Availability-->Recovery Settings) and enable Archive Logging then Flashback Database as shown in Figure 9-1.

Figure 9-1 Recovery Settings Page

Description of Figure 9-1 follows
Description of "Figure 9-1 Recovery Settings Page"

Next, navigate to the Backup Policies page (Target-->Database--><Repository Database Target>-->Availability-->Backup Settings-->Policy) and enable Block Change Tracking to speed up backup operations as shown in Figure 9-2.

Figure 9-2 Backup Policy Page

Description of Figure 9-2 follows
Description of "Figure 9-2 Backup Policy Page"

A thorough summary of how to configure backups using Enterprise Manager is available in the Oracle Database 2 Day DBA guide. For additional information on Database high availability best practices, review the Oracle Database High Availability Best Practices documentation.

Repository Recovery

Recovery of the Repository database must be performed using RMAN since Grid Control will not be available when the repository database is down. There are two recovery cases to consider:

  • Full Recovery: No special consideration is required for Enterprise Manager.

  • Point in time/Incomplete Recovery: Recovered repository may be out of sync with Agents because of lost transactions. In this situation, some metrics may show up incorrectly in the Grid Control console unless the repository is synchronized with the latest state available on the Agents.

Beginning with Enterprise Manager version 10.2.0.5, a new repository resync feature allows you to automate the process of synchronizing the Enterprise Manager repository with the latest state available on the Agents. To resynchornize the repository with the Agents, you use Enterprise Manager Command-line utility (emctl) resync repos command:

emctl resync repos -full -name "<descriptive name for the operation>"

You must run this command from the OMS Oracle Home after restoring the repository but BEFORE starting the OMS. After submitting the command, start up all OMS's and monitor the progress of repository resychronization from the Enterprise Manager console's Repository Resynchronization page, as shown in Figure 9-3.

Figure 9-3 Repository Synchronization Page

Description of Figure 9-3 follows
Description of "Figure 9-3 Repository Synchronization Page"

Repository recovery is complete when the resynchronization jobs complete on all Agents.

Oracle strongly recommends that the repository database be run in archivelog mode so that in case of failure, the database can be recovered to the latest transaction. If the database cannot be recovered to the last transaction, Repository Synchronization can be used to restore monitoring capabilities for targets that existed when the last backup was taken. Actions taken after the backup will not be recovered automatically. Some examples of actions that will not be recovered automatically by Repository Synchronization are:

  • Notification Rules

  • Preferred Credentials

  • Groups, Services, Systems

  • Jobs/Deployment Procedures

  • Custom Reports

  • New Agents

Manually Resynchronizing Agents

The Enterprise Manager Repository Synchronization feature can only be used for Agents 10.2.0.5 or later. Older Agents must be resynchronized manually by shutting down the Agent using the following procedure:

  1. Shut down the Agent.

  2. Delete the agentstmp.txt, lastupld.xml, state/* and upload/* files from the $AGENT_HOME/sysman/emd directory.

  3. Restart the Agent.

Recovery Scenarios

A prerequisite for repository (or any database) recovery is to have a valid, consistent backup of the repository. Using Enterprise Manager to automate the backup process ensures regular, up-to-date backups are always available if repository recovery is ever required. Recovery Manager (RMAN) is a utility that backs up, restores, and recovers Oracle Databases. The RMAN recovery job syntax should be saved to a safe location. This you to perform a complete recovery of the Enterprise Manager repository database. In its simplest form, the syntax would appear as follows:

run {

restore database;

recover database;

}

Actual syntax will vary in length and complexity depending on your environment. For more information on extracting syntax from an RMAN backup and recovery job, or using RMAN in general, see the Oracle Database Backup and Recovery Advanced User's Guide.

The following scenarios illustrate various repository recovery situations along with the recovery steps.

Full Recovery on the Same Host

Repository database is running in archivelog mode. Recent backup, archive log files and redo logs are available. The repository database crashes.

Resolution:

  1. Stop the OMS(s) using opmnctl stopall.

  2. Recover the database using RMAN

  3. Bring the site up using opmnctl startall on all OMS(s)

  4. No further action is required.

  5. Verify that the site is fully operational.

Incomplete Recovery on the Same Host

Repository database is running in noarchivelog mode. Full offline backup is available. The repository database crashes.

Resolution:

  1. Stop the OMS(s) using opmnctl stopall.

  2. Recover the database using RMAN

  3. Initiate Repository Resync using emctl resync repos -full -name "<resync name>" from one of the OMS Oracle home.

  4. Start OMS(s) using opmnctl startall.

  5. Manually fix all pre-10.2.0.5 Agents by shutting down the Agent, deleting the agentstmp.txt, lastupld.xml, state/* and upload/* files under the $AGENT_HOME/sysman/emd directory. Restart the Agent.

  6. Log into Grid Control. Navigate to Management Services and Repository Overview page. Click on Repository Synchronization under Related Links. Monitor the status of resync jobs. Resubmit failed jobs, if any, after fixing the error.

  7. Verify that the site is fully operational.

Full Recovery on a Different Host

The repository database is running on host "A" in archivelog mode. Recent backup, archive log files and redo logs are available. Host "A" is lost due to hardware failure.

Resolution:

  1. Stop the OMS(s) using opmnctl stopall.

  2. Recover the database using RMAN on a different host (host "B").

  3. Change the connect descriptor in each OMS emoms.properties file to point to database on host "B".

  4. Start the OMS(s) using opmnctl startall.

  5. Relocate the repository database target to the Agent running on host "B" by running the following command from the OMS:

    $emctl config repos -host <hostB> -oh <OH of repository on hostB>  -conn_desc "<TNS connect descriptor>"
    

    Note:

    This command can only be used to relocate the repository database under the following conditions:
    • An Agent is already running on this machine.

    • No database on host "B" has been discovered.

    If a new Agent had been installed on host "B", you must ensure there are NO previously discovered database targets.

  6. Change the monitoring configuration for the OMS and Repository target: by running the following command from the OMS:

    $emctl config emrep -conn_desc "<TNS connect descriptor>"
    
  7. Verify that the site is fully operational.

Incomplete Recovery on a Different Host

The repository database is running on host "A" in noarchivelog mode. Full offline backup is available. Host "A" is lost due to hardware failure.

Resolution:

  1. Stop the OMS(s) using opmnctl stopall.

  2. Recover the database using RMAN on a different host (host "B").

  3. Change the connect descriptor in each OMS emoms.properties file to point to the database on host "B".

  4. Initiate Repository Resync:

    emctl resync repos -full -name "<resync name>"

    from one of the OMS Oracle homes.

  5. Start the OMS(s) using opmnctl startall

  6. Run the command to relocate the repository database target to the Agent running on host "B":

    emctl config repos -agent <agent on host B> -host <hostB> -oh <OH of repository on hostB> -conn_desc "<TNS connect descriptor>"

  7. Run the command to change monitoring configuration for the OMS and Repository target:

    emctl config emrep -conn_desc "<TNS connect descriptor>"

  8. Manually fix all pre-10.2.0.5 Agents by shutting down the Agent, deleting the agentstmp.txt, lastupld.xml, state/* and upload/* files under $AGENT_HOME/sysman/emd directory. Restart the Agent.

  9. Log in to Grid Control. Navigate to Management Services and Repository Overview page. Click on Repository Synchronization under Related Links. Monitor the status of resync jobs. Resubmit failed jobs, if any, after fixing the error mentioned.

  10. Verify that the site is fully operational.

OMS Backup and Recovery

The OMS is a J2EE Web application that orchestrates with Management Agents to discover targets, monitor and manage them, and store the collected information in a repository for future reference and analysis. The OMS also renders the Web interface for the Enterprise Manager console.

Backing Up the OMS

The OMS is generally stateless. Some transient and configuration data is stored on the OMS file system. The shared loader “recv”directory stores metric data uploaded from Agents temporarily before the data is loaded into the repository. If an OMS goes down, other surviving OMS(s) upload the data stored in the shared loader location. In a High Availability (HA) configuration, the shared loader receive directory should be protected using some HA storage technology.

Beginning with Enterprise Manager version 10.2.0.5, a snapshot of OMS configuration can be taken using the emctl exportconfig oms command.

emctl exportconfig oms [-sysman_pwd <sysman password>]

      [-dir <backup dir>]     Specify directory to store backup file

      [-keep_host]            Specify this parameter if the OMS was installed

                              using a virtual hostname. 

                              For example: ORACLE_HOSTNAME

Running exportconfig captures a snapshot of the OMS at a given point in time, thus allowing you to back up the most recent OMS configuration on a regular basis. If required, the most recent snapshot can then be restored on a fresh OMS installation on the same or different host.

Recovering the OMS

If an OMS is lost, it should be reinstalled using “Installing Software-Only and Configuring Later". This is an additional Management Service option documented in the Oracle Enterprise Manager Grid Control Installation and Basic Configuration guide. The OMS configuration can then be restored with the following command:

emctl importconfig oms

Use export file backed up earlier. This command is available beginning with Enterprise Manager version 10.2.0.5.

OMS Recovery Scenarios

The following scenarios illustrate various OMS recovery situations along with the recovery steps.

Important:

A prerequisite for recovery is to have recent, valid OMS configuration backups available. Oracle recommends that you back up the OMS using the emctl exportconfig oms command whenever an OMS configuration change is made. Alternatively, you can run this command on a regular basis using the Enterprise Manager job system.

Single OMS with No Server Load Balancer (SLB). OMS Restored on the same Host

Single OMS site. No SLB is present. The OMS configuration was backed up using the emctl exportconfig oms command. OMS is lost.

Resolution:

  1. If possible, deinstall the OMS and Agent OracleHomes using the Oracle Universal Installer (OUI).

    Note:

    This step only applies if there is some remnant of the OMS still exists on the file system. Deinstallation of the OMS using OUI would not be possible if the OMS was lost as a result of disk/media failure.
  2. Reinstall the OMS using “Install Software only, configure later” – Additional management service option. Location of the install need not be same as the previous install.

  3. Import the OMS configuration:

    emctl importconfig oms -file <exportfile>

    Important:

    When using the importconfig command, the following restrictions apply:
    • The OMS configuration import can only be performed between the same operating system types.

    • The OMS configuration must be imported into the same version OMS.

    • Importing the OMS configuration only copies information which is unique to the installation (for example, emkey). For this reason, you should not use the importconfig command to copy OMS configurations across different Repositories.

    At this point two options exist depending upon the port used by the reinstalled Agent that comes along with the OMS:

    Option A: Agent uses the same port as the previous installation.

    • OMS automatically blocks the Agent. Resync the Agent from Agent homepage

    Option B: Agent uses a different port.

    • Run the command to relocate the OMS and Repository target to reinstalled Agent:

      emctl config emrep -agent <reinstalled agent>

    • Locate duplicate targets from the Management Services and Repository Overview page. Relocate duplicate targets from the old agent to the reinstalled Agent. Delete the old Agent.

  4. Verify that the site is fully operational.

Single OMS, No SLB, OMS Restored on a Different Host

Single OMS site. The OMS is running on host "A." No SLB is present. The OMS configuration was backed up using the emctl exportconfig oms command. Host "A" is lost.

Resolution:

  1. Reinstall the OMS using “Install Software only, configure later” – Additional management service option. Location of install need not be same as earlier install.

  2. Import the OMS configuration:

    emctl importconfig oms -file <exportfile>

    At this point, two possibilities exist depending upon your network setup

  3. Option A: Make host "B" reachable with hostname host "A"

    • Update the network information on host "B" so that it is reachable using the old host name from host "A." This can be done by multi-homing and adding an additional IP of host "A" to host "B".

    • Resecure the OMS

      emctl secure oms -host <host A>

    • Resecure the Agent on host "B".

      emctl secure agent -emdWalletUrlSrc "http://hostA:<httpport>/em"

    Note:

    Because the new machine uses the same hostname as the old machine, all the Agents in your monitored environment already know where to locate the new OMS.

    Option B: Change the OMS to which all Agents point and then resecure all Agents

    • Make all Agents in the deployment point to new OMS running on host "B". On each Agent, run the following command

      emctl secure agent -emdWalletUrlSrc "http://hostB:<httpport>/em"

      Run the command to relocate OMS and Repository target to Agent "B":

      emctl config emrep -agent <agent on host "B">.

      Note:

      Because the new machine is using a different hostname from the one originally hosting the OMS, all Agents in your monitored environment must be told where to find the new OMS.
  4. Locate duplicate targets from the Management Services and Repository Overview page of the Enterprise Manager console. Clicking the Duplicate Targets link, will bring you to the Duplicate Targets page. To resolve duplicate target errors, the duplicate target must be renamed on the conflicting Agent.

  5. Verify that the site is fully operational.

Multiple OMS, Server Load Balancer configured, OMS restored on the same host

Multiple OMS site. All OMSs fronted by an SLB. OMS configuration backed up using the emctl exportconfig oms command. One OMS is lost.

Resolution:

  1. Deinstall the OMS and Agent OracleHomes using the Oracle Universal Installer.

  2. Reinstall the OMS on same host using “Install Software only, configure later” – Additional management service option. Location of the install need not be the same as the earlier install.

  3. Import the OMS configuration:

    emctl importconfig oms -file <exportfile>

  4. Resecure the Agent that gets installed along with OMS.

    emctl secure agent -emdWalletSrcUrl"http://slb:<httpport>/em"

    Because the Agent that is installed with the OMS uses the same port as before, the OMS automatically blocks the Agent. You need to "resync" the Agent from the Agent homepage.

  5. Verify that the site is fully operational.

Multiple OMS, Server Load Balancer configured, OMS restored on a different host

Multiple OMS site. OMSs fronted by Server Load Balancers. OMS configuration backed up using the emctl exportconfig oms command. OMS on host "A" is lost.

  1. Ensure that shared loader receive directory and shared software library locations are accessible from the new OMS host (host "B")

  2. Reinstall OMS on host "B" using the “Install Software only, configure later” – management service option. Location of the install need not be same as previous install.

  3. Import the OMS configuration:

    emctl importconfig oms -file <exportfile>

  4. Resecure the Agent that gets installed along with OMS

    emctl secure agent -emdWalletSrcUrl"http://slb:<httpport>/em"

  5. Relocate the OMS and Repository target to reinstalled Agent:

    emctl config emrep -agent <agent on hostB>

  6. Locate duplicate targets from the Management Services and Repository Overview page. Relocate duplicate targets from the Agent on host "A" to the Agent on host "B". Delete the Agent on host "A".

  7. Configure the SLB to include this new host in its configuration.

    Comment: Is there an SLB note that covers this?

  8. Verify that the site is fully operational.

Agent Backup and Recovery

The Agent is an integral software component that is deployed on each monitored host. It is responsible for monitoring all the targets running on those hosts, communicating that information to the middle-tier OMS and managing and maintaining the hosts and its targets.

Backing Up Agents

There are no special considerations for backing up Agents. As a best practice, reference Agent installs should be maintained for different platforms and kept up-to-date in terms of customizations in the emd.properties file and patches applied. Use Deployment options from the Grid Control console to install and maintain Reference Agent installs.

Recovering Agents

If an Agent is lost, it should be reinstalled by cloning from a reference install. Cloning from a reference install is often the fastest way to recover an Agent install as one does not have to track and reapply customizations and patches. Care should be taken to reinstall the Agent using the same port. Using the Enterprise Manager's Agent Resynchronization feature, a reinstalled Agent can be reconfigured using target information present in the repository. When the Agent is reinstalled using the same port, the OMS detects that it has been re-installed and blocks it temporarily to prevent the auto-discovered targets in the re-installed Agent from overwriting any customizations done previously.

Blocked Agents:

A blocked Agent is a condition where the OMS rejects all heartbeat or upload requests from the blocked Agent. Hence, a blocked Agent will not be able to upload any alerts or metric data to the OMS. However, blocked Agents continue to collect monitoring data.

The Agent can be resynchronized and unblocked from the Agent homepage by clicking on the Resynchronize Agent button. Resynchronization pushes all targets from the repository to the Agent and then unblocks the Agent.

Agent Recovery Scenarios

The following scenarios illustrate various Agent recovery situations along with the recovery steps. The Agent resynchronization feature requires that a reinstalled Agent use the same port as the previous Agent that crashed.

Agent reinstall, same port.

An Agent is monitoring multiple targets. The Agent install is lost.

  1. Deinstall Agent OracleHome using the Oracle Universal Installer.

  2. Install a new Agent or use the Agent clone option to reinstall the Agent though Enterprise Manager. Specify the same port as used by the crashed Agent. The location of install need not be same as previous install.

    The OMS detects that Agent has been re-installed and blocks the Agent.

  3. Initiate Agent Resynchronization from the Agent homepage.

    All targets in the repository are pushed to the new Agent and Agent is unblocked.

  4. Reconfigure User-defined Metrics if the location of User-defined Metric scripts have changed.

  5. Verify that the Agent is operational and all target configurations have been restored.

Agent restore from filesystem backup

An Agent is monitoring multiple targets. File system backup for the Agent OracleHome exists. The Agent install is lost.

  1. Deinstall Agent OracleHome using OUI.

  2. Restore the Agent from file system backup. Start the Agent.

    OMS detects that Agent has been restored from backup and blocks the Agent

  3. Initiate Agent Resynchronization from the Agent homepage.

    All targets in the repository are pushed to the new Agent and Agent is unblocked.

  4. Verify that the Agent is functional and all target configurations have been restored using the following emctl commands:

    emctl status agent
    
    emctl upload agent 
    

    There should be no errors and no XML files in the backlog.

Recovering from a Compound OMS-Repository Failure

When both OMS and repository fail simultaneously, the recovery situation becomes more complex depending upon factors such as whether the OMS and repository are collocated, whether recovery has to be made on the same or different host, or whether there are multiple OMSs fronted by an SLB. In general, the order of recovery for this type of compound failure should be repository first followed by OMS(s) following the steps outlined in the appropriate recovery scenarios discussed earlier. The following scenarios illustrate two OMS-Repository failures and the requisite recovery steps.

Collapsed configuration, recovery on the same host, incomplete recovery of repository

Repository and the OMS are installed on same host (host "A"). No Server Load Balancer is configured. The repository database is running in noarchivelog mode. Full cold backup is available. Export of OMS configuration via emctl exportconfig oms is available. The repository, OMS and the Agent crash.

  1. Recover the repository database using RMAN.

  2. Since the OMS OracleHome is not available and repository resynchronization has to be initiated before starting an OMS against the restored repository, submit "resync" via the following PL/SQL block. Log into the repository as SYSMAN using SQLplus and run:

    begin emd_maintenance.full_repository_resync('<resync name>'); end;

  3. Deinstall the crashed OMS and Agent OracleHomes using OUI.

  4. Reinstall the OMS using “Install Software only, configure later”. This is an additional management service option. Location of the install need not be same as previous install.

  5. Import the OMS configuration:

    emctl importconfig oms -file <exportfile>

    Because the Agent that is installed with the OMS uses the same port as before, the OMS automatically blocks the Agent. At this point, you must "resync" the Agent from the Agent homepage.

  6. Manually fix all pre-10.2.0.5 Agents by shutting down the Agent, deleting the agentstmp.txt, lastupld.xml, state/* and upload/* files under $AGENT_HOME/sysman/emd directory. Restart the Agent.

    Note:

    he Repository Synchronization function will automatically fix all 10.2.0.5 and later Agents.
  7. Log into Enterprise Manager and navigate to the Management Services and Repository Overview page. Click on Repository Synchronization under Related Links. Monitor the status of resync jobs. Resubmit failed jobs, if any, after fixing the errors.

  8. Verify that the site is fully operational.

Distributed configuration, Multi-OMS with SLB, recovery on different hosts, incomplete recovery of repository

Repository installed on host "X". Two OMSs are installed-- one on host "A" and one on host "B". OMSs are fronted by an SLB. Repository database running in noarchivelog mode. Full offline backup available. Host "X" and host "B" are lost.

  1. Stop the OMS on host "A" using opmnctl stopall

  2. Recover the database using RMAN on new host "Y"

  3. Update the connect descriptor in the emoms.properties file on host "A" to point to host "Y".

  4. Initiate Repository resynchronization:

    emctl resync repos -full -name "<resync name>"

    from the OMS Oracle home of host "A"

  5. Run the command to relocate and reconfigure the repository database target:

    emctl config repos -agent <agent on hostY> -oh <OH on hostY> -host <hostY> -conn_desc "<TNS connect descriptor>"

  6. Export latest OMS configuration from host "A":

    emctl exportconfig oms -dir <export location>

  7. Ensure that shared loader receive directory and shared software library locations are accessible from the host "C".

  8. Start the OMS on hostA using opmnctl startall

  9. Reinstall the OMS on host "C" using the “Install Software only, configure later” – Additional management service option. Location of install need not be same as previous install.

  10. Import the OMS configuration:

    emctl importconfig oms -file <exportfile>

  11. Update the SLB pools by replacing host "B" entries with host "C".

  12. Resecure the Agent that gets installed along with OMS on host "C"

    emctl secure agent -emdWalletSrcUrl "http://slb/:<httpport>/em"

  13. Relocate and reconfigure the OMS and Repository target:

    emctl config emrep -agent <agent on hostC> -conn_desc "<TNS connect descriptor>"

  14. Locate duplicate targets from the Management Services and Repository Overview page. Relocate duplicate targets from Agent "B" to Agent "C". Delete the old Agent on host "B".

  15. Manually fix all pre-10.2.0.5 Agents by shutting down the Agent, deleting the agentstmp.txt, lastupld.xml, state/* and upload/* files under $AGENT_HOME/sysman/emd directory. Restart the Agent.

  16. Login to Grid Control and navigate to the Management Services and Repository Overview page. Click on Repository Synchronization under Related Links. Monitor the status of resync jobs. Resubmit failed jobs, if any , after fixing any errors mentioned.

  17. Verify that the site is fully operational.

EMCTL High Availability Commands

The Enterprise Manager command-line utility (emctl) adds many new commands that allow you to perform requisite backup and recovery operations for all major components.

exportconfig oms

Exports a snapshot of the OMS configuration to the specified directory.

Usage:

emctl exportconfig oms [-sysman_pwd <sysman password>]

      [-dir <backup dir>]     Specify the directory used to store the backup file

      [-keep_host]            Specify to back up hostname if no SLB is defined

                              (Use this option only if recovery will be performed

                               on the machine that responds to this hostname)

importconfig oms

Imports the OMS configuration from the specified backup file.

Usage:

emctl importconfig oms [-sysman_pwd <sysman password>] [-reg_pwd <registration password>]

      -file <backup file>     Required backup file to import from

      [-key_only]             Specify to import emkey only

      [-no_resecure]          Specify not to resecure the oms after import

                              (default is to resecure after import)

config emrep

Configures the OMS and repository target. The command is used to change the monitoring Agent for the target and/or the connection string used to monitor this target.

Usage:

emctl config emrep [-sysman_pwd <sysman password>]

      [-agent <new agent>]    Specify a new destination Agent for emrep target

      [-conn_desc [<jdbc connect descriptor>]]

                      Update the Connect Descriptor with value if specified,

                      else from value stored in the emoms.properties file.

config repos

Configures the repository database target. The command is used to change the monitoring Agent for the target and/or the monitoring properties (hostname, Oracle Home and connection string used to monitor this target).

Usage:

emctl config repos [-sysman_pwd <sysman password>]

      [-agent <new agent>]    Specify new destination agent for repository target

      [-host <new host>]      Specify new hostname for repository target

      [-oh <new oracle home>] Specify new OracleHome for repository target

      [-conn_desc [<jdbc connect descriptor>]]

                       Update the Connect Descriptor with the specified value,

                       else from the value stored in emoms.properties

resync repos

Submits a repository resynchronization operation. When the –full option is specified, all agents are instructed to upload the latest state to the repository. A list of agents can be specified using the –agentlist option to resync with a given list of agents.

Usage:

emctl resync repos (-full|-agentlist "agent names") [-name "resync name"] [-sysman_pwd "sysman password"]

abortresync repos

Aborts the currently running repository resynchronization operation. Use the –full option to stop a full repository resynchronization. Use the –agentlist option to stop resync on a list of agents.

Usage:

emctl abortresync repos (-full|-agentlist "agent names") -name "resync name" [-sysman_pwd "sysman password"]

 

statusresync repos

Lists the status of given repository resynchronization operation.

Usage:

emctl statusresync repos -name "resync name" 

create service

Valid on Windows only. The command creates a service for the Oracle Management Services on Windows. You use this command to manage the Windows service for the OMS on a failover host in a Cold Failover Cluster setup.

Usage:

emctl create service [-user <username>] [-pwd <password>]

      -name <servicename>     Name of service to be created  

delete service

Valid on Windows only. Deletes the service for the Oracle Management Services on Windows.

Usage:

emctl delete service

      -name <servicename>     Name of service to be deleted  

resyncAgent

Resynchronizes a restored or reinstalled Agent by pushing all target configuration from the repository.

Usage:

emcli resyncAgent -agent="Agent Name"

        [-keep_blocked]