Customizing Performance Scorecard

This section describes how to modify HPSConfig.properties to customize aspects of Performance Scorecard.

Performance Scorecard now uses common aspect logging. To use the previous style of logging, see Using Category-Based Logging.

  To customize Performance Scorecard:

  1. From application server\webappsconf\config, open HPSConfig.properties in any text editor.

  2. You can change these entries:

    Table 12. HPSConfig.properties

    Entry

    Description

    log4j.appender.ROOT_Appender.
    layout.filters=sun,org,java,javax,com
    Comment out this line to display the stack trace that provides detailed information about errors in the LOG file. The stack will include the exception name, exception message, the related class name, method, file name, and line number. For example:
    at com.hyperion.pmd.hps.system.debug.Assert.
    assertion(Assert.java:78)
    at com.hyperion.pmd.hps.system.debug.Assert.assertion
    (Assert.java:71)
    at com.hyperion.pmd.hps.model.BusinessObjectImpl.
    getOneToOneAssociatedBusinessObject(BusinessObjectImpl.
    java:1100

    hyperion.hps.audit_trail.is_
    required

    Set this to false if you want do not want to save extra auditing information in the data store.

    Caution!

    If set to false, the Alerter and support for deployment in a clustered environment will not work, and will not be able to use promotion.

    hyperion.hps.prefetch

    False—Fetch only page-specific objects This will improve application startup time but may decrease speed.

    True—Pre-fetch all objects. This results in slower application startup time, but better performance. Disables the Performance Scorecard Adapter.

    Note:

    To selectively turn off pre-fetching by object type, contact Oracle Support.

    hyperion.hps.user_account_
    automatic_id_computer_class

    A customer user-id generation algorithm can be implemented as a java class and then its full-package-name specified for this parameter.

    This java class must conform to the com.hyperion.pmd.hps.model.authorization.UserIDFromEmployeeComputerInterface interface (see below) and be available on the classpath.

    public interface UserIDFromEmployeeComputerInterface {
        /**
         @param     emp     Employee business object to base the construction of the user ID upon.
         @return    The user ID that should correspond to the given employee.
        public String computeUserID(Employee emp);

    hyperion.hps.notes.home

    This entry contains the absolute directory path to a directory in which the notes subsystem to keep temporary files.

    hyperion.hps.notes.minimum_db_ connections

    Using an integer greater than 0, this entry states the minimum number of database connections open for the notes subsystem database connection pool. We recommend that you have at least one connection.

    hyperion.hps.
    notes.maximum_db_ connections

    Using an integer greater than 0, this entry contains the maximum number of database connections that can be opened for the notes subsystem database connection pool. We recommend that you have at least four connections available.

    Modify this entry to increase the speed of notes-related functions such as fetching.

    hyperion.hps.
    password_constraint

    Modify this entry to customize the syntax of passwords using regular expressions.

    After changing this entry, modify webreports.password_change.password_ not_match_constraint in the ApplicationResources_*.properties file so the warning message reflects the constraint.

    hyperion.hps.objectAttachments
    Folder

    Provides the directory containing uploaded attachments.

    hyperion.hps.formula.value-caching_limits

    Modify this entry to increase caching limits for formula computations.

    hyperion.hps.datapoint.cached_
    result_limit

    Sets the maximum number of result values fetched from the database that will be cached in memory.

    hyperion.hps.datapoint.cached_
    target_limit

    Sets the maximum number of target values fetched from the database that will be cached in memory.

    hyperion.hps.host_name

    To deploy your application on a different computer, specify the name of the new computer after “hps.” For example: Organization.hps.computer.

    hyperion.hps.main_data_store.
    driver_class_name

    Provides the Java driver class name from the data store vendor used to access the application database. For example:

    hyperion.jdbc.sqlserver.SQLServer Driver

    Modify this entry if you changed database types.

    hyperion.hps.main_data_
    store.user_name

    This value is encrypted and cannot be manually changed.

    Provides the user name or account that connects to the data store (application database).

    hyperion.hps.main_data_store.
    password

    This value is encrypted and cannot be manually changed.

    Contains the password for the account used to log into the database.

    hyperion.hps.authentication_
    service.logon_params

    Contains the log on input fields used to authenticate users. These input field names are separated with blank spaces.

    Possible input field names are:

    • {user_name, password, domain}

    • For basic authentication: user_name password

    • For NTLM authentication: user_name password domain

    hyperion.hps.data_watcher_ service.change_check_ interval_seconds

    For users in a clustered environment: Modify the default value of 150 to increase or decrease the amount of time that elapses before changes made to one instance of an application are reflected in all applications.

    The number you specify instead of 150 is the maximum number of seconds that elapse before the application database shared by multiple applications in a clustered environment is refreshed so changes to one application are reflected in all others.

    hyperion.hps.request_blocker.
    class_name

    This class is set automatically during installation to block all requests during a Oracle's Hyperion® Application Link load or promotion.

    During installation, you select the deployment environment:

    • Non-clustered (single process), or

    • Clustered (multiprocess)

      The Request Blocker class name is automatically set to the appropriate value:

    • com.hyperion.pmd.hps.SingleProcessRequest Blocker

    • com.hyperion.pmd.hps.MultiProcessRequest Blocker

      This value should not be modified unless instructed by Support.

    hyperion.hps.object_id_generator.
    block_size

    Modify this entry to increase the block size of the object ID generator. that reserves a block of IDs in a pool (in the amount set by this entry) and generates the next ID from the pool.
    Because IDs that are reserved but not yet used will not be allocated to any object after rebooting the server, an unnecessarily high value will waste too much IDs if the server is often restarted.

  3. Save the file.