6 Installing Enterprise Manager System: Before You Begin Prerequisites Installation Procedure After You Install
6 Installing Enterprise Manager System: Before You Begin Prerequisites Installation Procedure After You Install
Overview
Before You Begin
Prerequisites
Installation Procedure
After You Install
Overview
You can install Enterprise Manager Cloud Control with either simple or advanced
configuration.
Simple Installs with typical, default configuration. As the name suggests, it is simple
and quick — you are prompted to enter only the administrator password and
the database connection details.
While the database connection details are used for connecting to your existing,
certified Oracle Database, the administrator password is used as a common
password for SYSMAN user account, WebLogic user account, node manager
user account, and also for authenticating new Oracle Management Agents that
join the Enterprise Manager system.
The rest of the installation comes with default settings and preferences that
Oracle believes you will need for a complete Enterprise Manager system.
This option is meant for administrators who do not worry about the granular
control of the installer and want to install the Enterprise Manager System
quickly.
Advanced Installs with custom or advanced configuration, and is more flexible — you
are prompted to enter WebLogic Server details, database connection details,
data file locations for tablespaces, a password for creating the SYSMAN user
account, and also customize ports according to your environment.
As part of a new Enterprise Manager system, the installation wizard does the
following:
Installs the following components in the middleware home you enter in the
installation wizard:
o Java Development Kit (JDK) 1.6 v24
o Oracle WebLogic Server 11g Release 1 (10.3.5)
o Oracle Management Service 12c Release 1 (12.1.0.1)
o Oracle Management Agent 12c Release 1 (12.1.0.1)
o Oracle JRF 11g Release (11.1.1.4.0), which
includes oracle_common directory
o Oracle Web Tier 11g Release (11.1.1.4.0), which
includes Oracle_WT directory
o Oracle Management Plug-Ins
Oracle Database Management Plug-In
Oracle Fusion Middleware Management Plug-In
Oracle My Oracle Support Management Plug-In
Oracle Exadata Management Plug-In
Note:
Java Development Kit (JDK) 1.6 v24
and Oracle WebLogic Server 11g
Release 1 (10.3.5) are installed only if
they do not exist in your environment.
If you want to manually install Oracle
WebLogic Server 11g Release 1
(10.3.5), then follow the guidelines
outlined in Before You Begin.
In addition to the mandatory plug-ins
listed above, you can optionally install
other plug-ins available in the
software kit (DVD, downloaded
software). The installer offers a screen
where you can select the optional
plug-ins and install them. However, if
you want to install some plug-ins that
are not available in the software kit
(DVD, downloaded software), then
refer to Advanced Installer Options.
Creates an Oracle WebLogic domain called GCDomain. For this WebLogic
Domain, a default user account, weblogic, is used as the administrative user.
You can choose to change this, if you want, in the installer.
Creates a Node Manager user account called nodemanager. A Node Manager
enables you to start, shut down, or restart an Oracle WebLogic Server
instance remotely, and is recommended for applications with high
availability requirements.
Configures an Oracle Management Service Instance Base location (gc_inst)
in the Oracle Middleware Home (middleware home), for storing all
configuration details related to Oracle Management Service 12 c. You can
choose to change this, if you want, in the installer.
By default, the following are the contents of the middleware home for this type of
installation:
<middleware_home>
|_____wlserver_10.3
|_____jdk16
|_____oms
|_____plugins
|_____oracle.sysman.db.oms.plugin_12.1.0.1.0
|_____oracle.sysman.emas.oms.plugin_12.1.0.1.0
|_____oracle.sysman.mos.oms.plugin_12.1.0.1.0
|_____agent
|_____plugins
|_____oracle.sysman.db.agent.plugin_12.1.0.1.0
|_____oracle.sysman.db.discovery.plugin_12.1.0.1.0
|_____oracle.sysman.emas.agent.plugin_12.1.0.1.0
|_____oracle.sysman.emas.discovery.plugin_12.1.0.1.0
|_____core
|_____12.1.0.1.0
|_____agent_inst
|_____sbin
|_____agentimage.properties
|_____gc_inst
|_____Oracle_WT
|_____oracle_common
|_____utils
|_____logs
|_____modules
|_____user_project
|_____ocm.rsp
|_____registry.dat
|_____domain-registry.xml
|_____registry.xml
You can install Enterprise Manager Cloud Control using the installation
wizard only on a single host, that is, locally on the server where the wizard
is invoked. You cannot install on multiple or remote hosts.
Enterprise Manager Cloud Control can communicate only with Oracle
Management Agent 12c and not with any earlier release of the Management
Agent.
While installing on hosts that have multiple host names (for example, virtual
hosts), you can pass the fully qualified host name using
the ORACLE_HOSTNAME argument. Ensure that the host name you enter does not
have underscores.
For example:
./runInstaller ORACLE_HOSTNAME=host1.foo.com
For example,
<JDK home>/bin/java -d64 -jar <absolute_path _to_wls1035_generic.jar>
For example,
<JDK home>/bin/java -jar <absolute_path _to_wls1035_generic.jar>
You must ensure that the Oracle WebLogic Server 11g Release 1 (10.3.5)
installed by the Enterprise Manager Cloud Control Installation Wizard or by
you is dedicated for Enterprise Manager Cloud Control. You must not have
any other Oracle Fusion Middleware product installed in that middleware
home.
Enterprise Manager Cloud Control cannot coexist with any Oracle Fusion
Middleware product in the same middleware home because
the ORACLE_COMMON property is used by both the products.
Oracle offers bug fixes for a product based on the Oracle Lifetime Support
Policy. When the license period expires for a particular product, the support
for bug fixes offered by Oracle also ends. For more information, see
the Oracle Lifetime Support Policy available at:
http://www.oracle.com/support/library/brochure/lifetime-support-technology.pdf
In addition to the mandatory plug-ins listed above, you can optionally install
other plug-ins available in the software kit (DVD, downloaded software).
The installer offers a screen where you can select the optional plug-ins and
install them. However, if you want to install some plug-ins that are not
available in the software kit (DVD, downloaded software), then refer
to Advanced Installer Options.
You can find the OMS and Management Agent entries in
the /etc/oragchomelist file for all UNIX platforms except HPUNIX, HPia64,
Solaris Sparc.
Prerequisites
Table 6-1 lists the prerequisites you must meet before installing Enterprise
Manager Cloud Control.
Requirement Description
Hardware Ensure that you meet the hard disk space and physical memory
Requirements requirements as described in Chapter 2.
Operating System Ensure that you install Enterprise Manager Cloud Control only on
Requirements certified operating systems as mentioned in the Enterprise
Manager Certification Matrix available on My Oracle Support.
Note: If you use Oracle Solaris 10, then ensure that you have
update 9 or higher installed. To verify whether it is installed, run
Requirement Description
Package Ensure that you install all the operating system-specific packages
Requirements as described in Chapter 3.
Operating System Ensure that you create the required operating system groups and
Groups and Users users as described in Chapter 4.
Requirements
Unique Host Name Ensure that you check the network configuration to verify that the
and Static IP Address host on which you are installing resolves to a unique host name
Requirements and a static IP address that are visible to other hosts in the
network.
For example:
Bash Shell
Requirement Description
$ . ./.bash_profile
C Shell
% source ./.login
File Descriptor Ensure that you set the file descriptor to a minimum of 4096.
Requirements
To verify the current value set to the file descriptors, run the
following command:
Important:
Ensure that the database is patched with all the Patch Set
Updates (PSU) or Critical Patch Updates (CPU) released
for that release. Also ensure that you apply the patches
If you use Oracle Database 11g Release 2 (11.2.0.1), then
ensure that you apply the patches for bugs 10014178 and
Requirement Description
8799099.
If you use Oracle Database 11g Release 1 (11.1.0.7), then
ensure that you apply Patch Set Update 2 and the patches
for bugs 8644757 and 7525072.
Host File Ensure that the host name specified in the /etc/hosts file is unique,
Requirements and ensure that it maps to the correct IP address of that host.
Otherwise, the installation can fail on the product-specific
prerequisite check page.
For example,
141.81.5.71 host1.foo.com host1
For example, all these commands must return the same output:
nslookup host1
nslookup host1.foo.com
nslookup 141.81.5.71
To verify whether the install user has these rights, from the
Start menu, click Settings and then select Control Panel.
From the Control Panel window, select Administrative
Tools, and from the Administrative Tools window,
select Local Security Settings. In the Local Security
Settings window, from the tree structure, expand Local
Policies, and then expand User Rights Assignment.
Permission Ensure that you have write permission in the middleware
Requirements home and the Oracle Management Service Instance Base
location.
Ensure that you have write permission in the temporary
directory where the executables will be copied. For
example, /tmp or c:\Temp.
Ensure that you have write permission in the location
where you want to create the Central Inventory
(oraInventory) if it does not already exist. If the Central
Inventory already exists, then ensure that you
have write permission in the inventory directory.
Ensure that the user who installed the existing Oracle
Database has write permission in the data file locations
where the data files for the new tablespaces will be copied.
Internet Connection Oracle recommends that the host from where you are running the
Requirements installer have a connection to the Internet so that the configuration
information can be automatically collected and uploaded to My
Oracle Support.
Installation Procedure
This section describes the following:
To install Enterprise Manager Cloud Control with simple configuration, follow these
steps:
If the host from where you are running the installation wizard does not
have a connection to the Internet, then enter only the e-mail address and
leave the other fields blank. After you complete the installation, manually
collect the configuration information and upload it to My Oracle Support.
3. Click Next.
4. Install Software Updates
On the Software Updates screen, select one of the following sources from
where the software updates can be installed while the installation of the
Enterprise Manager system is in progress. If you do not want to apply them
now, then select Skip.
Enter the My Oracle Support account user name and password, and
click Search for Updates. Once the search results appear with
patch numbers and their details, click the patch number to view the
ReadMe associated with that patch
Note:
5. Click Next.
If Enterprise Manager Cloud Control is the first Oracle product you are
installing on the host that is running on UNIX operating system, then the
Oracle Inventory screen appears. For details, see step (6). Otherwise, the
Check Prerequisites screen appears. For details, see step (8).
If Enterprise Manager Cloud Control is the first Oracle product you are
installing on the host that is running on Microsoft Windows operating
system, then the Oracle Inventory screen does not appear. On Microsoft
Windows, the following is the default inventory directory:
<system drive>\Program Files\Oracle\Inventory
On the Oracle Inventory screen, do the following. You will see this screen
only if this turns out to be your first ever installation of an Oracle product
on the host.
o Enter the full path to a directory where the inventory files and
directories can be placed.
Note:
The installation wizard runs the prerequisite checks automatically when you
come to this screen. It checks for the required operating system patches,
operating system packages, and so on.
If you prefer to hide the successful checks and view only the ones
with Warning or Failed status, then click Hide Successful Checks.
o Although Oracle recommends you to investigate and correct the
problems, if you are compelled to proceed without resolving them,
then select Ignore to ignore the warnings and failures.
o Click Next.
o Select Installation Type
Note:
If you have Oracle WebLogic Server and
Java Development Kit already installed, then
ensure that they are of the supported
releases—Oracle WebLogic Server 11g
Release 1 (10.3.5) and JDK 1.6 v24+. If you
have the supported releases, the installer
automatically detects them and displays the
absolute path to the middleware home
where they are installed. In this case,
validate the middleware home. If the
location is incorrect, then enter the path to
the correct location. Ensure that the
middleware home you select or enter is a
middleware home that does not have any
Oracle homes for Oracle Management
Service and Oracle Management Agent.
If you do not have Oracle WebLogic Server
11g Release 1 (10.3.5) and JDK 1.6 v24+,
then the installer automatically installs them
for you while installing the Enterprise
Manager system. In this case, enter the
absolute path to a directory where you want
to have them installed. For
example, /oracle/software/. Ensure that the
directory you enter does not contain any
files or subdirectories.
If you manually install Oracle WebLogic
Server 11g Release 1 (10.3.5), then follow
the guidelines outlined in Before You Begin.
b. Click Next.
c. Enter Configuration Details
On the Configuration Details screen, do the following:
Note:
o Enter the fully qualified name of the host where the existing
database resides, the database's listener port and its service name or
system ID (SID), and the SYS user account's password.
The installer uses this information to connect to the existing, certified
Oracle Database for creating the SYSMAN schema. SYSMAN schema
holds most of the relational data used in managing Enterprise
Manager Cloud Control.
Note:
d. Click Next.
Note:
Note:
o Once the software binaries are copied and configured, you are
prompted to run the allroot.sh script, and the oraInstRoot.sh script if
this is the first Oracle product installation on the host. Open another
window, log in as root, and manually run the scripts.
If you are installing on Microsoft Windows operating system, then you will
NOT be prompted to run this script.
o On the Finish screen, you should see information pertaining to the
installation of Enterprise Manager. Review the information and
click Close to exit the installation wizard.
For more information about this installation, refer to the following file in the
OMS home:
$<OMS_HOME>/install/setupinfo.txt
Note:
If the installation fails for some reason, review the log files available in the
following locations of the OMS home:
$oraInventory/logs/installActions<timestamp>.log
$oraInventory/logs/emdbprereqs/LATEST
$<OMS_HOME>/cfgtoollogs/oui/installActions<timestamp>.log
$<OMS_HOME>/cfgtoollogs/cfgfw/CfmLogger_<timestamp>.log
Configuration Assistant-Related Log Files:
Note:
For information about the additional, advanced options
you can pass while invoking the installer, refer
to Advanced Installer Options. To make yourself aware of
some installation-related known issues, see Limitations.
If the host from where you are running the installation wizard does not
have a connection to the Internet, then enter only the e-mail address and
leave the other fields blank. After you complete the installation, manually
collect the configuration information and upload it to My Oracle Support.
3. Click Next.
4. Install Software Updates
On the Software Updates screen, select one of the following sources from
where the software updates can be installed while the installation of the
Enterprise Manager system is in progress. If you do not want to apply them
now, then select Skip.
Enter the location where the updates are available, and click Search
for Updates. To search the computer and select the location,
click Browse. Once the search results appear with patch numbers
and their details, click the patch number to view the ReadMe
associated with that patch.
Enter the My Oracle Support account user name and password, and
click Search for Updates. Once the search results appear with
patch numbers and their details, click the patch number to view the
ReadMe associated with that patch
Note:
5. Click Next.
If Enterprise Manager Cloud Control is the first Oracle product you are
installing on the host that is running on UNIX operating system, then the
Oracle Inventory screen appears. For details, see step (6). Otherwise, the
Check Prerequisites screen appears. For details, see step (8).
If Enterprise Manager Cloud Control is the first Oracle product you are
installing on the host that is running on Microsoft Windows operating
system, then the Oracle Inventory screen does not appear. On Microsoft
Windows, the following is the default inventory directory:
<system drive>\Program Files\Oracle\Inventory
o Enter the full path to a directory where the inventory files and
directories can be placed.
Note:
The installation wizard runs the prerequisite checks automatically when you
come to this screen. It checks for the required operating system patches,
operating system packages, and so on.
If you prefer to hide the successful checks and view only the ones with
Warning or Failed status, then click Hide Successful Checks.
Note:
d. Click Next.
e. Select Installation Type
Note:
Note:
h. Click Next.
i. Enter WebLogic Server Configuration Details
On the WebLogic Server Configuration Details screen, enter the credentials
for the WebLogic Server user account and the Node Manager user account,
and validate the path to the Oracle Management Service instance base
location.
Note:
By default, the WebLogic Domain name is GCDomain, and the Node Manager
name is nodemanager. These are non-editable fields. The installer uses this
information for creating Oracle WebLogic Domain and other associated
components such as the admin server, the managed server, and the node
manager. A Node Manager enables you to start, shut down, or restart an
Oracle WebLogic Server instance remotely, and is recommended for
applications with high availability requirements.
j. Click Next.
k. Enter Database Connection Details
On the Database Connection Details screen, enter the fully qualified name
of the host where your existing, certified Oracle Database resides, its
listener port and its service name or system ID (SID), and the SYS user
account's password.
Note:
l. Click Next.
Note:
o If you are connecting to an Oracle RAC database,
and if you have specified the virtual IP address of
one of its nodes, then the installation wizard
prompts you with a Connection String dialog and
requests you to update the connection string with
information about the other nodes that are part of
the cluster. Update the connection string and
click OK. If you want to test the connection,
click Test Connection.
o If you see an error stating that the connection to
the database failed with ORA-01017 invalid user
name/password, then follow these steps to resolve
the issue:
Note:
Note:
Ensure that your password contains at least 8
characters without any spaces, begins with a letter,
and includes at least one numeric value.
For example, /u01/oracle/prod/oradata/mgmt.dbf
For example, /u01/oracle/prod/oradata/mgmt_ecm_depot1.dbf
For example, /u01/oracle/prod/oradata/mgmt_ad4j.dbf
Note:
b. Click Next.
c. Customize Ports
On the Port Configuration Details screen, customize the ports to be used for
various components.
Note:
You can enter a free custom port that is either within or outside the port
range recommended by Oracle.
Note:
d. Click Next.
e. Review and Install
On the Review screen, review the details you provided for the selected
installation type.
Note:
o Once the software binaries are copied and configured, you are
prompted to run the allroot.sh script, and the oraInstRoot.sh script if
this is the first Oracle product installation on the host. Open another
window, log in as root, and manually run the scripts.
If you are installing on Microsoft Windows operating system, then you will
NOT be prompted to run this script. You will directly reach the Finish screen
as described in Step (25).
For more information about this installation, refer to the following file
available in the OMS home:
$<OMS_HOME>/install/setupinfo.txt
Note:
If the installation fails for some reason, review the log files available in the
following locations of the OMS home:
$oraInventory/logs/installActions<timestamp>.log
$oraInventory/logs/emdbprereqs/LATEST
$<OMS_HOME>/cfgtoollogs/oui/installActions<timestamp>.log
$<OMS_HOME>/cfgtoollogs/cfgfw/CfmLogger_<timestamp>.log
Configuration Assistant-Related Log Files:
The following are some additional, advanced options you can pass while invoking
the installer:
For example, if you want to use the custom name EMDomain, then run the
following command:
./runInstaller WLS_DOMAIN_NAME=EMDomain
If you want to override this location with a custom location, then invoke the
installer with the EM_STAGE_DIR option, and enter a unique custom location.
For example,
./runInstaller EM_STAGE_DIR=/home/john/software/oracle/pafdir
During installation, if you want to install some plug-ins that are not in the
software kit (DVD, downloaded software), then follow these steps:
1. Manually download the plug-ins from the Enterprise Manager
download page on OTN, and store them in an accessible location:
http://www.oracle.com/technetwork/oem/grid-control/downloads/index.html
2. Invoke the installer with the following option, and pass the location
where the plug-ins you want to install are available:
./runInstaller -pluginLocation
<absolute_path_to_plugin_software_location>
This displays a list of plug-ins available in the software kit (DVD,
downloaded software) as well as the plug-ins available in this custom
location. You can choose the ones you want to install.
After the installation ends successfully, the OMS and the Management
Agent start automatically. If you do not want them to start automatically,
then invoke the installer with START_OMS and b_startAgent options, and set
them to TRUE or FALSE depending on what you want to control.
For example:
./runInstaller ORACLE_HOSTNAME=host1.foo.com
Limitations
Table 6-2 lists the different combinations of these advanced options, and describes
the workaround to be followed for each combination:
1. (Only for UNIX Operating Systems) If you did not run the allroot.sh script
when the installer prompted you to do so, then run them manually now:
o If this is the first Oracle product you just installed on the host, then
run the oraInstroot.sh script from the inventory location specified in
the oraInst.loc file that is available in the Management Agent home.
Note:
$<OMS_HOME>/allroot.sh
Note:
o Navigate to the OMS home and run the following command to see a
message that confirms that OMS is up and running.
$<OMS_HOME>/bin/emctl status oms
3. Note:
4. By default, you can access Enterprise Manager Cloud
Control only using the HTTPS protocol. If you want to use
the HTTP protocol, then unlock it by running the following
command from the OMS home:
5. emctl secure unlock -console
For example,
/u01/app/Oracle/Middleware/agent/core/12.1.0.1.0/perl/bin/perl
/u01/app/Oracle/Middleware/agent/core/12.1.0.1.0/bin/AgentPluginDeploy.pl
-oracleHome /u01/app/Oracle/Middleware/agent/core/12.1.0.1.0/ -agentDir
/u01/app/Oracle/Middleware/agent -pluginIdsInfoFile
/u01/app/Oracle/Middleware/agent/core/12.1.0.1.0/sysman/install/plugins.txt
-action configure -emStateDir /u01/app/Oracle/Middleware/agent/agent_inst
c. (Optional) If the repository prerequisites had failed, and if you had manually
run the EM Prerequisite Kit and taken corrective actions to meet the
repository requirements, then run the utility again to reset the repository
settings to what it had originally:
/install/requisites/bin/emprereqkit -executionType install -prerequisiteXMLLoc
<prereq_xml_location> -connectString <connect_string> -dbUser SYS -dbPassword
<db_password> -reposUser sysman -reposPassword <repo_user_password> -dbRole
sysdba -runPrerequisites -runPostCorrectiveActions -useHistory
Note:
However, the other targets running on that host and other hosts do not get
automatically discovered and monitored. To monitor the other targets, you
need to add them to Enterprise Manager Cloud Control either using the
Auto Discovery Results page, the Add Targets Manually page, or the
discovery wizards offered for the targets you want to monitor.
For information about discovering targets in Enterprise Manager Cloud
Control, refer to the chapter on adding targets in the Oracle Enterprise
Manager Cloud Control Administrator's Guide.
Note: