Methods for Configuring System Settings

You can use various methods to configure system settings by changing values that are stored in domain-specific locations.

The system settings are related to either functional behavior (for example, cache, thresholds), or environmental settings (for example, host names, ports, files or metadata locations).

Use the following methods:

The table below shows which method to use when configuring system settings. Each method updates settings in specific configuration files.

What Do You Want to Do? What Methods Can You Use? How Are Updates Made?

Change common configuration settings in an easy to use user interface.

Oracle Analytics Server Console

See Use the Oracle Analytics Server Console.

Oracle recommends that you use this method. However, if a setting isn't available, you can use Fusion Middleware Control, see Use Fusion Middleware Control, or a text editor.

Change values in specific Oracle Analytics Server configuration pages in the Oracle Analytics Server Console .

For example, to enable the cache, you click Cache Enable in the System Settings option in the Console.

Change configuration settings by manually editing a file.

Text editor

See Use a Text Editor.

Oracle recommends that you use this method when a setting isn't available in Fusion Middleware Control Oracle Analytics Server pages.

Change values in a configuration text file using a text editor.

Make more complex configuration changes using scripts.


See About the Scripts for Managing Service Instances.

Oracle recommends that you use this method when instructed by the documentation.

Make configuration changes by running commands using scripts.

Use the Oracle Analytics Server Console

Use Console to set advanced system settings for Oracle Analytics Server.

  1. Click Console.
  2. Click System Settings.
  3. Update the property value.
  4. If required, click Restart and then click OK to confirm.
    Wait a few moments for the changes to refresh through the system.

Use Fusion Middleware Control

You can use Fusion Middleware Control to update specific configuration settings.

Configuration settings you can change include performance settings, dashboard and analysis default presentation settings, and mail server settings used by agents.

If a configuration setting isn't available in Fusion Middleware Control, you can use a text editor to update the setting in a configuration file. See Methods for Configuring System Settings.

  1. Go to the Overview page, as described in Display Oracle Analytics Server Pages in Fusion Middleware Control.
  2. Select the appropriate page and tabs to display the settings to change.
  3. Click Lock and Edit to enable changes to be made.


    Oracle recommends that multiple administrators don't share the same administrator account. They can unknowingly make concurrent updates to the same configuration settings.
  4. Make the appropriate changes on each page.
  5. Click Apply on each page after you have made your changes.
  6. When you have finished making your changes, do one of the following:
    • Click Activate Changes to process your changes and release the lock to enable another system administrator to make changes.

    • Click Release Configuration to undo all changes you made since clicking Lock and Edit and release the lock to enable another system administrator to make changes.

  7. After you have activated your changes, go to the Overview page and click Restart.

Use a Text Editor

You can use a text editor to add or change a setting in a configuration file.

You would use text editor for the system configuration settings that are not available in Fusion Middleware Control.

Use the following procedure to update configuration files using a text editor.

  1. Make a backup copy of the files that you plan to edit.
  2. Open the appropriate configuration file in a text editor.
  3. In the configuration file, locate the element or create a new element if you must add a setting to the file.
  4. Enter the appropriate changes.
  5. Save your changes and close the configuration file.
  6. Restart the system in Fusion Middleware Control, go to the Process tab in the Availability page, and restart all components.

Use Scripts

Oracle provides scripts to perform Oracle Analytics Server configuration tasks. For example, to create a domain during installation, or to add a machine for high availability.

To run scripts see Use Scripts to Manage Oracle Analytics Server Instances:

Update the Java Development Kit (JDK)

After you install and configure Oracle Analytics Server, you might need to update the JDK for the instance; for example, if an update is required per the policy of your organization.

Before deciding to update the JDK, ensure that you consider an appropriate version.

  1. Stop all services for Oracle Analytics Server.
  2. Download the appropriate JDK version from the Oracle Java web site and copy it to the ORACLE_HOME directory.
  3. Rename the existing jdk directory to jdk.OLD.
  4. Run the JDK Installer, which unzips the distribution into the jdkversion-num directory.
  5. Rename the directory from jdkversion-num to jdk, to ensure that all existing configuration references remain valid.
  6. Restart the services for Oracle Analytics Server.

For information on installing with a specific JDK, see Installing and Configuring Oracle Analytics Server.