man pages section 1M: System Administration Commands

Exit Print View

Updated: July 2014
 
 

emCCR(1M)

Name

emCCR - configure data collection for OCM

Synopsis

/usr/lib/ocm/ccr/bin/emCCR [automatic_update on|off]
     [clear -diagnostic[=SR= n[,FILE=path] [-c completed] [-f force]]
     [[-annotation="annotation string"] collect]
     [enable_diagchecks | disable_diagchecks]
     [enable_target | disable_target] [getupdates] [help] [hold]
     [register] [resume] [set collection_interval="string"] [start]
     [status [-diagnostic[=SR=n[,FILE=path]]]] [stop]
     [[-register] [-verbose] test]
     [update_components [[-silent] -staged_dir="dir"| -distribution"name"]]
     [upload -diagnostic=SR=n,FILE=path [-restart] [-force]]

Description

The emCCR utility is used to configure the collection of data for the Oracle Configuration Manager (OCM). emCCR is implemented as a set of subcommands, with options to those subcommands.

Sub Commands

The following options are supported:

emCCR automatic_update [on|off]

Enable or disable the automatic retrieval of new software updates from automatic collections. By default, automatic updates are enabled.

emCCR clear –diagnostic
clear –diagnostic

Clears all diagnostic upload files.

clear –diagnostic=SR=x-y

Clears all uploads for a particular service request. The SR number must be in the format x-y where:

x

represents one digit

y

represents multiple digits

clear –diagnostic=SR=x-y,FILE=path

Clears a particular upload. path must include the full path to the diagnostic package, such as /scratch/test/support_info.zip.

clear –diagnostic –completed

Clears completed uploads only.

clear –diagnostic=SR=x-y,FILE=path –completed

Clears completed uploads for a particular service request. If FILE=path is added, only the upload for that instance is cleared.

clear –diagnostic –force

Clears all uploads even if there are errors.

clear –diagnostic=SR=x-y,FILE=path –force

Clears all uploads for a particular service request. If FILE=path is added, only the upload for that instance is cleared.

emCCR collect

In connected mode, this command will perform an immediate discovery, collection, and uploading of configuration data. In disconnected mode, this command will perform a manual discovery and collection of configuration data. The data is stored in:

...  /ccr/state/upload/ocmconfig.jar
–annotation=”string

Adds a note, consisting of ”string”, to the data collected.

emCCR [enable_diagchecks | disable_diagchecks]

Use this command to enable or disable all diagnostic checks collections.

emCCR [enable_target | disable_target]

Use this command to enable or disable the collection of configuration information for targets discovered by the Oracle Configuration Manager. When you enter this command, the list of targets that can be enabled or disabled is displayed. Enter the number for the target that is to be enabled or disabled. If you press Return without entering a target number no enabling or disabling occurs.

emCCR getupdates

Use this command to retrieve any new software updates from the content server and deploy these updates.

emCCR help

Use this command to list the available options.

emCCR hold

Use this command to put Oracle Configuration Manager on hold. When in hold, configuration data will not be automatically collected and uploaded to the Oracle repository. You can manually collect and upload the information with the collect command. To restart the collection of data, use the resume command.

emCCR register

Use this command to reregister any information that has changed.

emCCR resume

Use this command to resume the automatic collection and uploading of the configuration data.

emCCR set collection_interval=string

Use this command to define the schedule to collect configuration data. By default the collection is daily at the time the collector was first configured. The data can be collected daily, weekly, monthly or the time of collection can be changed as defined by string where:

FREQ=DAILY[\;BYHOUR=0-23][\;BYMINUTE=0 to 59]

Selects daily collections. You can optionally set the hour and minute to do the collection.

FREQ=WEEKLY\;BYDAY=MON to SUN [\;BYHOUR=0-23][\;BYMINUTE=0 to 59]

Selects weekly collections. You can optionally set the day, hour and minute to do the collection.

FREQ=MONTHLY\;BYMONTHDAY=1 to 31 [\;BYHOUR=0-23][\;BYMINUTE=0 to 59]

Selects monthly collections. You can optionally set the date, hour and minute to do the collection.

[\;BYHOUR=0-23][\;BYMINUTE=0 to 59]

Selects a new time to collect the data. The frequency will not be changed.

emCCR start

Use this command to start the scheduler.

emCCR status [–diagnostic]
status

Reports the status of the collector.

status –diagnostic

Reports the status of all diagnostics uploads.

status –diagnostic=SR=x-y

Reports all uploads for a particular service request. The SR number must be in the format x-y where:

x

represents one digit

y

represents multiple digits

status –diagnostic=SR=x-y,FILE=path

Reports a particular upload. path must include the full path to the diagnostic file.

emCCR stop

Use this command to stop the scheduler.

emCCR [–register] [–verbose] test

Use this command to test the connection to the server at Oracle, where:

–register

Specifies that the client will be registered during the test.

–verbose

Selects to display detailed information about the connection process.

emCCR update_components

Use this command to deploy any updates to the Oracle Configuration Manager client and to deploy the Diagnostic Check package.

[–silent] –staged_dir=”dir

Specifies the directory in which the Oracle Configuration Manager packages have been staged.

–silent

Specifies that no output be displayed to screen.

[–silent] –distribution=”path

Specifies the path to the Oracle Configuration Manager Kit to be used for deployment.

–silent

Specifies that no output be displayed to screen.

emCCR upload –diagnostic
upload –diagnostic=SR=x-y,FILE=path

Uploads diagnostic information for a particular instance. The SR number must be in the format x-y where:

x

represents one digit

y

represents multiple digits

The path must include the full path to the diagnostic file.

upload –diagnostic=SR=x-y,FILE=path –restart

Continues the upload for a particular service request. If FILE=path is added, only the upload for that instance is done.

upload –diagnostic=SR=x-y,FILE=path –force

Restarts the upload for a particular service request. If FILE=path is added, only the upload for that instance is done.

Files

/var/ocm

Directory to store all OCM related files and data.

/var/ocm/ccr/config

Contains configuration files.

/var/ocm/ccr/log

Contains log files.

/var/ocm/ccr/state

Contains state files and collected data.

/var/ocm/ccr/state/review/targetMap.xml

Summaries of the data that was collected.

/var/ocm/ccr/state/review

Data that was collected by the OCM.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
SUNWocm

See also

configCCR(1M), emocmrsp(1M), attributes(5)

Oracle Configuration Manager Installation and Adminstration Guide