Professional Documents
Culture Documents
Oracle Configuration Manager For Oracle Exadata Database Machine
Oracle Configuration Manager For Oracle Exadata Database Machine
February, 2012
Introduction........................................................................................ 2
Terminology....................................................................................... 2
Benefits of Deploying OCM for Exadata ............................................ 2
Before you start ................................................................................. 2
Pre-requisites .................................................................................... 3
Compute node SerialNumbers file permissions ............................. 3
Options available for configuring Oracle Configuration Manager collections for an
Oracle Exadata Database Machine ................................................... 4
Configure OCM collections for Exadata using the Enterprise Manager Cloud
Control 12c Harvester ........................................................................ 6
Step 1 - Configure OCM in each OMS Oracle Home ..................... 6
Step 2 - Assign CSIs to the Exadata targets. ................................. 7
Configure OCM collections for Exadata using the Mass Deployment utility to
deploy standalone OCM collectors to each Oracle Home on each compute node
........................................................................................................ 10
Step 1 - Download and Install the Mass Deployment utility .......... 10
Step 2 - Mass Deployment Input File Creation ............................. 11
Step 3 - Determine the current state of OCM in each compute node Oracle
home ........................................................................................... 14
Step 4 - Deploying/Configuring OCM ........................................... 15
Step 5 - Determine the state of OCM in each compute node Oracle home after
deployment .................................................................................. 18
Manually install OCM version 10.3.6 or above into each Oracle Home on each
compute node.................................................................................. 20
Configuring OCM in disconnected mode ..................................... 20
Problems you may experience......................................................... 21
Appendices...................................................................................... 22
Appendix A – Exadata Configuration Worksheets........................ 22
Appendix B - Configuration Table Entries for OCM ...................... 24
Appendix C - Secure Password Entry .......................................... 26
Appendix D - Testing the link to Oracle........................................ 27
Oracle Configuration Manager
for Oracle Exadata Database Machine
Introduction
This document is intended to assist in deploying and configuring Oracle Configuration
Manager (OCM) collections for an Oracle Exadata Database Machine (updates to this
document will be made available via the Oracle Support Portal).
Terminology
Throughout this document the terms ‘Compute node’ and ‘Database Server’ are used
interchangeably to refer to the Oracle Exadata Database Machine Database Servers. The
terms are synonymous.
Enable Oracle's Proactive Health Check capabilities. Health Check rules are run
against your Oracle Exadata Database Machine collections and any known issues found
are shown to you in the Health Recommendations area within My Oracle Support. Note
868955.1 My Oracle Support Health Check Catalog lists the current set of Health Checks
for Oracle Exadata Database Machines. Health Checks are being added continually to
improve the benefits of this service.
2
Oracle Configuration Manager
for Oracle Exadata Database Machine
2. Oracle Home, Oracle SID, sysdba username, sysdba password for each database
running on each compute node.
3. A valid My Oracle Support user name (email address) with the valid Hardware
Customer Support Identifier (CSI) for the Oracle Exadata Database Machine
registered and approved.
4. URL, username and password for Enterprise Manager Cloud Control 12c that
monitors the Oracle Exadata Database Machine targets - if Enterprise Manager
Cloud Control 12c is in use.
6. Oracle Support Hub URL – if the compute nodes have no way of connecting to
My Oracle Support and need to upload to an Oracle Support Hub.
Pre-requisites
Compute node SerialNumbers file permissions
Many services available in My Oracle Support (MOS) are dependent upon the validation
of the host server serial number being covered under an active support contract. If you
are running Exadata software prior to version 11.2.2.4.0, please run the following
commands on each compute server node. These commands only have to be executed
once. This ensures the capture of serial number data by the OCM collectors.
to the file /opt/oracle.cellos/vldrun. This allows vldrun to ensure the privileges are correct on the
SerialNumbers file. If the command is run repeatedly, duplicate lines will be repeatedly added to the
vldrun file. This does not cause any problem but should be avoided. Duplicate lines can be manually
removed from the file.
3
Oracle Configuration Manager
for Oracle Exadata Database Machine
Without Enterprise Manager Cloud Control 12c, it is necessary to deploy OCM in each
Oracle Home on each of the compute nodes, including both the Database Oracle Homes
and the Grid Infrastructure Oracle Homes. Since, even for the smaller variants of the
Oracle Exadata Database Machine, this results in the need to deploy a large number of
OCMs, it is useful to use the Mass Deployment utility, rather than manually deploying
each OCM, especially if it is likely that the exercise is to be repeated on several Oracle
Exadata Database Machines. The investment in time taken to become familiar with the
Mass Deployment utility will pay off the more it is used.
If the Oracle Exadata Database Machine compute nodes do not have direct connectivity
to My Oracle Support then the OCMs deployed in each of the compute node Oracle
Homes can be configured to upload via a proxy, via an Oracle Support Hub or via a
combination of both.
When the Oracle Exadata Database Machine compute nodes are on a network that has no
means of accessing My Oracle Support, with no option to use a proxy or an Oracle
Support Hub then it is possible to configure OCM in each Oracle Home in ‘disconnected’
mode. In this case, the Mass Deployment Utility cannot be used since the Mass
Deployment Utility itself requires connectivity to My Oracle Support as part of the
deployment process. OCM must therefore be installed manually in each Oracle Home on
each compute node.
4
Oracle Configuration Manager
for Oracle Exadata Database Machine
The following flowchart can be used to advise on the most appropriate option for your
environment:
Yes
Note: Please ensure that the network configuration applicable to your specific
environment is implemented and functioning before OCM is deployed and/or configured
using either of the methods outlined in this document.
5
Oracle Configuration Manager
for Oracle Exadata Database Machine
The directory in which the emgc.properties file is located is the "config home" of
the OMS. In the following example
/u01/app/oracle/product/gc_inst/em/EMGC_OMS1 is the config home of the
OMS:
EMGC_OMS1=/u01/app/oracle/product/gc_inst/em/EMGC_OMS1/emgc.properties
$export ORACLE_CONFIG_HOME=/u01/app/oracle/product/gc_inst/em/EMGC_OMS1
If the file setupCCR exists, OCM has never been configured for this
ORACLE_HOME, use setupCCR [CSI_number] to configure OCM.
6
Oracle Configuration Manager
for Oracle Exadata Database Machine
$ cd $ORACLE_HOME/ccr/bin
$ ./configCCR -r
$ ./configCCR –a 12345678
Notes:
i. The CSI number should be the one that Enterprise Manager Cloud
Control 12c Oracle Home itself will be associated with. If this is
not known, do not specify a CSI Number and OCM will use the
default CSI of the provided My Oracle Support account, which you
will be prompted for. You will be prompted for the password for
that account only if you have not provided a CSI number.
ii. The My Oracle Support account you provide is used to upload the
configuration data to My Oracle Support. This account needs to
have privileges on the CSI for the OMS and the HW CSI for the
Exadata targets in order to be able to allocate the HW CSI to the
Exadata targets uploaded by the Oracle Harvester.
iii. You must provide either the CSI that you would like to use for the
OMS or the password for the My Oracle Support user specified. If
neither a CSI nor a password is provided, OCM will be configured
in 'anonymous' mode and you will not see any of the data uploaded
to My Oracle Support.
4. Verify that OCM has been configured successfully in the OMS Oracle Home by
examining the output of the emCCR status command.
Example:
$ ./emCCR status
Oracle Configuration Manager - Release: 10.3.6.0.2 – Production
Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights
reserved.
------------------------------------------------------------------
Start Date 02-Dec-2011 04:40:29
Last Collection Time 12-Jan-2012 04:39:00
Next Collection Time 13-Jan-2012 04:39:00
Collection Frequency Daily at 04:39
Collection Status idle
Log Directory /u01/app/oracle/MW/oms/ccr/hosts/myOMShost/log
Registered At 02-Dec-2011 04:39:49
Automatic Update On
Collector Mode Connected
Look out for the version, which should be 10.3.6.0.1 or above, and the
timestamps, which should be current.
7
Oracle Configuration Manager
for Oracle Exadata Database Machine
data using different CSIs for each Oracle Home. This is important when monitoring
Oracle Exadata Database Machine targets since each Oracle Exadata Database Machine
target needs to be assigned its own CSI.
CSIs are assigned to Oracle Home targets using the Cloud Control console by navigating
to the Setup > My Oracle Support > Support Identified Assignment page:
Note: Before you can use this page to Assign CSIs you need to:
i. Ensure My Oracle Support credentials are set for your user in Cloud Control using Setup > My
Oracle Support > Set Credentials.
ii. Ensure the Connection setting is set to Online on the Setup > Proxy Settings > Online and
Offline Settings (Patching Setup) page.
iii. Ensure Proxy Settings are configured and tested (if required) using Setup > Proxy Settings >
My Oracle Support and Proxy Connection
iv. Wait for the Oracle Harvester to have run for the first time. As stated previously, the
Harvester requires OCM to be configured in each of the OMS Oracle Homes before it will run.
The Harvester will run automatically at 02:00 (OMS local time) following OCM configuration. No
Oracle Homes will be listed on the Assign CSI page until the Harvester has run successfully. The
scheduled run time for the Harvester can be modified following the steps in Note 1325594.1 How
To Change The Enterprise Manager Harvester Job RunTime Schedule.
8
Oracle Configuration Manager
for Oracle Exadata Database Machine
On the Support Identifier Assignment page, use the Search dialogue to filter the list of
Oracle Homes that can have CSIs assigned based on specified Oracle Home, Host Name
and Support Identifier search strings. The wildcard ‘%’ can be used within the search
strings.
The list of Oracle Homes can further be filtered based on whether or not the Oracle
Homes have CSIs assigned already by selecting ‘Assigned’ or ‘Unassigned’ from the Show
Oracle Homes drop-down list and clicking Go.
Users with Super Administrator privileges are able to assign CSIs for any oracle home.
Administrators without Super Administrator privileges can assign CSIs only to oracle
homes for which they have at least operator privilege on all the targets.
After finding the Oracle Home(s) that you want to Assign CSIs to, select them using the
checkboxes in the ‘Select’ column then click Assign. A pop-up window will appear that
shows the list of selected Oracle Homes and a drop-down list that can be used to select
the CSI that you want to assign to those Oracle Homes. Administrators will be able to
select from the list of CSIs available to the My Oracle Support user whose credentials they
provided in Setup > My Oracle Support > Set Credentials. Select the CSI from the
drop-down list then click OK.
See My Oracle Support Note 1368676.1 Tips and Tricks on Debugging the 12c Harvester
for details of how to troubleshoot problems with the Oracle Harvester.
9
Oracle Configuration Manager
for Oracle Exadata Database Machine
Download and install the Mass Deployment utility on any one host from which all the
nodes in an Oracle Exadata Database Machine can be accessed using ssh. A compute
10
Oracle Configuration Manager
for Oracle Exadata Database Machine
node can be used for this purpose. Instructions to install the Mass Deployment utility can
be referenced in the Oracle® Configuration Manager Companion Distribution Guide.
2. Create a line for each Compute Node/Database Oracle Home combination. For
example, if the Oracle Exadata Database Machine houses two compute nodes,
which each have one Grid Infrastructure Oracle Home and one Database Oracle
Home, create four lines. Add the following information on each line (if a column
value is not specified, leave it blank for now):
Action: Set this column to “get_info” to retrieve information about the state of
the OCM collector in the compute node Oracle home specified on this line
Host-Name: Host name of the compute node.
Host-User: OS user that owns the Oracle home.
Note: For Grid Infrastructure Oracle Homes, when using the Mass Deployment
utility, specify the ‘root’ user as the Host-User since it is the root user that owns
the Oracle home. This results in the OCM deployment being owned by the root
user. Alternatively, OCM can be deployed manually in Grid Infrastructure homes
using the non-root Oracle software owner.
Host-Password: Password for the OS user - set to “__PROMPT__” (two
underscores before and after) and you will be prompted for the password at the
time you run the Mass Deployment utility, interactively. This is a secure option
for providing the password as it results in the password not being written to a file
at any phase of the process. See Section 2.4.4 Credentials in the Mass
11
Oracle Configuration Manager
for Oracle Exadata Database Machine
and add the property md.repeater.uri with the value of the Oracle Support
Hub Url
Example
md.repeater.uri=http://shhost.example.com:7003
12
Oracle Configuration Manager
for Oracle Exadata Database Machine
Notes:
The Oracle Support Hub needs to have been deployed on a server that can
connect to My Oracle Support. A pre-requisite of deploying the Oracle
Support Hub is to have a Weblogic or Oracle Application Server to be
available and configured ready for deployment of the Oracle Support Hub
application. The Oracle Support Hub is supported to run on the following
versions of Weblogic and Oracle Application Server:
For details of how to install and configure an Oracle Support Hub, refer to
the Oracle Support Hub Documentation.
Example get_info_input.csv:
The following is an example of the lines in a csv file with sample entries for compute
nodes edbm01db01 and edbm01db02, which have one Database Oracle Home and one
Grid Infrastructure Oracle Home each. Notice, the first line starts with a pound sign (#)
signifying that the first line is a comment showing the column labels. You may copy these
lines to a text file and open that file in your favorite spreadsheet editor for better viewing.
"#Action","HostName","Host-user","Host-Password","Product Home Path","Oracle Config
Home Path","OCM Version","OCM Status","OCM Mode (connected/disconnected)","Db SID","DB
Type (EM/Ebiz/db)","ML-user (Metalink user ID)","ML-CSI (Metalink CSI)","ML-
Pwd","Proxy-Host","Proxy-Port","Proxy-user","Proxy-Pwd","DB-user (SYSDBA user)","DB-
Pwd","DB-App-user (Ebiz user if db type is Ebiz)","DB-App-Pwd (Ebiz user password if db
type is Ebiz or SYSMAN password if db type is EM)","Cmd Status (Status of the remote
operation)"
"get_info","edbmdb01","oracle","
ENCR_8EBB07D9D486C17A4BA0F6FD4B93BF52","/u01/app/oracle/product/11.2.0/dbhome_1",,,,,,,
"jdoe@example.com",12345678,,,,,,,,,,
"get_info","edbmdb01","root","__PROMPT__","/u01/app/grid/11.2.0",,,,,,
,"jdoe@example.com",12345678,,,,,,,,,,
"get_info","edbmdb02","oracle","__PROMPT__","/u01/app/oracle/product/11.2.0/dbhome_1",,
,,,, ,"jdoe@example.com",12345678,,,,,,,,,,
"get_info","edbmdb02","root","__PROMPT__","/u01/app/grid/11.2.0",,,,,,
,"jdoe@example.com",12345678,,,,,,,,,,
The following graphic illustrates the sample get_info_input.csv when viewed from
spreadsheet editor software (the full width of the spreadsheet is shown in three sections).
13
Oracle Configuration Manager
for Oracle Exadata Database Machine
Step 3 - Determine the current state of OCM in each compute node Oracle home
Before performing any deployment operations, the Mass Deployment Utility should first
be run with the Action ‘get_info’ for each database Oracle home on each compute node.
Based on the output of ‘get_info’, a new input csv file will be created in the next step with
relevant Action values depending on the current status of OCM in each database Oracle
home.
The Mass Deployment utility is run using the remote_op command and performs the
action specified in the Action column for the Oracle home of the compute node of each
row of the input csv file that gets passed as the parameter –input_file.
Execute the remote_op Mass Deployment command using the get_info_input.csv file
as input to gather information about the status of OCM in each DB Oracle Home on
each compute node.
For example:
$ bin/remote_op -input_file get_info_input.csv
Notes:
1. When you run either of the remote_op or secure_password utilities for the first time, you will
be prompted for a password. This password will be required subsequently each time either
the remote_op or secure_password utility is used. The password must be at least 8 characters
long. If you forget the password you will need to remove the current Mass Deployment
Utility and install it once again. Any input files that have encrypted values from a previously
deployed Mass Deployment utility will no longer be able to be used.
2. The remote_op command requires the environment variable JAVA_HOME to be set to point
to a JDK version greater than 1.5
Respond to the prompts as needed. You will be prompted for the Mass Deployment
utility password and each password field in the input.csv file that contained a
“__PROMPT__”
For example:
$ export JAVA_HOME=/
$ bin/remote_op -input_file get_info_input.csv
OCM Mass Deployment Utility - Release: 10.0.1.1.0
Copyright (c) 2009, Oracle. All rights reserved.
Please enter the password for Mass Deployment Utility.
Password:
Password for user oracle (host:edbmdb01):
Confirm Password:
14
Oracle Configuration Manager
for Oracle Exadata Database Machine
A Mass Deployment output csv file is generated showing the results of the remote_op
commands. The output file name will default to the input file name prepended by the
string ‘output-‘ and the timestamp, for example, output-2012-01-11_10-39-36-AM-
get_info_input.csv and will be located in the ocm/md/out directory. See “Mass
Deployment Output File” for details on the output file format and log file information
that can be used for troubleshooting.
Create a new input csv, deploy_input.csv, to perform the required deployment actions
After the initial execution of the remote_op command using the get_info_input.csv file,
create a new input file. deploy_input.csv by copying the get_info_input.csv file. You will
notice that the __PROMPT__ values have been replaced by encrypted passwords and
therefore the passwords do not need to be entered when the remote_op command uses
this file.
Edit the ‘Action’ value for each row of the input file based on the status returned for the
same row in the output.csv file from step 3:
1. Set to “install” if the OCM Mode field is empty or shows ‘OCM Not Configured’
2. Set to “config” if the OCM Mode field is ‘Disconnected’ or ‘Connected
unauthenticated’
3. Set to “upgrade” if the OCM Mode field is ‘Connected’ or ‘Connected (via Oracle
Support Hub)’ but the OCM Version is less than 10.3.6
Note: If a row shows the OCM Mode ‘Connected’ or ‘Connected (via Oracle Support Hub)
and the OCM Version is 10.3.6 or above, OCM is already configured in the Oracle Home,
keep the value ‘get_info’ for the Action for such rows. If OCM is already configured in all
Oracle Homes then there is no need to perform any more steps.
To ensure OCM collects the most complete set of configuration data for the databases
running on the Oracle Exadata Database Machine, it is good practice to ensure that the
most up to date version of the ORACLE_OCM schema objects are installed in the
ORACLE_OCM schema of each database. The Mass Deployment Utility ‘instrument’
action installs or updates the ORACLE_OCM schema for a specified database.
15
Oracle Configuration Manager
for Oracle Exadata Database Machine
For each database, select one compute node and Oracle Home that the database runs out
of and duplicate that row in the deploy_input.csv file. Give the new row the ‘Action’
value ‘Instrument’ and provide the DB SID, DB Type, DB-User and DB-Pwd field
values:
DB-SID:Database system identifier. Used for install and instrument actions.
DB-Type: The database type. Provide the value ‘db’ for all databases other than
EBiz repositories (provide the value ebiz) and Enterprise Manager repositories
(provide the value EM)
DB-user (SYSDBA user): SYSDBA user - This field is not required if OS
Authentication is enabled on the database
DB-Pwd: Password for the SYSDBA user. This field is not required if OS
Authentication is enabled on the database
The resultant deploy_input.csv file should have one row for each compute node Oracle
Home with the Action ‘install’, ‘config’, ‘upgrade’ or ‘get_info’ and one row for each
database with the Action ‘instrument’.
Example deploy_input.csv file
Below is an example of the lines in a deploy_input.csv file with sample entries for
compute nodes edbm01db01 and edbm01db02, which each have one Grid Infrastructure
Oracle Home and one Database Oracle Home that runs the proddb RAC database with
instances proddb1 running on emdbmdb01 and proddb2 running on emdbmdb02.
"#Action","HostName","Host-user","Host-Password","Product Home Path","Oracle Config
Home Path","OCM Version","OCM Status","OCM Mode (connected/disconnected)","Db SID","DB
Type (EM/Ebiz/db)","ML-user (Metalink user ID)","ML-CSI (Metalink CSI)","ML-
Pwd","Proxy-Host","Proxy-Port","Proxy-user","Proxy-Pwd","DB-user (SYSDBA user)","DB-
Pwd","DB-App-user (Ebiz user if db type is Ebiz)","DB-App-Pwd (Ebiz user password if db
type is Ebiz or SYSMAN password if db type is EM)","Cmd Status (Status of the remote
operation)"
"install","edbmdb01","oracle","ENCR_8EBB07D9D486C17A4BA0F6FD4B93BF52","/u01/app/oracle/
product/11.2.0/dbhome_1",,,,,,,"jdoe@example.com",12345678,,,,,,,,,,
"install","edbmdb01","root","ENCR_8EBB07D9D486C17A4BA0F6FD4B93BF52","/u01/app/grid/11.2
.0",,,,,,,"jdoe@example.com",12345678,,,,,,,,,,
"install","edbmdb02","oracle","ENCR_8EBB07D9D486C17A4BA0F6FD4B93BF52","/u01/app/oracle/
product/11.2.0/dbhome_1",,,,,,,"jdoe@example.com",12345678,,,,,,,,,,
"install","edbmdb02","root","ENCR_8EBB07D9D486C17A4BA0F6FD4B93BF52","/u01/app/grid/11.2
.0",,,,,,,"jdoe@example.com",12345678,,,,,,,,,,
"instrument","edbmdb01","oracle","__PROMPT__","/u01/app/oracle/product/11.2.0/dbhome_1"
,,,,,"proddb1","db","jdoe@example.com",12345678,,,,,, "sys","__PROMPT__",,,
The following graphic illustrates the sample deploy_input.csv when viewed from
spreadsheet editor software (the full width of the spreadsheet is shown in three sections).
16
Oracle Configuration Manager
for Oracle Exadata Database Machine
Run the Mass Deployment utility using the deploy_input.csv file as input
Once the deploy_input.csv file has been created and populated, run the Mass Deployment
utility, passing the deploy_input.csv file as input. The Mass Deployment will attempt to
perform each of the Actions and if they are all successful OCM will be configured in each
of the compute node Database Oracle homes and each of the databases running on the
Oracle Exadata Database Machine will be instrumented with the most up to date version
of the ORACLE_OCM schema objects.
17
Oracle Configuration Manager
for Oracle Exadata Database Machine
For example:
$ bin/remote_op -input_file deploy_input.csv
OCM Mass Deployment Utility - Release: 10.0.1.1.0
Copyright (c) 2009, Oracle. All rights reserved.
Please enter the password for Mass Deployment Utility.
Password:
Password for user SYS (database:proddb1):
Confirm Password:
Encrypting input file
/scratch/username/MD/ocm_companion/distributions/ocm/md/deploy_input.csv
Please be patient, process may take some time.
Log File: /scratch/username/MD/ocm_companion/distributions/ocm/md/out/output-2011-09-
12_03-50-03-PM-install_exadata_csi_input.csv.log
Please see the output file
/scratch/username/MD/ocm_companion/distributions/ocm/md/out/output-2011-09-12_03-50-03-
PM-install_exadata_csi_input.csv
Step 5 - Determine the state of OCM in each compute node Oracle home after
deployment
After running the Mass Deployment utility remote_op command with the
deploy_input.csv file as input, an output csv file is generated showing the results of the
remote_op commands. The output file name will default to the input file name
prepended by the string ‘output-‘ and the timestamp, for example, output-2012-01-11_10-
39-36-AM-deploy_input.csv and will be located in the ocm/md/out directory.
Confirm the success of each action by checking the Cmd Status field of the output csv
file. The example, below, shows the successful installation of OCM on both nodes along
with the successful instrumentation of the database.
"#Action",HostName,Host-user,Host-Password,Product Home Path,Oracle Config Home
Path,OCM Version,OCM Status,OCM Mode (connected/disconnected),Db SID,DB Type
(EM/Ebiz/db),ML-user (Metalink user ID),ML-CSI (Metalink CSI),ML-Pwd,Proxy-Host,Proxy-
Port,Proxy-user,Proxy-Pwd,DB-user (SYSDBA user),DB-Pwd,DB-App-user (Ebiz user if db
type is Ebiz),DB-App-Pwd (Ebiz user password if db type is Ebiz or SYSMAN password if
db type is EM),
"",edbmdb01,oracle,ENCR_8EBB07D9D486C17A4BA0F6FD4B93BF52,/u01/app/oracle/product/11.2.0
/dbhome_1,,10.3.6.0.2,idle,Connected,,,jdoe@example.com,12345678,,,,,,,,,,Success:
config operation
"",edbmdb01,root,ENCR_8EBB07D9D486C17A4BA0F6FD4B93BF52,/u01/app/grid/11.2.0,,10.3.6.0.2
,idle,Connected,,,jdoe@example.com,12345678,,,,,,,,,,Success: config operation
"",edbmdb02,oracle,ENCR_8EBB07D9D486C17A4BA0F6FD4B93BF52,/u01/app/oracle/product/11.2.0
/dbhome_1,,10.3.6.0.2,idle,Connected,,,jdoe@example.com,12345678,,,,,,,,,,Success:
config operation
"",edbmdb02,root,ENCR_8EBB07D9D486C17A4BA0F6FD4B93BF52,/u01/app/grid/11.2.0,,10.3.6.0.2
,idle,Connected,,,jdoe@example.com,12345678,,,,,,,,,,Success: config operation
"",edbmdb01,oracle,ENCR_8EBB07D9D486C17A4BA0F6FD4B93BF52,/u01/app/oracle/product/11.2.0
/dbhome_1,,10.3.6.0.2,idle,Connected,proddb1,db,jdoe@example.com,12345678,,,,,,SYS,ENCR
_8EBB07D9D486C17A4BA0F6FD4B93BF52,,,Success: instrument operation
See Section 2.4.6 “Mass Deployment Output File” for details on the output file format
and log file information that can be used for troubleshooting.
You can also validate the success of the deployment and/or configuration of OCM via
Mass Deployment by executing the “emCCR status” command on each node. If
successful, the command should return the status of the collector.
18
Oracle Configuration Manager
for Oracle Exadata Database Machine
For example:
[oracle@db01 ccr]$ bin/emCCR status
Oracle Configuration Manager - Release: 10.3.6.0.1 – Production
Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved.
------------------------------------------------------------------
Start Date 12-Jan-2012 14:13:17
Last Collection Time 12-Jan-2012 14:13:17
Next Collection Time 13-Jan-2012 14:12:00
Collection Frequency Daily at 14:12
Collection Status idle
Log Directory
/u01/app/oracle/product/11.2.0/dbhome_1/ccr/hosts/edbmdb01.us.oracle.com/log
Registered At 12-Jan-2012 14:12:59
Automatic Update On
Collector Mode Connected
Look out for the version, which should be 10.3.6.0.1 or above, and the timestamps, which
should be current.
19
Oracle Configuration Manager
for Oracle Exadata Database Machine
Special care should be taken to ensure that setupCCR is run with the Hardware CSI of the
Oracle Exadata Database Machine passed as a parameter, e.g:
$ setupCCR 12345678
Note: When installing OCM into a Grid Infrastructure home, since version 10.3.5 of
OCM, it is no longer necessary to install as the root user or change ownership of the
Oracle Home to the non-root user.
Since the Grid Infrastructure Oracle Home is owned by the root user, OCM must be
unzipped as the root user and then ‘chown’ can be used to change the ownership of the
‘ccr’ directory and its contents to the non-root user before that user runs setupCCR.
It is not currently possible to use the Mass Deployment utility to deploy OCM in
disconnected mode so manually deploying OCM in each Oracle Home is the only option
available.
Note 763142.1 How to upload the collection file ocmconfig.jar to My Oracle Support for
Oracle Configuration Manager (OCM) running in Disconnected Mode provides
instructions on how to upload the Oracle Exadata Database Machine configuration data
to My Oracle Support.
20
Oracle Configuration Manager
for Oracle Exadata Database Machine
This account does not have permission to use cron. The Oracle Configuration Manager
will not be automatically started on system reboot. Add the command:
It is common for non-root users on an Exadata server to not have access to cron.
The message is displayed because the deployment of OCM tries to configure crontab
to run a script every 15 minutes to start OCM when it is not running, e.g:
21
Oracle Configuration Manager
for Oracle Exadata Database Machine
Appendices
Appendix A – Exadata Configuration Worksheets
Exadata Database Machine Configuration Worksheets contain customer provided data
used to generate the Exadata Installation Template. These worksheets, along with the
installation template are a good source of Exadata compute node data used by the OCM
Mass Deployment Utility.
See below for examples:
The value of the Net0 Name column of rows with a Component of “Database
server” in the Server Components listing from the Exadata Installation Template
can be used as compute node host names in the Mass Deployment input.csv file.
Host
Names
The Exadata Database machine name entered into the General Configuration
Worksheet is the basis of the generated host names (e.g., dm01 will result in a
database server host name of dm01db01). This can then be used to infer the host
names to be entered into the input.csv file.
22
Oracle Configuration Manager
for Oracle Exadata Database Machine
Oracle Environment Default Settings can also be used to deduce compute node host
user names and passwords.
Host username
Host password
23
Oracle Configuration Manager
for Oracle Exadata Database Machine
[<Proxy-user>@]<Proxy-host>[:<Proxy-port>]
24
Oracle Configuration Manager
for Oracle Exadata Database Machine
The following table can be used to list each Oracle Home for each Compute Node along
with the details of the databases that run from that Oracle Home.
25
Oracle Configuration Manager
for Oracle Exadata Database Machine
a). Allow the utility to prompt for the password: If you want to be prompted
for the password as the remote_op utility processes the input file, enter
__PROMPT__ (that is, two underscore characters, followed by the string PROMPT in
uppercase, followed by another two underscore characters) in the password fields in the
password.csv. For more details on this, refer to Section 2.4.4 of the Oracle
Configuration Manager Companion Distribution Guide.
Note: The remote_op utility encrypts the values of the input.csv file, changing the values
in the actual input file and saves those changes.
b). If the same credentials are being used for multiple hosts, another option is to
use a password group name in the password.csv file as described in Section 2.4.1
of the Oracle Configuration Manager Companion Distribution Guide.
26
Oracle Configuration Manager
for Oracle Exadata Database Machine
An alternative way of testing connectivity to Oracle would be to use ssh as in the example
below:
The ssh connection will hang and you will need to use CTRL-C to exit but the highlighted
output will confirm whether or not the node you are on can connect to Oracle.
27
Oracle Configuration Manager for Oracle Copyright © 2011, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only and the
Exadata Database Machine contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
January, 2012 warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or
Author: David Parker-Bastable fitness for a particular purpose. We specifically disclaim any liability with respect to this document and no contractual obligations are
Contributing Authors: Casey Costley, Tina formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by a ny
Boisvert means, electronic or mechanical, for any purpose, without our prior written permission.
Oracle Corporation
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
World Headquarters
500 Oracle Parkway
AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices.
Redwood Shores, CA 94065
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under licens e
U.S.A.
and are trademarks or registered trademarks of SPARC International, Inc. UNIX is a registered trademark licensed through X/Open
Worldwide Inquiries: Company, Ltd. 1010
Phone: +1.650.506.7000
Fax: +1.650.506.7200
oracle.com