6
Managing the Discoverer CORBA components

6.1 Managing the Discoverer CORBA components

This chapter explains how to manage the Discoverer CORBA components. For example, when you install Oracle9iAS Discoverer on a new machine in a multiple machine environment you might want to manually register or unregister CORBA components. This section contains the following topics:

• Section 6.2, "About the Discoverer CORBA components"

• Section 6.3, "About managing Discoverer CORBA components"

• Section 6.4, "How to confirm that the OAD is running and responding"

• Section 6.5, "How to view the registered components"

• Section 6.6, "How to register and unregister the Discoverer Session component with the OAD"

• Section 6.7, "How to start and stop the Preferences component"

6.2 About the Discoverer CORBA components

The Discoverer Session and Discoverer Preferences components are installed on one or more application servers. For more information about the Discoverer Session component and the Discoverer Preferences component, see Section 1.7.2, "About the Discoverer CORBA components".

Notes:

• You can register and unregister the Discoverer Session component using the Windows Start menu or using the Unix command line.

• You can view the registered components for one machine or for the entire network.

• To register and unregister the Discoverer Session component (and to view registered components), the VisiBroker Object Activation Daemon (OAD) must be running and responding. For more information about confirming that the OAD is running, see Section 6.4, "How to confirm that the OAD is running and responding".

6.3 About managing Discoverer CORBA components

To manage the Discoverer CORBA components, you typically do the following:

• confirm that the OAD is running and responding (for more information, see Section 6.4, "How to confirm that the OAD is running and responding")

• find out what components are registered (for more information, see Section 6.5, "How to view the registered components"

• register or unregister the Discoverer Session component (for more information, see Section 6.6, "How to register and unregister the Discoverer Session component with the OAD")

6.4 How to confirm that the OAD is running and responding

How you confirm that the OAD is running and responding depends on the operating system on which you are running the Discoverer Server, as follows:

• if you are running the Discoverer Server on UNIX, see Section 6.4.1, "How to confirm that the OAD is running and responding on UNIX"

• if you are running the Discoverer Server on Windows, see Section 6.4.2, "How to confirm that the OAD is running and responding on Windows"

6.4.1 How to confirm that the OAD is running and responding on UNIX

If you are not sure whether the OAD is running on UNIX:

1. Type the following at the command prompt:

   > oadutil list
   
   

   If the OAD process is not running or the OSAGENT is not running, the following message is displayed:

   Unable to bind to OAD

If the OAD process is not running, do the following to start OAD:

1. Navigate to the directory containing the stopall.sh and startall.sh files and type the following two commands at the command prompt:

   > stopall.sh
   > startall.sh
   
   

   To find out the location of the files, see Section A.2, "List of Discoverer file locations".

6.4.2 How to confirm that the OAD is running and responding on Windows

If you are not sure whether the OAD is running on Windows:

1. Press Ctrl + Alt + Del to open the Windows NT Security dialog and click Task Manager.

2. Display the Processes tab.

   The Processes list should contain two java.exe processes (one for OC4J and one for OAD). Therefore, if both java.exe processes are running you can assume that the OAD is running. If you think that the OAD is running but not responding, stop and start the Discoverer service (see If the OAD is running but not responding below).

   Note: The Processes list might contain more than two java processes.

If the OAD is not running, do the following to start OAD:

1. From the Windows Start menu, choose Settings | Control Panel and double-click on the Services icon to display the Services dialog box.

2. Select Disco9.0.2Service and click Start.

3. When the OAD has started, click Close to close the Services dialog box.

If the OAD is running but not responding, do the following:

1. From the Windows Start menu, choose Settings | Control Panel and double-click on the Services icon to display the Services dialog box.

2. Select Disco9.0.2Service.

3. Click Stop, then click Start.

4. When the OAD has started, click Close to close the Services dialog box.

6.5 How to view the registered components

To view the registered components:

1. Make sure the OAD is running (for more information, see Section 6.4, "How to confirm that the OAD is running and responding").

2. Navigate to the Visibroker root directory. For example, \VBROKER\BIN\.

3. Specify which domain the osagent needs to look at by typing the following at the command prompt:

   > oadutil list -VBJprop vbroker.agent.port=<port number>
   
   

   Note: To find out the port number:

   • On Windows, look at the value of the Windows Registry key HKLM/Software/Oracle/<Oracle Home>/DC902_OSAGENT_PORT.

   • On UNIX, open the startoad.sh script in a text editor or look for the comment that starts the OAD (for more information about the location of script files, see Section A.2, "List of Discoverer file locations").

     Tip: The command contains -VBJprop vbroker.agent.port=<port number>.

4. View the registered components by typing the following at the command prompt:

   > osfind -VBJprop vbroker.agent.port=<port number>
   
   

   A list of the components running on the network is displayed.

6.6 How to register and unregister the Discoverer Session component with the OAD

How you register and unregister the Discoverer Session component with the OAD depends on the operating system on which you are running the Discoverer Server, as follows:

• if you are running the Discoverer Server on UNIX, you register the Discoverer Session component with the OAD using the command line (for more information, see Section 6.6.1, "How to register and unregister the Discoverer Session component using the command line")

• if you are running the Discoverer Server on Windows, you can register the Discoverer Session component with the OAD using:
  • the command line (for more information, see Section 6.6.1, "How to register and unregister the Discoverer Session component using the command line")

  • the Windows Start menu (for more information see Section 6.6.2, "How to register and unregister the Discoverer Session component using the Windows Start menu")

6.6.1 How to register and unregister the Discoverer Session component using the command line

When you use the command line to register the Discoverer Session component, you run scripts contained in files. The names of the files will depend on the operating system on which you are running the Discoverer Server, as follows:

Operating system	Session registration script
UNIX	registersession.sh
Windows	registersession.bat

To register the Discoverer Session component using the command line:

At the command prompt, navigate to the directory containing the Session component registration script (for more information about the location of configuration files, see Section A.2, "List of Discoverer file locations").

1. At the command prompt, run the script as follows:
   • on UNIX, type the following:

     > registersession.sh
     
     

   • on Windows, type the following:

     > registersession.bat
     
     

6.6.1.1 To unregister the Discoverer Session component using the command line

When you use the command line to unregister the Discoverer Session component, you run scripts contained in files. The names of the files will depend on the operating system on which you are running the Discoverer Server, as follows:

Operating system	Session unregistration script
UNIX	unregistersession.sh
Windows	unregistersession.bat

To unregister the Session component using the command line:

1. At the command prompt, navigate to the directory containing the Session component unregistration script (for more information about the location of configuration files, see Section A.2, "List of Discoverer file locations").

2. At the command prompt, run the script as follows:
   • on UNIX, type the following:

     > unregistersession.sh
     
     

   • on Windows, type the following:

     > unregistersession.bat
     
     

6.6.2 How to register and unregister the Discoverer Session component using the Windows Start menu

If you are running the Discoverer Server on Windows, you can register and unregister the Discoverer Session component with the OAD using options on the Windows Start menu.

On the machine where you want to register or unregister the Discoverer Session component:

1. From the Windows Start menu, choose Programs | Oracle9iAS Discoverer Server Setup.

   A number of register and unregister options are available.

2. Choose the component that you want to register or unregister.

   A confirmation screen appears.

6.7 How to start and stop the Preferences component

How you start and stop the Discoverer Preferences component depends on the operating system on which you are running the Discoverer Server, as follows:

• if you are running the Discoverer Server on UNIX, see Section 6.7.1, "How to start and stop the Discoverer Preferences component on UNIX"

• if you are running the Discoverer Server on Windows, seeSection 6.7.2, "How to start and stop the Discoverer Preferences component on Windows"

6.7.1 How to start and stop the Discoverer Preferences component on UNIX

To stop the Discoverer Preferences component on UNIX:

1. Navigate to the directory containing the stoppreference.sh file and type the following at the command prompt:

   > stoppreference.sh
   
   

   For more information about the location of configuration files, see Section A.2, "List of Discoverer file locations".

To start the Preferences component on UNIX:

1. Navigate to the directory containing the startpreference.sh file and type the following at the command prompt:

   > startpreference.sh
   
   

   For more information about the location of configuration files, see Section A.2, "List of Discoverer file locations".

6.7.2 How to start and stop the Discoverer Preferences component on Windows

To stop the Discoverer Preferences component on Windows:

1. Stop the Discoverer Windows service (for more information, see Section 4.2.4, "How to stop the Discoverer Windows service manually").

2. From the Windows Start menu, select Run.

3. In the Run window, type regedit and press [Enter].

4. In the Registry Editor, open the HKEY_LOCAL_MACHINE/SOFTWARE/ORACLE/ key.

5. Change the value of the DC902_START_PREFERENCES from 1 to 0.

6. Start the Discoverer Windows service (for more information, see Section 4.2.3, "How to start the Discoverer Windows service manually").

To start the Preferences component on Windows:

1. Stop the Discoverer Windows service (for more information, see Section 4.2.4, "How to stop the Discoverer Windows service manually").

2. From the Windows Start menu, select Run.

3. In the Run window, type regedit and press [Enter].

4. In the Registry Editor, open the HKEY_LOCAL_MACHINE/SOFTWARE/ORACLE/ key.

5. Change the value of DC902_START_PREFERENCES from 0 to 1.

6. Start the Discoverer Windows service (for more information, see Section 4.2.3, "How to start the Discoverer Windows service manually").