H
Domain Administration with the Java-based Oracle Enterprise Manager Console

Administering Oracle 9iFS requires starting the domain and nodes and monitoring the performance of the domain. This chapter describes the components of the domain and use of the Oracle Enterprise Manager Java Console, include:

• Starting Oracle 9iFS through the Oracle Enterprise Manager Java Console

• Monitoring the Performance of an Oracle 9iFS Domain

Starting Oracle 9iFS through the Oracle Enterprise Manager Java Console

These instructions assume you have run the Enterprise Manager Configuration Assistant to set up Oracle Enterprise Manager to work with Oracle 9iFS and configured the local Oracle Management Server. See the Oracle Internet File System Installation and Configuration Guide for detailed instructions.

Launch the Oracle Enterprise Manager Java Console

1. On Unix: Launch the Oracle Enterprise Manager Java Console by executing the command:

   oemapp console
   
   

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

2. On the Oracle Enterprise Manager Java Console Login dialog, log into Oracle Management Server. Enter your Administrator user ID and password.

   

   Text description of the illustration 2omslogi.gif

3. If you are working with more than one management server, select it from the pull-down list.

4. Click OK. The Oracle Enterprise Manager Java Console displays.

   

   Text description of the illustration 2oemcons.gif

Start the Oracle 9iFS Domain

1. From the Navigator on the left side of the console, select Internet File Systems. (If "Internet File Systems" is not visible, it has not been discovered. See "Cannot discover Oracle 9iFS targets in Oracle9i Enterprise Manager Console" in Table 10-1 of Chapter 10, "Oracle 9iFS Troubleshooting and Performance Information".)

2. If there is a plus (+) sign to the left of the domain name, you can click it to see the nodes. You can also double-click the domain name.

3. If this is the first time you are using the Oracle Enterprise Manager Java Console, 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 theOracle 9iFS machine) and click Next. The Discovery Wizard refreshes (or creates, if this is the first time you're running it) the information about the Oracle 9iFS node. Click Finish.

4. Select an Oracle 9iFS domain controller. The domain controllers are the top-most nodes under Internet File Systems. The General property sheet displays, showing:
   • The state of the domain, illustrated by a traffic light. Red=shut down, yellow=launched, green=started.

   • Agent status. Whether the Intelligent Agent (IA) is running or not. Click the Ping Agent button to confirm that the IA is running. If it is not, you need to start the IA before you can launch the domain controller. At the command line, type agentctl start.

   • Information about the repository. The database and schema names, the locations of the domain controller, the launch script, and the configuration file.

   • Performance/Statistics Overview. Click this button to display a graphic overview showing general information about the domain, details on document storage and connected sessions, and a client/usage summary.

     

     Text description of the illustration 2oemdc.gif

5. To start the domain, right-click it and select Start Domain from the Context menu or select the domain and choose Start Domain from the Object menu.

   This command submits a job to the Intelligent Agent. For more information on submitting jobs, see the Oracle Enterprise Manager Administrator's Guide.

6. The domain controller starts and prompts for the schema password. Enter the Schema password. Click "Save as Preferred Credential" to save the password in the OMS repository and prevent this screen from displaying in the future. Click OK.

7. This task connects to the started domain controller to get the list of nodes configured for the domain and launch the nodes when available. Once a node is launched, it will be started by the domain controller automatically. You are prompted to enter the System Administrator user ID and password. Select "Save Credentials" to keep from having to enter the password each time you access the domain. Click OK.

   The General property sheet shows what has been started. For example, when the DAV servlet starts, an HTTP node is started.

   Note: For the Oracle Enterprise Manager job to be successfully submitted and started, you must set up node/host credentials for the host where the job is submitted. In Unix, supply the root username and password as the host credential if any Oracle 9iFS node will be running on that host.

8. The domain is started if the traffic light on the General property sheet is green and the status is Started.

   

   Text description of the illustration 1domain.gif

Start Oracle 9iFS Manager

1. To start Oracle 9iFS Manager, on the Oracle Enterprise Manager Java Console, expand Internet File System and select the domain.

2. Select Related Tools from the Object menu, or right-click the domain and select Related Tools from the context menu.

   

   Text description of the illustration 2launchi.gif

3. Oracle 9iFS Manager displays in a separate window.

   

   Text description of the illustration 2ifsmgrn.gif

Automatically Restarting the Domain and its Nodes

In the event of a domain controller failure, the domain controller can be relaunched automatically by Intelligent Agent, and even restarted, if the Schema password is stored as an OMS-preferred credential and if the 'Domain Controller Down" event and its fix-it job are set up correctly on this domain controller. Similarly, in the event of a node failure, the node (its node guardian) will be relaunched automatically by IA if the 'node down' event and its fix-it job are set up correctly for the node. For more on how to register events and associated fix-it jobs, see the Oracle Enterprise Manager Administrator's Guide.

When a domain controller is started, it obtains a list of nodes in the domain and attempts to start each in turn. If a node is unavailable, the domain controller logs that node's unavailability and continues with the next node in the list. The domain controller then enters a cycle in which it waits a short period then attempts to contact each node on its list, logging failures, starting nodes not previously started, and restarting failed nodes. This cycle repeats for the life of the domain controller.

If the domain controller process fails, the already started nodes remain running. However, unstarted nodes will remain unstarted until the domain controller is re-launched and restarted.

Node Discovery

Launching Oracle 9iFS Manager in the OMS-connected mode implies that Oracle 9iFS Manager lists all the OMS-discovered Oracle 9iFS instances. A new Oracle 9iFS instance, however, is discovered by Oracle Enterprise Manager through the Discovery Wizard and not by Oracle 9iFS Manager. The Oracle 9iFS credentials for the Oracle 9iFS instances can be stored in OMS.

The Discovery Wizard

The Discovery Wizard is activated each time you select Discover Nodes from the Console's Navigator menu. The Discovery Wizard searches the network for the host you specify. If that node has an Oracle Intelligent Agent running, it will be added to the Oracle Enterprise Manager Java Console Navigator for management along with any services running on that target. You will be able use these services as targets in jobs, events, and groups. For details about the Discovery Wizard, see Chapter 2, "Navigator" in the Oracle Enterprise Manager Administrator's Guide.

Launching Oracle 9iFS Manager as a Standalone Application

Although launching Oracle 9iFS Manager as a standalone application provides the same repository management functionality, you cannot administer the Oracle 9iFS domain and its nodes from Oracle 9iFS Manager.

You can launch Oracle 9iFS Manager in standalone mode in two ways:

• Connected only to the local Oracle 9iFS repository.

• Connected to any Oracle 9iFS repository on the network.

Connecting to the Local Oracle 9iFS Repository

1. Launch Oracle 9iFS Manager from the command line using the ifsmgr command, usually found in the $ORACLE_HOME/9ifs/bin/ folder.

2. On the Connect Information dialog, enter a username and password (the default administrator login is system/manager).

   

   Text description of the illustration 2noemlog.gif

3. Notice that the following fields are dimmed because you can connect only to the local Oracle 9iFS repository. They display information for the underlying Oracle 9iFS Service:
   • Oracle 9iFS Service--The property settings for the Oracle 9iFS Service. This field is not editable, but you can change it by clicking Change 9iFS Service.

   • Database Service--The Oracle database Net8 Service Name. This field is not editable and is determined by the Oracle 9iFS Service field.

   • Oracle 9iFS Schema--The Oracle database schema name for the Oracle 9iFS repository. This field is not editable and is determined by the Oracle 9iFS Service field.

4. Enter the Oracle 9iFS Schema Password.

5. Click OK to complete the login process.

   The main window for Oracle 9iFS Manager displays.

Connecting to Any Oracle 9iFS Repository on the Network

1. Launch Oracle 9iFS Manager from the Oracle Enterprise Manager Console by selecting the domain and choosing Related Tools from the Object menu, or right-clicking the domain and selecting Related Tools from the context menu. From Related Tools, select 9iFS Manager.

   Or:

2. Launch Oracle 9iFS Manager from the command line using the oemapp ifsmgr command.

3. From the Oracle 9iFS Manager screen, choose Launch Standalone. The login screen displays.

   

   Text description of the illustration 2oemstan.gif

4. Make sure you have selected "Connect directly to a 9iFS repository."

5. Enter a username and password (the default administrator login is system/manager).

6. Specify which Oracle 9iFS repository to connect to.
   • Database Service--Enter the Oracle database service information in the format:

     <host>:<port>:<sid>
     
     

     where:

     host is the machine name where the database is located.

     port is the database listener port address, usually 1521 or 1526.

     sid is the database system identifier.

     For example:

     my_ifs_machine:1521:ifs90
     
     

     which connects to the ifs90 database using port 1521 on the my_ifs_machine machine.

   • Oracle 9iFS Schema--Enter the Oracle database schema name for the Oracle 9iFS repository.

7. Enter the Oracle 9iFS Schema Password.

8. Click OK to complete the logon process.

   The main window for Oracle 9iFS Manager displays.

Monitoring the Performance of an Oracle 9iFS Domain

Since service and server configuration parameters are stored in Oracle 9iFS along with your files and data as objects, you can use Oracle Enterprise Manager Java Console to manage these parameters.

Text description of the illustration javacona.gif

To change the default values used to configure the services and servers, select the service or server from the Administrator's Tasks section of Oracle 9iFS Manager. For more information see Chapter 5, "Service and Server Configuration".

Text description of the illustration javacon2.gif

Text description of the illustration 2servers.gif

To get an overall picture of the domain's performance or to continuously monitor the domain, click the Performance/Statistics Overview button on the General tab. The following information is depicted graphically:

Text description of the illustration 1dashgra.gif

The left side of the screen monitors the Oracle 9iFS repository and its documents and users. It provides general information and information about document storage. The right side provides information about the domain, including information about usage by connected session and an overall usage summary by node showing each session on each machine.

Monitoring Node Performance

The 9iFS Node Performance dialog shows the allocated and total memory and the thread count. The display is dynamic; that is, the allocated heap size and total heap size change as time passes. Likewise, the number of threads and system time change.

To display the Node Performance dialog, on the General property sheet associated with the node, click the Performance Overview button.

Text description of the illustration 2nodeper.gif

If your Total Heap size is equal to your "MX" setting for the JVM (the MX setting is different for the main node versus the Oracle 9iFS JServ process), and your Allocated Heap Size equals the Total Heap size more than once hour, then the Oracle 9iFS server may be spending too much time in "major" garbage collection, and your users may notice a frequent "stall" of the server during this garbage collection. You should increase your MX size the next time you restart the JVM. This will increase your memory usage on the middle-tier machine.

If you have developed a custom application, and your Thread Count continues to increase over time and never decreases, then you may have a thread leak in your software. In particular, check that you are calling LibrarySession.disconnect() whenever a user disconnects or is timed out.

View the Status of Services and Servers

To see the services and servers started along with the node, double-click the node name, then double-click the Services or Servers folders. The property sheet displays the service and servers running in the selected node.

Service Information

For each service the following information is shown:

• Name of the service

• Configuration object associated with the service

• Whether the service is active or not (active=true, inactive=false).

  

  Text description of the illustration 2servgen.gif

• You can specify whether the number of concurrent sessions should be unlimited or limit the sessions to a maximum number.

• You can enable or disable the acceptance of new sessions.

• You can specify whether the service should shut down automatically when the last session is disconnected.

• You can view additional detail about the service by clicking the View/Edit Service Details button.

Service Details

Click the View/Edit Service Details button on a Service property sheet to view service details. There are four dynamic displays that you can access from the four tabs. The parameters shown are detailed in Appendix B, "Service Configuration Properties".

Sessions

The Sessions tab shows the number of session running and provides the following information about each session:

Text description of the illustration 2servses.gif

To stop a session, highlight the session in the table and click the Disconnect Session button.

Committed Data Cache

The Committed Data Cache dynamically provides information about the percentage of cache hits and cache size and capacity and allows you to reset the cache statistics or change the cache configuration. Caching this data allows sessions to get the attribute values of frequently used LibraryObjects without a database request, greatly improving performance and scalability. Data that has not been recently used is periodically purged from the cache.

Text description of the illustration 2servcac.gif

If your Cache hits is less than 90 percent, then the Oracle 9iFS Committed Data Cache may be too small. Proportionately increase all Cache settings (Cache capacity, Normal purge trigger, Urgent purge trigger, Emergency purge trigger, Purge target) through the "Change Cache Configuration" button. This will increase your memory usage on the middle-tier machine.

Readonly Connection Pool

The Readonly Connection Pool dynamically displays the total and allocated connections and the average time to allocate connection and allows you to reset the Readonly Connection Pool statistics or change the configuration. The Readonly Connection Pool is a set of database connections shared by the sessions to perform database read operations. A minimum number of connections are created when the Oracle 9iFS domain is started. Depending on the number of concurrent operations performed by the sessions, and the nature of these operations, additional connections may be added to the pool up to a specified maximum.

Text description of the illustration 2readcon.gif

If the number of Failed allocations is greater than 0, or the Deferred allocations percentage is greater than 5 percent and the Average time to Allocate is more than 50 milliseconds, then your Connection Pool settings may be too small. Increase the Target and Maximum settings using the "Change Configuration" button. This will take more memory on the middle-tier machine for open cursors, and on the database machine for shadow processes.

Writeable Connection Pool

The Writeable Connection Pool dynamically displays the total and allocated connections and the average time to allocate connection and allows you to reset the Writeable Connection Pool statistics or change the configuration. The Writeable Connection Pool is a set of database connections shared by the sessions to perform database read/write operations. A minimum number of connections are created when the Oracle 9iFS domain is started. Depending on the number of concurrent operations performed by the sessions, and the nature of these operations, additional connections may be added to the pool up to a specified maximum.

Text description of the illustration 2writeco.gif

Server Information

For each server, the following information is shown:

• Name of the server

• Configuration file associated with the server

• Whether the server is active or not (active=true, inactive=false).

• The service the server is associated with.

• The initial priority set for the server.

You can change the status of the server; that is, restart, suspend, or stop the server. Using the slider control you can set the priority associated with the server in increments running from minimum to maximum. You can also change the dynamic properties values associated with this server.

Click the Start Automatic Refreshing button to refresh the server information constantly. Otherwise, you must manually refresh the information by selecting Refresh from the Navigator menu.

Text description of the illustration 2ftpserv.gif

You can also use this page to determine if you have too many or too few protocol Here are the servers, and when you need them:

• Agents which should only run in one "service" regardless of how many services connect to the same 9iFS schema.
  • ContentGarbageCollector.

  • DanglingObjectAVCleanupAgent

  • EventExchangerAgent

  • ExpirationAgent

  • FolderIndexAnalyzerAgent

  • GarbageCollectionAgent

  • interMediaAnnotatorAgent

  • ServiceWatchdogAgent

• Agents which should be running in every "service" :
  • ServiceWarmupAgent

• Protocol Servers (may run on many different middle-tier machines):
  • SmbServer and NbServer both must run for the SMB protocol to run.

  • DavServer must run for HTTP/WebDAV (WebFolders, FileSync) support, and must be paired with a running Oracle HTTP Server. The HTTP Server runs in its own Service.

  • WcpServer must run to use the Windows Utility.

  • ImapServer and SmtpServer both must run for full e-mail access.

  • NtfsServer must run for NTFS support.

  • FtpServer must run for FTP support.

Log Files

Log files are generated for the Oracle Enterprise Manager Java Console, the Oracle 9iFS Manager, and the dashboard. $ORACLE_HOME/9ifs/log/ifsmgr.log contains information for both Oracle Enterprise Manager Java Console and Oracle 9iFS Manager. $ORACLE_HOME/9ifs/log/dashboard.log contains information from the dashboard. You can set options for the ifsmgr.log file in:

$ORACLE_HOME/9ifs/settings/IfsManager.def

No settings for the dashboard log may be modified.