2 Starting and Stopping Enterprise Manager Components

2.1.1 Starting, Stopping, and Checking the Status of the Management Agent on UNIX

To start, stop, or check the status of the Management Agent on UNIX systems:

1. Change directory to the AGENT_HOME/bin directory.

2. Use the appropriate command described in Table 2-1.

   For example, to stop the Management Agent, enter the following commands:

   $PROMPT> cd AGENT_HOME/bin
   $PROMPT> ./emctl stop agent
   

$PROMPT> ./emctl status agent
Oracle Enterprise Manager 10g Release 10.1.0.2.0
Copyright (c) 2002, 2003 Oracle Corporation.  All rights reserved.
-----------------------------------------------------------------
Version           : 10.1.0.2.0
Agent Home        : /private/oracle/EM_40_SH10/agent
Agent Process ID  : 8102
Parent Process ID : 8095
Agent URL         : http://usunnab08.us.oracle.com:1813/emd/main/
Started at        : 2003-01-29 12:11:39
Started by user   : oracle
Last Reload       : 2003-01-29 12:45:10
Last successful upload                       : 2003-01-30 11:08:27
Total Megabytes of XML files uploaded so far :    25.21
Number of XML files pending upload           :        0
Size of XML files pending upload(MB)         :     0.00
Available disk space on upload filesystem    :    76.87%
---------------------------------------------------------------
Agent is Running and Ready
$PROMPT> 

2.1.2 Starting and Stopping the Management Agent on Windows

When you install the Oracle Management Agent on a Windows system, the installation procedure creates three new services in the Services control panel.

The procedure for accessing the Services control panel varies, depending upon the version of Microsoft Windows you are using. For example, on Windows 2000, locate the Services Control panel by selecting Settings and then Administrative Tools from the Start menu.

Table 2-2 describes the Windows services that you use to control the Management Agent.

Oracle<agent_home>Agent

OracleOraHome1Agent

Oracle<oracle_home>SNMPPeerEncapsulator

OracleOraHome1PeerEncapsulator

Oracle<oracle_home>SNMPPeerMasterAgent

OracleOraHome1PeerMasterAgent

$PROMPT> <AGENT_HOME>/bin/emctl istop agent

2.1.3 Checking the Status of the Management Agent on Windows

To check the status of the Management Agent on Windows systems:

1. Change directory to the following location in the AGENT_HOME directory:

   AGENT_HOME/bin
   
   

2. Enter the following emctl command to check status of the Management Agent:

   $PROMPT> ./emctl status agent
   
   

   If the Management Agent is running, this command displays status information about the Management Agent, including the Agent Home, the process ID, and the time and date of the last successful upload to the Management Repository ().

2.2.1 Controlling the Management Service on UNIX

There are two methods for starting and stopping the Oracle Management Service on UNIX systems. You can use the Oracle Process Management and Notification (OPMN) utility, or you can use a set of emctl commands.

The following sections describe these two approaches to controlling the Management Service, as well as information about starting and stopping OracleAS Web Cache, which is also required by the Grid Control Console:

• Using OPMN to Start and Stop the Management Service

• Using emctl to Start, Stop, and Check the Status of the Oracle Management Service

• Starting and Stopping Oracle Application Server Web Cache

$PROMPT> cd opmn/bin
$PROMPT> ./opmnctl startall

$PROMPT> ./opmnctl stopall

AS_HOME/Apache/Apache

HTTP 500 - Internal server error

2.2.2 Controlling the Management Service on Windows

When you install the Oracle Management Service on a Windows system, the installation procedure creates three new services in the Services control panel.

The procedure for accessing the Services control panel varies, depending upon the version of Microsoft Windows you are using. For example, on Windows 2000, locate the Services control panel by selecting Settings and then Administrative Tools from the Start menu.

Table 2-5 describes the Windows services that you use to control the Oracle Management Service.

Oracle<oracle_home>ASControl

OracleOraHome1ASControl

Oracle<oracle_home>ProcessManager

OracleOraHome1ProcessManager

2.3.1 Starting and Stopping the Application Server Control on UNIX

To control the Application Server Control Console on UNIX systems, you use the emctl command-line utility that is available in the IAS_HOME/bin directory after you install Oracle Application Server.

To start the Application Server Control Console, change directory to the IAS_HOME/bin directory and then enter the following command:

$PROMPT> ./emctl start iasconsole

To stop the Application Server Control Console, enter the following command:

$PROMPT> ./emctl stop iasconsole

2.3.2 Starting and Stopping the Application Server Control on Windows

To start or stop the Application Server Control on Windows systems:

1. Open the Services control panel.

   For example, on Windows NT, select Start > Settings > Control Panel and then double-click the Services icon.

   On Windows 2000, select Start > Administrative Tools > Services.

2. Locate the Application Server Control in the list of services.

   The name of the service is usually consists of "Oracle," followed by the name of the home directory you specified during the installation, followed by the word "ASControl." For example, if you specified AS10g as the Oracle Home, the Service name would be:

   OracleAS10gASControl
   
   

3. After you locate the service, you can use the Services control panel to start or stop the Application Server Control service.

   By default, the Application Server Control service is configured to start automatically when the system starts.

2.4.1 Starting the Database Control on UNIX

To start the Database Control, as well the Management Agent and the Management Service associated with the Database Control:

1. Set the following environment variables to identify the Oracle home and the system identifier (SID) for the database instance you want to manage:

   • ORACLE_HOME

   • ORACLE_SID

2. Change directory to the ORACLE_HOME/bin directory.

3. Enter the following command:

   $PROMPT> ./emctl start dbconsole
   

2.4.2 Stopping the Database Control on UNIX

To stop the Database Control, as well the Management Agent and the Management Service associated with the Database Control:

1. Set the following environment variables to identify the Oracle home and the system identifier (SID) for the database instance you want to manage:

   • ORACLE_HOME

   • ORACLE_SID

2. Change directory to the ORACLE_HOME/bin directory.

3. Enter the following command:

   $PROMPT> ./emctl stop dbconsole
   

2.4.3 Starting and Stopping the Database Control on Windows

To start or stop the Database Control on Windows systems:

1. Open the Services control panel.

   For example, on Windows NT, select Start > Settings > Control Panel and then double-click the Services icon.

   On Windows 2000, select Start > Administrative Tools > Services.

2. Locate the Database Control in the list of services.

   The name of the service is usually consists of "Oracle," followed by the name of the home directory you specified during the installation and the database system identifier (SID), followed by the word "DBControl." For example, if you specified DBd10g as the Oracle Home, the Service name would be:

   OracleDB10gDBControl
   
   

3. After you locate the service, you can use the Services control panel to start or stop the Database Control service.

   By default, the Database Control service is configured to start automatically when the system starts.

2.6.1 Starting Grid Control and All Its Components

The following procedure summarizes the steps required to start all the components of the Grid Control. For example, use this procedure if you have restarted the host computer and all the components of the Grid Control have been installed on that host.

To start all the Grid Control components on a host, use the following procedure:

1. If your Oracle Management Repository resides on the host, change directory to the Oracle Home for the database where you installed the Management Repository and start the database and the Net Listener for the database:

   1. Set the ORACLE_HOME environment variable to the Management Repository database home directory.

   2. Set the ORACLE_SID environment variable to the Management Repository database SID (default is asdb).

   3. Start the Net Listener:

      $PROMPT> $ORACLE_HOME/bin/lsnrctl start
      
      

   4. Start the Management Repository database instance:

      ORACLE_HOME/bin/sqlplus /nolog
      SQL> connect SYS as SYSDBA
      SQL> startup
      SQL> quit
      

      
      

      See Also: Oracle Database Administrator's Guide for information about starting and stopping an Oracle Database

      
      

2. Start the Oracle Management Service:

   $PROMPT> ORACLE_HOME/bin/emctl start oms
   

   
   

   See Also: "Controlling the Oracle Management Service"

   
   

3. Start OracleAS Web Cache:

   $PROPMT> $ORACLE_HOME/opmn/bin/opmnctl startproc ias-component=WebCache
   
   

4. Change directory to the home directory for the Oracle Management Agent and start the Management Agent:

   $PROMPT> AGENT_HOME/bin/emctl start agent
   

   
   

   See Also: "Controlling the Oracle Management Agent"

   
   
   
   

   Note: Be sure to run the emctl start agent command in the Oracle Management Agent home directory and not in the Management Service home directory.

   
   

5. Optionally, start the Application Server Control Console, which is used to manage the Oracle Application Server instance that is used to deploy the Management Service:

   $PROMPT> $ORACLE_HOME/bin/emctl start iasconsole
   

   
   

   See Also: "Controlling the Application Server Control"

   
   

2.6.2 Stopping Grid Control and All Its Components

The following procedure summarizes the steps required to stop all the components of the Grid Control. For example, use this procedure if you have installed all the components of the Grid Control on the same host you want to shut down or restart the host computer.

To stop all the Grid Control components on a host, use the following procedure:

1. Stop the Oracle Management Service:

   $PROMPT> $ORACLE_HOME/bin/emctl stop oms
   

   
   

   See Also: "Controlling the Oracle Management Service"

   
   

2. If necessary, stop the Application Server Control Console, which is used to manage the Oracle Application Server instance used to deploy the Management Service:

   $PROMPT> $ORACLE_HOME/bin/emctl stop iasconsole
   

   
   

   See Also: "Controlling the Application Server Control"

   
   

3. Stop all the Oracle Application Server components, such as the Oracle HTTP Server the OracleAS Web Cache:

   $PROMPT> $ORACLE_HOME/opmn/bin/opmnctl stopall
   

   
   

   See Also: Oracle Application Server Administrator's Guide

   
   

4. Change directory to the home directory for the Oracle Management Agent and stop the Management Agent:

   $PROMPT> AGENT_HOME/bin/emctl stop agent
   

   
   

   See Also: "Controlling the Oracle Management Agent"

   
   
   
   

   Note: Be sure to run the emctl stop agent command in the Oracle Management Agent home directory and not in the Oracle Application Server home directory.

   
   

5. If your Oracle Management Repository resides on the same host, change directory to the Oracle Home for the database where you installed the Management Repository and stop the database and the Net Listener for the database:

   1. Set the ORACLE_HOME environment variable to the Management Repository database home directory.

   2. Set the ORACLE_SID environment variable to the Management Repository database SID (default is asdb).

   3. Stop the database instance:

      $PROMPT> ORACLE_HOME/bin/sqlplus /nolog
      SQL> connect SYS as SYSDBA
      SQL> shutdown
      SQL> quit
      

      
      

      See Also: Oracle Database Administrator's Guide for information about starting and stopping an Oracle Database

      
      

   4. Stop the Net Listener:

      $PROMPT> $ORACLE_HOME/bin/lsnrctl stop
      

2.7.1 Uploading and Reloading Data to the Management Repository

Under normal circumstances, the Management Agent uploads information about your managed targets to the Management Service at regular intervals.

However, there are two Enterprise Manager commands that can help you force an immediate upload of data to the Management Service or a reload of the target definitions and attributes stored in the Management Agent home directory.

To use these commands, change directory to the AGENT_HOME/bin directory (UNIX) or the AGENT_HOME\bin directory (Windows) and enter the appropriate command as described in Table 2-6.

2.7.2 Specifying New Target Monitoring Credentials

To monitor the performance of your database targets, Enterprise Manager connects to your database using a database username and password. This username and password combination is referred to as the database monitoring credentials.

When you first add an Oracle9i Database target, or when it is added for you during the installation of the Management Agent, Enterprise Manager uses the DBSNMP database user account and the default password for the DBSNMP account as the monitoring credentials.

When you install Oracle Database 10g, you specify the DBSNMP monitoring password during the database installation procedure.

As a result, if the password for the DBSNMP database user account is changed, you must modify the properties of the database target so that Enterprise Manager can continue to connect to the database and gather configuration and performance data.

Similarly, immediately after you add a new Oracle Database 10g target to the Grid Control, you may need to configure the target so it recognizes the DBSNMP password that you defined during the database installation. Otherwise, the Database Home page may display no monitoring data and the status of the database may indicate that there is a metric collection error.

You can modify the Enterprise Manager monitoring credentials by using the Oracle Enterprise Manager 10g Grid Control Console or by using the Enterprise Manager command-line utility (emctl).

$PROMPT>./emctl config agent credentials emrep10.acme.com:oracle_database
Oracle Enterprise Manager 10g Release 10.1.0.2.0
Copyright (c) 2002, 2003 Oracle Corporation.  All rights reserved.
Name = emrep10.us.oracle.com, Type = oracle_database
Want to change for "UserName" (y/n):n
Want to change for "password" (y/n):y
Enter the value for "password" :*******
EMD reload completed successfully

2.7.3 Listing the Targets on a Managed Host

There are times when you need to provide the name and type of a particular target you are managing. For example, you must know the target name and type when you are setting the monitoring credentials for a target.

To list the name and type of each target currently being monitored by a particular Management Agent:

1. Change directory to the AGENT_HOME/bin directory (UNIX) or the AGENT_HOME\bin directory (Windows).

2. Enter the following command to specify new monitoring credentials:

   $PROMPT>./emctl config agent listtargets  [AGENT_HOME]
   
   

   shows the typical output of the command.

./emctl config agent listtargets
Oracle Enterprise Manager 10g Release 10.1.0.2.0
Copyright (c) 2002, 2003 Oracle Corporation.  All rights reserved.
[usunnab08.us.oracle.com, host]
[LISTENER_usunnab08.us.oracle.com, oracle_listener]
[EnterpriseManager.usunnab08.us.oracle.com_HTTP Server, oracle_apache]
[EnterpriseManager.usunnab08.us.oracle.com_home, oc4j]
[EnterpriseManager.usunnab08.us.oracle.com_Web Cache, oracle_webcache]
[EnterpriseManager.usunnab08.us.oracle.com, oracle_ias]
[EnterpriseManager.usunnab08.us.oracle.com_OC4J_EM, oc4j]
[EnterpriseManager.usunnab08.us.oracle.com_OC4J_Demos, oc4j]
[EM_Repository, oracle_emrep]
[usunnab08.us.oracle.com:1813, oracle_emd]
[EM Website, website]
[emrep10.us.oracle.com, oracle_database]

2.7.4 Controlling Blackouts

Blackouts allow Enterprise Manager users to suspend management data collection activity on one or more managed targets. For example, administrators use blackouts to prevent data collection during scheduled maintenance or emergency operations.

You can control blackouts from the Oracle Enterprise Manager 10g Grid Control Console or from the Enterprise Manager command-line utility (emctl). However, if you are controlling target blackouts from the command line, you should not attempt to control the same blackouts from the Grid Control Console. Similarly, if you are controlling target blackouts from the Grid Control Console, do not attempt to control those blackouts from the command line.

From the command line, you can perform the following blackout functions:

• Starting Immediate Blackouts

• Stopping Immediate Blackouts

• Checking the Status of Immediate Blackouts

  
  

  Note: When you start a blackout from the command line, any Enterprise Manager jobs scheduled to run against the blacked out targets will still run. If you use the Grid Control Console to control blackouts, you can optionally prevent jobs from running against blacked out targets.

  
  

To use the Enterprise Manager command-line utility to control blackouts:

1. Change directory to the AGENT_HOME/bin directory (UNIX) or the AGENT_HOME\bin directory (Windows).

2. Enter the appropriate command as described in Table 2-7.

   
   

   Note: When you start a blackout, you must identify the target or targets affected by the blackout. To obtain the correct target name and target type for a target, see "Listing the Targets on a Managed Host".

   
   

Use the following examples to learn more about controlling blackouts from the Enterprise Manager command line:

• To start a blackout called "bk1" for databases "db1" and "db2," and for Oracle Listener "ldb2," enter the following command:

  $PROMPT> emctl start blackout bk1 db1 db2 ldb2:oracle_listener -d 5 02:30
  
  

  The blackout starts immediately and will last for 5 days 2 hours and 30 minutes.

• To check the status of all the blackouts on a managed host:

  $PROMPT> emctl status blackout
  
  

• To stop blackout "bk2" immediately:

  $PROMPT> emctl stop blackout bk2
  
  

• To start an immediate blackout called "bk3" for all targets on the host:

  $PROMPT> emctl start blackout bk3 -nodeLevel
  
  

• To start an immediate blackout called "bk3" for database "db1" for 30 minutes:

  $PROMPT> emctl start blackout bk3 db1 -d 30
  
  

• To start an immediate blackout called "bk3" for database "db2" for five hours:

  $PROMPT> emctl start blackout bk db2 -d 5:00