The enterprise manager command line interface2
Upcoming SlideShare
Loading in...5

Like this? Share it with your network


The enterprise manager command line interface2

Uploaded on

EM CLI Slides from Redgate Webinar, Dec. 12th, 2012. Webinar is available

EM CLI Slides from Redgate Webinar, Dec. 12th, 2012. Webinar is available

  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Be the first to comment
    Be the first to like this
No Downloads


Total Views
On Slideshare
From Embeds
Number of Embeds



Embeds 0

No embeds

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

    No notes for slide


  • 1.  Kellyn Pot’Vin, Westminster, Colorado Oracle ACE, Sr. Technical Specialist at Enkitec Finishing up EM12c book and starting EM CLI book Specialize in performance and management of large enterprise environments. Board of directors for RMOUG, Director of Training Days 2013, KSCOPE DB Track Lead 2013 Blog: Twitter: @DBAKevlar
  • 2.  What to Include? What to Exclude? What are the most important areas of the EM CLI? What commands are best covered to create the best educational introduction to the topic?
  • 3.  Enterprise Manager Command Line Interface History How EM12c has changed level of knowledge requirements for the administrator The Command Line Interface Basics Enterprise Manager commands EM CLI Procedure Scripting
  • 4.  Introduced in Oracle 9i with very limited use. Access to EM functionality from text based consoles. Ability to incorporate scripts, including SQL*Plus, Perl, Shell, Python, etc. Fully integrated as part of the EM environment, including same security. Ability to simplify multi-target tasks through command line interface.
  • 5.  Create Jobs, schedule jobs, delete jobs Administer groups, members, targets Administer users and credentials. Upload patches, delete patches-create patch plans. Execute host and sql commands. Get information about all targets, monitoring. Over 30 verb “groups” and 250 commands that I have documented “so far”.
  • 6.  EM CLI Login- Online or Offline? “Verbs” grant the administrator initial commands for the interface. May Require one or more arguments. Can utilize a argument file, aka properties file. Syntax often changes with version of Enterprise Manager. emcli help <verb>
  • 7.  The Command Line must be logged into for the first time before commands will be accepted, (login dependent upon EM security time out feature or connection mode.)emcli login –username=<username> Syncronize the EMCLI with the OMS:emcli sync
  • 8.  Check connection mode, if complete, then offline the EM CLIemcli get_connection_modeemcli set_connection_mode -mode="offline“emcli get_jobsSet back to online mode if wanting to proceed.
  • 9. emcli<verb>1st_argument[-name, -procedure, -instance, -guid, -argfile, -input_file, -type, -targets, -action…] = <value>2nd_argument [-xml, -tailLength, -info, -analyze, -grants, -scheduler, -notification] =<value>
  • 10.  Redirection example of output, (similar to Unix):emcli get_procedure_xml –procedure=“PROC_GUID” >test_proc.xml
  • 11.  get_resolution_states - Incident Information stop/start_agent - Manage Agents create/stop_blackout - Manage Blackouts clone_database_home - Clone home execute_sql - Execute SQL get_jobs - Get a list of jobs clear_stateless_alerts - Clears stateless alerts Argfile: File of verbs to execute from the emcli.
  • 12.  EM CLI for EM12c support › Checking Incidents › Retrieve Targets Monitored › Retrieve Agent Properties › Agent Deployment › Platform support › Creating/Stopping Blackouts › Executing Host Commands
  • 13. emcli get_resolution_states
  • 14.  What database targets are being monitored, both single instance and RAC?emcli get_targets -targets="%database%"
  • 15. emcli get_supported_platforms
  • 16. emcli get_agentimage -destination=/home/oracle -platform="Microsoft Windows x64(64-bit)" –version=""
  • 17. emcli get_targetsemcli delete_target –name="<trg_nm>“emcli import_update –file="file_nm" –omslocalemcli deploy_plugin_on_server -plugin=oracle.sysman.db –sys_password=<passwd>emcli deploy_plugin_on_agent –plugin="oracle.sysman.db" –agent_name="<dbname>:<port>"
  • 18. emcli set_credential -target_type=oracle_database -target_name="<preferred_nm>"-credential_set=DBCredsMonitoring -user=sysman-column="Role:SYSDBA;UserName:sys;password:<passwd>"-monitoring
  • 19.  Save off Templates Inventory Existing Jobs Create secure credentials for targets Create administrator groups to ease administration. Reuse templates, post creating first one, easy updates!
  • 20. emcli create_blackout -name="LinuxPatch 120612" -reason="Needs to beDone" -add_targets="emrep12:oracle_database" -schedule="duration::60“How fast could you blackout entireenvironment for maintenance window withthis scripted?
  • 21. Simply state the name of the blackout andthe agent will issue a stop to the OMS:emcli stop_blackout-name="Linux Patch 120612“How quickly could you end a blackout ofenvironment post maintenance?
  • 22. emcli execute_hostcmd –cmd=“ls -ltr/home/oracle”-credential_set_name=“HostCredsPriv”-targets=“<host>.com:host”
  • 23.  Simplify management of large number of targets with simple script vs. multiple steps through EM12c console. This simplicity includes creating, managing, editing and purging of jobs and patching job tasks. Retain EM12c security and single console monitoring if required.
  • 24.  Need to verify job informationemcli get_jobs
  • 25. emcli get_job_execution_detail -execution=C07388B855B44C38B5953B8C3C7C6A5E -xml
  • 26.  Assumption is that patches are downloaded via EM12c. Process: › Verify Patch Available. › Create Patch Plan › Schedule Patches in Patch Plan › Deploy Patch Plan
  • 27.  list_aru_languages -- List ARU Language information. list_aru_platforms -- List ARU platform information. list_aru_products -- List ARU Product information. list_aru_releases -- List ARU Release information. list_patch_plans -- List existing Patch Plans. search_patches -- Search patches from ARU site or Software
  • 28. emcli search_patches-patch_name="patch number"-platform="platform id“emcli search_patches–patch_name=“5875660” (BIPublisher)–platform=“233” (Windows 64 bit)
  • 29.  Multi-step, multi-tasked or chained scripting through the EM CLI. Ability to execute SQL, Perl, OS Commands from one procedure. Ability to use properties file to simplify work and reuse with other procedures. EM Console access through Job Activity Interface.
  • 30. emcli submit_procedure-name=<Procedure Name>-input_file="<data:path to file>"-instance_name="<ProcedureInstance>"-schedule=start_time:yyyy/mm/ddHH:mm;
  • 31. emcli submit_procedure -input_file=data:data.xml -procedure=3D7F4D139E70453CB56D7621BB56D390-schedule="start_time:2012/12/0321:00; tz:America/Central" -grants="KPOTVIN:VIEW_JOB;SYSMAN:FULL_JOB" -notification="action required,failed"
  • 32.  Create a template to use for your new properties file, sourced from a procedure definition. Fill in all pertinent information for the target lists. Submit the procedure, using the properties file as part or whole of the entry at the command line. Verify all was successful.
  • 33. emcli get_procedures –type=DBPROVExample Output$>BFC71D3485629B93E04014AC08001B7D, DBPROV, DBREPLAYCLIENTDP_NG,Provision Oracle Database Client,6.2, ORACLEBFC71D3485599B93E04014AC08001B7D,DBPROV, SIHA_SIDB_PROC, ProvisionOracle Database, 1.1, ORACLE
  • 34. Using the GUID, (or the procedure<NAME>, we can then generate aproperties file template:emcli describe_procedure_input –procedure=BFC71D3485629B93E04014AC08001B7D >$> Verifying parameters…$>
  • 35. Edit the new template properties file andadd the new values for the following:$ vi Source and Reference Host Data Agent Info Oracle Home Credentials
  • 36. emcli submit_procedure –name=test_dbrpl_job-owner=sys_jobs-procedure= C23E10B1F427B4EEE040578CD74442G4-input_file=/u01/emjobs/emcli/"action required, failed"-grants=“KPOTVIN:VIEW_JOB; SYSMAN:FULL_JOB"-schedule= "start_time:2012/12/06 01:00:00;tz:America/Denver"
  • 37. emcli get_instance_status -instance=C23E10B1F427B4EEE040578CD74442G4 -details -showJobOutputOutput:C23E10B1F427B4EEE040578CD74442G4, test_job, test_job, SUCCESSFUL
  • 38. Rob Zoeteweij, Patching with EM12c Leturgez, Useful EMCLI Commands Schneider, The EM CLI
  • 39. http://enkitec.com