emCCR(1M) System Administration Commands emCCR(1M)NAMEemCCR - configure data collection for OCM
SYNOPSIS
/opt/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 discov‐
ery, collection, and uploading of configuration data. In discon‐
nected mode, this command will perform a manual discovery and col‐
lection 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 collec‐
tions.
emCCR [enable_target | disable_target]
Use this command to enable or disable the collection of configura‐
tion 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 tar‐
get 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 con‐
tent 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 con‐
nection 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 Man‐
ager 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
/opt/ocm
Directory to store all OCM related files and data.
/opt/ocm/ccr/config
Contains configuration files.
/opt/ocm/ccr/log
Contains log files.
/opt/ocm/ccr/state
Contains state files and collected data.
/opt/ocm/ccr/state/review/targetMap.xml
Summaries of the data that was collected.
/opt/ocm/ccr/state/review
Data that was uploaded to the server.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWocm │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOconfigCCR(1M), emocmrsp(1M), attributes(5)
Oracle Configuration Manager Installation and Adminstration Guide
SunOS 5.10 10 Aug 2012 emCCR(1M)