This chapter describes how to reconfigure Enterprise Manager if you later revisit your configuration decisions after you have installed the software.
This chapter contains the following sections:
The following sections describe reconfiguration and tuning changes you can make to the Management Agent after you have installed Enterprise Manager. Refer to the following sections for more information:
Configuring the Management Agent to Use a New Management Service
Controlling the Amount of Disk Space Used by the Management Agent
When you install the Management Agent on a managed host, you associate the Management Agent with a particular Management Service. The Management Agent uses the Management Service URL address and port to identify and communicate with the Management Service.
After you install the Management Agent, you can later reconfigure the Management Agent so it is associated with a different Management Service. Reconfiguring the Management Agent requires no changes to the Management Service. The reconfigured Management Agent will begin communicating with the new Management Service after the Management Agent is restarted.
To associate the Management Agent with a new Management Service after you have installed the Management Agent:
Stop the Management Agent.
Locate the emd.properties
file in the Management Agent home directory:
AGENT_HOME/sysman/config/emd.properties
Use a text editor to open the file and locate the REPOSITORY_URL property.
Modify the value for the REPOSITORY_URL
property so it references the new Management Service.
For example:
REPOSITORY_URL=http://mgmthost2.acme.com:4889/em/upload
Modify the value for the emdWalletSrcUrl
and emdWalletDest
properties so they reference the new Management Service and the new Oracle home path, respectively:
For example, if the new Management Service is on a host called mgmthost2.acme.com
and the new Oracle home is /private/oracle/em10g
, modify the properties as follows:
emdWalletSrcUrl=http://mgmthost2.acme.com:4889/em/wallets/emd emdWalletDest=/private/oracle/em10g/sysman/config/server
Save your changes and close the emd.properties
file.
Delete all the files in the following directories:
AGENT_HOME/sysman/emd/upload/ AGENT_HOME/sysman/emd/state/
Restart the Management Agent.
The Management Agent uses a predefined port number to receive requests from the Management Service. This port number is defined by default when you install the Management Agent on a managed host. If you later need to modify this port, you can use the following procedure. You might need to modify this port number if you have existing software that uses the default Management Agent port.
To change the Management Agent port:
Stop the Management Agent.
Locate the emd.properties
file in the Management Agent home directory:
AGENT_HOME/sysman/config/emd.properties
Use a text editor to open the file and locate the EMD_URL property.
For example:
EMD_URL=http://managed_host1.acme.com:1813/emd/main
Modify the port number in the EMD_URL property so the Management Agent uses a new unused port on the managed host.
For example:
EMD_URL=http://managed_host1.acme.com:1913/emd/main
Start the Management Agent.
Oracle designed the Management Agent to work within a set of disk space limits. These limits prevent the Management Agent from using too much disk space and causing performance or resource issues on your enterprise systems. However, if disk space becomes an issue, you can adjust the default settings that are used to control the amount of disk space used by the Management Agent.
As the Management Agent on a particular host gathers management data about the targets on the host, it saves the collected data on the local disk until the data is uploaded to the Management Repository. The Management Agent saves this collected data and metadata in the following directory:
AGENT_HOME/sysman/emd/upload
By default, the Management Agent will save up to 50MB of collected data in the upload directory. If the amount of collected data exceeds 50MB, data collection is stopped temporarily until the data is uploaded to the repository and more disk space becomes available.
In addition, the Management Agent checks to be sure that the percentage of disk space currently in use on the local disk does not exceed 98 percent. If this value is exceeded, the Management Agent stops collecting data and stops saving information to the Management Agent log and trace files.
You can modify these default settings as follows:
Stop the Management Agent.
Locate the emd.properties
file in the Management Agent home directory:
AGENT_HOME/sysman/config/emd.properties
Use a text editor to open the file and modify the entries shown in Table 12-1.
Save your changes and exit the file.
Restart the Management Agent.
Table 12-1 Properties for Controlling the Disk Space Used by the Management Agent
Property | Explanation |
---|---|
Use this property in the |
|
Use this property in the The Management Agent will begin collecting data again when the percentage of disk space in use falls to less than the percentage specified in the |
The Management Agent is the Enterprise Manager component that gathers the data you need to manage your enterprise efficiently. As a result, Enterprise Manager includes software that keeps track of the Management Agent processes and makes sure the Management Agent stays running.
For example, if the Management Agent quits unexpectedly, this self-monitoring process—referred to as the watchdog process—will restart the Management Agent automatically.
In most situations, the watchdog process works in the background and requires no configuration or maintenance. The watchdog process is controlled by the emwd.pl
script located in the following directory of the Management Agent home directory:
AGENT_HOME/bin
You can identify the watchdog process by using the following commands:
$PROMPT> ps -ef | grep emwd
In today's global economy, it is not uncommon for the systems you manage to reside in multiple locations throughout the world. For example, if your company headquarters are in New Hampshire, USA, you may need to manage systems that reside in California, Canada, and in Europe.
As Enterprise Manager collects monitoring data from Management Agents running on these remote systems, it is important that the data is correlated accurately. A software failure on a machine in Ontario, Canada might be the cause of a performance problem on a machine in Hoboken, New Jersey.
To correlate this data, it is important that Enterprise Manager obtains the correct time zone for each Management Agent that you install. The following sections describe how the Management Agent obtains the time zone and how to correct the problem if the time zone for a Management Agent is incorrect:
Understanding How the Management Agent Obtains Time Zone Information
Resetting the Time Zone of the Management Agent Due to Inconsistency of Time Zones
When you install the Management Agent, the software attempts to obtain the current time zone of the host computer. If successful, the installation procedure updates the agentTZRegion
property setting in the following configuration file:
AGENT_HOME/sysman/config/emd.properties
The agentTZRegion
property can be set to any of the values listed in the following file, which is installed in the Management Agent home directory:
AGENT_HOME/sysman/admin/suportedtzs.lst
You need to reset the time zone of the Management Agent when both of the following situations are true:
The Management Agent has been running with a particular time zone
Subsequently a change occurs to the time zone of the host where the Management Agent is running
To propagate the time zone change to the emd.properties
file, perform the following:
Execute the following script:
ORACLE_HOME/bin/emctl reseTZ agent
This script updates ORACLE_HOME/<hostname>_<sid>/sysman/config/emd.properties
so that the value of agentTZRegion
matches that of the current time zone setting of the machine.
Note:
The location of theemd.properties
file depends on the Control Console being used:
For the Database Control Console, the location is usually: ORACLE_HOME/<host>_<sid>/sysman/config
For the Application Server Control Console, the location is: ORACLE_HOME/sysman/config
For the Grid Control Management Agent, the location is ORACLE_HOME/sysman/config
For the Real Application Cluster central Management Agent, the location is usually: ORACLE_HOME/<host>/sysman/config
In addition, this command prompts you to run a script against the Enterprise Manager Repository. You must log in to the database as the Enterprise Manager repository user and run the script mgmt_target.set_agent_tzrgn
. An example follows:
SQL> exec mgmt_target.set_agent_tzrgn('em.oracle.com:1830','PST8PDT'); SQL> commit; SQL> exit
em.oracle.com:1830
represents the name of the emd target.
Sometimes, during the Management Agent installation, the time zone detected by the Management Agent configuration tool is not recognized by the Management Agent. In other words, the time zone obtained by the configuration tool is not listed in the Management Agent list of supported time zones.
This problem prevents the Management Agent from starting and results in an error similar to the following:
Could not determine agent time zone. Please refer to the file:
ORACLE_HOME/sysman/admin/supportedtzs.lst and pick a timezone region with a
standard offset of +5:0 from GMT and update the property 'agentTZRegion' in the
file: ORACLE_HOME/sysman/config/emd.properties
This error appears in one of the log files shown in Table 12-2, depending upon which Enterprise Manager product you are using.
Table 12-2 Location of Time Zone Error in the Enterprise Manager Log Files
If you are using... | Look for the Time Zone Error in This File... |
---|---|
Grid Control Console |
|
Application Server Control Console |
|
Database Control Console |
|
See Also:
"Locating and Configuring Management Agent Log and Trace Files" for more information about the Management Agent log filesTo configure the Management Agent to use a valid time zone:
Enter the following command in the Management Agent home directory to identify the time zone currently being used by the host computer:
AGENT_HOME/bin/emctl config agent getTZ
Note the time zone that is returned by the emctl config agent getTZ
command.
This is the time zone of the host computer.
Use a text editor to open the following file in the Management Agent home directory:
AGENT_HOME/sysman/admin/supportedtzs.lst
This file contains a list of all the time zones supported by the Management Agent.
Browse the contents of the supportedtzs.lst
file and note the supported time zone closest to the time zone of the host computer.
Use a text editor to open the following Management Agent configuration file:
AGENT_HOME/sysman/config/emd.properties
Locate the following property near the end of the emd.properties
file:
agentTZRegion=
Set the value of this property to the time zone you identified as closest to the host time zone in the supportedtzs.lst
file.
For example:
agentTZRegion=Europe/Warsaw
Save your changes and close the emd.properties
file.
You should now be able to start the Management Agent without generating the error in the log file.
Section 12.1.5.3 describes how to correct potential problems that result when the Management Agent cannot determine the proper time zone. Similar problems can occur when the Management Agent finds the correct time zone, but the time zone is not recognized by the Management Service or the database where the Management Repository resides.
When the Management Service does not recognize the time zone established by the Management Agent, Enterprise Manager generates the following error:
OMS does not understand the timezone region of the agent. Either start the OMS using the extended list of time zones supported by the database or pick a value of time zone from ORACLE_HOME/emdw/sysman/admin/nsupportedtzs.lst, update the property 'agentTZRegion' in the file ORACLE_HOME/sysman/config/emd.properties and restart the agent. A value which is around an offset of -05:00 from GMT should be picked.
This error appears in one of the log files shown in Table 12-2, depending upon which Enterprise Manager product you are using.
There are two ways to correct this problem:
Restart the Management Repository database using the more extensive list of time zones in the timezlrg.dat
database configuration file, and then start the Management Agent.
See Also:
"Specifying the Database Time Zone File" in the Oracle Database Administrator's GuideSpecify a new time zone for the Management Agent that the Management Repository database will recognize.
See Also:
"Troubleshooting Management Agent Time Zone Problems" for instructions on changing the time zone assigned to the Management AgentFor Application Server components such as Oracle Portal to run on a secure sockets layer (SSL), the appropriate security certificate must be added to the Management Agent configuration files.
Perform these steps to add the relevant security certificate:
Obtain the certificate, which is in Base64encoded X.509 (.CER) format, in the b64SiteCertificate.txt
file. (The file name may be different in your configuration.) An example of the contents of the file is as follows:
------BEGIN CERTIFICATE-------------- MIIDBzCCAnCgAw... ...... base 64 certificate content ..... ------END CERTIFICATE-----------------
In the Oracle Home of the Management Agent monitoring the wallet, run the following command to add the certificate to the Management Agent:
${ORACLE_HOME}/bin/mkwallet -i welcome ${ORACLE_HOME}/sysman/config/monwallet ${ORACLE_HOME}/sysman/config/b64SiteCertificate.txt NZDST_CLEAR_PTP
The following sections describe configuration changes you can make to the Management Service after you install Enterprise Manager:
Configuring the Management Service to Use a New Management Repository
Configuring the Management Service to Prompt You When Using Execute Commands
When you install and deploy the Management Service, you associate the Management Service with a Management Repository. The Management Service uses the database host, database system identifier (SID), database port, management user, and management password to identify and communicate with the Repository.
This repository information is stored in the emoms.properties
file, which can be found in the following directory where the Oracle Management Service is installed and deployed:
ORACLE_HOME/sysman/config/
The following sections describe how to modify the repository information in the emoms.properties
file and provide details about how Enterprise Manager keeps the Management Repository password secure.
To associate the Management Service with a new repository, you must modify the repository properties saved in the emoms.properties
configuration file:
Stop the Management Service.
Locate the emoms.properties
file in the following directory where you installed and deployed the Management Service:
ORACLE_HOME/sysman/config/
Edit the emoms.properties
file by updating the appropriate values for the properties described in Table 12-3.
shows sample entries in the emoms.properties
file.
Restart the Management Service.
Table 12-3 Repository Properties in the emoms.properties File
Property | Description |
---|---|
The Management Repository user name. The default value is SYSMAN. |
|
The Management Repository password. See "About Changing the Repository Password" for information of how to change the password value. |
|
emdRepConnectDescriptor |
The Management Repository Oracle Net Connect String for the repository database. The values specified for properties emdRepSID, emdRepServer, and emdRepPort must be the same as that of HOST, PORT, and SERVICE_NAME in the connect string. If this property is not specified, then emRepSID, emRepServer, and emRepPort properties are used to construct the connect descriptor. If the database hosting the repository is a RAC database, then the value must be configured as explained in "Configuring the Management Services" |
The System Identifier (SID) for the database where the Management Repository schema resides. |
|
The name of the server or host computer where the repository database resides. |
|
The port number for the repository database. |
Example 12-1 Sample Repository Properties in the emoms.properties File
oracle.sysman.eml.mntr.emdRepUser=SYSMAN oracle.sysman.eml.mntr.emdRepPwd=sysman oracle.sysman.eml.mntr.emdRepConnectDescriptor=(DESCRIPTION\=(ADDRESS_ LIST\=(ADDRESS\=(PROTOCOL\=TCP)(HOST\=system12.mycompany.com)(PORT\=1521))) (CONNECT_DATA\=(SERVICE_NAME\=oemrep1))) oracle.sysman.eml.mntr.emdRepSID=oemrep1 oracle.sysman.eml.mntr.emdRepServer=system12.mycompany.com oracle.sysman.eml.mntr.emdRepPort=1521
For security reasons, the password stored in the emoms.properties
file is encrypted as soon as you start the Management Service. To change the repository password in the emoms.properties file, use the emctl setpasswd oms
command line utility. This utility prompts you for the new password for the repository. When you press ENTER after supplying the password, the utility automatically updates the password.
To modify the repository password, do the following:
Stop the Management Service using the following command:
ORACLE_HOME/bin/emctl stop oms
Change the repository in ORACLE_HOME/sysman/config/emoms.properties by using the following command:
ORACLE_HOME/bin/emctl setpasswd oms
Restart the Management Service using the following command:
ORACLE_HOME/bin/emctl start oms
When you install the Management Service, the port number for the Management Service is automatically set to 4889. The following procedure describes how to manually change the port number after the Enterprise Manager installation. For example, you will have to modify the port number if you attempt to install two Oracle Management Services on the same host computer.
To change the default Management Service port:
Stop the Management Service.
Locate the following httpd_em.conf
file located in the following directory in the home directory where you installed and deployed the Management Service:
ORACLE_HOME/sysman/config/
Open the http_em.conf
file with a text editor and change all occurrences of 4889
to the new port number you want to use.
Save and close the http_em.conf
file.
Inform the DCM layer about the port change:
ORACLE_HOME/dcm/bin/dcmctl updateconfig -ct ohs
Locate the emoms.properties
file in the same sysman/config
directory.
Open the emoms.properties
file with a text editor and change the following entry so it references the new port number of the Management Service:
oracle.sysman.emSDK.svlt.ConsoleServerPort=4889
Restart the Management Service.
Reconfigure each Management Agent on your managed hosts to use the new management port.
To change the default Management Service port to a secure port:
Stop the Management Service using:
ORACLE_HOME/bin/emctl stop oms
Change the secure port using the following command:
ORACLE_HOME/bin/emctl secure oms -secure_port <newPortNo>
Inform the DCM layer about the port change:
ORACLE_HOME/dcm/bin/dcmctl updateconfig -ct ohs
Start the Management Service using:
ORACLE_HOME/bin/emctl start oms
The Execute Host Command and Execute SQL applications enable you to execute commands against multiple hosts and multiple databases respectively.
The default, when you click the Execute button of these applications, is for the command execution to begin immediately on the specified targets. If desired, you can set up the Management Service so that a confirmation page displays when you click the Execute button.
To enable the confirmation page for each application, perform the following:
Stop the Management Service.
Locate the emoms.properties
file where you installed the Management Service:
ORACLE_HOME/sysman/config/emoms.properties
Edit the emoms.properties
file and add the appropriate lines:
For the Execute Host Command, add the following line:
oracle.sysman.cmd.tgt.multiTarget.confirmExecuteHostCommand=true
For Execute SQL, add the following line:
oracle.sysman.cmd.tgt.multiTarget.confirmExecuteSQL=true
Note:
The text in the commands is case-sensitive.Save the changes and close the emos.properties
file.
Restart the Management Service.