Perform these tasks to install the Oracle Enterprise Manager Agent and deploy the plug-in.
Topics:
Before deploying Oracle Database Appliance plug-in, ensure that you complete the prerequisites.
Complete the following prerequisites:
Create a special user for the Oracle ILOM service processor.
For the Oracle Enterprise Manager agent to communicate with an Oracle Integrated Lights Out Manager (Oracle ILOM) service processor, you must have a specific user ID configured for the Oracle ILOM service processor.
Note:
Adding the specific user ID requires administrator level privilege on the Oracle ILOM service processor.
The specific Oracle ILOM user ID can be added in the Oracle ILOM service processor web interface, Oracle ILOM CLI, or with the ipmitool
command. This example uses the Oracle ILOM CLI.
For security reasons, the root
user password to the Oracle ILOM service processor is not shown in the Oracle ILOM CLI commands in this example.
Log in to the Oracle ILOM Service Processor as root:
# ssh root@[Service Processor IP] Password:
Change to the users
directory:
-> cd /SP/users
Create the oemuser
user and password:
-> create oemuser Creating user... Enter new password: ******** Enter new password again: ******** Created /SP/users/oemuser
Change to the new user's directory and set the role:
-> cd oemuser /SP/users/oemuser -> set role='cro' -> Set 'role' to 'cro'
Test the Oracle ILOM user ID created in step 3 by listing the last 10 system events:
-> ipmitool -I lanplus -H -U oemuser -P welcome1 -L USER sel list last 10
Repeat steps 1 through 5 for the rest of the server node Oracle ILOM service processors in Oracle Database Appliance.
(Optional) Create a special user for monitoring instead of using the root user.
The root user can perform monitoring on Oracle Database Appliance agents. However, if the root user is not accessible for security reasons, an alternative method is to create a monitoring OS user as the monitoring user, and set the privilege delegation appropriately. If you run a virtualized ODA, please perform the following steps from ODA_BASE.
The following is an example that creates an oak/welcome2
user for the purpose of monitoring Oracle Database Appliance.
Run the following commands:
#useradd oak #passwd oak
Add SUDO privilege for user oak
.
Modify the /etc/sudoers
file on the host using the visudo
command.
Add the following commands to the /etc/sudoers
file.
Cmnd_Alias plugin_agent_script=$perl_home/bin/perl $agent_home/plugins/$plugin_opar_version /scripts/*.pl* , \ $agent_home/sbin/nmosudo default_plugin default_functionality default_subaction default_action perl -e exit 0 monitor_user ALL=(ALL) plugin_agent_script
Note that:
$agent_home
is the absolute path to the installed agent home. The agent home directory is created during agent deployments to the hosts. For example, /u01/app/agent_home/
$perl_home
is the absolute path to the installed executable Perl. For example, /u01/app/agent_home/core/12.1.0.5.0/perl/
$
plugin_opar_version
is the complete Oracle Database Appliance Plug-in OPAR file that is deployed to the Oracle Management System (OMS) and the agents. It is in the format:
oracle.dba.odba.agent.plugin_version
version
is the Oracle Database Appliance plug-in version, for example, 13.1.1.1.0.
Set privilege delegation to the host targets.
Log in to Oracle Enterprise Manager.
In the Setup menu select Security, then Privilege Delegation.
Select Edit.
In the Type box, select Sudo.
Enter /usr/bin/sudo -u %RUNAS% %COMMAND%
in the Sudo Command box.
Click Save.
Verify that you have a supported version of Oracle Appliance Manager software installed.
To verify the software version on Oracle Database Appliance, run the command:
# oakcli show version
Validate the Oracle Database Appliance storage topology and external JBOD connectivity before deploying Oracle Database Appliance. You should also validate the connections after changing the cabling.
oakcli validate
command on each node to check the cable connections between the system controllers and the storage shelf, as well as the cable connection to the storage expansion shelf (if one is installed). If you have incorrect or missing cable connections, then the output displays errors. You can also find details for Storage Topology Validation in the /opt/oracle/oak/log/hostname/storagetopology/
log file.Verify that each server node is able to resolve the host names of the Oracle ILOM servers.
If the names of those components are not registered in DNS, then entries can be added to the /etc/hosts
file of each server node.
Use one of two methods to install the Oracle Enterprise Manager Agent for Oracle Database Appliance.
Topics:
Deploy the Oracle Enterprise Manager agent on ODA_BASE for Oracle Database Appliance Virtualized Platform deployments, and in Linux Hosts for Oracle Database Appliance Bare Metal deployments.
Oracle Enterprise Manager target discovery supports the use of either the management network host name or the client network host name for the server nodes. When you install the Oracle Enterprise Manager agent on the server nodes, use the same host name you used in Oracle Clusterware.
You can identify the host name of the nodes in the cluster by running the olsnodes
command on one of the server nodes. It is recommended that a fully qualified host name, including the domain name, be used when specifying an Oracle Enterprise Manager agent host name.
Note:
Before deploying the agent, review the following requirements:
The Oracle Enterprise Manager agent must be deployed to all server nodes of Oracle Database Appliance. The host target name of the server node must be the fully qualified host name, for example, dbm1db01.mydomain.com
.
A non-fully qualified host name (for example, dbm1db01
) or IP address must not be used for the host target name of the server node.
The same version of the Oracle Enterprise Manager agent and the same version of the plug-ins should be deployed on all server nodes within the same Oracle Database Appliance.
Use this procedure to install Oracle Enterprise Manager Agent using the Push method.
To install the Oracle Enterprise Manager agent using the push method, add the Oracle Database Appliance server nodes as host targets to Oracle Enterprise Manager Cloud Control 13c, and then start the agent deployment process.
Note:
If the root.sh
was not executed during deployment, then make sure to execute it on all server nodes.
Use this procedure to install Oracle Enterprise Manager Agent using a response file.
You can install Oracle Management Agent in non-interactive (“silent”) mode, as an alternative to installing Oracle Management Agent by using the Add Host Target wizard. You configure a response file with the information required for the installation, and then run a deployment script to install the management agent using the information supplied in the response file.
See Also:
Installing a Management Agent in Silent Mode in the Oracle Enterprise Manager Cloud Control Advanced Installation and Configuration Guide.Import and deploy the Oracle Enterprise Manager Plug-in for Oracle Database Appliance.
Topics:
*.opar
).EMCLI
on a different system than the system where you created the plug-in archive (*.opar
file).The Oracle Enterprise Manager Plug-in for Oracle Database Appliance is delivered as an Oracle plug-in archive file (*.opar
).
The plug-ins belong to a specific Oracle Enterprise Manager category called Add-on
. If you are using Oracle Enterprise Manager 12c to monitor Oracle Database Appliance, download the latest 13c compatible version of the plug-in and follow the instructions to invoke the Enterprise Manager Cloud Control Installer in GUI Mode before starting the Enterprise Manager 13c upgrade process.
The Enterprise Manager for Oracle Database Appliance plug-in archive file (*.opar
) is named oda_plugin_version_number
_oracle.dba.odba_2000_0.opar
. The oda_plug_in_version number
is the Oracle Database Appliance plug-in version, the plug-in version is not the same as the Oracle Database Appliance version. The latest Oracle Database Appliance plug-in version for Enterprise Manager 13.1 is named 13.1.1.1.0_oracle.dba.odba_2000_0.opar
.
Assuming you plan to use an existing Oracle Enterprise Manager installation, and that you have installed an Oracle Enterprise Manager agent, you are ready to deploy the Oracle Database Appliance plug-in.
Note:
Before deploying the plug-in, you must have already completed the Oracle Database Appliance deployment, and the Oracle Grid Infrastructure cluster should be up and running.The following is a high-level overview of the steps to deploy the plug-in:
Download the Enterprise Manager for Oracle Database Appliance plug-in archive file from http://www.oracle.com/technetwork/oem/enterprise-manager/downloads/oem-plugins-2882950.html.
Either import the Oracle Database Appliance plug-in archive locally, or import the Oracle Database Appliance plug-in archive file remotely.
Deploy the Oracle Database Appliance plug-in on Oracle Enterprise Manager Cloud Control (Oracle Management System Servers).
Deploy the Oracle Database Appliance plug-in to the management agents on both Oracle Database Appliance server nodes (hosts).
Use this procedure to import the Oracle Database Appliance plug-in archive file locally.
Use this procedure if you are running EMCLI
on a different system than the system where you created the plug-in archive (*.opar
file).
Run the following command to import the plug-in archive file (OPAR) remotely:
emcli import_update -file="path to the .opar file" -host="host name of plug-in host" -credential_name="credential for plug-in host" -credential_owner="credential owner on the plug-in host"
-path to the .opar file
is the absolute path to the *.opar
file on the system where you created the archive.
-host name of plug-in host
is the host name for the host target where the file is available.
-credential for plug-in host
is the name of the credentials on the remote system you are connecting to.
-credential owner on the plug-in host
is the owner of the credentials on the host system you are connecting to.
Example 2-1 Example of How to Import the OPAR File Remotely
emcli import_update -file=/tmp/sample_plugin.opar -host="host1.acme.com" -credential_name="myOracleCred" -credential_owner="myPassword"
Use this task to deploy Oracle Database Appliance Plug-in on Oracle Enterprise Manager Cloud Control (Oracle Management System Servers).
To deploy the Oracle Database Appliance plug-in on Oracle Management System (OMS) servers:
Use this task to deploy Oracle Database Appliance Plug-in to the management agents on both Oracle Database Appliance server nodes (hosts).
To deploy plug-ins on Management Agents, you must select only plug-ins that are deployed on the management server.
The following is an overview of the tasks that you need to perform to begin monitoring Oracle Database Appliance systems.
Install the Oracle Enterprise Manager Agent
Deploy the plug-in
Discover Oracle Database Appliance systems to add the targets for monitoring
(Optional) Configure the monitoring metrics and notifications
After Oracle Enterprise Manager Cloud Control discovers the targets, the software begins monitoring the supported hardware and software components.