Search this Blog

Tuesday, January 11, 2011

Installing Oracle Agent11g

In this thread the installation of Oracle's Management Agent 11g for Grid Control 11g is explained.

The agent installation is not a manual install anymore. Oracle has decided to only provide in silent installs.
The available options are:

- Push install from the OMS server ( requires ssh to be configured on the client )
- Pull install from the client ( requires wget to be installed )
- Silent install from an Agent download.

Unfortunately the first two options are not suitable for AIX servers. With a push install from the OMS server, the push installer tries to start a ssh-session on the server to be installed, using the ssh binary in a Linux style path ( /usr/local/bin/ssh ).

The second installation type is also unfortunately more Linux minded. Wget, the Linux source download tool, is by default not available on AIX.

The last method is the easiest, because no extra software ( ssh, wget) needs to be installed or configured.
You can download the Agent11g installer from:


After downloading, FTP the agent 11g install file to the client to be installed.
Unzip it into a temporary directory.


Create an Installation response file, with the contents like below. A sample configuration file can be found in /aix/response.
The to be changed values are marked in bold-white.

####################################################################
## copyright (c) 1999, 2010 Oracle. All rights reserved. ##
## ##
## Specify values for the variables listed below to customize ##
## your installation. ##
## ##
## Each variable is associated with a comment. The comment ##
## identifies the variable type. ##
## ##
## Please specify the values in the following format: ##
## ##
## Type Example ##
## String "Sample Value" ##
## Boolean True or False ##
## Number 1000 ##
## StringList {"String value 1","String Value 2"} ##
## ##
## The values that are given as need to be ##
## specified for a silent installation to be successful. ##
## ##
## ##
## This response file is generated by Oracle Software ##
## Packager. ##
###################################################################

RESPONSEFILE_VERSION=2.2.1.0.0

#################################################################################
#Inputs for Oracle Configuration Manager
#################################################################################
#-------------------------------------------------------------------------------
#SECURITY_UPDATES_VIA_MYORACLESUPPORT: Whether security updates are reqi-
# uired via My Oracle Support
#DECLINE_SECURITY_UPDATES: Whether security updates should be declined.
#MYORACLESUPPORT_USERNAME & MYORACLESUPPORT_PASSWORD: User name and passw-
# ord for My Oracle Support access, these will be effected only when SECU-
# RITY_UPDATES_VIA_MYORACLESUPPORT=true
#COLLECTOR_SUPPORTHUB_URL: If there is not direct connection and Support
# hub is deployed. Need to specify that URL.
#-------------------------------------------------------------------------------
SECURITY_UPDATES_VIA_MYORACLESUPPORT=False
DECLINE_SECURITY_UPDATES=True

################################################################################
#PARAMETERS FOR SOFTWARE UPDATES
################################################################################
#-------------------------------------------------------------------------------
#INSTALL_UPDATES_SELECTION:
# Option 1. If you want to skip the software updates, provide
# INSTALL_UPDATES_SELECTION="skip"
# Option 2. If you have already downloaded the updates then provide
# INSTALL_UPDATES_SELECTION="staged"
# If you choose the Option 2 then make sure you also provide STAGE_LOCATION.
#STAGE_LOCATION: Stage location for software updates. It will be effected
# only when INSTALL_UPDATES_SELECTION is set to "staged"
#-------------------------------------------------------------------------------
INSTALL_UPDATES_SELECTION="skip"
STAGE_LOCATION=

################################################################################
#PROXY DETAILS FOR SECURITY UPDATES/ SOFTWARE UPDATES
################################################################################
#-------------------------------------------------------------------------------
#PROXY_USER: User name for proxy access.
#PROXY_PWD: Password for proxy access.
#PROXY_HOST: Server providing proxy access.
#PROXY_PORT: Port for proxy access.
#------------------------------------------------------------------------------
PROXY_USER=
PROXY_PWD=
PROXY_HOST=
PROXY_PORT=

################################################################################
#Various inputs required for Installation and Configuration
################################################################################
#-------------------------------------------------------------------------------
#ORACLE_AGENT_HOME_LOCATION: The location of oracle agent home.
#Agent home "agent11g" would be created under the directory specified by
#ORACLE_AGENT_HOME_LOCATION.
#-------------------------------------------------------------------------------
ORACLE_AGENT_HOME_LOCATION=/opt/wcst01/ora/

#-------------------------------------------------------------------------------
#DEINSTALL_LIST: List of components to be deinstalled during a
# deinstall session.The following choices are available. The value should
# contain only one of these choices.The choices are of the form
# Internal Name, Version : External name. Please use the internal name and
# version while specifying the value.
# oracle.sysman.top.agent, 10.2.0.0.0 : Oracle Management Agent 10.2.0.0.0
# oracle.sysman.top.em_seed, 10.2.0.0.0 : Oracle Enterprise Manager Repository Database 10.2.0.0.0
# oracle.sysman.top.oms, 10.2.0.0.0 : Oracle Enterprise Manager Grid Console 10.2.0.0.0
#-------------------------------------------------------------------------------
DEINSTALL_LIST={"oracle.sysman.top.agent","11.1.0.1.0"}

#-------------------------------------------------------------------------------
#b_silentInstall: The user should not change this value
#CLUSTER_NODES: This variable represents the cluster node names
# selected by the user for installation.
#-------------------------------------------------------------------------------
b_silentInstall=true
CLUSTER_NODES=vtl1h121ps,vtl1h123ps

#-------------------------------------------------------------------------------
#TOPLEVEL_COMPONENT: The top level component to be installed in the
# current session.Value should contain only one of the following available
# choices.The choices are of the form Internal Name, Version : External name.
# Please use the internal name and version while specifying the value.
# oracle.sysman.top.agent, 10.3.0.0.0 : Oracle Management Agent 10.3.0.0.0
# Example: TOPLEVEL_COMPONENT = {"oracle.sysman.top.agent","10.3.0.0.0"}
#-------------------------------------------------------------------------------
TOPLEVEL_COMPONENT={"oracle.sysman.top.agent","11.1.0.1.0"}

#-------------------------------------------------------------------------------
#SELECTED_LANGUAGES: Languages in which the components will be installed.
# The following choices are available. The value should contain only one of
# these choices.The choices are of the form Internal Name : External name.
# Please use the internal name while specifying the value.
# en, : English
# de, : German
# es, : Latin American Spanish
# es_MX, : Mexican Spanish
# es_ES, : Spanish
# fr, : French
# fr_CA, : Canadian French
# it, : Italian
# iw, : Hebrew
# ja, : Japanese
# ko, : Korean
# pt_BR, : Brazilian Portuguese
# zh_CN, : Simplified Chinese
# zh_TW, : Traditional Chinese
#Example: SELECTED_LANGUAGES = {"en"}
#-------------------------------------------------------------------------------
SELECTED_LANGUAGES={"en"}

#-------------------------------------------------------------------------------
#COMPONENT_LANGUAGES: Languages in which the components will be installed.
# The following choices are available. The value should contain only one of
# these choices.The choices are of the form Internal Name : External name.
# Please use the internal name while specifying the value.
# en, : English
# de, : German
# es, : Latin American Spanish
# es_MX, : Mexican Spanish
# es_ES, : Spanish
# fr, : French
# fr_CA, : Canadian French
# it, : Italian
# iw, : Hebrew
# ja, : Japanese
# ko, : Korean
# pt_BR, : Brazilian Portuguese
# zh_CN, : Simplified Chinese
# zh_TW, : Traditional Chinese
#Example: COMPONENT_LANGUAGES = {"en"}
#-------------------------------------------------------------------------------
COMPONENT_LANGUAGES={"en"}

#-------------------------------------------------------------------------------
#OMS_HOST: OMS host info required to connect to OMS
#OMS_PORT: OMS port info required to connect to OMS
#AGENT_REGISTRATION_PASSWORD: Agent Registration Password needed to
# establish a secure connection to the OMS.
#-------------------------------------------------------------------------------
OMS_HOST=[Your FQN OMS server]
OMS_PORT=1159
#OMS_PORT=4889
AGENT_REGISTRATION_PASSWORD=[Agent registration password entered during OMS installation]

#-------------------------------------------------------------------------------
#s_agentSrvcName: Sets the agent Service Name and this variable can be
# used to overrite the agent service name calculated by the install. This is
# required for only Windows.
# Example:
# s_agentSrvcName = "Oracleagent11gAgent" ; default value
# s_agentSrvcName = "GridAgent" ; User specified value
#-------------------------------------------------------------------------------
#s_agentSrvcName=""

####################################################################################
#Please Don't change the values of these variables
####################################################################################
#-------------------------------------------------------------------------------
#FROM_LOCATION: Complete path to the products.xml.
#b_upgrade: "whether it is Upgrade or not"
#EM_INSTALL_TYPE: install type
#-------------------------------------------------------------------------------
FROM_LOCATION="[Absolute path to products.xml]"
b_upgrade=false
EM_INSTALL_TYPE="AGENT"


Note that the above response file is from an installation where the to be installed server was a two-node RAC. When provided with the cluster names, the installer is able to install all nodes in one time.
When installing a RAC cluster, these options are mandatory. When not, comment out the option "CLUSTER_NODES"

Also note that in the above example there are two entries for OMS_PORT. One is commented out. Use port 1159 for SSL communication between the agent and the OMS server. The agent is in that case automatically secured. Use port 4889 for non-SSL communication.
The to be used ports here are the defaults. During the OMS installation, the port list of the OMS server is shown. Make sure you use the ports that match your OMS server.

The last entry that needs some attention is the one at the bottom of the file. However in the example a relative path has been given, the installer needs an absolute path instead.



When ready, start the installer using the command:

cp aix/response/additionalAgent.rsp aix/agent
cd aix/agent
./runInstaller [-CLUSTER_NAME=] -silent -responseFile -noconfig


The is the name of the RAC-cluster.
This name can be obtained by looking into an OCR-dump file and look for the entry:

[SYSTEM.css.clustername]
ORATEXT :

How to generate an OCR dump file can be found here .

When the installation finishes, run the given 'root.sh' script.


After that the agents need to be configured on each host ( in a cluster installation do this host by host )
Go to the AGENT_HOME/bin directory and execute:

./agentca -f -n -c -i /etc/oraInst.loc

When installing a non-RAC system, the -n and -c options can be left out.

This finishes the installation of the Oracle Agent 11g on AIX.
It might be necessary to 'upload' the first configuration manually, before the agent will appear in the OMS console. Use the following command to do so:

./emctl upload agent ( for a RAC do this on each node )





1 comment:

  1. Thank you for posting this. After many fails at attempting to install anything (grid, agent) with Oracle's own documentation, I appreciate the simplicity of your procedure as it works just fine!

    Many thanks!

    /Phil
    Québec, Canada

    ReplyDelete