Skip Headers
Oracle® Enterprise Manager Grid Control Installation and Basic Configuration
10g Release 2 (10.2) for Linux x86

Part Number B16228-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

3 Installing Enterprise Manager

This chapter describes the possible installation options available for Enterprise Manager, and provides basic instructions for installing with Oracle Universal Installer. This chapter contains the following sections:

Accessing the Installation Software

The Oracle Enterprise Manager Grid Control software is available on a DVD-ROM, or you can download it from the Oracle Technology Network (OTN) Web site. You can access and install Enterprise Manager Grid Control by using the following scenarios:

Installing From a Remote DVD Drive

If the computer where you want to install Enterprise Manager does not have a DVD drive, you can perform the installation from a remote DVD drive. Complete the following steps:

Setting the Mount Point for the DVD-ROM

On most Linux systems, the disk mounts automatically when you insert it into the disk drive. To mount the disk, complete the following steps:

  1. Insert the Oracle Enterprise Manager DVD into the disk drive.

  2. To verify if the disk is automatically mounted, enter the following command:

    • On Red Hat Enterprise Linux:

      # ls /mnt/cdrom
      
      
    • On SUSE Linux Enterprise Server:

      # ls /media/cdrom
      
      
  3. If the command in step 2 fails to display the contents of the disk, enter the following command:

    • On Red Hat Enterprise Linux:

      # mount -t nfs <host name>:/mnt/<full path to the dvdrom>
      
      
    • On SUSE Linux Enterprise Server:

      # mount -t nfs <host name>:/media/<full path to the dvdrom>
      

Installing on Remote Computers Using Remote Access Software

Consider a scenario where the remote computer has the hard drive and will run Enterprise Manager, but you do not have physical access to the computer. You can perform the installation on the remote computer, provided it is running remote access software such as VNC or Symantec pcAnywhere. You also need the remote access software running on your local computer.

You can install Enterprise Manager on the remote computer in one of two ways:

  • If you have copied the contents of the Oracle Enterprise Manager Grid Control DVD to a hard drive, you can install from the hard drive.

  • You can insert the DVD into a drive on your local computer, and install from the DVD.

Installing From a Hard Drive

If you have copied the contents of the Oracle Enterprise Manger DVD to a hard drive, you can install from the hard drive. The steps that you need to complete are:

  1. Make sure that the remote access software is installed and running on the remote and local computers.

  2. Share the hard drive that contains the Oracle Enterprise Manager DVD.

  3. On the remote computer, map a drive letter to the shared hard drive. You would use the remote access software to do this on the remote computer.

  4. Through the remote access software, run Oracle Universal Installer on the remote computer. You can access Oracle Universal Installer from the shared hard drive.

  5. For more information on running the installer, see Chapter3, "Starting the Installer" for more information.

Installing From a Remote DVD Drive

You can insert the DVD into a drive on your local computer, and install from the DVD.The steps that you need to complete are:

  1. Make sure that the remote access software is installed and running on the remote and local computers.

  2. On the local computer, share the DVD drive.

    On the remote computer, map a drive letter to the shared DVD drive. You would use the remote access software to do this on the remote computer.

  3. Through the remote access software, run Oracle Universal Installer on the remote computer. You access Oracle Universal Installer from the shared DVD drive.

  4. For more information on running the installer, see Chapter3, "Starting the Installer" for more information.

Using Oracle Universal Installer

The Enterprise Manager installation uses the Oracle Universal Installer, a Java-based graphical user interface application that enables you to install Oracle components from a DVD, multiple DVDs, or the Web.


See Also:

For information on using Universal Installer to install Oracle software, refer to the Oracle Universal Installer and OPatch User's Guide.

Specifying a Temporary Directory on Linux

When you start Oracle Universal Installer (OUI), it automatically copies some executable files and link files into the default /tmp directory on the machine. If the machine is set to run cron jobs periodically, these jobs attempt to cleanup the default temporary directory, thereby deleting some files causing OUI to fail.

If there are any cron jobs that are automatically run on the machines to clean up the temporary directories, ensure you set the TMP or TEMP environment variable to a different location (than/tmp) that is secure on the hard drive (meaning a location on which the cleanup jobs are not run). This must be done before you execute runInstaller.


Note:

Specifying an alternative temporary directory location is not mandatory, and is required only if any cron jobs are set on the Linux machines to clean up the /tmp directory.

Starting the Installer

Start the Oracle Universal Installer by executing the runInstaller script for Linux from the top directory of the DVD.

Alternatively, you can change the directory to the Parent Directory, the root directory where you will install the Oracle home, then specify the full path to ./runInstaller.

To specify a response file for a silent installation, use the following command:

$ ./<runInstaller or setup.exe> -responseFile <responsefile_location> <optional_parameters> -silent


See Also:

Refer to the Creating and Customizing Response Files chapter of the Oracle Universal Installer and OPatch User's Guide for more information on silent installations.

When you invoke the installer, the installation runs prerequisite checks on:

  • Operating System Version

  • Operating System Packages

  • Operating System Patches

  • User Credentials

  • TEMP and SWAP space

  • DISPLAY Colors

  • Additional Patches

  • Kernel version

  • Oracle home is empty

  • Oracle home space

  • Physical memory

The list of prerequisite checks that must be executed can be viewed in the initialization parameters file located in the following directory of the product-specific installation:

<DVD>/install/oraparam.ini

If a prerequisite check fails, you are prompted to continue or stop the installation process. You may install the missing software at this point or discontinue the installation. Note, however, that you may have newer patches that supersede the required patches.

Once you continue, follow the installation instructions on the page. At any time while installing Enterprise Manager, you can click Help for information about the pages.

Enterprise Manager Installation Types

This section contains the following topics:

The following pre-defined installation options, described in Table 3-1, determine which components will be installed on your system for Linux operating systems. During installation, you are prompted to choose one of the following options. Note that the hard disk space represents the footprint that the components of the installation consume, and the physical memory prerequisites refer to the initial RAM required for installation, and not the operating memory.

Table 3-1 Enterprise Manager Installation Options

Installation Option Description Hard Disk Space (Oracle Homes) Physical Memory

Enterprise Manager 10g Grid Control Using a New Database

Installs Enterprise Manager Grid ControlFoot 1  onto the host machine, creating the Management Repository on a new Enterprise Edition Oracle 10g Database Release 1 (10.1.0.4).

4.5 GB

1 GB

Enterprise Manager 10g Grid Control Using an Existing Database

Installs Enterprise Manager Grid Control onto the host machine, creating the Management Repository on a qualified existing database, which may be local to the host or remote. See Chapter1, "Management Repository Software Requirements" for more information on supported repository versions.

Note: If the repository is on the same machine as the Management Service, allow 1 GB more memory than recommended.

Oracle recommends installing Enterprise Manager on a separate disk from the Oracle Database containing the Management Repository.

2.5 GB

512 MB

Additional Management Service

Installs the Management Repository onto the host machine. Allows you to specify an existing Management Repository, either local or remote.

2 GB

512 MB

Additional Management Agent

Installs the Management Agent on the target machine you want to monitor with the Grid Control Console. The Management Service and Management Repository are not required on the same machine as the Management Agent, but must exist within the enterprise.

The Management Agent may be installed on a cluster node. Oracle recommends that the target host on which you are installing the agent have a static IP address and not DHCP.

400 MB

No minimum requirement


Footnote 1 Enterprise Manager Grid Control consists of the Management Repository, Management Service, Management Agent, and OracleAS J2EE and Web Cache, against which the middle-tier Management Service Web application is deployed.

ATTENTION:

When you perform an Enterprise Manager installation, this installation does not include Enterprise Manager Configuration Plug-in (EMCP) in the database Oracle home. EMCP is part of the repository database Oracle home only when you perform a standalone database installation.


See Also:

Refer to Oracle Enterprise Manager Concepts for more detailed information about the Grid Control Console, the Management Repository, Management Service, and Management Agent, and how they work together.

See Chapter 4, "Enterprise Manager Silent Installations" for more information.


Installation Instructions

Start the Oracle Universal Installer by executing the runInstaller script in Linux (<DVD>/runInstaller).

Installation types are predefined component sets that determine which components to install. The Enterprise Manager 10g Grid Control installation involves four top-level components, each representing an install type. Select one of the installation types described below.

Installing Enterprise Manager 10g Grid Control Using a New Database

This is the default option that is selected when you run the Enterprise Manager Grid Control installer. Keep this selection if you want to install Enterprise Manager and all its dependent components on a single host. If you choose this installation option, you do not need an existing Enterprise Edition database, because one is created during the installation.


Note:

The default port for the Listener is 1521 for the 10g R1 (10.1) Oracle Database provided with the full installation.

Permissions and Prerequisites

The installation should not be run by the root user.

  • Create a token object

  • Lock pages in memory

  • Log in as Administrator

  • Create a Service

To Install Enterprise Manager Using a New Database

Complete the following steps to perform an Enterprise Manager installation using a new database.

  1. Select the first option (Enterprise Manager 10g Grid Control Using a New Database). By default, this option is selected when you invoke the installer.

    Figure 3-1 Specify Installation Type

    Select the Installation Type in this page.
  2. Click Next. In the Specify Installation Location page that appears, enter a parent directory (base directory), for example, /scratch/OracleHomes, for the new installation. All the Oracle homes created during this installation are created as sub-directories under this parent directory. For example: db10g, oms10g, and agent10g.


    Note:

    Ensure you do not use symbolic links to specify the Oracle home path.

    Figure 3-2 Specify Installation Location

    Specify the Installation location in this page.

    The installer by default installs the selected products in the English language. If you want to install the product in a different language, click Product Languages.

    The Language Selection page is displayed.

    Figure 3-3 Language Selection

    Select the required product languages.

    Choose the languages that you want to use to run Enterprise Manager.


    Note:

    The languages that you select here only change the language of Enterprise Manager, and not the language of the installation itself.

  3. Click Next. The Specify Inventory Directory and Credentials page is displayed only if you are installing Grid Control for the first time.

    Figure 3-4 Specify Inventory Directory and Credentials

    Specify the Inventory Directory and Credentials.
    1. Specify the full path to the directory where the Oracle Universal Installer (OUI) should place inventory files and directories. For example, oracle_base/oraInventory.

      Refer to the Enterprise Manager Online Help for more information on Oracle-recommended guidelines for naming the directories.

    2. Select the appropriate Operating System group name that will own the Oracle Inventory Directories. The group that you select must have write permissions on the Oracle Inventory directories.

  4. Click Next. The Product-Specific Prerequisite Checks page is displayed.

    Figure 3-5 Product-Specific Prerequisite Checks

    Displays product-specific prerequisites checks.

    At this point, the installer runs some prerequisite checks to verify whether the environment meets the minimum requirements for a successful Enterprise Manager installation.

    Early detection of problems with the system setup reduces the chances of you encountering problems during installation; for instance, problems with insufficient disk space, missing patches, inappropriate hardware, and so on.

    This page displays the name, type, and status for all prerequisite checks designed for the installation. Automatic checks are run first, followed by optional and manual checks.

    Depending on the status of the automatic checks, you must verify all warning and manual checks. At some point, if you have stopped the prerequisite check and want to re-run these checks, select the checks that you want to rerun and click Retry. As each check runs, a progress bar is shown, and test details (expected results, actual results, error messages, instructions) are displayed in the details section at the bottom of the page.


    Note:

    You can also run these prerequisite checks in standalone mode, prior to starting the runInstaller. See Chapter1, "Running the Prerequisite Checker in Standalone Mode" for more information.

    1. To stop all prerequisite checks, click Stop. At any point in time, click a prerequisite check to view its corresponding details, including the recommended user actions.


      Note:

      You must manually verify and confirm all checks that were flagged with a warning, skipped (stopped by user), or failed.

    2. To continue with the installation without retrying, click Next.

      An error message is displayed if some recommended prerequisite checks have failed.

      Figure 3-6 Warning

      Error Message if recommended prereq checks have failed.
    3. Click No to go back and rerun the prerequisite check. click Yes to ignore the message and continue with the installation.


      Note:

      It is recommended that you retry checks that were flagged with warnings, failed, or were skipped (stopped by the user) before continuing with the installation.

  5. The Specify Configuration page appears.

    Figure 3-7 Specify Configuration

    Specify repository configuration details.

    You must specify the configuration details for the new database that you are creating, and select the appropriate recipients of the OSDBA and OSOPER privileges.


    Note:

    Your Management Repository Database may also require patches to be applied after successful installation. See Chapter1, "Enterprise Manager Platform and Target Certification Requirements" for more information.

    1. Specify the new Database Name, and the Database File Location (location where the new database is going to reside).


      Note:

      It is recommended that you specify a fully qualified database name (for example, emrep.<domain_name>), though appending the database name with the domain name is not mandatory.

    2. In the Group Specification section, select the OSDBA and OSOPER groups that you are a member of. These memberships are required to grant the SYSDBA and SYSOPER privileges that are, in turn, required to create the new database using the Operating System authentication.

  6. Click Next. The Specify Optional Configuration page appears.

    Figure 3-8 Specify Optional Configuration

    Specify the option configuration details.

    As the name suggests, all the fields on this page are optional, and are disabled by default. Select the required check box to enable the corresponding fields.

    1. In the Configure Email Notification section, specify an appropriate e-mail address, and the corresponding SMTP server name. You will receive information on important developments and events in Grid Control, including critical alerts at this e-mail address.

      The e-mail address that you specify should be associated with the SYSMAN user to receive notifications.

      The SMTP Server is the name of the mail server (for example mail.acme.com). For Linux, the default SMTP server is the local host name. Use the fully-qualified host name (including domain).


      Note:

      If you do not provide the e-mail notification information, this feature is not enabled upon installation. You may also choose to configure these settings through the Enterprise Manager console by clicking Notification Methods under Setup. Refer to the Enterprise Manager Online Help for more information.

    2. Specify the Oracle MetaLink credentials.

      If you prefer, you can also enter this information through the Enterprise Manager console after installation by clicking Patching Setup, under Setup.


      Note:

      Enterprise Manager uses these credentials to search for and download patches from http://oracle.com/support/metalink/index.html.

    3. Specify the Proxy Information if Enterprise Manager is using a proxy server for external access. The following table describes each of the fields under this section:

      Table 3-2 Specify Proxy information - Input Fields

      Input Description

      Proxy Server

      Specify the proxy server host name. For example, www-fooproxy.here.com

      Port

      Specify the port at which the server is listening. For example, 80

      Do Not Proxy For

      Specify the URLs that do not need the proxy server to be accessed. You can specify multiple comma-separated values. For example, .here.com, .us.mycompany.com, .uk.mycompany.com, and so on.

      Note that you must always specify fully-qualified host names.

      Proxy User and Password

      These are optional fields. You must specify the username and password only if the proxy server has been configured to use these credentials for authentication.

      Realm

      This becomes a mandatory field only if the proxy server credentials have been configured using a realm, in which case you must specify an appropriate realm value.

      A realm is a string value assigned by the proxy server to indicate the secure space that requires authentication.

      Test Proxy

      Click this button to verify your proxy server settings.



      Note:

      When you search for a patch, if the proxy properties (saved in the sysman/config/emoms.properties file) are not set, or are set incorrectly, you receive an error message indicating that Enterprise Manager cannot access the Oracle MetaLink Web site.


      ATTENTION:

      If the proxy server requires user authentication before providing access, you must specify these credentials here or through the Patching Setup page under Setup in the Grid Control console.

  7. Click Next. The Specify Security Options page is displayed.

    Figure 3-9 Specify Security Options

    Specify OMS and repository database securtiy details.

    You must specify the passwords that are used to secure your entire Grid Control environment. This page has two sections - Secure Management Server Password, and Repository Database Passwords.

    • Management Server Security: The password that you specify here is used to secure the Oracle Management Service (OMS).

      Select Require Secure Communications for all agents if you want the secure OMS to communicate only with Secure Agents. This is optional, though recommended.

      For example, consider you have 10.1.x agents in the Grid and you have secured the OMS. Now, if you select the Require Secure Communications option, then all communication between the 10.2 OMS and 10.1.x agents fails (since these agents have not been secured).


      Note:

      To secure an Agent, go to the Agent Oracle home command line of the particular target, and execute following command:
      AGWNT_HOME/bin/emctl secure agent
      

    • Repository Database Passwords: Specify the passwords for each of the following administrative database accounts.

      Table 3-3 Repository Database Passwords

      User Account Applies To Description

      SYS

      Repository Database

      Super Administrator for the repository database.

      SYSTEM

      Repository Database

      Administrator for the repository database.

      DBSNMP

      Repository Database

      Monitoring user for the repository database.

      SYSMAN

      Repository Database, Application Server, and Grid Control

      The default Grid Control Super Administrator and Owner of the repository database schema and the Grid Control application user.

      The default ias_admin password is the same as the password assigned to the SYSMAN account. This is required to access the Oracle application server (ias_admin). The ias_admin user is the administrative user for Oracle Application Server instances.


      You can use the same password for all four accounts, or specify a different password for each account. These passwords are used to secure the Management Repository database.

      To specify a different password for each account, select Use different passwords for these accounts and specify the passwords for each account.

      To specify the same password for all accounts, select Use the same password for all accounts and specify one password to be used for all database accounts.


      Note:

      The SYS, SYSMAN, DBSNMP, and SYSTEM users are privileged database users. You must remember the passwords that you specify for them. For more information on password restrictions and recommendations, see the Oracle Database Administrator's Guide.

      Password Restrictions and Recommendations

      The following restrictions apply to passwords:

      • Passwords must be between 5 and 30 characters long.

      • Passwords cannot be the same as the user name.

      • Passwords must include alphabets (lowercase/uppercase) and numbers only.


        Note:

        The SYSMAN password can include underscores (_), and hypens (-) along with alphanumeric characters. Alpha characters can be uppercase or lowercase.

      • Passwords cannot be Oracle reserved words. See Appendix H, "Oracle Reserved Words" for more information.


      Note:

      Oracle recommends the passwords you specify:
      1. Have at least one letter, one integer, and one punctuation mark (underscore).

      2. Are not simple or obvious words such as welcome, account, database, or user.


  8. Click Next. The Summary page is displayed.

    Figure 3-10 Summary

    The installation summary page appears.

    This page displays a summary of the options that you have selected during the installation process. Depending on the installation type, this page displays any or all of the following details:

    • Global Settings

    • Product Languages

    • Space Requirements

    • Installed Products

    Verify the choices that you have made.

    1. Click Install to start the installation. The Install page that appears displays the installation progress bar.

      Figure 3-11 Installation in Progress

      The installation progress bar is displayed.

      Enterprise Manager Installer seamlessly installs all Grid Control components based on the installation type you selected.

    2. During the installation, you are prompted to execute certain configuration scripts. These scripts and their locations are listed in the Execute Configuration Scripts dialog that is displayed (only for Linux).

      Figure 3-12 Execute Configuration Scripts

      Execute the configuration scripts.

      Go to the terminal window, log in as root, and run these configuration scripts.

    3. Return to the above dialog box after executing the scripts, and click OK to continue the installation.

  9. The Configuration Assistants page is displayed. At this point, the Installer starts running the recommended Configuration Assistants.

    Figure 3-13 Configuration Assistants

    Configuration assistants that are being executed.

    This page displays the name, status, and the type of each configuration tool that Oracle recommends to be run before completing the installation.

    The following table lists all the configuration tools that are run during a typical Enterprise Manager installation (Install Enterprise Manager Using a New Database):

    Table 3-4 Enterprise Manager Configuration Tools

    Product Configuration ToolFoot 1 

    Oracle Repository Database

    • Oracle Net Configuration Assistant

    • Oracle Database Configuration Assistant

    Oracle Enterprise Manager Grid Console

    • OC4j Configuration Assistant

    • HTTP Server Configuration Assistant

    • Java Configuration Assistant

    • Web Cache Configuration Assistant

    • Oracle iAS Instance Configuration Assistant

    • Register DCM Plug-Ins with Enterprise Manager

    • DCM Repository backups Assistant

    • Enterprise Manager Technology Stack Upgrade

    • Oracle Management Service Configuration

    Oracle Management Agent

    • Agent Configuration Assistant


    Footnote 1 Depending on the installation type that you have selected, any or all the configuration tools listed in this table will be run.

    Note:

    The individual log files for each configuration tool are available at the following directory:
    ORACLE_HOME/cfgtoollogs/cfgfw
    
    

    Besides the individual configuration logs, this directory also contains cfmLogger_timestamp.log (The timestamp depends on the local time and has a format such as cfmLogger_2005_08_19_01-27-05-AM.log.) This log file contains all the configuration tool logs.


    1. To stop running a configuration tool, select it and click Stop.

    2. To rerun a configuration tool, select it and click Retry.


      Note:

      The installation is considered successful even if all the configuration tools fail, irrespective of their type (recommended/optional). However, failing to successfully run all the configuration tools results in an improperly configured product, which may not function. Refer to the Enterprise Manager Installation Online Help for more information.


      Caution:

      In the event a particular configuration assistant fails, you can choose to rerun only that configuration assistant (in standalone mode). See Appendix D, "Executing the runConfig Command Line Tool" for more information.

  10. After successfully running all the recommended configuration tools, the End of Installation page is displayed.

    This page displays some important information about the products you have installed. This information is also available in the <AGENT_HOME>/sysman/setupinfo.txt file.

    For example, it might contain information about the URLs for particular Web applications. If necessary, write this information down so that you can remember it.

Installing Enterprise Manager 10g Grid Control Using an Existing Database

Select this option if you want to perform a complete Enterprise Manager Grid Control installation and have a qualified existing database in which to create the Management Repository. The database can be local or remote to the machine on which you are installing. Real Application Clusters databases must be on a shared disk.

The hardware requirements for the Management Repository and the operating system patch requirements for the host machine must be satisfied regardless of whether you choose to create a new database or use an existing database for the Management Repository during the installation session.

If you plan to use an existing database for your Management Repository creation, check all software requirements for the database and host, as well as for the repository.

Prerequisites

  • Ensure the installation is not run by the root user.

  • Ensure the Password Verification option is disabled in the database. If the Password Verification is enabled, repository creation may fail.

  • Ensure there is sufficient physical memory available for this installation type. See Table 3-1 for more information on the recommended hard disk and memory requirements. See Chapter1, "Recommended CPU and Memory Allocation for Enterprise Manager Deployments" for more information.

  • The RDBMS version should be 9.2.0.6 and higher, or 10.1.0.4 and higher. Execute select banner from v$version to find out the current RDBMS version.

  • The name of the host on which the installation is being performed should neither be localhost.localdomain nor an IP Address. It must be a valid host name. At the time of invoking the installer, you can pass ORACLE_HOSTNAME as an argument.


    ATTENTION:

    Do not pass the argument as ORACLE_HOSTNAME=<localhost.localdomain> or ORACLE_HOSTNAME=<IP address>. You must pass the argument as ORACLE_HOSTNAME=<valid host name>.

Table 3-5 Initialization Parameter Values

Parameter Value

job_queue_processes

10

db_block_size

8192

remote_login_passwordfile

EXCLUSIVE

timed_statistics

TRUE

open_cursors

300

session_cached_cursors

200

shared_pool_size

67108864

dispatchersFoot 1 

NULL

aq_tm_processesFoot 2 

1

compatible

<currently installed Oracle RDBMS version> (default)

TEMP Space

50 MB (extending to 100 MB)


Footnote 1 If this parameter is present in the inti.ora file, it MUST be set to NULL. No other value must be used.
Footnote 2 If this parameter is not set, or is set to 0 (zero), the dequeued messages are not purged. Set this value to 1 or greater.

See AppendixB, "Initialization Parameters" for a detailed list of database initialization parameter settings based on the Enterprise Manager deployment size.

Chapter1, "Enterprise Manager Software Requirements" includes information on the versions of the Oracle Database and Real Application Clusters Database that qualify for Management Repository creation.

See Chapter 1, "Pre-Installation Requirements" for more information on hardware and software requirements.

NLS_LANG Environment Variable

If your operating system is Linux, ensure the NLS_LANG environment variable is set with a value that is compatible with the operating system default locale setting and the Management Repository database character set. For information on the specific values for language, territory, or character set, refer to the Globalization Support Guide of the Oracle product that you are using.

A Typical Installation Scenario

If you choose to install Enterprise Manager using an existing database, you must provide the location of an existing database where the installer will create the repository. Here again, the database should be of version 9.2.0.6 and higher, or 10.1.0.4 and higher. If you have an earlier database version installed, you must first upgrade this database instance to the specified minimum version (9.2.0.6 and higher, or 10.1.0.4 and higher) and then proceed with the Enterprise Manager installation.

To Install Enterprise Manager Using Existing Database

Complete the following steps to install Enterprise Manager using an existing database:

  1. Start the Oracle Universal Installer by running the runInstaller script in Linux (<DVD>/runInstaller) from the top directory of the DVD.

  2. In the Specify Installation Type page, select the second option (Enterprise Manager 10g Grid Control Using an Existing Database). Click Next.

    Figure 3-14 Specify Installation Type

    Select the appropriate installation option.
  3. The Specify Installation Location page appears.

    1. Specify the full path to the parent directory (base directory), for example, /scratch/OracleHomes. All the Oracle homes created during the installation are placed as sub-directories under this parent directory. For example: oms10g, and agent10g.


      ATTENTION:

      Ensure you do not use symbolic links to specify the Oracle home path.

      The installer by default installs the selected products in the English language.

    2. If you want to install the product in a different language, click Product Languages.

      The Language Selection page is displayed. Make the required language selections here, and click Next. See Figure 3-3, "Language Selection" for details.

  4. Click Next. The Specify Inventory Directory and Credentials page appears if Enterprise Manager is the first Oracle product that you are installing on the machine. See Figure 3-4, "Specify Inventory Directory and Credentials" for details.

  5. Click Next. The Product Specific Prerequisites Check page appears.

    This page displays the name, type, and status for all prerequisite checks designed for the installation. Automatic checks are run first, followed by optional and manual checks.

    Depending on the status of the automatic checks, you must verify all warning and manual checks. At some point, if you have stopped the prerequisite check and want to re-run these checks, select the checks that you want to re-run and click Retry. As each check runs, a progress bar is shown, and test details (expected results, actual results, error messages, instructions) are displayed in the details section at the bottom of the page. See Figure 3-5, "Product-Specific Prerequisite Checks" for details.


    Note:

    You can also run these prerequisite checks in standalone mode, prior to starting the runInstaller. See Chapter1, "Running the Prerequisite Checker in Standalone Mode" for more information.

  6. Click Next. The Specify Repository Database Configuration page appears.

    Figure 3-15 Specify Repository Database Configuration

    Specify repository database configuration details.

    Specify the connection details for the existing database in which the Management Repository should be created. The Management Repository database can be created on the following database versions:

    • Oracle 10g Database Release 1 (10.1.0.4 and higher), Enterprise Edition

    • Oracle 10g Real Application Clusters Database Release 1 (10.1.0.4 and higher)

    • Oracle 9i Database Release 2 (9.2.0.6 and higher), Enterprise Edition

    • Oracle 9i Real Application Clusters Database Release 2 (9.2.0.6 and higher)

    1. In the Database Connection Details section, specify a fully-qualified host name, repository Port number, SID (Oracle System Identifier) for the database instance, and the SYS Password.

      The Oracle System Identifier (SID) identifies a specific Oracle database and distinguishes it from other databases on the computer.


      Note:

      When selecting an existing cluster database for creating the Management Repository, you must replace the SID value with the Management Service name.

    2. Enter the password for the SYS user. This account is used to create the SYSMAN user, which is the primary owner of the Management Repository schema.

    3. In the Additional Tablespace section, specify the location for the following:

    • Management Tablespace Location: The MGMT_TABLESPACE tablespace holds data for the Management Repository.

    • Configuration Data Tablespace Location: The MGMT_ECM_DEPOT_TS tablespace holds Configuration Management data for the Management Repository.

    For ASM (Automatic Storage Management) devices, the tablespace locations should be specified relative to the ASM disk group. For example: +<DVD>/emrep/tablespace.dbf

    For tuning/performance reasons, Oracle recommends placing Binary Large Objects (BLOBs) in their own tablespace. Since Enterprise Configuration Management data support BLOBs, the Management Repository requires two tablespaces: MGMT_TABLESPACE and MGMT_ECM_DEPOT_TS.

    Specify the full path file locations for the above-mentioned tablespaces. The directories you specify for these tablespaces must already exist for repository creation to succeed. For raw devices, you must partition your disk before specifying its location. Note that raw device path names vary across volume managers. Make sure to use the right path format for your raw device locations.

    If you do not have the complete path for the tablespaces, click Prefill Tablespace Location. The installer then queries the database you have specified. Look for the SYSAUX tablespace location, and prefill that path in the appropriate box.


    Notes:

    • The two tablespaces initially require 120 MB of disk space, with MGMT_TABLESPACE requiring 20 MB and MGMT_ECM_DEPOT_TS requiring about 100 MB. Ensure there is enough disk space available.

    • If you are selecting an existing cluster database for the new Management Repository, the management tablespace file locations must be on a shared device that is accessible to all instances that provide the database service.



    ATTENTION:

    If the DBMS_SHARED_POOL package has not been installed at the time of the database creation, Oracle Universal Installer displays an error message and prompts you to execute this package before proceeding with the installation.

    To check whether the DBMS_SHARED_POOL package has been installed, login to the database and execute the following query:

    select object_name, object_type from all_objects where object_name = 'DBMS_SHARED_POOL'

    To install the DBMS_SHARED_POOL package, execute the following scripts:

    1. <DB_HOME>/rdbms/admin/dbmspool.sql

    2. <DB_HOME>/rdbms/admin/prvtpool.plb


  7. Click Next. The Specify Optional Configuration page appears.

    As the name suggests, all the fields on this page are optional, and are disabled, by default. Select the required check box to enable the corresponding fields.

    1. In the Configure Email Notification section, specify an appropriate e-mail address, and the corresponding SMTP server name in this section. You will receive information on important developments and events in Grid Control, including critical alerts, at this e-mail address.

      The e-mail address that you specify should be associated with the SYSMAN user to receive notifications.

      The SMTP Server is the name of the mail server (for example mail.acme.com). For Linux, the SMTP server must be the local host name. Use the fully-qualified host name (including domain).


      Note:

      If you do not provide the e-mail notification information, this feature is not enabled upon installation. You may also choose to configure these settings through the Enterprise Manager console by clicking Notification Methods under Setup. Refer to the Enterprise Manager Online Help for more information.

    2. Specify the MetaLink credentials if you are going to use a proxy server to access MetaLink.

      If you prefer, you may also enter this information through the Enterprise Manager console after installation by clicking Patching Setup, under Setup.


      Note:

      Enterprise Manager uses the MetaLink credentials to search for and download patches from http://oracle.com/support/metalink/index.html.

    3. Specify the Proxy Information if Enterprise Manager is using a proxy server for external access. See Table 3-2 for a description on each of the input fields in this section.


      ATTENTION:

      If the proxy server requires user authentication before providing access, you must specify these credentials here, or through the Patching Setup page under Setup in the Grid Control console.

  8. Click Next. The Specify Passwords page appears.

    Figure 3-16 Specify Passwords

    Specify OMS and repository security details.
    1. Specify the Secure Management Service, and Repository Database passwords that are used to secure your entire Grid Control environment.

    2. Select Lock Secure Communications if you want the secure OMS to communicate only with Secure Agents. This is optional, though recommended.

      For example, if you have 10g R1 (10.1.x) agents in the Grid environment, and you have secured the OMS and selected the Require Secure Communications option, then all communication between the 10g R2 (10.2) OMS and 10.1 agents fails (since these agents have not been secured).

      To secure an agent, execute the following command from the agent Oracle home of that particular target:

      emctl secure agent
      
      

      See the section on Password Restrictions and Recommendations in this chapter for more information.

  9. Click Next. The Summary page appears.

    This page displays a summary of the options that you have selected during the installation process. Depending on the installation type, this page displays any or all of the following details:

    • Global Settings

    • Product Languages

    • Space Requirements

    • New Installations

    • Installed Products

    Verify the choices that you have made and click Install to start the installation. The Install page that appears displays the installation progress bar.

    Enterprise Manager Installer seamlessly installs all Grid Control components based on the installation type you selected.

  10. During the installation, you are prompted to execute certain configuration scripts. These scripts and their locations are listed in the Execute Configuration Scripts dialog that is displayed (only for Linux). Refer to Figure 3-12.

    1. To execute these scripts, go to the terminal window, log in as root, and run these configuration scripts.

    2. Return to the Execute Configuration Scripts dialog box after executing the scripts, and click OK to continue the installation.

  11. The Configuration Assistants page appears. At this point, the installer starts running the recommended Configuration Assistants.


    Note:

    The OMS Configuration Assistant will create the repository. The repository creation log (emca_repos_create<TimeStamp>.log for Eg.emca_repos_create05_13_33.log) is available at the following directory:
    OMS_HOME/sysman/log/
    

    This page displays the name, status, and the type of each configuration tool that Oracle recommends to be run before completing the installation. Refer to Table 3-4 to see the list of configuration tools that are run.

  12. After successfully running all the recommended configuration tools, click Next. The End of Installation page appears.

    This page tells you whether or not the installation was successful, and displays some important information that you must remember about the products you have installed. For example, it might contain information about the URLs for particular Web applications. If necessary, write this information down so that you can remember it.

Configuration Assistant

The Enterprise Manager Repository Configuration Assistant displays an error message if the SYSMAN user already exists in the database you specify for the Management Repository. This type of database installation cannot be used for a Management Repository.

If the Management Repository Configuration Assistant fails before completion, you can click Retry, which automatically cleans up the repository when the configuration tool is rerun. To manually clean up the repository, use the following command:

OMS_HOME/sysman/admin/emdrep/bin/RepManager

You may need to set the LD_LIBRARY_PATH to the Management Service's ORACLE_HOME/lib directory before running the script. Refer to the Oracle Enterprise Manager Advanced Configuration for further instructions on how to drop the existing Repository from the database.The listener for the existing database should be the same version as the highest database version on the host. Otherwise, Management Repository creation may fail.

Installing an Additional Management Service

Select this option if you need to add an additional Management Service to your environment. Note that setting credentials for Oracle MetaLink is not necessary for this installation type, as the Management Repository is not affected.

Prerequisites

Ensure the following prerequisites are met before starting the installation:

  • Ensure the installation is not run by the root user.

  • Ensure the hard disk and physical memory requirements are met. See Table 3-1 for more information.

  • Besides the RDBMS version, ensure the Repository version is 10.2.0.1.0.

  • The name of the host on which the installation is being performed should neither be localhost.localdomain nor an IP Address. It must be a valid host name. At the time of invoking the installer, you can pass ORACLE_HOSTNAME as an argument.


    ATTENTION:

    Do not pass the argument as ORACLE_HOSTNAME=<localhost.localdomain> or ORACLE_HOSTNAME=<IP address>. You must pass the argument as ORACLE_HOSTNAME=<valid host name>.


See Also:

Refer to the Reconfiguring the Management Agent and Management Service chapter of the Oracle Enterprise Advanced Configuration Guide for more information on controlling the Management Service.

See Appendix G, "Assigning Custom Ports" for more information on assigning port numbers for Enterprise Manager components.


To Install an Additional Management Service

Complete the following steps to install an additional Management Service.

  1. Start the Oracle Universal Installer by running the runInstaller script in Linux (<DVD>/runInstaller) from the top directory of the DVD.

  2. In the Specify Installation Type page, select the third option (Additional Management Service).

    Figure 3-17 Specify Installation Type

    Select appropriate installation (third) option.
  3. In the Specify Installation Location page, specify the full path to the parent directory (base directory), for example, /scratch/OracleHomes. The OMS home created during the installation is placed as a sub-directory under this parent directory. For example: oms10g.


    Note:

    Ensure you do not use symbolic links to specify the Oracle home path.

    The installer by default installs the selected products in the English language.

    1. If you want to install the product in a different language, click Product Languages.

    2. The Language Selection page is displayed. Make the required language selections here. See Figure 3-3, "Language Selection" for details.

  4. Click Next. The Product Specific Prerequisites Check page appears.

    This page displays the name, type, and status for all prerequisite checks designed for the installation. Automatic checks are run first, followed by optional and manual checks.

    Depending on the status of the automatic checks, you must verify all warning and manual checks. At some point, if you have stopped the prerequisite check and want to rerun these checks, select the checks that you want to rerun and click Retry. As each check runs, a progress bar is shown, and test details (expected results, actual results, error messages, instructions) are displayed in the details section at the bottom of the page. See Figure 3-5, "Product-Specific Prerequisite Checks" for more information.


    Note:

    You can also run these prerequisite checks in standalone mode, prior to starting the runInstaller. For more information on running these prerequisite checks in standalone mode, see Chapter1, "Running the Prerequisite Checker in Standalone Mode" for more information.

  5. Click Next. The Specify Repository Database Configuration page appears.

    Figure 3-18 Specify Repository Database Configuration

    Specify OMS and reporitory database configuration details.
    1. You must configure the additional Management Service to establish the connections with the existing Management Repository.


      Note:

      The existing Management Repository database must be one of the following versions:
      • Oracle 10g Database Release 1 (10.1.0.4), Enterprise Edition

      • Oracle 10g Real Application Clusters Database Release 1 (10.1.0.4)

      • Oracle 9i Database Release 2 (9.2.0.6 and higher), Enterprise Edition

      • Oracle9i Real Application Clusters Database Release 2 (9.2.0.6 and higher)

      The Management Repository database may also require patches to be applied, prior to successful installation. See Chapter1, "Enterprise Manager Platform and Target Certification Requirements" for more information.


    2. In the Repository Database Connection Details section, specify a fully-qualified host name on which the Management Repository database is installed, the repository port, and the SID (Oracle System Identifier) for the database instance.

      The Oracle System Identifier (SID) identifies a specific Oracle database and distinguishes it from other databases on the computer.


      Note:

      When selecting an existing cluster database for creating a Management Repository, you must replace the SID value with the Service name.

    3. Enter the password for the SYSMAN user (the default Super Administrator account for Enterprise Manager).

    4. In the Management Server Security section, specify the password used to secure the Oracle Management Service (OMS).

    5. Select Require Secure Communications for all agents if you want the secure OMS to communicate only with Secure Agents. This is optional, though recommended.

      For example, if you have 10g R1 (10.1.x) agents in the Grid environment, and you have secured the OMS and selected the Require Secure Communications option, then all communication between the 10g R2 (10.2) OMS and 10.1 agents fails (since these agents have not been secured).

      To secure an agent, execute the following command from the agent Oracle home of that particular target:

      emctl secure agent <password>
      
      

      See the section Password Restrictions and Recommendations in this chapter for more information.


      Note:

      The password that you specify here must be the same as the password that you specified to secure the Management Service (OMS).

  6. Click Next. The Specify Optional Configuration page appears.

    Figure 3-19 Specify Optional Configuration

    Select optional configurations.

    As the name suggests, all the fields on this page are optional, and are disabled, by default. Select the required check box to enable the corresponding fields.

    1. Select the Configure Proxy check box (optional) if Enterprise Manager is using a proxy server for external access. Specify the properties for the proxy server host name (enter a fully-qualified host name), port number, Do Not Proxy for list, and the Proxy user credentials. See Table 3-2 for a description of the input fields.

    2. Specify an appropriate Realm value. This becomes a mandatory field only if the proxy server credentials have been configured using a Realm, in which case, you must specify an appropriate Realm value.

      A Realm is a string value that is assigned by the proxy server to indicate the secure space that requires authentication.

  7. Click Next. The Summary page appears.

    This page displays a summary of the options that you have selected during the installation process. Depending on the installation type, this page displays any or all of the following details:

    • Global Settings

    • Product Languages

    • Space Requirements

    • New Installations

    For more information on each of the above-listed details, see the Enterprise Manager Online Help.

    Verify the choices that you have made and click Install to start the installation. Enterprise Manager Installer begins installing the selected Oracle product.

  8. During the installation, you are prompted to execute certain configuration scripts. These scripts and their locations are listed in the Execute Configuration Scripts dialog that is displayed (only for Linux). Refer to Figure 3-12.

    1. To execute these scripts, go to the terminal window, log in as root and run these configuration scripts.

    2. Return to the Execute Configuration Scripts dialog box after executing the scripts, and click OK to continue the installation.

  9. The Configuration Assistants page appears. At this point, the installer starts running the recommended configuration tools.

    This page displays the name, status, and the type of each configuration tool that Oracle recommends to be run before completing the installation. Refer to Table 3-4 to see the list of configuration tools that are run.

  10. After successfully running all the recommended configuration tools, click Next. The End of Installation page appears.

    This page tells you whether or not the installation was successful and displays some important information that you must remember about the product you have installed. For example, it might contain information about the URLs for particular Web applications. If necessary, write this information down so that you can remember it.

Installing a Management Agent

Select this option to install the Management Agent in an Oracle home directory on a specified host target. Each host you wish to monitor must have an Agent installed.

You can install the Management Agent in the following ways:

  • On each host computer, run Oracle Universal Installer from the Enterprise Manager DVD-ROM and select the Additional Management Agent installation type. This method installs one Agent at a time in interactive GUI mode. You may also perform silent installations using a response file.

  • Use the Agent Deploy application to perform a fresh agent installation (standalone or cluster agent) or a shared agent installation.

  • Use the nfsagentinstall script to install and deploy the shared Mangement Agent.

  • Use the agentDownload script to install and deploy Management Agents to many managed hosts through HTTP or over the network.


    See Also:

    See Chapter 5, " Deploying the Management Agent" for a full and detailed explanation on installing Management Agents using the agentDownload script and the nfsagentinstall script.

    See Appendix G, "Assigning Custom Ports" for information on assigning custom port numbers for Enterprise Manager components.



    Attention:

    If you install the Management Agent on a system where you have already installed an Oracle Application Server instance, you must install the Management Agent from a user account that belongs to the same OS Group group that was used to install the Application Server. Otherwise, you cannot monitor the application server metrics.
    • To see which group was used to install the Application Server, type ls -l on the command line in the directory containing opmn.xml: <AS_ORACLE_HOME>/opmn/conf.

    • To see the groups to which you belong, type groups on the command line. You may be a member of several groups. Note that it is not sufficient to be a member of the group used to install the Application Server; that group must be your current group.

    • To see which user/group you are currently using, type id on the command line. Use the newgrp command to change to the group used to install the Application Server. Oracle recommends installing all software using a single group.


Prerequisites

Ensure the Agent Oracle home must not contain any other Oracle software installation.


Note:

Enterprise Manager does not support uploading of data to the same Management Repository from two Management Agents running on the same host.

To Install an Additional Management Agent Using OUI

  1. Start the Oracle Universal Installer by running the runInstaller script in Linux (<DVD>/runInstaller) from the top directory of the DVD.

  2. In the Specify Installation Type page, select the fourth option (Additional Management Agent), and specify the parent directory path and installation name.

    Figure 3-20 Specify Installation Type

    Select the appropriate installation option (fourth).
  3. In the Specify Installation Location page, specify the full path to the parent directory (base directory), for example, /scratch/OracleHomes. The agent home created during the installation is placed as a sub-directory under this parent directory. For example: agent10g.


    Note:

    Ensure you do not use symbolic links to the Oracle home path.

    The installer by default installs the selected products in the English language.

    1. If you want to install the product in a different language, click Product Languages.

    2. The Language Selection page appears. Make the required language selections here, and click Next. See Figure 3-3, "Language Selection" for details.

  4. The Product Specific Prerequisites Check page appears.

    This page displays the name, type, and status for all prerequisite checks designed for the installation. Automatic checks are run first, followed by optional and manual checks.

    Depending on the status of the automatic checks, you must verify all warning and manual checks. To do this, select the appropriate prerequisite status check box and click Retry. As each check runs, a progress bar is shown, and test details (expected results, actual results, error messages, instructions) are displayed in the details section at the bottom of the page. See Figure 3-5, "Product-Specific Prerequisite Checks" for more information.


    Note:

    You can also run these prerequisite checks in standalone mode, prior to starting the runInstaller. For more information on running these prerequisite checks in standalone mode, see Chapter1, "Running the Prerequisite Checker in Standalone Mode"for more information.

  5. Click Next. The Specify Oracle Management Service Location page appears.

    Figure 3-21 Specify Oracle Management Service Location

    Specify host name and OMS port.
    1. Specify the Management Service host name. For example: dlsun1444.acme.com. Use the fully-qualified host name (including domain).


      ATTENTION:

      When specifying the host name, ensure you do not include the protocol (that is, http:// or https://).

    2. Enter the port number for the Management Service. The default port is 4889 and the default secure port number is 1159.

      However, even if you are specifying a secure Management Service, you must still enter the non-secure port number (4889) here. You must connect over HTTP to receive the certificate before you can connect over HTTPS.


      Note:

      If your Management Service has been configured to use HTTPS, you are prompted to enter the Agent Registration password (used to secure the management Service environment). If you do not know the password, obtain it from the user who configured the Management Service for SSL.

  6. Click Next. If the Management Service is found to be running in a secure mode, the Specify Agent Registration Password page appears. You must provide the correct password to enable communications between the new Management Agent and the SSL-enabled Management Service.

    Figure 3-22 Specify Agent Registration Password

    Specify Agent Resitration Password.

    IMPORTANT:

    If you do not know the password and choose to leave the Password field blank, you must do the following after installation to enable communication between the agent and secure OMS:
    • Find out the correct password for the secure OMS environment. If you do not know the password, obtain it from the user who configured the Management Service for SSL.

    • In the <AGENT_HOME>/bin directory, execute the following command:

      emctl secure agent <password>
      
      

      where <password> is the Agent Registration Password.


  7. Click Next. The Summary page appears.

    This page displays a summary of the options that you have selected during the installation process. Depending on the installation type, this page displays any or all of the following details:

    • Global Settings

    • Product Languages

    • Space Requirements

    • New Installations

    For more information on each of the above-listed details, see the Enterprise Manager Online Help.

    Verify the choices that you have made and click Install to start the installation. Enterprise Manager Installer starts installing the selected Oracle product.

  8. During the installation, you are prompted to execute certain configuration scripts. These scripts and their locations are listed in the Execute Configuration Scripts dialog that is displayed (only for Linux). Figure 3-12, "Execute Configuration Scripts" provides details on this page .

    1. To execute these scripts, go to the terminal window, log in as root, and run these configuration scripts.

    2. Return to the Execute Configuration Scripts dialog box after executing the scripts, and click OK to continue the installation.

  9. The Configuration Assistants page appears. At this point, the installer starts running the recommended configuration tools.

    This page displays the name, status, and the type of each configuration tool that Oracle recommends to be run before completing the installation. Refer to Table 3-4 to see the list of configuration tools that are run.

    See Appendix D, "Executing the runConfig Command Line Tool" for information on executing the runConfig tool.

  10. After successfully running all the recommended configuration tools, click Next. The End of Installation page appears.

    This page displays some important information about the products you have installed. This information is also available in the <AGENT_HOME>/sysman/setupinfo.txt file.

    For example, it might contain information about the URLs for particular Web applications. If necessary, write this information down so that you can remember it.

Deinstallation of Oracle Homes

If you de-install the Enterprise Manager 10g ORACLE_HOME using Oracle Universal Installer, the ORACLE_HOME is de-registered from the central inventory and the oratab file. However, some files may remain in the ORACLE_HOME.

If the ORACLE_HOME has been successfully removed (verify this in OUI by clicking Installed Products), you can manually delete the files through the operating system.

The proper de-installation sequence is:

  1. Stop Enterprise Manager by executing /emctl stop em.

  2. Shut down the Management Service and repository database (if the database software is installed as a part of the Management Service ORACLE_HOME being de-installed).

  3. Shut down the Oracle Database Listener.

  4. Shut down the Management Agent in the Agent Oracle home using the emctl stop agent command.

  5. Run the Database Configuration Assistant (DBCA) to delete the database before proceeding to de-install the Oracle home.

  6. Run the Oracle Universal Installer and select the ORACLE_HOME to de-install. It is removed from the Central Inventory.

  7. Remove stray files from the ORACLE_HOME using the appropriate operating system command.