How to Install Enterprise Manager 10g (Grid Control) - 10.2.0.4 - on Linux
Posted at Tuesday, April 15, 2008
In the following example, I install Enterprise Manager (Grid Control)- 10.2.0.4 - against an existing 10.2.0.3 RAC database on Linux x86.
In order to accomplish this, the base version of Enterprise Manager needs to be installed - 10.2.0.1 - and then patched as appropriate.
Needless to say, Grid Control is not extremely stable and has many bugs. Accordingly, the installation is a little more detailed and prone to error. Be sure that you pay careful attention to prerequisites, etc. for your environment (reference documents listed below). I won't go into all the O/S requirements here - it is assumed that things like semaphores and file descriptor limits, etc. have been attended to already.
Download the base release and patchset Enterprise Manager Software
Install the base version - 10.2.0.1 - of Enterprise Manager
Perform prerequisite checks via Universal Installer (as oracle)
Prepare the Database for the install
FGA must be installed:
DBMS_SHARED_POOL must be installed:
Prepare the environment for Installation
Update /etc/oratab:
Set the environment:
Preform the Installation
Choose 'Using an Existing Database' option
Specify Parent Location
Verify the prerequisite checks. The failures for compat* libraries can be ignored on Linux
Specify Database Connection information, including file locations for Enterprise Manager's tablespaces
In response, unset dispatchers parameter and click 'Retry':
In response, set session_cached_cursors and aq_tm_processes parameters upward and click 'OK':
Cycle the database for the changes to take effect:
In response, set sga_target and sga_max_size parameters upward and click 'OK':
Once again, cycle the database for the changes to take effect:
Specify Optional Configuration Information
Provide Security Passwords
Review the Summary Screen, click 'Install'
When prompted run the allroot.sh
Then Click 'OK'
Upon successful completion, test Grid Control to ensure that it is working
Configure Enterprise Management Tablespaces per your requirements:
Patch the Enterprise Manager installation to 10.2.0.4 (Patch #3731593)
Stop Services in Preparation for Patching:
Patch the Repository and Management Service to 10.2.0.4:
Specify Software Home to Patch
Note the Provisioning Archive Message
Set up the Software Library
Navigate to the Software Library Configuration Page and specify a valid directory
Afterwords, run the following command:
Secure the OMS
Upgrade the Management Agent on the OMS Node
Run the installer, just as you did for patching the OMS:
You will see screens similar to that of the last install; simply follow the prompts as you did before.
Secure the agent:
Reconfigure the agent:
Remember to configure any applicable targets so that you can monitor the target via Grid Control. You will first have to unlock the dbsnmp user for databases (if not done already).
At this point your Grid Control Installation is ready for use.
Optionally, Setup Mass Deployment Agent
Download the Mass Deployment Agent Software from Oracle
Stage the Agent Software on the Management Service
Edit the agentDownload script, specifying the appropriate values for the following variables
Test Installing the Agent via the Mass Deployment Agent
Start and Test the Agent
References:
Oracle® Enterprise Manager Grid Control Installation and Basic Configuration 10g Release 4 (10.2.0.4)
10.2.0.4 Enterprise Manager README
Oracle Enterprise Manager Grid Control Release Notes for Linux and Microsoft Windows 10g Release 4 (10.2.0.4.0) - Metalink Note 457442.1
Oracle Management Agent Download Installation README
In order to accomplish this, the base version of Enterprise Manager needs to be installed - 10.2.0.1 - and then patched as appropriate.
Needless to say, Grid Control is not extremely stable and has many bugs. Accordingly, the installation is a little more detailed and prone to error. Be sure that you pay careful attention to prerequisites, etc. for your environment (reference documents listed below). I won't go into all the O/S requirements here - it is assumed that things like semaphores and file descriptor limits, etc. have been attended to already.
Download the base release and patchset Enterprise Manager Software
Install the base version - 10.2.0.1 - of Enterprise Manager
Perform prerequisite checks via Universal Installer (as oracle)
# /u02/oracle/software/oms/install/runInstaller -prereqchecker PREREQ_CONFIG_LOCATION=/u02/oracle/software/oms/rdbms/Disk1/stage/prereq -entryPoint oracle.sysman.top.oms_Core -prereqLogLoc /home/oracle -silent
# /u02/oracle/software/oms/install/runInstaller -prereqchecker PREREQ_CONFIG_LOCATION=/u02/oracle/software/oms/rdbms/Disk1/stage/prereq -entryPoint oracle.sysman.top.em_seed_Core -prereqLogLoc /home/oracle -silent
Prepare the Database for the install
FGA must be installed:
SQL> select value from v$option where parameter = 'Fine-grained access control';
VALUE
----------------------------------------------------------------
TRUE
DBMS_SHARED_POOL must be installed:
SQL> select count(*) from DBA_OBJECTS where object_name='DBMS_SHARED_POOL'
2 ;
COUNT(*)
----------
0
SQL> @$ORACLE_HOME/rdbms/admin/dbmspool.sql
Package created.
Grant succeeded.
View created.
Package body created.
SQL> @$ORACLE_HOME/rdbms/admin/utlrp.sql
SQL> select count(*) from DBA_OBJECTS where object_name='DBMS_SHARED_POOL'
2 ;
COUNT(*)
----------
2
Prepare the environment for Installation
Update /etc/oratab:
# echo oms10g:$ORACLE_BASE/product/oms10g:N >> /etc/oratab
# echo agent10g:$ORACLE_BASE/product/agent10g:N >> /etc/oratab
Set the environment:
# export ORACLE_SID=oms10g
# . oraenv
# export DISPLAY=192.168.1.2:0.0
# export TMP=/tmp
# export TEMP=/tmp
Preform the Installation
# ./runInstaller
Choose 'Using an Existing Database' option
Specify Parent Location
Verify the prerequisite checks. The failures for compat* libraries can be ignored on Linux
Specify Database Connection information, including file locations for Enterprise Manager's tablespaces
In response, unset dispatchers parameter and click 'Retry':
SQL> alter system set dispatchers='' scope=both sid='*';
System altered.
In response, set session_cached_cursors and aq_tm_processes parameters upward and click 'OK':
SQL> alter system set session_cached_cursors=200 scope=spfile sid='*';
System altered.
SQL> alter system set aq_tm_processes=4 scope=spfile sid='*';
System altered.
Cycle the database for the changes to take effect:
# srvctl stop database -d em
# srvctl start database -d em
In response, set sga_target and sga_max_size parameters upward and click 'OK':
SQL> alter system set sga_target=256M scope=spfile sid='*';
System altered.
SQL> alter system set sga_max_size=256M scope=spfile sid='*';
System altered.
Once again, cycle the database for the changes to take effect:
# srvctl stop database -d em
# srvctl start database -d em
Specify Optional Configuration Information
Provide Security Passwords
Review the Summary Screen, click 'Install'
When prompted run the allroot.sh
# cd /u01/app/oracle/product/oms10g
# ./allroot.sh
Then Click 'OK'
Upon successful completion, test Grid Control to ensure that it is working
Configure Enterprise Management Tablespaces per your requirements:
SQL> alter tablespace MGMT_TABLESPACE read only;
Tablespace altered.
SQL> alter tablespace MGMT_TABLESPACE offline;
Tablespace altered.
SQL> ! mv /u02/oracle/ora1/em/mgmt.dbf /u02/oracle/ora2/em/mgmt.dbf
SQL> alter database rename file '/u02/oracle/ora1/em/mgmt.dbf' to '/u02/oracle/ora2/em/mgmt.dbf';
Database altered.
SQL> alter tablespace MGMT_TABLESPACE online;
Tablespace altered.
SQL> alter tablespace MGMT_TABLESPACE read write;
Tablespace altered.
SQL> alter database datafile '/u02/oracle/ora2/em/mgmt.dbf' resize 10G;
Database altered.
SQL> alter database datafile '/u02/oracle/ora2/em/mgmt.dbf' autoextend off;
Database altered.
Patch the Enterprise Manager installation to 10.2.0.4 (Patch #3731593)
Stop Services in Preparation for Patching:
# export ORACLE_SID=oms10g
# . oraenv
# $ORACLE_HOME/bin/emctl stop oms
Oracle Enterprise Manager 10g Release 10.2.0.1.0
Copyright (c) 1996, 2005 Oracle Corporation. All rights reserved.
Oracle Management Server is Down.
# $ORACLE_HOME/bin/emctl stop iasconsole
Oracle Enterprise Manager 10g Release 10.2.0.1.0
Copyright (c) 1996, 2005 Oracle Corporation. All rights reserved.
Stopping Oracle 10g Application Server Control ... ... Stopped.
# $ORACLE_HOME/opmn/bin/opmnctl stopall
opmnctl: stopping opmn and all managed processes...
# export AGENT_HOME=$ORACLE_BASE/product/agent10g
# $AGENT_HOME/bin/emctl stop agent
Oracle Enterprise Manager 10g Release 10.2.0.1.0.
Copyright (c) 1996, 2005 Oracle Corporation. All rights reserved.
Stopping agent ... stopped.
Patch the Repository and Management Service to 10.2.0.4:
# export DISPLAY=192.168.1.2:0.0
# /u02/oracle/software/3731593/Disk1/runInstaller &
Specify Software Home to Patch
Note the Provisioning Archive Message
Set up the Software Library
Navigate to the Software Library Configuration Page and specify a valid directory
Afterwords, run the following command:
# export ORACLE_SID=oms10g
# . oraenv
# /u01/app/oracle/product/oms10g/bin/PARDeploy -action deploy -parDir /u01/app/oracle/product/oms10g/sysman/prov/paf -force
Secure the OMS
# export ORACLE_SID=oms10g
# . oraenv
# emctl status emkey
Oracle Enterprise Manager 10g Release 4 Grid Control
Copyright (c) 1996, 2007 Oracle Corporation. All rights reserved.
Please enter repository password:
The Em Key is configured properly, but is not secure. Secure the Em Key by running "emctl config emkey -remove_from_repos".
# emctl config emkey -remove_from_repos
Oracle Enterprise Manager 10g Release 4 Grid Control
Copyright (c) 1996, 2007 Oracle Corporation. All rights reserved.
Please enter repository password:
The Em Key has been removed from the Management Repository.
Make a backup copy of OH/sysman/config/emkey.ora file and store it on another machine.
WARNING: Encrypted data in Enterprise Manager will become unusable if the emkey.ora file is lost or corrupted.
# emctl status emkey
Oracle Enterprise Manager 10g Release 4 Grid Control
Copyright (c) 1996, 2007 Oracle Corporation. All rights reserved.
Please enter repository password:
The Em Key is configured properly.
Upgrade the Management Agent on the OMS Node
# export ORACLE_SID=agent10g
# . oraenv
# which emctl
/u01/app/oracle/product/agent10g/bin/emctl
# emctl stop agent
Oracle Enterprise Manager 10g Release 10.2.0.1.0.
Copyright (c) 1996, 2005 Oracle Corporation. All rights reserved.
Agent is Not Running
Run the installer, just as you did for patching the OMS:
# export DISPLAY=192.168.1.2:0.0
# /u02/oracle/software/3731593/Disk1/runInstaller &
You will see screens similar to that of the last install; simply follow the prompts as you did before.
Secure the agent:
# emctl secure agent
Oracle Enterprise Manager 10g Release 4 Grid Control 10.2.0.4.0.
Copyright (c) 1996, 2007 Oracle Corporation. All rights reserved.
Enter Agent Registration password :
Agent successfully stopped... Done.
Securing agent... Started.
Requesting an HTTPS Upload URL from the OMS... Done.
Requesting an Oracle Wallet and Agent Key from the OMS... Done.
Check if HTTPS Upload URL is accessible from the agent... Done.
Configuring Agent for HTTPS in CENTRAL_AGENT mode... Done.
EMD_URL set in /u01/app/oracle/product/agent10g/sysman/config/emd.properties
publicKeyFile = /u01/app/oracle/product/agent10g/sysman/config/nmosudo.props
Generating RSA keys.
Saving private key in wallet.
SaveKeyWallet: Cannot open wallet (error=28759): file:/u01/app/oracle/product/agent10g/sysman/config
SaveKeyWallet: Re-creating wallet.
Reading private key from wallet.
Saving public key into file.
Reading public key from file.
Encrypting clear-text: gensudoprops pass.
Decrypting encrypted-text.
Decrypted Text: gensudoprops pass
Securing agent... Successful.
Agent successfully restarted... Done.
Reconfigure the agent:
# agentca -f
Stopping the agent using /u01/app/oracle/product/agent10g/bin/emctl stop agent
Oracle Enterprise Manager 10g Release 4 Grid Control 10.2.0.4.0.
Copyright (c) 1996, 2007 Oracle Corporation. All rights reserved.
Stopping agent ... stopped.
Running agentca using /u01/app/oracle/product/agent10g/oui/bin/runConfig.sh ORACLE_HOME=/u01/app/oracle/product/agent10g ACTION=Configure MODE=Perform RESPONSE_FILE=/u01/app/oracle/product/agent10g/response_file RERUN=TRUE INV_PTR_LOC=/etc/oraInst.loc COMPONENT_XML={oracle.sysman.top.agent.10_2_0_1_0.xml}
Perform - mode is starting for action: Configure
Perform - mode finished for action: Configure
You can see the log file: /u01/app/oracle/product/agent10g/cfgtoollogs/oui/configActions2008-04-17_06-54-10-PM.log
# emctl upload agent
Oracle Enterprise Manager 10g Release 4 Grid Control 10.2.0.4.0.
Copyright (c) 1996, 2007 Oracle Corporation. All rights reserved.
---------------------------------------------------------------
EMD upload completed successfully
# emctl status agent
Oracle Enterprise Manager 10g Release 4 Grid Control 10.2.0.4.0.
Copyright (c) 1996, 2007 Oracle Corporation. All rights reserved.
---------------------------------------------------------------
Agent Version : 10.2.0.4.0
OMS Version : 10.2.0.4.0
Protocol Version : 10.2.0.4.0
Agent Home : /u01/app/oracle/product/agent10g
Agent binaries : /u01/app/oracle/product/agent10g
Agent Process ID : 12778
Parent Process ID : 12736
Agent URL : https://rac2.colestock.test:3872/emd/main/
Repository URL : https://rac2.colestock.test:1159/em/upload
Started at : 2008-04-17 18:59:20
Started by user : oracle
Last Reload : 2008-04-17 19:01:24
Last successful upload : 2008-04-17 19:01:45
Total Megabytes of XML files uploaded so far : 10.19
Number of XML files pending upload : 0
Size of XML files pending upload(MB) : 0.00
Available disk space on upload filesystem : 74.73%
Last successful heartbeat to OMS : 2008-04-17 19:01:27
---------------------------------------------------------------
Agent is Running and Ready
Remember to configure any applicable targets so that you can monitor the target via Grid Control. You will first have to unlock the dbsnmp user for databases (if not done already).
SQL> alter user dbsnmp account unlock;
User altered.
SQL> alter user dbsnmp identified by "password";
User altered.
At this point your Grid Control Installation is ready for use.
Optionally, Setup Mass Deployment Agent
Download the Mass Deployment Agent Software from Oracle
Stage the Agent Software on the Management Service
# export ORACLE_SID=oms10g
# . oraenv
# echo $ORACLE_HOME
/u01/app/oracle/product/oms10g
# mkdir -p $ORACLE_HOME/sysman/agent_download/10.2.0.4.0
# unzip /u02/oracle/software/Linux_Grid_Control_agent_download_10_2_0_4_0.zip -d /u01/app/oracle/product/oms10g/sysman/agent_download/10.2.0.4.0
Edit the agentDownload script, specifying the appropriate values for the following variables
vi /u01/app/oracle/product/oms10g/sysman/agent_download/10.2.0.4.0/linux/agentDownload.linux
# Variables instantiated during the OMS install
# Machine hosting the OMS
OMShost=rac2.colestock.test
# Default HTTP port for EM console
httpPort=4889
Test Installing the Agent via the Mass Deployment Agent
# echo agent10g:$ORACLE_BASE/product/agent10g:N >> /etc/oratab
# export ORACLE_SID=agent10g
# . oraenv
# export AGENT_INSTALL_PASSWORD=password
# scp -p rac2.colestock.test:/u01/app/oracle/product/oms10g/sysman/agent_download/10.2.0.4.0/linux/agentDownload.linux .
The authenticity of host 'rac2.colestock.test (192.168.1.102)' can't be established.
RSA key fingerprint is 1e:7c:5c:fa:da:29:f0:62:cd:30:0a:57:67:85:f1:77.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'rac2.colestock.test' (RSA) to the list of known hosts.
oracle@rac2.colestock.test's password:
agentDownload.linux 100% 28KB 27.9KB/s 00:00
# chmod u+x agentDownload.linux
./agentDownload.linux -b $ORACLE_BASE/product -dt
su - root
Password:
[root@rac1 ~]# /u01/app/oracle/product/agent10g/root.sh
Start and Test the Agent
[oracle@rac1 tmp]$ emctl start agent
Oracle Enterprise Manager 10g Release 4 Grid Control 10.2.0.4.0.
Copyright (c) 1996, 2007 Oracle Corporation. All rights reserved.
Starting agent ...... started.
# emctl upload agent
Oracle Enterprise Manager 10g Release 4 Grid Control 10.2.0.4.0.
Copyright (c) 1996, 2007 Oracle Corporation. All rights reserved.
---------------------------------------------------------------
EMD upload completed successfully
# emctl status agent
Oracle Enterprise Manager 10g Release 4 Grid Control 10.2.0.4.0.
Copyright (c) 1996, 2007 Oracle Corporation. All rights reserved.
---------------------------------------------------------------
Agent Version : 10.2.0.4.0
OMS Version : 10.2.0.4.0
Protocol Version : 10.2.0.4.0
Agent Home : /u01/app/oracle/product/agent10g
Agent binaries : /u01/app/oracle/product/agent10g
Agent Process ID : 15529
Parent Process ID : 15478
Agent URL : https://rac1.colestock.test:3872/emd/main/
Repository URL : https://rac2.colestock.test:1159/em/upload
Started at : 2008-04-17 19:58:33
Started by user : oracle
Last Reload : 2008-04-17 19:58:33
Last successful upload : 2008-04-17 19:58:55
Total Megabytes of XML files uploaded so far : 0.67
Number of XML files pending upload : 3
Size of XML files pending upload(MB) : 2.02
Available disk space on upload filesystem : 87.75%
Last successful heartbeat to OMS : 2008-04-17 19:58:37
---------------------------------------------------------------
Agent is Running and Ready
References:
Oracle® Enterprise Manager Grid Control Installation and Basic Configuration 10g Release 4 (10.2.0.4)
10.2.0.4 Enterprise Manager README
Oracle Enterprise Manager Grid Control Release Notes for Linux and Microsoft Windows 10g Release 4 (10.2.0.4.0) - Metalink Note 457442.1
Oracle Management Agent Download Installation README
Labels: Grid Control
_507.png)
Subscribe
