5
Getting Started with Oracle Enterprise Manager

The Oracle 9iFS administration software integrates with Oracle Enterprise Manager. This chapter provides information about creating a new Oracle Enterprise Manager repository and an Oracle Management Server, and about how to setup Oracle 9iFS to work with OEM. The chapter also provides basic information about starting and stopping Oracle 9iFS nodes and domains. Topics include:

For more information, see the Oracle Enterprise Manager Configuration Guide.

Setting Up Oracle Enterprise Manager

To setup a new Oracle Enterprise Manager (OEM) repository and Oracle Management Server (OMS) for the Oracle 9iFS installation, follow the instructions below. These instructions assume that you are creating the first OMS in the environment and the OEM will be installed in the same database instance you were working with in Task 4: Install (or Upgrade to) Oracle 8.1.7.2 or Oracle9i Database in Pre-installation--that is, the same database that will store the Oracle 9iFS repository. If the OEM repository and OMS are already running in your environment, you may not need to perform this task.

To set up Oracle Enterprise Manager, log on to the Windows NT or Windows 2000 machine as the Administrator (or other user with Administrator privileges that installed the Oracle database).

You will need to know an account name and password that has SYSDBA privileges (system/manager, for example) for the database instance. The Enterprise Manager Configuration Assistant wizard will use the credentials you supply to logon to the database and create a schema name for the OEM repository (the default is OEM_REPOSITORY) in the existing database.

Create the Oracle Management Server (OMS) and Oracle Enterprise Manager Repository

From the Windows NT or Windows 2000 Start menu, select Programs-->Oracle<Oracle_Home>-->Configuration and Migration Tools-->Enterprise Manager Configuration Assistant. Alternatively, you can start the Oracle9i Enterprise Manager Configuration Assistant (EMCA) from a Command Prompt by entering the following:
```
c:\%ORACLE_HOME%\bin\emca
```
On the Welcome page, click Next to continue.
On the Configuration Operation page, choose "Configure local Oracle Management Server" and click Next to continue.

If a configuration already exists, a dialog displays prompting you to edit the configuration or create a new configuration. Do not edit an existing configuration unless you know for sure that you should do so.
Click the Create button; the Configure Oracle Management Server page displays.
On the Configure Oracle Management Server page, select "Create a new repository" and click Next to continue. The Create New Repository Options page displays.
- If you are not creating the first OMS in the environment but rather are creating an additional OMS to point to an existing repository, select "Use an existing repository" instead.
On the Create New Repository Options page, choose "Custom" and click Next to continue. The Select Database Location page displays.
On the Select Database Location page, choose "In another existing database" and click Next to continue. The Select Database for Repository page displays.
On the Select Database for Repository page, enter the service name, account name, and password information for the database installed in "Task 4: Install (or Upgrade to) Oracle 8.1.7.2 or Oracle9i Database". The account must have SYSDBA privileges for the database; for example, system/manager. The EMCA wizard uses the information you enter here to connect to the database and then and create the schema for the OEM repository and associated user account and passwords. Be sure that Connect as: SYSDBA is selected.
Click Next to continue. The Repository Login Information page displays.
On the Repository Login Information page, enter a unique user name (schema) for the OEM repository. The name must be unique throughout the network. The Intelligent Agents of OEM send information to the OMS by means of the repository name, so more than one OEM repository with the same name will cause addressing problems.

Note:
Because you will need the username and password when running the ifsomssetup batch file, Oracle recommends that you write down the username and password for future reference.
Click Next to continue. The Select Repository User Tablespaces page displays.
On the Select Repository User Tablespaces page, select the default to Create a new OEM_REPOSITORY tablepace and click Next to continue. The Create Repository Summary page displays, summarizing all the configuration details that you've entered thus far (schema (user) name and password, database target, tablespace name, and so on).
Click the Finish button if you're certain of the settings. The tablespace, schema, and a default administration account for the OEM repository is created.

The process may take several minutes to complete. When completed, you can continue with the next task.

Start the Oracle 9iFS Nodes and Domain

You can now start the Oracle 9iFS nodes and the domain.

From the Windows NT or Windows 2000 Start menu, select Programs-->Oracle-<oracle_home>-->Enterprise Manager Console.

Alternatively, you can also use this command-line option to also launch the Oracle Enterprise Manager Console and connect to OMS:
```
c:\%ORACLE_HOME%\bin oemctl start oms 
```
The first time you attempt to logon to Oracle Enterprise Manager through a connection to OMS, you will be prompted to change the password for OMS administrator sysman from the default initial password, oem_temp.
- To check the status of the OMS or to stop OMS, assuming the password for sysman is oemanager, enter:
```
c:\%ORACLE_HOME%\bin oemctl status oms sysman/oemanager   
c:\%ORACLE_HOME%\bin oemctl stop oms sysman/oemanager 
```
Launch the Oracle Enterprise Manager with a connection to OMS using the oemapp console batch file.
Discover the Oracle 9iFS targets on all middle-tier machines by selecting "Discover Nodes" from the Oracle Enterprise Manager Navigator menu. The Discovery Wizard launches. Enter the name of the Oracle 9iFS node (the hostname of the Oracle 9iFS machine. The Discovery Wizard will refresh (or create, if this is the first time you're running it) the information about the Oracle 9iFS node.
Select the Oracle 9iFS Domain Controller you want to start and click the Start Domain command on the Object menu.

For information about stopping nodes, domains, and all other Oracle 9iFS administration tasks, see the Oracle Internet File System Setup and Administration Guide.

Setup Oracle 9iFS to Support Oracle Enterprise Manager Automation

The Oracle Enterprise Manager framework supports automated recovery from failures and provides other pro-active remote management capabilities, in particular, a "fixit" job capability. (See the Oracle Enterprise Manager administrator guides for complete details.) To enable Oracle iFS to take advantage of these features on Windows NT and Windows 2000 machines, you must:

enable the "Logon as batch job" user right for the Administrator account (or the account that you used to install the Oracle 9iFS software)
run the ifsomssetup batch file

These tasks are described in this section.

Enable "Logon as batch job" Rights on Windows NT Machine

These instructions presume the Administrator account was used to install Oracle 9iFS.

Open the User Manager (Start-->Administrative Tools (Common)-->User Manager). The Windows NT User Manager (or User Manager for Domains for Windows NT Server) displays.
Select User Rights... from the Policies menu. The User Rights Policy screen displays:
Click the Show Advanced User Rights checkbox, located in the lower-left corner of the display, to select it.
Select "Logon as batch job" from the drop-down menu of rights.
Click the Add... button.
Add the user account that was used to install Oracle 9iFS, typically Administrator or other user account from the Administrators group.
Click OK to close the dialog.
Click OK to save the change and exit the User Rights Policy dialog.

Enable "Logon as batch job" Rights on Windows 2000 Machine

These instructions presume the Administrator account was used to install Oracle 9iFS.

Open the Control Panel (Start-->Settings-->Control Panel).
Double-click the Administrative Tools control panel.
Double-click the Local Security Policy tool to display the Local SecuritySettings window:
Double-click the "Log on as batch job" right to display the settings dialog.
Click the Add... button to display a list of users and groups.
Add the user account that was used to install Oracle 9iFS, typically Administrator or other user account from the Administrators group.
Scroll through the list, selecting the users and groups to which want to give access by clicking on the name.
Click the Add button; the user or group name displays in the lower portion of the dialog box.

Click the OK when you have finished. The window closes. Continue clicking OK until the dialogs are all closed and your changes are saved.

Run the ifsomssetup Batch File

From the Windows NT or Windows 2000 command prompt, navigate to the %ORACLE_HOME%\9ifs\bin directory and run the batch file as follows:

ifsomssetup <oem_repos_schema_name> <schema_password> <oem_tns_service_name>

OEM repository schema name and schema password are the name and password of the existing OEM repository schema.
OEM repository TNS name is the local TNS name (Service Name) for the OEM repository database.

If you created a new OEM repository schema and OMS by following "Task 8: Prepare Middle-tier Machine or Oracle9i Home" in Chapter 2, "Pre-installation," enter the values you specified during the Enterprise Manager Configuration Assistant (emca) wizard. The Service Name is the name of the database instance.

When ifsomssetup runs successfully, the console displays something like the following:

..10%..20%...100%

After running ifsomssetup, restart Oracle Management Server as described in Table 4-1 in Chapter 4-1.

See Chapter 2, "Administering an Oracle 9iFS Domain" in the Oracle 9iFS Setup and Administration Guide for complete details about administering Oracle 9iFS.

5 Getting Started with Oracle Enterprise Manager