Make OEM Sing and Dance with EM Command Line Interface

Transcription

1 Make OEM Sing and Dance with EM Command Line Interface

2 Oracle Technologist / DBA IOUG Volunteer SELECT Magazine Editorial Board Collaborate Conference Committee Blog: Contact: ray.smith@pgn.com

3 Setting Expectations Machine sounds and physical motion are not covered Working title: Doing the Java Polka This is a shell scripting session Enterprise Manager Command Line Interface Command line training Script functions and function libraries

4 Agenda Key terms, concepts, and architecture Step-by-step illustrations How to install EMCLI

5 OEM 12c Cloud Control OEM 12c is an entirely new product WebLogic look and feel Oracle scaleability OEM 12c installation Five OUI screens Integrated installation of OEM and WLS

6

7

8

9 EMCLI Architecture OMS is J2EE domain in WLS server Java application EMCLI is a Java application on the client side EMCLI verbs are Java plug-in extensions EMCLI OMS extension is preinstalled As a console page in the OMS Commands execute as if executed locally

10 Oracle Enterprise Manager Command Line Interface 12c Release 1 ( ) E

11 Operational Verbs

12 Administrator Verbs

13 Targets & Blackout Verbs

14 What's my target called? Target name may be fully-qualified (or not) May also be upper or lower case You need to match the repository name exactly Ask the repository for 1. Target of type oracle_database 2. Grep for your SID in its name 3. Then cut it down to just the true name

15

16 Statement Syntax Purpose emcli get_targets Lists all targets emcli get_targets -alerts emcli get_targets -targets="oracle_database Lists targets with Critical and Warning columns Lists all oracle_database targets emcli get_targets -targets="%oracle%" emcli get_targets -targets="databa%:%oracle%" Lists all targets whose type contains the string oracle Applies wildcards to list targets whose name starts with databa% and type contains %oracle% emcli get_targets -targets="database3:oracle_database" -alerts Shows status and alert information on the Oracle database named database3

17 Output Formats Named formats format="name:pretty" prints the output table in a readable format not intended to be parsed by scripts. format="name:script" sets the default column separator to a tab and the default row separator to a newline. The column and row separator strings can be specified to change these defaults. format="name:csv" sets the column separator to a comma and the row separator to a newline. User-defined formats format=column_separator:"column_sep_string" column-separates the Verb output by <column_sep_string>. Rows are separated by the newline character. row_separator:"row_sep_string" row-separates the Verb output by <row_sep_string>. Rows are separated by the tab character.

18

19 Extract the Nugget

20 Industrial Strength

21 Portable Strength

22 Call the Function by Name

23 Cloud computing is about scalability Embrace scalable processes Never customize a script for a specific database Reuse code whenever possible Make the machines do the work Take it to the next level

24 Questions emcli get_answers -accuracy= Questionable -specificity= Vague

25 Power vs Pretty 12c user interface is clear and easy to use Customize to your needs Favorites What about.. Ad hoc or scheduled blackouts Target maintenance Server-side commands

26

27

28

29

30

31

32 Blackout Scripts * * * /scripts/oem/create_blackout.sh gold * * * /scripts/refresh/restore_training_baseline.sh gold * * * /scripts/oem/end_blackout.sh gold Handy for scheduled events Refresh training database from baseline Cold backups Convenient for manual activities Save a trip to the browser

33

34 Building a Blackout Command Required fields Name of the blackout Targets Schedule Reason

35

36

37

38

39

40

41

42

43

44

45 Questions emcli get_answers -accuracy= Questionable -specificity= Vague

46 EM Administrator Maintenance Situation You ve added an OEM training database and targets Trainer wants to change the accounts weekly Requirements Delete the old users with a special role Create new ones just like the old ones Do it between 5:00 Friday and 9:00 Monday

47 3 mouse clicks

48 7 mouse clicks

49 2 mouse clicks

50 2 mouse clicks

51 1 mouse click

52 15 mouse clicks

53

54

55

56 Non-oracle HA Target Monitoring Situation Veritas Cluster Services (VCS) used for high availability Need a fail-over solution Requirements No loss in OEM monitoring Built into HA system fail-over procedures

57 Integration Example: Monitoring HA Targets OEM requires static agent installation Physical host or VM Agents do not fail over Target monitoring can be reassigned between agents Authorize another agent Transfer responsibility

58

59

60 Multiple Data Sources EMCLI tasks 1. Get monitored target list EMCTL tasks 1. List targets associated with the local agent Veritas/HA system tasks 1. Discover resources in the fail-over group

61 Aren't all targets tracked by OEM?

62 Don't I already know the agent name? >emctl config agent gettargets [agent12g1_1_newhost, oracle_home] [LSNRORCLA_vcshost.corp.dom, oracle_listener] [OraDb11g_home1_2_newhost, oracle_home] [ORCLA.WORLD, oracle_database] [newhost.corp.dom, host] [newhost.corp.dom:3872, oracle_emd]

63 To : From statement called $AGENT HAGROUP from the calling Veritas script OLD_NODE=`hastatus -summary grep ONLINE grep ${HAGROUP}` NEW_NODE=`hastatus -summary grep OFFLINE grep ${HAGROUP}` OLD_EMD=`emcli get_targets grep ${OLD_NODE} grep oracle_emd` NEW_EMD=`emcli get_targets grep ${NEW_NODE} grep oracle_emd` AGENT=`echo "-src_agent="${old_emd}" -dest_agent="${new_emd}""`

64 To / From statement called $AGENT HAGROUP passed-in from Veritas OLD_NODE=`hastatus -summary grep ONLINE grep ${HAGROUP}` NEW_NODE=`hastatus -summary grep OFFLINE grep ${HAGROUP}` OLD_EMD=`emcli get_targets grep ${OLD_NODE} grep oracle_emd` NEW_EMD=`emcli get_targets grep ${NEW_NODE} grep oracle_emd` AGENT=`echo "-src_agent="${old_emd}" -dest_agent="${new_emd}""`

65 Populate Target Lists emctl config agent listtargets grep oracle_database >${EMCTL_DB} emctl config agent listtargets grep oracle_listener >${EMCTL_LSNR} emcli get_targets grep oracle_database >${EMCLI_DB} emcli get_targets grep oracle_listener >${EMCLI_LSNR} hares -display -type Oracle grep ${HAGROUP} >${VCS_DATABASES} hares -display -type Netlsnr grep ${HAGROUP} >${VCS_LISTENERS}

66 = = $MOVING_DATABASES $MOVING_LISTENERS For monitored database targets in the emcli list from OEM repository The local emagent reports it through emctl And if the database is 'resource' in this VCS group Create an argfile Do the same thing for listeners

67 Common string values: AGENT=`echo "-src_agent="${old_emd}" -dest_agent="${new_emd}""` TARGET=`echo "-target_name=\"${thisitem}\" -target_type=\"oracle_database\""` for thisitem in `cat ${MOVING_DATABASES}`; do TARGET=`echo "-target_name=\"${thisitem}\" -target_type=\"oracle_database\""` echo "set_standby_agent ${AGENT} ${TARGET}" >>${ARGFILE} echo "relocate_targets ${AGENT} ${TARGET} -copy_from_src -force=yes" >>${ARGFILE} done

68 Argfile: Database target commands set_standby_agent -src_agent="oldhost.com:3872" \ -dest_agent="newhost.com:3872" \ -target_name="orcla" -target_type="oracle_database"; relocate_targets -src_agent="oldhost.com:3872" \ -dest_agent="newhost.com:3872" \ -target_name="orcla" -target_type="oracle_database" -copy_from_src -force=yes;

69 Argfile: Listener target commands set_standby_agent -src_agent="oldhost.com:3872" \ -dest_agent="newhost.com:3872" \ -target_name="lsnrorcla" \ -target_type="oracle_listener"; relocate_targets -src_agent="oldhost.com:3872" \ -dest_agent="newhost.com:3872" \ -target_name="lsnrorcla" -target_type="oracle_listener"-copy_from_src;

70 Run-time emcli argfile ${ARGFILE} echo "These targets are now tracked by the agent ${NEW_EMD}: " emctl config agent listtargets

71 EMCLI execution results: Success Moved all targets from oldhost.corp.dom:3872 to newhost.corp.dom:3872 Success Moved all targets from oldhost.corp.dom:3872 to newhost.corp.dom:3872 These targets are now tracked by the other agent: [agent12g1_1_newhost, oracle_home] [LSNRORCLA_vcshost.corp.dom, oracle_listener] [OraDb11g_home1_2_newhost, oracle_home] [ORCLA.WORLD, oracle_database] [newhost.corp.dom, host] [newhost.corp.dom:3872, oracle_emd]

72 Bottom Line EMCLI is another tool in your toolkit Simple, predictable, powerful & quick EMCLI isn't always the best tool When emctl does the job -- use emctl "Any tool can be the right tool"

73 Questions emcli get_answers -accuracy= Questionable -specificity= Vague

74 java -jar emclikit.jar client -install_dir=<emcli client dir> Installing EMCLI EMCLI is not pre-installed on your host targets Install emcli from emclikit.jar 12c deploys agents from OMS Leverage that capability Push to standard agent location Install and configure EMCLI during agent deployment Prerequisite: Jar file available on new host

75

76

77

78

79

80

81

82

83

84 SAVE THE DATE! COLLABORATE 13 April 7-11, 2013 Colorado Convention Center Denver, Colorado