| Oracle® Configuration Manager Installation and Administration Guide 10g Release 2 (10.2) Part Number B28484-02 |
|
|
View PDF |
| Oracle® Configuration Manager Installation and Administration Guide 10g Release 2 (10.2) Part Number B28484-02 |
|
|
View PDF |
This chapter describes the various command line options that are available to manage the Oracle Configuration Manager client.
The following commands are described:
Usage: Use this command to enable and disable the automatic retrieval of new software updates. Automatic retrieval of new software updates occurs only with automatic collections. By default, automatic updates are enabled.
$ORACLE_HOME/ccr/bin/emCCR automatic_update on / off
Pre-requisites: None
Example:
$ORACLE_HOME/ccr/bin/emCCR automatic_update on Oracle Configuration Manager - Release: 10.2.4.0.0 - ProductionCopyright (c) 2005, 2006, Oracle. All rights reserved.----------------------------------------------------------------AUTOMATIC_UPDATE command ended successfully.
Errors: Some of the error messages you may see are the following:
Access Denied: This error is displayed if you do not have the required privileges to run this command.
Usage: Use this command to perform an immediate discovery, collection, and uploading of configuration data. When you run this command, it checks if any Oracle Configuration Manager mandatory software updates are available. You will be notified if any mandatory updates are available. You must download these mandatory updates using the emCCR getupdates command. If these mandatory updates are not downloaded, the configuration data collection will fail.
Pre-requisites:
Oracle Configuration Manager is registered with Oracle.
The Scheduler is already running.
Example:
$ORACLE_HOME/ccr/bin/emCCR collect Oracle Configuration Manager - Release: 10.2.4.0.0 - Production Copyright (c) 2005, 2006, Oracle. All rights reserved. ---------------------------------------------------------------- Collection done.
Errors: Some of the error messages you may see are the following:
Access Denied: This error is displayed if you do not have the required privileges to run this command.
Oracle Configuration Manager Not Registered with Oracle: In this case, you must register Oracle Configuration Manager with Oracle.
Mandatory updates available. Command failed. This error occurs if you perform a manual collection before applying the mandatory updates.
Server not available.
Handshake failure. You must reregister Oracle Configuration Manager.
Oracle Configuration Manager is Not Running - Restart the Scheduler using the emCCR start command.
Usage: Use this command to manually collect configuration data. If you want to annotate the data collected, use the -annotation option.
Pre-requisites: None
Example:
$ORACLE_HOME/ccr/bin/emCCR -annotation="annotation string" collect Oracle Configuration Manager - Release: 10.2.4.0.0 - Production Copright (c) 2005, 2006, Oracle. All rights reserved. ---------------------------------------------------------------- Collection done.
Usage: This command displays a user interface that allows you to do the following
Pre-requisites: None
Example:
$ORACLE_HOME/ccr/bin/emCCR config
The Oracle Configuration Manager General page is displayed as shown in Figure 5-1.
The registration information (CSI, Country, and the MetaLinkUserName) is displayed in Figure 5-1. You can specify different registration information here.
You can select the Enable Automatic Upload to specify the frequency at which the automatic collection of data should occur. You can also specify the date and time at which data collection should occur. The frequency can be Daily, Weekly, or Monthly.
You can select the Enable Automatic Oracle Configuration Manager Updates option. If this option is selected, any new updates of the Oracle Configuration Manager software will be automatically downloaded and applied during the next automatic collection. If this option is not selected and a mandatory update is available, configuration data will not be automatically collected until the mandatory software update is applied. You can apply the mandatory software updates either manually by using the emCCR getupdates command, or by selecting the Enable Automatic Oracle Configuration Manager Updates option.
If you need to change the proxy server information, click the Connection tab. The Oracle Configuration Manager Connection page is displayed as shown in Figure 5-2.
If you need to modify the proxy server settings, you can do so on this page. After you have modified the proxy server settings, click Test Connection to test the connection between your local host and Oracle. You will not be able to exit from this page until the proxy data has been verified or the data has been removed.
Errors: Some of the error messages you may see are the following:
Access Denied: This error is displayed if you do not have the required privileges to run this command.
Cannot connect to the server.
Cannot verify registration.
Usage: Use this command to enable or disable the collection of configuration information for targets discovered by the Oracle Configuration Manager. By default, all targets are enabled for collection. When you enter this command, the list of targets that can be enabled or disabled is displayed. Enter the number corresponding the target to be enabled or disabled.
Pre-requisites: You can use this option only if Oracle Configuration Manager has been registered with Oracle.
Example: For example, enter the command to disable the database instance HTMLDB.
$ORACLE_HOME/ccr/bin/emCCR disable_targetOracle Configuration Manager - Release: 10.2.4.0.0 - ProductionCopyright (c) 2005, 2006, Oracle. All rights reserved.----------------------------------------------------------------S. No. Category Target Name0 Host ocmdev.us.oracle.com1 Database Instance ND10G2 Database Instance HTMLDB3 Oracle Home 10gR1dbPress Enter to exit the command.Use Comma to separate multiple target numbers.Enter the number(s) corresponding to the target(s) you wish to disable:2DISABLE_TARGET command ended successfully.
Errors: Some of the error messages you may see are:.
Access Denied - This error is displayed if you do not have the required privileges to run this command.
Oracle Configuration Manager Not Registered With Oracle - In this case, you must register Oracle Configuration Manager with Oracle.
No targets to act on by this Command. - There are no targets that can be enabled or disabled.
Usage: Use this command to retrieve any new software updates.
Pre-requisites:
Oracle Configuration Manager is registered with Oracle.
The Scheduler is already running.
Example:
Errors: Some of the error messages you may see are the following:
Access Denied: This error is displayed if you do not have the required privileges to run this command.
Oracle Configuration Manager Not Registered with Oracle: In this case, you must register Oracle Configuration Manager with Oracle.
Server not available.
Oracle Configuration Manager is Not Running - Restart the Scheduler using the emCCR start command.
Usage: This command lists the available emCCR (Oracle Configuration Manager) options.
Pre-requisites: None
Example:
$ORACLE_HOME/ccr/bin/emCCR help Oracle CCR - Release: 10.2.4.0.0 - Production Copyright (c) 2005, 2006, Oracle. All rights reserved. ------------------------------------------------------------------ emCCR start| stop| status emCCR set collection_interval= "[FREQ=MONTHLY | WEEKLY | DAILY] [; BYMONTHDAY=1 to 31, when FREQ is MONTHLY] [; BYDAY=MON to SUN, when FREQ is WEEKLY] [; BYHOUR=0 to 23] [; BYMINUTE=0 to 59]" DAILY is the default Frequency. emCCR hold | resume emCCR [annotations="string"] collect | upload | getupdates emCCR [-verbose] [-register] test emCCR register emCCR automatic_update on/off emCCR enable_target | disable_target emCCR config emCCR help
Usage: Use this command to put Oracle Configuration Manager on hold. When Oracle Configuration Manager is on hold, configuration data will not be automatically collected and uploaded to the Oracle repository. You can perform only a manual collection and upload using the $ORACLE_HOME/ccr/bin/emCCR collect command. To resume the collection of configuration data, use the emCCR resume command.
Pre-requisites:
Oracle Configuration Manager is registered with Oracle.
The Scheduler is already running and is not on hold.
Example:
Errors: Some of the error messages you may see are the following:
Access Denied - This error is displayed if you do not have the required privileges to run this command.
Oracle Configuration Manager Not Registered With Oracle - In this case, you must register Oracle Configuration Manager with Oracle.
Oracle Configuration Manager is Not Running - In this case, you must restart the Scheduler using the emCCR start command.
Oracle Configuration Manager is already on hold.
Usage: After you have installed Oracle Configuration Manager, it is automatically registered. If any of the registration information has changed, use this command to re-register Oracle Configuration Manager.
Pre-requisites: None
Example:
Errors: Some of the error messages you may see are the following:
Access Denied: This error is displayed if you do not have the required privileges to run this command.
Cannot connect to the server.
Invalid credentials specified.
Usage: Use this command to resume the automatic collection and uploading of the configuration data.
Pre-requisites:
Oracle Configuration Manager is registered with Oracle.
Oracle Configuration is on hold.
The Scheduler is already running.
Example
$ORACLE_HOME/ccr/bin/emCCR resume Oracle Configuration Manager - Release: 10.2.4.0.0 - Production Copyright (c) 2005, 2006, Oracle. All rights reserved. ---------------------------------------------------------------- Oracle Configuration Manager Resumed.
Errors: Some of the error messages you may see are the following:
Access Denied: This error is displayed if you do not have the required privileges to run this command.
Oracle Configuration Manager Not Registered with Oracle: In this case, you must register Oracle Configuration Manager with Oracle.
Oracle Configuration Manager is not on hold.
Oracle Configuration Manager is Not Running - Restart the Scheduler using the emCCR start command.
Usage: Use this command to define the schedule to collect configuration data. Configuration data can be collected daily, weekly, or monthly. If configuration data is collected daily (FREQ=DAILY), you can specify the hour (BYHOUR) and the minute (BYMINUTE) at which the collection is to be performed. If the frequency is weekly, you can specify the day of the week (BYDAY=[MON|TUE|WED|THU|FRI|SAT|SUN]) and the time (BYHOUR and BYMINUTE) at which the data is to be collected. If the frequency is monthly, you can specify the date [BYMONTHDAY=1 to 31] and the time (BYHOUR and BYMINUTE) at which the collection is to be performed.
$ORACLE_HOME/ccr/bin/emCCR set collection_interval= "[FREQ=MONTHLY|WEEKLY|DAILY] [; BYMONTHDAY=1 to 31, when FREQ is MONTHLY] [; BYDAY=MON to SUN, when FREQ is WEEKLY] [; BYHOUR=0 to 23] [; BYMINUTE=0 to 59]"
Note:
Configuration data is collected only if the Scheduler has been started. By default, configuration data is collected DAILY at the time Oracle Configuration Manager was installed.
The BYHOUR and BYMINUTE parameters can be used with all frequencies.
If the frequency is set to MONTHLY, and the month does not include the value of the MONTHDAY, configuration data will not be collected for that month.
You can verify the collection interval and the collection time by using the emCCR status command.
Pre-requisites:
Oracle Configuration Manager is registered with Oracle.
The Scheduler is already running.
Example: Enter the command to specify that configuration data is to be collected on the fourth day of the month at 11.30 pm.
$ORACLE_HOME/ccr/bin/emCCR set collection_interval="FREQ=MONTHLY;BYMONTHDAY=4;BYHOUR=23;BYMINUTE=30"Oracle Configuration Manager - Release: 10.2.4.0.0 - ProductionCopyright (c) 2005, 2006, Oracle. All rights reserved.----------------------------------------------------------------Collection interval set successfully.
Errors: Some of the error messages you may see are:
Access Denied - This error is displayed if you do not have the required privileges to run this command.
Oracle Configuration Manager Not Registered With Oracle - In this case, you must register Oracle Configuration Manager with Oracle.
Usage errors such as mismatched options are also returned.
Usage: Use this command to start the Scheduler.
Pre-requisites: You can use this option only if Oracle Configuration Manager has been registered with Oracle.
Example:
$ORACLE_HOME/ccr/bin/emCCR startOracle Configuration Manager - Release: 10.2.4.0.0 - ProductionCopyright (c) 2005, 2006, Oracle. All rights reserved.----------------------------------------------------------------Starting Oracle Configuration Manager...Waiting for status from Oracle Configuration Manager....Start Date 01-Aug-2006 07:29:05Last Collection Time 11-Jul-2006 11:17:14Next Collection Time 01-Aug-2006 11:12:00Collection Frequency Daily at 11:12Collection Status idleLog Directory /u01/app/oracle/product/10.1.0/database/ccr/logOracle Configuration Manager successfully started.
Errors: Some of the error messages you may see are:
Access Denied - This error is displayed if you do not have the required privileges to run this command.
Oracle Configuration Manager Not Registered With Oracle - In this case, you must register Oracle Configuration Manager with Oracle.
Oracle Configuration Manager is Already Running - In this case, the Scheduler has already been started. No action is required.
Registration failure errors
Usage: Use this command to view the current status. If the automatic update feature has been disabled and mandatory packages are available on the server, a message indicating that mandatory updates are available is displayed.
Warning: Mandatory updates are available for download. AutoUpdate is currently disabled. Therefore collections will no longer be uploaded. Download the updates using emCCR getupdates or enable the automatic update feature.
Pre-requisites: None.
Example:
$ORACLE_HOME/ccr/bin/emCCR status Oracle Configuration Manager - Release: 10.2.4.0.0 - Production Copyright (c) 2005, 2006, Oracle. All rights reserved. ---------------------------------------------------------------- Start Date 11-Jul-2006 07:51:18 Last Collection Time 11-Aug-2006 11:17:14 Next Collection Time 11-Sep-2006 11:12:00 Collection Frequency Daily at 11:12 Collection Status idle Log Directory /u01/app/oracle/product/10.1.0/database/ccr/log Registered At 11-Jul-2006 11:13:00 Automatic Update On Collector Mode Connected
Note:
If there is a mismatch between the Oracle Configuration Manager PL/SQL script installed in the database and the version present in the
collectconfig, collectemrep, and ebs_collectconfig scripts, the following error is displayed:
WARN: The CCR database objects are not in sync with the CCR configuration collection scripts. Refer to the Installation and Configuration documentation on reloading the SQL collection packages. SID Script ---- ----- orcl1013 collectconfig orcl1013 ebs_collectconfig
You must re-run the installCCRSQL script specifying the script that has been updated.
Errors: Some of the error messages you may see are the following:
Access Denied: This error is displayed if you do not have the required privileges to run this command.
Usage: Use this command to stop the Scheduler. When the Scheduler has been manually stopped, if the system is rebooted, the Scheduler is not restarted automatically. You must start it manually using the emCCR start command. If you run the emCCR stop command when a data collection or another command is in progress, a stop pending message is displayed. Once the command in progress is completed, the Scheduler will be stopped.
Prerequisites: You can use this option only if the Scheduler is already running.
Example:
$ORACLE_HOME/ccr/bin/emCCR stopOracle Configuration Manager - Release: 10.2.4.0.0 - ProductionCopyright (c) 2005, 2006, Oracle. All rights reserved.----------------------------------------------------------------Oracle Configuration Manager Stopped...
Errors: Some of the error messages you may see are:
Access Denied - This error is displayed if you do not have the required privileges to run this command.
Oracle Configuration Manager Not Registered With Oracle - In this case, you must register Oracle Configuration Manager with Oracle.
Oracle Configuration Manager is Not Running - Restart the Scheduler using the emCCR start command.
Usage: Use this command to test the connection to the server at Oracle. If you specify the -register option, the client will be registered during the test. The -verbose option displays detailed information about the connection process. Both -register and -verbose arguments are optional.
Pre-requisites: Oracle Configuration Manager is registered with Oracle.
Example:
$ORACLE_HOME/ccr/bin/emCCR -register test Oracle Configuration Manager - Release: 10.2.4.0.0 - Production Copyright (c) 2005, 2006, Oracle. All rights reserved. ------------------------------------------------------------- Verifying Proxy settings... No Proxy host set. Oracle Configuration Manager Server is: ccr.oracle.com Resolving Oracle Configuration Manager Server address... Connecting to Oracle Configuration Manager server... Registering with Oracle Configuration Manager server... Command successfully completed. $ORACLE_HOME/ccr/bin/emCCR -verbose test Oracle Configuration Manager - Release: 10.2.4.0.0 - Production Copyright (c) 2005, 2006, Oracle. All rights reserved. -------------------------------------------------------------Verifying Proxy settings... {main} [08:28:04.761] Conn: added module HTTPClient.RetryModule {main} [08:28:04.771] Conn: added module HTTPClient.CookieModule {main} [08:28:04.776] Conn: added module HTTPClient.RedirectionModule {main} [08:28:04.782] Conn: added module HTTPClient.AuthorizationModule {main} [08:28:04.783] Conn: added module HTTPClient.DefaultModule {main} [08:28:04.789] Conn: added module HTTPClient.TransferEncodingModule {main} [08:28:04.794] Conn: added module HTTPClient.ContentMD5Module {main} [08:28:04.796] Conn: added module HTTPClient.ContentEncodingModule No Proxy host set. Oracle Configuration Manager Server is: ccr.oracle.com Resolving Oracle Configuration Manager Server address... Connecting to Oracle Configuration Manager server... {main} [08:28:05.103] Conn: Creating Socket: ccr.oracle.com:443 {main} [08:28:05.112] Conn: using SSL version JSSE {main} [08:28:05.140] Demux: Initializing Stream Demultiplexor (6915075) {main} [08:28:05.792] Conn: Sending Request: GET /em/upload HTTP/1.1 Host: ccr.oracle.com Connection: Keep-Alive, TE TE: trailers, deflate, gzip, compress User-Agent: RPT-HTTPClient/0.3-3 Accept-Encoding: gzip, x-gzip, compress, x-compress {main} [08:28:05.804] Demux: Opening stream 18929195 for demux (6915075) {main} [08:28:05.804] Conn: Request sent {main} [08:28:05.804] Resp: Reading Response headers 18929195 {main} [08:28:05.805] Resp: Parsing Response headers from Request "GET /em/upload": (18929195) HTTP/1.1 200 OK Date: Tue, 01 Aug 2006 15:28:05 GMT Server: Oracle-Application-Server-10g/10.1.2.0.2 Oracle-HTTP-Server Content-Length: 170 Cache-Control: private Keep-Alive: timeout=15, max=100 Connection: Keep-Alive Content-Type: text/html {main} [08:28:05.808] Resp: Response entity delimiter: Content-Length (18929195) {main} [08:28:05.808] Conn: Protocol Version established: HTTP/1.1 Command successfully completed.
Errors: Some of the error messages you may see are the following:
Access Denied: This error is displayed if you do not have the required privileges to run this command.
Cannot connect to the server.
Proxy server information is incorrect.
Proxy server is not available.
For other registration errors, refer to the error messages listed under the emCCR register command.
Usage: Use this command to upload the configuration data to the Oracle repository.
Pre-requisites:
Oracle Configuration Manager is registered with Oracle.
Configuration data must have been collected but not uploaded.
The Scheduler is already running.
Example:
$ORACLE_HOME/ccr/bin/emCCR upload Oracle Configuration Manager - Release: 10.2.4.0.0 - Production Copyright (c) 2005, 2006, Oracle. All rights reserved. ---------------------------------------------------------------- Upload Done.
Errors: Some of the error messages you may see are the following:
Access Denied: This error is displayed if you do not have the required privileges to run this command.
Oracle Configuration Manager Not Registered with Oracle: In this case, you must register Oracle Configuration Manager with Oracle.
Mandatory update available. Command failed.
Cannot connect with the server.
Handshake failure. You must register Oracle Configuration Manager.
Oracle Configuration Manager is Not Running - Restart the Scheduler using the emCCR start command.
Usage: Use this command to modify the configuration information using the command line interface. Using this command, you can modify the proxy server information, CSI, MetaLinkUserName and Country Code after Oracle Configuration Manager has been installed.
configCCR -p <proxy | none> <CSI> <MetaLinkeUserName> <Country Code>
The -p is an optional parameter and is used to specify the proxy server information needed to connect to the Internet. This parameter is used for the host, port and authentication information of the proxy server. If you specify this parameter and enter none, the existing proxy server information will be cleared. For more information on -p parameter, refer to the Installing Oracle Configuration Manager Using the Command Line Interface section.
The CSI, MetaLinkUserName and Country Code are optional. All parameters can be specified on the command line. Any parameters not specified will be prompted for and existing values (if any) will be displayed. After you specify the parameters, registration will be performed. If the registration fails, the original values of these parameters will be used by default.
Pre-requisites: None
Example:
configCCR The installation requires the following piece(s) of information. Customer Support Identifier (CSI): [123456] Oracle MetaLink User Name: [customer@customercorp.com] cust@customercorp.com The two character country code: [us]
Errors: Some of the error messages you may see are the following:
Failure in registering with Oracle Configuration Manager server. Invalid credentials specified
