Oracle® Configuration Manager Installation and Administration Guide Release 10.3.2.1 Part Number B32294-11 |
|
|
View PDF |
This chapter contains the following sections:
Section 5.1, "Collecting Configuration Data (Connected Mode)"
Section 5.2, "Collecting Configuration Data (Disconnected Mode)"
Section 5.4, "Disabling Collection of IP, MAC, and Broadcast Addresses"
Section 5.6, "Enabling the Default Collection of NFS Disk Information"
Configuration data is automatically collected on a regular schedule. By default, collections are scheduled to run once a day at the time the original installation was done. Therefore, no matter how many times you view the data within that 24 hour time period, the data will remain the same until the time of the next collection.
To start a manual collection of configuration data, enter the following command:
<ocm_install_root>/ccr/bin/emCCR collect
This command collects the configuration data and uploads it to the server located at Oracle. Configuration data is collected only if the Scheduler has been started. The Scheduler is always running unless it has been manually stopped with the emCCR stop
command. In this case, you will have to manually restart the Scheduler so that configuration data can be automatically collected. Check the status of the Scheduler by entering emCCR status
which indicates whether the Scheduler has been started. To start the Scheduler, enter the following command:
<ocm_install_root>/ccr/bin/emCCR start
The Scheduler acts as a coordinator of activities, and provides both a richer schedule capability and the ability to perform collections on a regular schedule. Scheduled collections are only available when Oracle Configuration Manager is running in Connected mode.
Configuration data can be collected daily, weekly, or monthly, at a particular date and time. You can set the interval for automatically collecting the configuration data with the emCCR set collection_interval
command.
The emCCR stop
, emCCR set collection_interval
, emCCR hold
, emCCR resume
, emCCR getupdates
, and emCCR upload
commands can be used only if the Scheduler has been started.
For more information on these commands, refer to Chapter 6, "Managing the Oracle Configuration Manager Client".
If you are using Oracle Configuration Manager in Disconnected mode, configuration data needs to be manually collected. As the Scheduler is not running in this mode, it cannot be used to automatically collect configuration data at regular intervals.
You can collect configuration data manually by using the emCCR
collect
command. When you run this command, the ocmconfig.jar
is created in the OCM_CONFIG_HOME/state/upload/
directory. This file contains the manually collected configuration data. You can then upload this file to Oracle by way of My Oracle Support from another system that has internet access. For more details on manual collection of configuration data, refer to Section 6.3, "emCCR collect".
In this mode, the only commands supported are emCCR collect
, emCCR status
, emCCR enable_target
, emCCR
disable_target
, emCCR update_components
, configCCR
, and emCCR help
.
You can update Oracle Configuration Manager either manually or automatically.
Updating Oracle Configuration Manager Automatically: After the Oracle Configuration Manager client has been installed in Connected mode, it automatically schedules a collection. If any updates to the Oracle Configuration Manager client are available, they are downloaded and applied before the configuration data is collected.
To disable the automatic updates, enter the following command:
<ocm_install_root>/ccr/bin/emCCR automatic_update off
Updating Oracle Configuration Manager Manually: You can manually apply updates by using the emCCR
update_components
command. You can either use the latest Oracle Configuration Manager distribution kit for the update or stage individual Oracle Configuration Manager packages in a local directory and deploy them by using the emCCR
update_components
command. This command can be used in both Connected and Disconnected modes. For more information on this command, refer to Section 6.16, "emCCR update_components".
If you have disabled the automatic updates, the updates can be manually downloaded and applied. To manually download and deploy the updates, enter the following command:
<ocm_install_root>/ccr/bin/emCCR getupdates
Important:
Automatic updates are not possible if Oracle Configuration Manager is installed on a shared, read-only file system. In this situation, the automatic update feature should be disabled and all updates performed manually.You can disable the collection of the Host IP Address, the Network Interface MAC Address, and the Broadcast Address. To disable the collection of these items, you must add the following entries to the OCM_CONFIG_HOME/config/collector.properties
file.
To disable the collection of network addresses, add the following entry:
ccr.metric.host.ecm_hw_nic.inet_address=false
To disable the collection of the MAC address, add the following entry:
ccr.metric.host.ecm_hw_nic.mac_address=false
To disable the collection of the Broadcast address, add the following entry:
ccr.metric.host.ecm_hw_nic.broadcast_address=false
You can disable the collection of certain database columns by using data masking. Masking data means replacing certain fields with a mask character, such as an X.
All masking operations are defined in the collector.properties file located in the $ORACLE_HOME/ccr/hosts/<hostname>/config/ directory or the $ORACLE_HOME/ccr/config/ directory.
To mask the database user name in the database collection, include the following in the collector.properties file:
ccr.metric.oracle_database.db_users.username=mask
To remove the database user name mask, remove the associated line from the collector.properties file or set the parameter to false:
ccr.metric.oracle_database.db_users.username=mask or ccr.metric.oracle_database.db_users.username=false
The NFS mounted file system information is no longer collected by default. Only local file system information is collected by default.
To enable the collection of NFS mounted file system information, add the following entry to the OCM_CONFIG_HOME/config/collector.properties
file.
metric.host.ecm_os_filesystem.nfs_enable=true
In support of mass deployment using a scripted installation, Oracle Configuration Manager installation and configuration supports the ability to create and specify a response file. The response file contains all the user required input needed when running the setupCCR and configCCR commands.
To specify the response file with the setupCCR and configCCR commands, use the -R
qualifier with the <response file>
argument.
configCCR [-R <response file>] setupCCR [-R <response file>]
To create a response file, use the emocmrsp
response generation utility, located in the $ORACLE_HOME/ccr/bin
directory. This utility walks you through the interrogation phase of an installation and records your responses to the prompts. The information is recorded in an Oracle Configuration Manager private format response file. By default, the response file is created in the current directory with the file name ocm.rsp
. To view the contents of the response file, use the -verbose
option on the command line.
Note:
To create a response file that installs but does not configure Oracle Configuration Manager, click ENTER when prompted for the e-mail address and specify Yes when asked to confirm if you want to remain uninformed.To create the response file, enter the following command:
emocmrsp [-output <response-file>] [-help] [-no_banner] [-repeater <URL>] [[<CSI>] [[<MyOracleSupportUserName>] [[<CountryCode>]]]] [-verbose <response-file>] [-verify <response-file>]
The following qualifiers are allowed:
Qualifier | Description |
---|---|
<CSI> | To use Customer Support Identifier for registration, enter CSI at the end of the command line. You can either enter the MyOracleSupportUserName and CountryCode on the command line or be prompted for them.
Note: If |
<MyOracleSupportUserName> | My Oracle Support User Name holding the CSI in its My Oracle Support profile. |
<CountryCode> | Country Code corresponding to the CSI. |
-help | Displays this usage information. |
-no_banner | Indicates the banner for the response utility is not to be displayed. |
-output <response_file> | Creates a response file with the name specified. If you do not specify this qualifier, the response file is created in your current working directory with the file name ocm.rsp . |
-repeater <URL> | Indicates the URL of the Oracle Support Hub. |
-verbose <response-file> | Displays contents of the response file specified. |
-verify <response-file> | Verifies that the contents of the response file are valid. |
Example
$ORACLE_HOME/ccr/bin/emocmrsp
OCM Installation Response Generator 10.3.2.1.0 - Production Copyright (c) 2005, 2010, Oracle. All rights reserved. Provide your email address to be informed of security issues, install and initiate Oracle Configuration Manager. Easier for you if you use your My Oracle Support Email address/User Name. Visit http://www.oracle.com/support/policies.html for details. Email address/User Name: test@company.com Provide your My Oracle Support password to receive security updates via your My Oracle Support account. Password (optional): The OCM configuration response file (ocm.rsp) was successfully created.
Notes
If you cannot access the Oracle server, you will be prompted for the URL of the Oracle Support Hub. If NONE is entered to indicate that no Oracle Support Hub is to be used, or if a proxy server is required to access the Oracle Support Hub, you will be prompted for proxy server information. If NONE is entered for both Oracle Support Hub and proxy server, Oracle Configuration Manager will be installed in Disconnected mode.
If you do not specify password when prompted, the setup will use unauthenticated mode.
Because the information is stored in an internal format, to see the contents of the response file, use the emocmrsp -verbose
command.
Example Using -verbose Qualifier
This example displays the contents of a response file.
$ORACLE_HOME/ccr/bin/emocmrsp -verbose <response_file>
OCM Installation Response Generator 10.3.2.1.0 - Production Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved. Response file created: Jan 3, 2010 3:09:29 PM Created by: jsmith License agreement: accepted Connected configuration state: connected Proxy configuration: (none specified) Oracle Support Hub: http://host123.company.com:7654 Response file registration via: My Oracle Support username My Oracle Support registration username: ccrother@jsmith.com
Example Using -verify Qualifier
$ORACLE_HOME/ccr/bin/emocmrsp -verify <response_file>
OCM Installation Response Generator 10.3.2.0.0 - Production Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved. Configuration connectivity verified successfully.
For a given environment, the administrator installing Oracle Configuration Manager sets things so that all the parts of that environment are functioning properly. Part of that set up is determining the environment variables used in Oracle Configuration Manager.
To run the configuration collection, Oracle Configuration Manager needs to be in sync with the given environment. The emSnapshotEnv script (shell script on UNIX; Visual Basic script on Windows) captures the values of the environment variables required by Oracle Configuration Manager. The environment variables are listed in Table 5-1:
Table 5-1 Environment Variables Used in Oracle Configuration Manager
Environment Variable | Used in UNIX | Used in Windows |
---|---|---|
BEA_HOME |
yes |
yes |
CCR_DEBUG |
yes |
yes |
CRS_HOME |
yes |
yes |
CLUSTER_NAME |
yes |
yes |
EMAGENT_PERL_TRACE_LEVEL |
yes |
yes |
EMTAB |
yes |
yes |
IAS_CONFIG_HOME |
yes |
no |
JAVA_HOME |
yes |
yes |
JAVA_HOME_CCR |
yes |
yes |
LD_PRELOAD |
yes |
no |
ORACLE_CONFIG_HOME |
yes |
yes |
ORACLE_HOME |
yes |
yes |
ORACLE_OCM_SERVICE |
yes |
yes |
ORAINST_LOC |
yes |
yes |
TNS_ADMIN |
yes |
yes |
TZ |
yes |
yes |
WL_HOME |
yes |
yes |