Skip Headers
Oracle® Enterprise Manager Advanced Configuration
10g Release 2 (10.2)

Part Number B16242-02
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
Feedback

Go to previous page
Previous
Go to next page
Next
View PDF

11 Migrating from Previous Versions of Enterprise Manager

This chapter discusses the migration procedure used to move from a previous version of Oracle Enterprise Manager to the new Oracle Enterprise Manager 10g environment. This chapter contains the following topics:

11.1 Overview of the Enterprise Manager Migration Process

This chapter describes how to migrate from the following versions of Enterprise Manager:

Migrating your existing Enterprise Manager framework to the Oracle Enterprise Manager 10g environment involves two steps:

Once you have completed migrating to the new framework, you may wish to change the default metric thresholds for groups of managed targets within your enterprise. For more information, see Configuring Metric Thresholds.

11.2 Requirements for Migrating from Previous Versions of Enterprise Manager

Before beginning the migration process, ensure that the following list of requirements is satisfied:

11.3 The Oracle Enterprise Manager 10g Migration Process

Migrating from a previous version of Enterprise Manager to the Oracle Enterprise Manager 10g Grid Control is a two-stage process. The following sections describe each stage in the process:

11.3.1 Deploying and Configuring Oracle Enterprise Manager 10g Management Agents

Deploying Oracle Enterprise Manager 10g Management Agents on machines running targets managed by an older version of Enterprise Manager makes these targets monitorable via Oracle Enterprise Manager 10g. To simplify and automate Management Agent deployment, a Tcl script is provided that is submitted as a job from an Enterprise Manager Release 2.2, Release 9.0.1, or Release 9.2 Job system. The deployment script (agentIntallJob.tcl) can be found in the Oracle Enterprise Manager 10g home directory at the following location:

%ORACLE_HOME/sysman/agent_download/agentInstallJob.tcl

Deployment of the Oracle Enterprise Manager 10g Management Agent is carried out in two phases:

11.3.1.1 Deploying the Oracle Enterprise Manager 10g Management Agents Using the Release 2.2, Release 9.0.1, or Release 9.2 Job System

The agentInstallJob.tcl script must be run as a Tcl job from an Enterprise Manager Release 2.2, Release 9.0.1, or Release 9.2 Console. As shown in Figure 11-1, you define the job by choosing a "Node" target type and then selecting the machines on which the Oracle Enterprise Manager 10g Management Agents are to be installed.

Figure 11-1 Selecting Machines for Management Agent Deployment

Description of Figure 11-1 follows
Description of "Figure 11-1 Selecting Machines for Management Agent Deployment"

Once you have selected where the Management Agents are to be deployed, you need to define an installation task using agentInstallJob.tcl. As shown in Figure 11-2, select the "Run TCL Script" task.

Figure 11-2 Choosing the Run TCL Script Task

Description of Figure 11-2 follows
Description of "Figure 11-2 Choosing the Run TCL Script Task"

The next step involves defining the functional core of the job. As shown in Figure 11-3, you need to copy the content of the agentInstallJob.tcl script into the text entry area using either the Import function or manually copying and pasting the entire script into the TCL Script text entry area.

Figure 11-3 Copying agentInstallJob.tcl and Specifying Job Parameters

Description of Figure 11-3 follows
Description of "Figure 11-3 Copying agentInstallJob.tcl and Specifying Job Parameters"

In addition to importing the script content, you must specify operational parameters required by the script to install the Oracle Enterprise Manager 10g Management Agent. As shown in Figure 11-3, you enter these parameters in the Run TCL Script Parameters field. The parameters are:

  • The Oracle Management Service host

    Example: mgmthost1.acme.com

  • HTTP Port Number

    Example: 7778

  • Directory Type (-o or -f)

    Usage:

    -o Identical installation directory structure on all machines.

    -f Different installation directory structure on various machines (specified in text file)

  • Directory Argument

    Example: /u09/agent/agent_41

Example 11-1 and Example 11-2 show the format and syntax used to specify these parameters in the Run TCL Script Parameters field.

Example 11-1 Same Installation Directory Structure on All Machines

mgmthost1.acme.com 7778 -o /u09/Agent/Agent_41

Example 11-2 Different Installation Directory Structure on Different Machines

mgmthost1.acme.com 7778 -f hostname_lookup.txt
11.3.1.1.1 More About the Directory Type Parameter

The Directory Type parameter offers two options either "-o" or "-f" plus the Directory Argument which consists of either a default directory (-o option) or host lookup file (-f option). As mentioned in the previous section, the "-o" option specifies that the same Management Agent home directory structure be created on all machines where the Management Agent is to be installed. For example, if the agentInstallJob.tcl job is submitted against MACHINE1, MACHINE2, and MACHINE3 using the following job parameters:

mgmthost1.acme.com 7778 -o /u09/agent/agent_41

The agentInstallJob.tcl script will create the /u09/agent/agent_41 directory on each of the three machines. Once created, this directory is used by the Oracle Universal Installer (OUI) as an installation staging area. This directory eventually becomes the Oracle Enterprise Manager 10g Management Agent Home.


Note:

The agentInstallJob.tcl job runs OUI in silent mode to perform the actual Management Agent installation operations.

In contrast, the "-f" option specifies that different installation/Agent Home directory structures be created for specific machines. Before creating a TCL job with this option you must first create a flat text file listing each machine name and corresponding directory for that host. The flat file MUST reside in the Oracle Enterprise Manager 10g Management Service Home in the following directory:

OMS_HOME/sysman/agent_download

In the following example, the lookup file parsed by the TCL job is named hostname_lookup.txt.

mgmthost1.acme.com 7778 -f hostname_lookup.txt

When a TCL job is submitted using the "-f" option, the job first obtains the name of the target machine by executing the "hostname" command. The result is then compared against entries in the hostname lookup file. If the hostname is found in the file, the associated directory structure is used. If the hostname is not found, then the directory structure specified for the "wildcard" character is used. The wildcard can be used as a default entry in case the TCL job cannot locate a particular hostname within the file. A wildcard entry is designated by a "*" and must be the last entry as the file is parsed from top to bottom.

Example 11-3 shows the format for a sample hostname lookup file. In the example, you have 20 machines in your enterprise where you want Oracle Enterprise Manager 10g Management Agents installed. You want the same Agent Home directory structure created on all machines except HOST1, HOST2, and HOST3.

Example 11-3 Sample Hostname Lookup File

HOST1             /oracle_home1/agent/agent_install
HOST2           /ora_host2/agent_install
HOST3           /orahome_host3/agent/install
*               /ora_agent/agent/install

The TCL job (submitted to HOST2) runs the hostname command and receives HOST2 as the output. This output is then cross-referenced with all entries within the hostname_lookup.txt file. Since HOST2 is an entry in the hostname_lookup.txt file, the TCL job knows to create the Oracle Enterprise Manager 10g Management Agent Home in /ora_host2/agent_install. HOST1, HOST2, and HOST3 will have unique directories. The Management Agent home directory for the remaining 17 machines will be /ora_agent/agent/install.

Because the TCL job, or more specifically OUI, creates files and directories on the target machines, full read/write privileges for the Enterprise Manager administrator account running the job are required. When the installation is complete the new Oracle Enterprise Manager 10g Management Agent is started automatically and begins retrieving host, database, and listener information. This information is then uploaded via HTTP or HTTPS to the new Enterprise Manager 10g management repository where it becomes available to the Grid Control for viewing.

11.3.1.2 Configuring the Oracle Enterprise Manager 10g Management Agents for Use with the Oracle Enterprise Manager 10g Job System (UNIX Systems Only)

Once the Oracle Enterprise Manager 10g Management Agents are operational, you need to configure each Management Agent for use with the Oracle Enterprise Manager 10g job system. This step consists of running the root.sh script on each machine where the Management Agent is installed. This script is located in the Management Agent Home of the host machine. Specifically, the root.sh script grants root privileges to the Oracle Enterprise Manager 10g Management Agent. Therefore, the root user and password for that machine are required in order to run root.sh.

As with the agentInstallJob.tcl script you can automate this task by running the root.sh script using the Enterprise Manager Release 2.2, Release 9.0.1, or Release 9.2 Job system. To do this, you create an "OS command" job that executes "root.sh" on all machines requiring Management Agent configuration. As shown in the Figure 11-4, preferred credentials should be overridden by the root user and password of the target host.


Note:

The Preferred Credential Override is available with Enterprise Manager Release 9.2 systems only. For older versions of Enterprise Manager, you must run the job as a user with preferred credentials allowing root access.

Figure 11-4 Overriding Preferred Credentials

Description of Figure 11-4 follows
Description of "Figure 11-4 Overriding Preferred Credentials"

On the job Parameters page (Figure 11-5), specify "root.sh" in the Command field as shown in the following figure and submit the job for execution. You must specify the full path to the root.sh script. For example: /u09/agent/agent_41/root.sh

Figure 11-5 Command Parameters

Description of Figure 11-5 follows
Description of "Figure 11-5 Command Parameters"

The Oracle Enterprise Manager 10g Management Agent can be up and running when root.sh is executed and does not need to be restarted after the configuration process has been completed.


Note:

In previous releases of Enterprise Manager, job system configuration was part of the Intelligent Agent install. With the Enterprise Manager 10g release, this configuration is now a separate step due to architectural differences between the old and new frameworks.

11.3.2 Migrating Management Repository Data

Once the Oracle Enterprise Manager 10g Management Agents have been deployed and configured, the next step is to migrate information about users, privileges, groups, and preferred credentials from the original Management Repository to the Oracle Enterprise Manager 10g Management Repository.


Note:

Privileges, group membership, and preferred credentials are migrated for databases, listeners, and hosts only.

Both Enterprise Manager 9i and Oracle Enterprise Manager 10g save and encrypt all administrator accounts and preferred credentials in the repository. In order to migrate all of these accounts over to Enterprise Manager 10g, you must run the Migration Utility from the Enterprise Manager 10g home. This command line utility can be found in the following directory:

%EM_HOME%\bin\repo_mig

The Migration Utility requires the repository user and password for both the original Management Repository database and for the new Oracle Enterprise Manager 10g Management Repository database. You execute the utility and specify operational parameters using the following format:

repo_mig -preview|-migrate source_user/source_pwd@source_service dest_user/dest_pwd@dest_service          

where:

  • -preview: Generates a preliminary migration report without carrying out the migration.

  • -migrate: Performs migration of groups, administrators, target privileges, and preferred credentials of hosts, databases, and listeners.

  • source_user: Source OEM repository user name

  • source_pwd: Source OEM repository password

  • source_service: Source OEM repository service. For example, Host:Port:SID

  • dest_user: Destination OEM repository user name

  • dest_pwd: Destination OEM repository password

  • dest_service: Destination OEM repository service. (Host:Port:SID)

Once the migration is complete, the account information is then saved and encrypted. The passwords on all of the accounts will remain the same.

11.4 Configuring Metric Thresholds

As mentioned previously, migration only involves transferring users, privileges, groups, and preferred credentials to the Enterprise Manager 10g framework; any older event test thresholds that existed in pre-10g versions of Enterprise Manager will not be transferred.

Enterprise Manger 10g provides out-of-the-box monitoring that simplifies a critical but potentially time-consuming task of setting up monitoring for managed targets. As you add targets to Enterprise Manager, options are automatically provided to monitor the target at a recommended or at a minimum level. Each level of monitoring consists of a set of metrics and predefined thresholds that are based on Oracle recommendations for those levels. You may choose to use these Oracle recommendations, or you can change these thresholds to suit your particular needs.

11.4.1 Copying Metric Thresholds to Multiple Targets

Your Enterprise Manager Grid Control installation may be monitoring a very large number of targets, making it inconvenient to manually change metric threshold values for each monitored target. Enterprise Manager Grid Control 10.2 provides an easy way to propagate metric thresholds to any number of targets via monitoring templates.

Monitoring templates allow you to define metric settings once and apply these settings to any number of targets of the same type. For more information about monitoring templates, see Enterprise Manager Grid Control online help.