H Manually Updating Fusion Middleware Control Settings

This appendix describes how to manually update configuration settings that are normally managed by Fusion Middleware Control. The appendix contains the following topics:

Note:

Use Fusion Middleware Control to update Oracle Business Intelligence configuration settings rather than manually updating configuration files using a text editor. For information, see Section 3.2, "Using Fusion Middleware Control to Update Oracle Business Intelligence Configuration Settings".

H.1 Disabling Fusion Middleware Control from Managing Oracle Business Intelligence Configuration Settings

Caution:

Do not attempt to manually update configuration settings that are normally managed by Fusion Middleware Control unless you have been specifically instructed by Oracle Support Services.

Complete this task to prevent manual updates from being overwritten by Fusion Middleware Control for Oracle Business Intelligence configuration settings that are normally managed by Fusion Middleware Control.

You should not manually update configuration settings (that are normally managed by Fusion Middleware Control) without disabling Fusion Middleware Control. Otherwise, your manual changes are overwritten when the Administration Server is restarted, or if changes are activated.

When Fusion Middleware Control is disabled, the Oracle Business Intelligence configuration settings are disabled in the user interface, the Lock Configuration buttons are unavailable, and a message ("Central Configuration is disabled") is displayed.

If you disable Fusion Middleware Control from managing Oracle Business Intelligence configuration settings, then you can continue to use Fusion Middleware Control for other functions such as starting, stopping, restarting, monitoring performance, and viewing diagnostics.

You can disable Fusion Middleware Control from managing Oracle Business Intelligence configuration settings by manually updating a setting in the biee-domain.xml file, as described in the following procedure.

To disable Fusion Middleware Control from managing Oracle Business Intelligence configuration settings:

Caution:

Do not attempt to manually update a configuration setting that is normally managed by Fusion Middleware Control unless you have been specifically instructed by Oracle Support Services.
  1. Stop Oracle Business Intelligence.

    For information, see Chapter 4, "Starting and Stopping Oracle Business Intelligence."

  2. Complete the following steps to set the centralConfigurationEnabled setting in the biee-domain.xml file:

    1. Open the biee-domain.xml file in a text editor.

      The biee-domain.xml file is located in:

      user_projects\domains\bifoundation_domain\config\fmwconfig\biee-domain.xml

    2. Locate the centralConfigurationEnabled element and ensure that its value is set to false.

      To re-enable the element, set it to true.

    3. Save the biee-domain.xml file.

  3. Restart Oracle Business Intelligence.

H.2 Manually Updating Oracle Business Intelligence Configuration Settings Normally Managed by Fusion Middleware Control

Do not disable Fusion Middleware Control from updating Oracle Business Intelligence configuration settings unless specifically instructed to by Oracle Support Services. If you must update configuration settings normally managed by Fusion Middleware Control, then you can use this procedure.

Configuration settings that are normally managed by Fusion Middleware Control, and which you manually update in a text editor, are overwritten by Fusion Middleware Control when you restart the Administration Server. Therefore you must disable Fusion Middleware Control from overwriting manual configuration changes for parts of the Oracle Business Intelligence system that are centrally managed.

Caution:

If you manually update configuration settings that are normally managed by Fusion Middleware Control (when Fusion Middleware Control is disabled), then you are likely to have to make identical changes in multiple copies of configuration files on multiple computers. If you fail to make appropriate changes in all of the necessary configuration files, then the system is incorrectly configured.

Configuration elements that are normally managed by Fusion Middleware Control are clearly marked in the configuration file as follows:

Warning text in config file.

To manually update the Oracle Business Intelligence configuration settings that are normally managed by Fusion Middleware Control:

  1. If not yet done, disable Fusion Middleware Control from being able to update Oracle Business Intelligence configuration settings.

    For information, see Section H.1, "Disabling Fusion Middleware Control from Managing Oracle Business Intelligence Configuration Settings."

  2. Stop Oracle Business Intelligence.

    For information, see Chapter 4, "Starting and Stopping Oracle Business Intelligence."

  3. Make a backup copy of each configuration file that you plan to edit.

  4. Open the configuration file in a text editor.

    Note:

    If Oracle Business Intelligence is installed on multiple computers or in multiple locations, then a copy of the configuration file exists for each installation, and each file contains duplicate settings. Therefore, you must locate and make the same changes in each copy of a configuration file.

    For information, see Section 3.6, "Where are Configuration Files Located?"

  5. In each configuration file to change, locate the element, or create the new element if a setting must be added to the file.

    For information, see Appendix G, "Mapping User Interface Labels with Configuration File Elements."

  6. Enter the appropriate changes.

  7. Save your changes and close the configuration file.

  8. Restart Oracle Business Intelligence.

    For information, see Section 4.1, "About Starting and Stopping Oracle Business Intelligence."