1. 4 Copyright © 2006, Oracle. All rights reserved. Deploying the Oracle Management Agent

2. Copyright © 2006, Oracle. All rights reserved. 4 - 2 Objectives After completing this lesson, you should be able to: Describe the deployment options for the Oracle Management Agent Deploy Oracle Management Agent to your target hosts Describe the postinstallation configuration tasks

3. Copyright © 2006, Oracle. All rights reserved. 4 - 3 Deploying the Management Agent There are several options to deploying the Management Agent: Agent Deploy application NFS-mounted agent installation agentDownload script Cluster Agent installation Management Agent cloning Interactive installation using OUI Silent installation

4. Copyright © 2006, Oracle. All rights reserved. 4 - 4

5. Copyright © 2006, Oracle. All rights reserved. 4 - 5 Agent Installation: Agent Deploy Application The installation of the Management Agent by using the Agent Deploy application: Is performed through the Grid Control console Can be used for remote deployments Is used for mass-deploy installations Has several prerequisites that need to be met $./sshUserSetup.sh –hosts myhost.oracle.com -user oracle

6. Copyright © 2006, Oracle. All rights reserved. 4 - 6

7. Copyright © 2006, Oracle. All rights reserved. 4 - 7 Starting Agent Deploy Application From the Deployments tab:

8. Copyright © 2006, Oracle. All rights reserved. 4 - 8 Agent Deploy: Installation Details

9. Copyright © 2006, Oracle. All rights reserved. 4 - 9 Agent Deploy

10. Copyright © 2006, Oracle. All rights reserved. 4 - 10 Agent Installation: NFS-Mounted Agent The installation of the Management Agent using NFS-mounted agent: Is where the agent bits are shared on a Net App Filer disk Has configuration files for each host stored in the STATE directory Can have only one nfsagent installation per host

11. Copyright © 2006, Oracle. All rights reserved. 4 - 11 NFS-Mounted Agent: Installation Steps 1.Configure the shared drive so that the master host has read/write access and all other hosts (slave hosts) have read access. 2.From the master host, perform agent installation in this shared drive. 3.Stop Agent from the Oracle home. 4.From the master host and the slave hosts, execute the nfsagentinstall script.

12. Copyright © 2006, Oracle. All rights reserved. 4 - 12 Agent Installation: Downloadable Agent Script Installation of the Management Agent by using the downloadable agent script: Is used for deploying one agent at a time Is run from the target (so uses pull technology) Can be modified for specific environments Is noninteractive; silent Provides text-only output Simplifies deploying Management Agents in secure Web environments (HTTP access)

13. Copyright © 2006, Oracle. All rights reserved. 4 - 13 Preinstallation Steps for agentDownload Before executing agentDownload, perform the following steps: 1.Create the oracle operating system user and the appropriate operating system groups. 2.Ensure that wget (used by agentDownload to download the installation files) is available in the correct location. 3.Log in as the oracle operating system user. 4.Ensure that the Java program jar is available in the oracle user’s path. 5.Determine the parent directory for the installation of the Management Agent home.

14. Copyright © 2006, Oracle. All rights reserved. 4 - 14 Installation Steps for agentDownload Perform the following steps: 1.Download the agent download script, agentdownload.linux, to the target host using the management service URL (using upload port): http:// : /agent_download/ / Example: http://ex0028.us.oracle.com:4889/agent_download/10.2.0.1.0/l inux 2.Modify permission on agentdownload.linux to allow it to execute. 3.Install the agent by executing agentdownload.linux. $ chmod 755 agentDownload.linux $./agentDownload.linux –b /u01/app/oracle/product

15. Copyright © 2006, Oracle. All rights reserved. 4 - 15

16. Copyright © 2006, Oracle. All rights reserved. 4 - 16 What agentDownload Does Upon execution, agentDownload : 1.Creates necessary directories 2.Downloads the installation response file 3.Downloads a jarred OUI 4.Unjars and launches the OUI in silent mode to install the management agent 5.Discovers targets and starts the management agent

17. Copyright © 2006, Oracle. All rights reserved. 4 - 17 Agent Installation: Silent Installation Silent installation of the Oracle Management Agent requires: Grid Control product CDs An installation response file $ /stage/Disk1/runInstaller - -responseFile /home/oracle/agent.rsp - -silent doDiscovery=TRUE startAgent=TRUE

18. Copyright © 2006, Oracle. All rights reserved. 4 - 18

19. Copyright © 2006, Oracle. All rights reserved. 4 - 19 Response File Response file parameters control the installation. RESPONSEFILE_VERSION=2.2.1.0.0 UNIX_GROUP_NAME="oinstall" FROM_LOCATION="/stage/Disk1/stage/products.xml" ORACLE_HOME="/u01/app/oracle/product/agent" ORACLE_HOME_NAME="agent"... s_OMSHost="eddnr5p10.us.oracle.com" s_OMSPort="4889"...

20. Copyright © 2006, Oracle. All rights reserved. 4 - 20 Postinstallation After installing the management agent, perform the following steps: 1.Run root.sh as necessary. 2.Configure the monitoring credentials for discovered targets. $ su – Password: #./root.sh

21. Copyright © 2006, Oracle. All rights reserved. 4 - 21 Configuring Monitoring Credentials Configure monitoring credentials for discovered targets.

22. Copyright © 2006, Oracle. All rights reserved. 4 - 22 Key Configuration Files The key configuration files for the Management Agent include: –./sysman/emd/targets.xml –./sysman/config/emd.properties –./sysman/config/emagentlogging.properties The Management Agent log and trace files are located in /sysman/log/.

23. Copyright © 2006, Oracle. All rights reserved. 4 - 23 Target Discovery During target discovery: Management agents automatically discover available targets and register them with the management repository Target names must be unique for registration to succeed The Management Agent must have read permission on some application server files

24. Copyright © 2006, Oracle. All rights reserved. 4 - 24 Adding a Target Manually

25. Copyright © 2006, Oracle. All rights reserved. 4 - 25 Configuring Agent to Use a New Management Service The steps involved to associate the agent with a new Management Service are the following: 1.Stop the Management Agent. 2.Edit emd.properties to point to the new Management Service. 3.Delete files in the upload and state directories. 4.Restart the Management Agent.

26. Copyright © 2006, Oracle. All rights reserved. 4 - 26

27. Copyright © 2006, Oracle. All rights reserved. 4 - 27 Summary of Ports Assigned You can view a list of ports assigned during the installation process by viewing the contents of the portlist.ini file.

28. Copyright © 2006, Oracle. All rights reserved. 4 - 28 Custom Port Selection Ports used by Grid Control components may be customized by using a static ports file. $ /stage/Disk1/runInstaller - oracle.sysman.top.em_seed:s_staticPorts= - /home/oracle/staticports.ini

29. Copyright © 2006, Oracle. All rights reserved. 4 - 29

30. Copyright © 2006, Oracle. All rights reserved. 4 - 30 RepManager RepManager is a command-line utility that: Is mainly used by the Grid Control Installer when the “installing Grid Control w/ existing database” installation type is chosen Collects input from the user and invokes the EM repository SQL scripts Has three major functions: –Dropping repository –Creating repository –Upgrading repository

31. Copyright © 2006, Oracle. All rights reserved. 4 - 31 agentca The Agent Configuration Assistant ( agentca ) script is used to: Reconfigure the agent and rediscover targets on the host it resides on Discover new targets on the host it resides on Reconfigure a stand-alone agent to a RAC agent $ /u01/app/oracle/product/agent10g/bin/agentca –d $ /u01/app/oracle/product/agent10g/bin/agentca -f –c "node1,node2…."

32. Copyright © 2006, Oracle. All rights reserved. 4 - 32 Summary In this lesson, you should have learned how to: Describe the deployment options for the Oracle Management Agent Deploy Oracle Management Agent to your target hosts Describe postinstallation configuration tasks

33. Copyright © 2006, Oracle. All rights reserved. 4 - 33 Practice 4 Overview: Deploying the Management Agent This practice covers the following topics: Deploying the Management Agent Configuring Your Database Grid Control Case Study

34. Copyright © 2006, Oracle. All rights reserved. 4 - 34