Using the Server Configuration Utility to Modify Server Configuration Parameters

The server.conf file contains the values of all of the server parameters applied during the last server configuration utility (kConfig.sh script) run.

Note: We recommend that you not modify the server.conf file directly. Instead, modify parameter values from the Administration Console interface, or use the server configuration utility (kConfig.sh), both of which provide a graphical interface that you can use to change the server configuration parameter values.

For information about how use Administration Console to modify parameter values, see Modifying Parameters from the Administration Console.

To edit the server.conf file using the server configuration utility:

  1. Stop the PPM Server.

  2. Run the kConfig.sh script.

    After you finish specifying configuration parameter values, the kConfig.sh script automatically runs the kUpdateHtml.sh script to regenerate the server.conf file and apply your changes. For information about the kUpdateHtml.sh script, see kUpdateHtml.sh.

    If you make a change to the server.conf file that affects more than one node in a cluster, you must:

    • Stop all the nodes in the cluster.

    • Run the kUpdateHtml.sh script on each machine.

    • Start all the nodes in the cluster, one at a time.

  3. Restart the PPM Server.

    To view a list of the server configuration parameter values on an active PPM Server, run the Server Configuration report. (See Running Server Reports from the Admin Tools Window and Running server reports from the command line .)

The following table provides descriptions of the configuration parameters in the server.conf file. The parameter names listed in the table are shortened versions of the actual names, all of which start with the string com.kintana.core.server. For example, the full name of the CLIENT_TIMEOUT parameter is com.kintana.core.server.CLIENT_TIMEOUT.

Table A-1. Server configuration parameters
Parameter Name
(*Required,
**Required If)
Description, Usage Default and Valid Values

AAL_DATA_EXTRACT_MAX_RESOURCES

Determines the maximum number of resources that can be extracted from the database and returned in the Analyze Assignment Load portlet in Resource Management. This acts as a safety valve to prevent PPM from hanging if a user defines portlet criteria that would return a very large volume of data.

Default: 1000

Valid values:
Positive integer

AAL_PORTLET_MAX_RESOURCES

Maximum number of resources pools to be represented in the Analyze Assignment Load portlet in Resource Management.

If the resource count exceeds the set value, the PPM Server stops calculating and displays no result in the portlet.

Note: Setting a very high value for this parameter could affect system performance.

Default: 300

Valid values:
Any positive integer

ADD_QUOTES_FOR_DB_CONNECTION

Set it to true in the server.conf file if you encounter the following error when running the sqlplus command of a report:

-bash: syntax error near unexpected token `('

This will automatically adds single quotes outside the command description.

Default: false

Valid values:
true, false

ALLOW_DELETE_WORK_PLAN_WITH_ACTUALS

If it is set to true, PPM allows project managers to directly delete a work plan with actuals.

We recommend that you keep its value as false, preventing project managers from deleting a work plan with actuals, and set it to true temporarily only for special cases.

Default: false

Valid values:
true, false

ALLOW_SAVE_REQUEST_DRAFT

If set to true, enables the Save Draft button on the Create New Request page, which allows Demand Management users to save requests without automatically submitting them in the standard interface.

Default: false

Valid values:
true, false

ALLOWED_MSP_INTEGRATION_MODE
  • When set to MPP_FILE, you can only use MPP file to integrate PPM with Micrsoft Project.
  • When set to PLUGIN, you can only use Microsoft Project plug-in to integrate PPM with Microsoft Project.
  • When set to BOTH, you can select to use either MPP file or plug-in to integrate PPM with Microsoft Project.

Default: BOTH

Valid values:
MPP_FILE, PLUGIN, BOTH

APP_SERVER_ALERT_TEXT

Alert text that displays on the application server logon page and headers.

 

**APP_SERVER_UIL2_BINDING_PORT

JBoss UIL2 Binding port. You must set a value for this parameter if the PPM Server is part of a server cluster.

Default: 8093

Valid values:
If the PPM Server is part of a cluster, specify a value that is unique for the node.

ARP_MAX_RESOURCE_POOLS

Maximum number of resource pools that can be represented in the Analyze Resource Pool portlet in Resource Management.

If the resource pool count exceeds the set value, the PPM Server stops calculating and no result is displayed in the portlet.

Note: Setting a very high value for this parameter could affect system performance.

Default: 30

Valid values:
Positive integer

ARP_MAX_RESOURCES

Maximum number of resources that can be represented in the Analyze Resource Pool portlet in Resource Management.

If the resource count exceeds the set value, the PPM Server stops calculating and no result is displayed in the portlet.

Note: Setting a very high value for this parameter could affect system performance.

Default: 300

Valid values:
Positive integer

ARP_PORTLET_MAX_RESOURCE_POOLS

Maximum number of resource pools to be represented in the Analyze Resource Pool portlet in Resource Management.

If the resource pool count exceeds the set value, the PPM Server stops calculating and displays no result in the portlet.

Note: Setting a very high value for this parameter could degrade system performance.

Default: 30

Valid values:
Any positive integer

ASSET_ROLLUP_TIMESHEETLINE_BATCH_SIZE Specifies the batch size of time sheet lines for asset cost calculation.

Default: 800

Valid: Any positive integer

*ATTACHMENT_DIRNAME

Absolute pathname of the directory where attached documents are to be stored. This directory must:

  • Give read/write access to Web browsers

  • Be outside the directory tree if the system includes an external Web server

In a server cluster, all servers must be able to access and share the specified directory.

Example

C:/ppm/eon
/attachments

AUTHENTICATE_REPORTS

If set to true, access to all reports requires user authentication. (A user must provide a PPM user login ID).

Default: true

Valid values:
true, false

*AUTHENTICATION_MODE

Method(s) used to authenticate users.

To specify multiple modes, use a comma-delimited list of valid values.

Default: ITG

Valid values:
ITG,LDAP,
NTLM,SITEMINDER

AUTO_COMPLETE_LONG_TYPE_CULLTEXT_REQUIRED

Determines whether the user must enter a filter in the auto-complete dialog box in order to retrieve the initial results for validations of type long. If set to true, and no user filter is specified, the validation returns an empty result set. The user must then either click Find or select the Show All link.

Default: false

Valid values:
true, false

AUTO_COMPLETE_LONG_TYPE_MAX_ROWS

Maximum number of rows in long auto-complete lists.

Default: 5000

AUTO_COMPLETE_QUERY_TIMEOUT

Sets query timeouts on auto-complete lists to prevent excessive database CPU use.

Default: 30 (seconds)

AUTO_COMPLETE_SHORT_TYPE_MAX_ROWS

Maximum number of rows to retrieve from the database for short type auto-completion lists.

Default: 500

AUTO_RELATE_TS_EXTERNAL_DATA

If it is true, when you import effort from agile systems to your time sheet, PPM automatically selects a project or task for the effort, adds the project or task in your time sheet, and transfers the agile effort to the project or task.

If it is false, agile effort is imported to your time sheet as external data. You can manually transfer external data to a PPM work item.

Default: false

Valid values: true, false

AUTOCOMPLETE_STATUS_REFRESH_RATE

Interval at which the command status is refreshed to provide a list of values in an auto-complete list.

Default: 5 (seconds)

BACKGROUND_SERVICE_MONITOR_THRESHOLD

If ENABLE_BACKGROUND_SERVICE_MONITOR is enabled, this parameter determines the threshold value of the Background Services monitor.

Default: 900000 (milliseconds)

BASE_LOG_DIR

Points to the "logs" directory directly under the directory specified for *BASE_PATH.

In a server cluster, all servers must be able to access and share the specified directory.

Example com.kinta
na.core
.server.
BASE_LOG_DIR=C:/PPM/eon/logs

*BASE_PATH

Full path to the directory where the PPM Server is installed.

Default: Based on the operating system platform.

Example:
C:/PPM/eon/

*BASE_URL

Web location (top directory name) of the PPM Server.

If you want to specify a literal IPv6 address, make sure you enclose the literal address with "[" and "]" characters. For example, http://[::1]:8080

Note: We strongly recommend you specify DNS name instead of literal IPv6 address.

Example:

http://www.mydomain
.com:8080

BASE_URL_QC_INTEG

Used in the process of enabling the integration of PPM with Quality Center when PPM is set up with an external Web server with HTTPS enabled.

For detailed information on how to use this parameter, see the Solution Integrations Guide.

Default:N/A

Valid values:
http://<Instance
_Host
_Name
>:<HTTP
_Port

>/itg/

BLOCK_PENDING_PKGL_FOR_ERROR

Specifies whether or not the system continues executing the subsequent package lines when a package line fails.

If you set this parameter to false, when a package line fails, the system continues executing the subsequent package lines. If you set this parameter to true, the execution is blocked when a package line fails.

When a package line fails and its subsequent package lines pass, the status of this execution is still successful in PPM Workbench. However, you should note that even when the status is successful, it does not mean all the package lines are executed successfully in logical relationship to meet your business needs. Micro Focus suggests that you exercise caution when setting this parameter to false, unless you are absolutely sure about the consequences.

Default: true

Valid: true, false

BUDGET_IN_THOUSAND_SHOW_DECIMAL

Used with the BUDGET_IN_WHOLE_DOLLARS parameter as follows:

  • If BUDGET_IN_WHOLE_DOLLARS is set to true, the BUDGET_IN_THOUSAND_SHOW_DECIMAL parameter is ignored and values are displayed as whole numbers.

  • If BUDGET_IN_WHOLE_DOLLARS is set to false, and BUDGET_IN_THOUSAND_SHOW_DECIMAL is set to false, values are displayed as 1000s without decimals. For example, the value 1234567 is displayed as 1235.

  • If BUDGET_IN_THOUSAND_SHOW_DECIMAL is set to true, values are displayed as 1000s with decimals. For example, the value 1234567 is displayed as 1234.567.

Default: false

Valid values:
true, false

BUDGET_IN_WHOLE_DOLLARS

Determines whether forecast, approved funding, and financial summary values are expressed in whole dollars.

Default: false

Valid values:
true, false

BYPASS_STARTUP_CHECKS

If set to true, prevents server checks at PPM startup.

Caution: We strongly recommend that you leave this parameter set to false, unless Software Support has advised that you set it to true.

Default: false

Valid values:
true, false

CCM_MACHINE_URL a

URL of the Release Control server and port number used for integration with PPM.

Valid value format:
http://<Host>
:<Port>
/ccm/

CHANGE_MANAGEMENT_LICENSE_KEY

License key for Demand Management.

Default: N/A

CHECK_COMMIT_RESOURCES_ IN_RESOURCE_FINDER

Flags whether or not the option Commit selected resources is checked in resource finder.

The setting of this parameter is only meaningful when the parameter ENABLE_COMMIT_RESOURCES_IN_RESOURCE_FINDER is set to true.

Default: false

Valid values:
true, false

CHECK_DISTRIBUTE_RESOURCES_ IN_RESOURCE_FINDER

Flags whether or not the option Distribute demand evenly to selected resources is checked in resource finder.

The setting of this parameter is only meaningful when the parameter ENABLE_DISTRIBUTE_RESOURCES_IN_RESOURCE_FINDER is set to true.

Default: false

Valid values:
true, false

CHECK_STATIC_JS_FILES_UPDATES When set to true, PPM checks if JS files were modified every time before including them in a JSP page and recomputes the hash accordingly.

Default: false

Valid values:
true, false

CLIENT_RMI_URL

Port on which the PPM Server listens to initiate RMI client/server communication via port forwarding.

Must be a unique port, distinct from the Web server, SQL*Net, and the HTTP or HTTPS ports.

Format:

rmi://<Public_Server_IP_Address>: <Public_Server_Port>/KintanaServer

Valid values:
Port numbers higher than 1024

Example

rmi://gold.ppm
.com:8082
/PPMServer

CLIENT_TIMEOUT

Frequency (in minutes) with which the PPM Workbench interface session sends a message to the PPM Server that indicates the client is still active.

Under normal operation, do not change this value.

Default: 5

CLOSE_BROWSER_ON_APPLET_EXIT

Determines whether the client browser closes after the user quits the PPM Workbench.

Default: false

Valid values:
true, false

CMQC_QC_VERSION

Specifies ALM/Quality Center version for CMQC solution.

Valid values:
10.00, 11.00

CMQC_INIT_STRING

The value for initString parameter for CMQC solution, for example,

INI:s4OF+cwwevEkcnJ9zWHwpE8ktxfl1pb5y8QoENFQLs8=

You can get the value from Quality Center/ALM server.

The initString value is stored in a properties file (ALM\jboss\server\default\deploy\20qcbin.war\WEB-INF\siteadmin.xml) or an XML configuration file (ALM\conf\qcConfigFile.properties) on the server where Quality Center/ALM is installed.

Valid value: string

COLOR_CACHE_SIZE

Used to extend the number of colors available in the cached copy of the ColorPalette.css file.

 

**CONC_LOG_TRANSFER_PROTOCOL

Required if ORACLE_APPS_ENABLED = true

Transfer protocol used to transfer concurrent request logs and patching README files. If you use Object Migrator with PPM, you must specify a value.

Default: FTP

Valid values:
FTP, SCP

**CONC_REQUEST_PASSWORD

Required if ORACLE_APPS_ENABLED = true

Encrypted password of the concurrent request user. If you use Object Migrator with PPM, you must specify a value.

Note: You must use kEncrypt.sh to encrypt the password. For information on how to run the kEncrypt.sh script, see kEncrypt.sh.

Default: N/A

Valid values:
Encrypted password in the format #!#<Encrypted_Password>#!#

**CONC_REQUEST_USER

Required if ORACLE_APPS_ENABLED = true

Valid user on the Oracle system that can be used to retrieve concurrent request output files. If you use Object Migrator with PPM, you must specify value.

Set the retrieval method (FTP or SCP).

See CONC_LOG_TRANSFER_PROTOCOL.

Example applmgr

COST_CAPITALIZATION_ENABLED

Flag to enable cost capitalization globally. You can enable this parameter only in the server.conf file.

Note: We strongly recommend that you not change the value of this parameter after PPM has been put into use.

Default: false

Valid values:
true, false

COST_ROWS_BATCH_SIZE

Batch size of rows for the Cost Rollup Service to process.

Default: 1000

COST_RATE_RULE_ UPDATE_SERVICE_COMMIT_BATCH_ SIZE Batch size for the Cost Rate Rule Update Service to process. Default: 20

CUSTOM_SERVER_INFO

Enables customization of the text
displayed in the PPM Workbench title bar. For example,
com.kintana.core.server.CUSTOM_SERVER_INFO=Welcome to PPM Workbench

Default: N/A

Valid value:

Text string

dashboard.Page-Filters-Usage Whether or not to enable dashboard page filters.

Default: Disabled

Valid values: Automatic, Disabled

The value of this prameter is case-sensitive. Lower-case values are not working.

DATE_NOTIFICATION_INTERVAL

Interval at which the PPM Server is to check to determine whether date-based notifications are pending, and to send them.

Default: 60
(minutes)

DAYS_TO_KEEP_APPLET_KEYS

Number of days applet keys are retained in the KNTA_APPLET_KEYS table.

Default: 1

DAYS_TO_KEEP_COMMANDS_ROWS

Number of days records are kept in the prepared commands tables before they are cleaned up.

Default: 1

DAYS_TO_KEEP_INTERFACE_ROWS

Number of days to keep records of all interfaces.

Default: 5

DAYS_TO_KEEP_LOGON_ATTEMPT_ROWS

Number of days to keep records of all logon attempts.

Note: PPM keeps a record of the most recent logon attempt, regardless of when it occurred. So, for example, if the sole user only logs on once a month, PPM retains the record of the last logon, even if DAYS_TO_KEEP_LOGON_ATTEMPT_ROWS is set to 14 days.

Default: 14

DAYS_TO_KEEP_LOGON_SESSIONS_ROWS Number of days to keep records of all user sessions. Default: 60

**DB_CONNECTION_STRING

(Required if RAC is used)

Oracle RAC (Real Application Clusters) service name.

Example
K92RAC

DB_LOGIN_TIMEOUT

Amount of time that the PPM Server is to continue to try to log on to the database (acquire the JDBC connections that make up the connection pool) before reporting that the database is unavailable.

Default: 30000
(milliseconds)

*DB_PASSWORD

Password for the database schema that contains the PPM tables.

Note: You must use kEncrypt.sh to encrypt the password. For information on how to run the kEncrypt.sh script, see kEncrypt.sh.

Example
#!#<Password>#!#

DB_POOL_DEADLOCK_CHECK_INTERVAL

Specifies database pool deadlock check interval.

Default: 10

DB_RECONNECTION_CHECK_INTERVAL

Specifies database reconnection check interval.

Default: 240

DB_SESSION_TRACKING

May have been replaced by ENABLE_DB_SESSION_TRACKING

Valid values:
TRUE, FALSE

*DB_USERNAME

Name of the database schema that contains the PPM tables.

Example

knta

DEFAULT_COMMAND_TIMEOUT

Number of seconds the PPM Server can try to run commands before it times out.

Default: 90

DEFAULT_EXPENSE_TYPE_FOR_POSITIONS

Specifies the default value of expense type for staffing profile positions when costs are capitalized.

Note: If the Expense Type field is not editable (because SOP 98-1 is not enabled on the parent entity of the staffing profile), Capex is still the default value regardless of how the parameter is set.

Default value: Capex

Valid values: CAPEX, OPEX, and SPLITXX, with XX being the percentage going to CAPEX.

*DEFAULT_PAGE_SIZE

Number of work plan lines that can be loaded into the Work Plan page for all new users. This setting indicates whether to use the fast setting or the slow setting (rather than indicating a specific size).

In new installations, this defaults to the slow connection setting. We recommend that the system administrator review this setting after installation.

If your system has mostly LAN users (fast connections), set this to use the fast setting. If your system has mostly WAN/VPN users (slow connections) or mixed usage, set this to use the slower setting.

Default: 50

DEFAULT_STAFFING_EFFORT_EDIT_MODE

Specifies the default editable view (Gantt view or Table view) in Staffing Profile New UI.

If you do not specify the parameter value, the default editable view is Gantt view.

Default value: Gantt

Valid values: Gantt, Table

 

*DEFAULT_PAGE_SIZE_OPTION

Initial type of page size (low, high, or custom) selected for the Edit My Profile page.

Default: LOW_PAGE_SIZE

Valid values:

LOW_PAGE_SIZE,
HIGH_PAGE_SIZE,
and
CUSTOM_PAGE_SIZE

DEFAULT_REQUEST_SEARCH_ORDER_BY_ID

Affects the Sort By field on the Search Requests page. The default value is true, which sorts the search results based on Request ID. If set to false, search results are returned unsorted.

Default: true

Valid values:
true, false

*DEFAULT_TIME_SHEET_LINES_VIEW_MODE

Determines whether the time sheet items in Time Management are grouped under appropriate headings, or displayed in a flat list without headings. For detailed information about grouped and ungrouped display of time sheet items, see the Time Management User Guide.

Default: grouped

Valid values:
grouped, flat

DEMAND_FIELDS_CACHE_SIZE

Specifies the size of the demand set fields cache in number of demand set.

Default: 10

DEMAND_FIELDS_CACHE_TIMEOUT

Timeout for the demand set fields cache, expressed in seconds.

Default: 360000
(seconds)

DEPLOY_BASE_PATH

Deployment destination.

Note: We recommend that you leave the default value unless the PPM Server directory is renamed.

Default: server/

DISPLAY_ICONFONT_AS_IMG When it is set to true, icon fonts in PPM web pages are displayed as images.

Default: false

Valid values:
true, false

DIST_ENGINE_MONITOR_SLEEP_TIME

Used in release distribution. Number of milliseconds the monitor waits between checking existing result listener. Use this parameter to adjust the amount of time the monitor sleeps between checks.

Note: We recommend that you not change this value. It does not affect performance.

Default: 5000
(milliseconds)

DMS_DB_ENABLE_ FULLTEXT_SEARCH

To enable the database fulltext search feature in document management for PPM, set this parameter to true.

Note: You must create and build database indexes in advance. For details, see the Document Management Guide and Reference.

Default: false

Valid values:
true, false

DMS_FILENAME_ DISPLAY_LENGTH

Determines the number of characters shown in the References section for the names of files attached to PPM entities.

Default: 30

Valid values:
Positive integer

DMS_FILENAME_SEARCH_MAX_RESULTS

Specifies maximum number of matching items before applying filters from other search criteria, such as creation date or "Closed" status. You may need to increase this value if too many filename matching items are filtered out by very selective search criteria.

Default: 1000

Valid values:
integer

DMS_INSECURE_FILE_EXTENSIONS Defines the file extensions that you think insecure and cannot be uploaded to PPM.

Example:

exe, com, bat, reg, jar, cmd, lnk

DMS_SECURE_FILE_EXTENSIONS_WHITE_LIST

Defines a list of comma-separated file extensions that are allowed to be uploaded to PPM.

If defined, it has priority over the following parameters:

  • DMS_INSECURE_FILE_EXTENDSIONS
  • DMS_INSECURE_FILE_EXTENSION_CHECK

Example:

txt, html, docx

DMS_INSECURE_FILE_EXTENSION_CHECK

Flags whether or not to prevent uploading files of the extensions defined in the DMS_INSECURE_FILE_EXTENDSIONS parameter.

If you set this parameter to false, files of all extensions are allowed to be uploaded. If you set this parameter to true, files of the extensions defined in DMS_INSECURE_FILE_EXTENDSIONS cannot be uploaded.

Default: false

Valid values: true, and false

DMS_XSS_CHECK

Flags whether or not to display the document download links.

If you set this parameter to true, the document download links on PPM pages are hidden.

Default: false

Valid values: true, and false

DMS_MIGRATION_ DELAY_BETWEEN_ DOCUMENT

Determines the duration (in seconds) that a thread will wait between two documents to migrate. To lighten the load of the migration process on the PPM Server, increase the value of this parameter.

Default: 0 (seconds)

Valid values:
Positive integer

DMS_MIGRATION_ DOCUMENTS_BATCH_ SIZE

Determines the number of documents to be queued for migration on a given PPM Service node. Every time the DMS Migration Engine Service runs on a Service node, the queue of documents to be migrated is filled up.

Default: 1000

Valid values:
Positive integer

DMS_MIGRATION_THREAD_COUNT

Specifies number of threads that will be migrating documents on a given PPM Service node.

Default: 3

Valid values:
integer

EDIT_TIMESHEET_TABLE_ MAX_HEIGHT

The vertical size (in pixels) of the time sheet table before the vertical scroll bar appears in the table.

For example, if you set it to 300, the vertical scroll bar appears when the vertical size of the time sheet table exceeds 300 pixels.

Default value: 1,500

Valid values: positive integer

EMAIL_NOTIFICATION_SENDER

Email address of the default sender of email notifications.

This sender receives any error messages associated with email notifications.

Example
mgr@ppm.com

ENABLE_ALL_PERFORMANCE_MONITOR If you set this parameter to true, you enable the UI monitor, the portlet monitor, and the Background Services monitor, regardless of whether these three monitors are enabled or not. If you set this parameter to false, the UI monitor, the portlet monitor, and the Background Services monitor are enabled or disabled according to their own parameters. Default: false
ENABLE_ANTISAMY

If you set this parameter to true, you enable the AntiSamy feature to protect PPM from potential security issues. End users cannot open hyperlinks on request details page or project details page.

If you set this parameter to false, you disable the AntiSamy feature. End users can open the hyperlinks on the request details page or project details pages.

If you enable the AntiSamy feature and still want your end users to access to specific hyperlinks, you can configure the the antisamy-ppm.xml file located in <PPM_HOME>\conf to add those hyperlinks.

Default: true

Valid values:
true, false

ENABLE_BACKGROUND_SERVICE_MONITOR

If set to true, enables the background services monitor.

Default: true

Valid values:
true, false

ENABLE_BUSINESS_OBJECTIVES

Menus for creating and managing business objectives willl only show up if this parameter is set to true.

If you set it to false, you may also want to hide the Business Objective field in all PFM request types.

Default: true

Valid values:
true, false

ENABLE_COMMIT_RESOURCES_IN_RESOURCE_FINDER Flags whether or not the option Commit selected resources is available in the resource finder. This option is used to commit assigned resources.

Default: true

Valid values:
true, false

ENABLE_DISTRIBUTE_RESOURCES_IN_RESOURCE_FINDER Flags whether or not the option Distribute demand evenly to selected resources is available in the resource finder. This option is used to distribute demand evenly to selected resources after they are assigned.

Default: true

Valid values:
true, false

ENABLE_CONC_FILES_RETRIEVAL

Flags whether PPM server retrieves log/output files from Oracle E-Business Suite server or not.

With the Oracle Apps (the extension for Oracle E-Business Suite) and the extension for Oracle Technology deployed on PPM Server, you may encounter performance issue with PPM server retrieving log/output files from Oracle EBS server. For better performance, you can add this parameter into the server.conf file manually and set the parameter value to false to switch off the log/output files retrieval. Make sure you restart the PPM Server for the server configuration parameter to become effective.

Default: true

Valid values:
true, false

ENABLE_CONC_FILES_RETRIEVAL_DEBUG

Controls whether to print debugging messages when transferring concurrent Request logs.

If you want to troubleshoot the concurrent request logs retrieval from Oracle EBS server to PPM server, set both ENABLE_CONC_FILES_RETRIEVAL_DEBUG and ENABLE_SCP_CLIENT_DEBUG to true, then you can get detailed debugging message from the package line logs.

Even when the two parameters are false, if there are exceptions, the exceptions are always printed into the package line logs.

Default: false

Valid values:
true, false

ENABLE_SCP_CLIENT_DEBUG

Controls whether to print debugging messages for SCP command.

If you want to troubleshoot the concurrent request logs retrieval from Oracle EBS server to PPM server, set both ENABLE_CONC_FILES_RETRIEVAL_DEBUG and ENABLE_SCP_CLIENT_DEBUG to true, then you can get detailed debugging message from the package line logs.

Even when the two parameters are false, if there are exceptions, the exceptions are always printed into the package line logs.

Default: false

Valid values:
true, false

ENABLE_CONCURRENT_REQUEST_UPDATES

Related to requests in Demand Management. If set to true, multiple users can change the same request simultaneously. Request data such as notes, new references and new table entries are always saved. Conflicting changes that cannot be saved are displayed to the user as differences.

Default: true

Valid values:
true, false

ENABLE_CONNECTION_CORRELATION

The Connection Correlation page is intended for use by Software Support for troubleshooting and is disabled by default in a production environment. If the page is enabled, you access it by selecting Open > Administration > View connection correlation from the PPM Dashboard.

To enable the Open > Administration > View connection correlation menu item and the Connection Correlation page, add the ENABLE_CONNECTION_CORRELATION parameter to the server.conf file, and set its value to true.

Default: false

Valid values:
true, false

ENABLE_DB_SESSION_TRACKING

If set to true, enables a stack trace to be reported in the PPM DB Server Reports, which you can use to track the exact line of code used to request a database connection.

Default: false

Valid values:
true, false

ENABLE_IPV6

Add this parameter to the server.conf file and set it to true to enable support for IPv6.

Note: If this parameter is not present in the server.conf file, the system uses IPv4 by default.

Default: false

Valid values:
true, false

ENABLE_GENERIC_SSO_TIMEOUT

If you set this parameter to true, the session timeout property works fine in generic SSO implementation. PPM redirects you to the sign-in page when it times out and forwards you to the Dashboard page after you click Sign-in.

Note: In MLU environment, a window pops up for you to select the session language before you click Sign-in.

If you set the parameter to false, the session timeout property does not work in generic SSO implementation.

Default: false

Valid values:
true, false

ENABLE_JDBC_LOGGING

Enables JDBC logging, which records SQL runs against the database, the time required to run the SQL, and the time to retrieve the results. This information is recorded in jdbc.System_Name.log in the server log directory.

This parameter is useful in debugging system performance problems.

You can set this parameter in the PPM Workbench interface without stopping the system (Edit > Settings).

Default: false

Valid values:
true, false

ENABLE_LOGIN_COOKIE

If set to true, the Remember my logon option is displayed on the logon page, and a cookie is placed on the client browser to maintain a record of the user logon information.

Remember my logon sets a cookie on the local machine that lets a user log on to PPM later, without providing logon information. You can also view reports through notification links, and so on, without logging on. This cookie is removed only if the user clicks Sign Out (or clears cookies, or the cookie expires). If a user closes the browser window without signing off, the cookie is not cleared.

To disable this function, change the parameter value to false.

Note: If PPM is integrated with an SSO provider such as SiteMinder, then set this parameter to false. If PPM is not integrated with an SSO provider, we recommend that you keep the parameter set to true.

Default: false

Valid values:
true, false

ENABLE_LOG_SUCCESS_SERVICE_LIST Specify the refernces codes of services. If these services are run successfully, PPM will record the success logs for them. Reference codes are separated by semicolon.

For example:

_COST_RATE_RULE_ UPDATE_SERVICE; _ COST_ROLLUP_SERVICE

ENABLE_LW_SSO_UI

If added to the server.conf file and set to true, enables the lightweight single sign-on (LW-SSO) user interface

Default: N/A

Valid values:
true, false

ENABLE_LW_SSO_WEB_ SERVICE

(For integration of PPM Tasks with Service Manager RFCs only)

If LW-SSO authentication is enabled, add this parameter to the server.conf file and set it to true to specify that PPM is to always use the current user to call the Service Manager Web service.

Default: N/A

Valid values:
true, false

ENABLE_MOBILITY_ACCESS_SERVICE

If set to true, enables the Mobility Access Service.

Default: false

Valid values:
true, false

ENABLE_OVERVIEW_PAGE_BUILDER

Provided for backward compatibility if you have customized "overview pages". If you do not have customized "overview pages", leave the default value (false).

Default: false

Valid values:
true, false

ENABLE_PORTLET_FULL_RESULTS_SORTING

If set to true, enables sorting of portlet results.

Default: false

Valid values:
true, false

ENABLE_PORTLET_MONITOR

If set to true, enables the portlet monitor, which gathers statistics on portlet performance. If activity exceeds the threshold value (determined by the parameter PORTLET_MONITOR_THRESHOLD), the captured information is output to the thresholdLog.txt log file, which resides in same directory as the server log.

Default: false

Valid values:
true, false

ENABLE_PROJECT_LAUNCH_FROM_ACTION_MENU

If set to true, enables users with the required permission to open the PPM Workbench as a stand-alone application using Active X.

Default: true

Valid values:
true, false

ENABLE_PROJECT_COST_ROLLUP

Setting this parameter to false prevents the Cost Rollup service from running when you do the following:

  • create a work plan from template
  • Schedule summary tasks
  • Schedule work plans
  • Indent/outdent tasks
  • Import a work plan from another work plan

Disabling this parameter helps save time and memory in the above actions.

Default: false

Valid values:
true, false

ENABLE_PROJECT_DETAIL_VALIDATE

When you set it to true, the system will check the fields on Project Details tab before you switch to another tab. If the fields are updated without saving, a prompt will pop up for your confirmation.

When you set it to false, the system will not do the check, and the prompt will not appear.

Default: true

Valid values: true,false

ENABLE_PROMISE_RESOURCE_ALLOCATION

If set to true, a user who has the Resource Management: Promise Unspecified Resources access grant can promise allocations and modify or remove previously promised allocations. A user who does not have the access grant cannot promise allocations or modify or remove previously promised allocations. In this case, the promise allocations for the resource pool (if any) are displayed (view-only) on the Staffing Profile and the Resource Allocation Management pages. The values are used in computing totals, regardless of whether the user has the Resource Management: Promise Unspecified Resources access grant.

Default: false

Valid values:
true,false

ENABLE_QUALITY_CENTER_INTEGRATION a

(For integrating with Quality Center version 10.00 only) If no XML mapping file has been generated and deployed to both PPM and Quality Center, set this value to false. If a mapping has been deployed, to enable the integration, set the value to true.

Default: false

Valid values:
true, false

ENABLE_QUERY_BUILDER

If set to true, enables the advanced "query builder" capability for searching Demand Management requests.

Default: true

Valid values:
true, false

ENABLE_QUICKLIST_UPDATE

Controls the visibility of the Update button on the Quick List.

Default: true

Valid values:
true, false

ENABLE_REQUEST_EXPORT_TO_PDF If its is true, you can export a request to PDF by clicking More > PDF in the request details page.

Default: true

Valid values:
true, false

ENABLE_RESTRICTIONS_ON_PROJ_SEARCH

To enable a restriction on the number of projects returned on project searches, set this parameter to true.

To specify the maximum number of projects returned on project searches, set the MAX_RESULTS_ALLOWED_ON_PROJ_SEARCH parameter.

Default: false

Valid values:
true, false

ENABLE_ROADMAP_EXT_ATTR If set to true, administrators can define the database view APM_ROADMAP_ENTITY_EXT_ATTR_V to add customized columns in APM roadmap hierarchy.

Default: false

Valid values:
true, false

ENABLE_SITE_MAP

If set to true, enables the Site Map link in the header of each page.

Default: false

Valid values:
true, false

ENABLE_SKIP_NAVIGATION

If set to true, enables the Skip Navigation link in the header of each page.

Default: false

Valid values:
true, false

ENABLE_SP_LABOR_COST_UPDATE

If set to true, PPM calculates staffing profile labor cost when you save project settings.

PPM suggests that you do not change it to false unless you meet the following conditions:

  • The project has a large staffing profile which contains more than 200 positions.
  • It takes more than 2 minutes to save the project settings.

Default: true

Valid values:
true, false

ENABLE_SQL_TRACE

Determines whether performance statistics for all SQL statements run are placed into a trace file.

The SQL trace facility generates the following statistics for each SQL statement:

  • Parse, run, and fetch counts
  • CPU and elapsed times
  • Physical reads and logical reads
  • Number of rows processed
  • Misses on the library cache
  • User name under which each parse occurred
  • Each commit and rollback

This parameter corresponds to the Enable DB Trace Mode checkbox in the Server Settings dialog box.

Default: false

Valid values:
true, false

ENABLE_SSL_LOGIN

Enables flag for the SSL Login page. If set to true, then the following parameters must also be set:

Default: false

Valid values:
true, false

ENABLE_STAFFING_PROFILE_LEGACY_VIEW

Flags whether or not Staffing Profile Legacy UI is enabled so that you can switch staffing profile page between New UI and Legacy UI.

Default: false

Valid values:
true, false

ENABLE_STRATEGIC_THEMES Menus, request detalls section, and portfoliio Strategy tab for managing strategic themes will show up only if the parameter is true.

Default: true

Valid values:
true, false

ENABLE_TIMESTAMP_LOGGING

If set to true, specifies that a timestamp is written into the log for each line of debugging text that corresponds to actions you have performed. The timestamp can help you locate information in the server log files about events that occurred at a specific time, or to determine how much time elapsed between specific logged statements.

Note: Including the timestamp adds text to each logged statement, which bloats the log file and can make it more difficult to read.

Default: true

Valid values:
true, false

ENABLE_TM_ALLOW_EMPTY_ITEM

Default setting used by time sheet policies to specify what occurs when users try to submit time sheets that contain empty lines (lines in which all values are 0). Time sheet policies have options that correspond to these settings. For the users assigned to a time sheet policy, the policy can override the default value set for this parameter. Following are the parameter settings and descriptions of their effects if the user's time sheet policy does not override the selected setting:

  • ALLOW. The user can submit time sheets that contain empty lines.

  • WARNING.PPM displays a warning that advises the user to consider entering data in the empty lines before submitting the time sheet. The user can, however, still submit the time sheet.

  • RESTRICT.PPM requires the user to enter data in the empty lines or delete those lines before submitting the time sheet.

  • Note: To improve PPM performance and to make it easier for approvers to review submitted time sheets, We strongly recommend using the RESTRICT setting.

For more information about time sheet policies, see the Time Management Configuration Guide.

Default:

  • RESTRICT when used by new time sheets or new time sheet policies on an upgraded instance or a new installation.
  • WARNING for existing time sheets on an upgraded instance.

Valid values:
ALLOW,
WARNING,
RESTRICT

ENABLE_TM_WORK_ITEM_PACKAGES

If set to true, the Allowed work item types list on the Work Items tab of a time sheet policy includes the Packages checkbox. If set to false, the Packages checkbox is not displayed.

For information about the Work Items tab, see the Time Management Configuration Guide.

Default: true

Valid values:
true, false

ENABLE_TM_WORK_ITEM_EXTERNAL_DATA

If set to true , the External Data option is available in the following PPM Workbench windows:

  • On the Work Items an Activities tabs of the Tim Sheet Policy window
  • In the Work Item Type drop-down list (under the Dependencies section) of the Override Rule window

Default: true

Valid values:
true, false

ENABLE_TM_WORK_ITEM_PROJECTS

If set to true, the Allowed work item types list on the Work Items tab of a time sheet policy includes the Projects checkbox. If set to false, the Projects checkbox is not displayed.

For information about the Work Items tab, see the Time Management Configuration Guide.

Default: true

Valid values:
true, false

ENABLE_TM_WORK_ITEM_PROGRAMS

If set to true, the Allowed work item types list on the Work Items tab of a time sheet policy includes the Programs checkbox. If set to false, the Programs checkbox is not displayed.

For information about the Work Items tab, see the Time Management Configuration Guide.

 

ENABLE_TM_WORK_ITEM_REQUESTS

If set to true, the Allowed work item types list on the Work Items tab of a time sheet policy includes the Requests checkbox. If set to false, the Requests checkbox is not displayed.

For information about the Work Items tab, see the Time Management Configuration Guide.

Default: true

Valid values:
true, false

ENABLE_TM_WORK_ITEM_TASKS

If set to true, the Allowed work item types list on the Work Items tab of a time sheet policy includes the Tasks checkbox. If set to false, the Tasks checkbox is not displayed.

For information about the Work Items tab, see the Time Management Configuration Guide.

Default: true

Valid values:
true, false

ENABLE_TMPM_SYNC_SERVICE

If set to true, enables the TM-PM Sync Service, which synchronizes time sheet updates from Time Management to project work plan tasks in Project Management, at the interval specified by the TMPM_SYNC_SERVICE_INTERVAL parameter.

Default: false

Valid values:
true, false

ENABLE_UI_MONITOR

If set to true, enables the activity monitor, which captures UI activities (mainly URL requests). If activity exceeds the threshold value (determined by the UI_MONITOR_THRESHOLD parameter), the captured information is output to the thresholdLog.txt log file. This file resides in same directory as the server log.

Default: false

Valid values:
true, false

ENABLE_WEB_ACCESS_LOGGING

If set to true, tells Tomcat to log all http requests received.

Note: If this is enabled on a busy system, Web access logging can generate many log files in <PPM_Home>/logs. This will occupy some disk space.

Default: true

Valid values:
true, false

ENABLE_WEB_SERVICES

Enables the PPM Web services interface.

Default: false

Valid values:
true, false

ENABLE_WORK_ITEM_MISC

If set to true, the Allowed work item types list on the Work Items tab of a time sheet policy includes the Miscellaneous Items checkbox. If set to false, the Miscellaneous Items checkbox is not displayed.

For information about the Work Items tab, see the Time Management Configuration Guide.

Default: true

Valid values:
true, false

ENABLE_WORKBENCH_NOTIFICATIONS

If set to true, the PPM Server receives notifications of completed concurrent requests from the Concurrent Request Watch background service and updates the status on PPM Workbench clients connected to that server. If set to false,PPM Workbench clients connected to the server do not receive automatic updates unless the Concurrent Request Watch background service is running on this node.

Default: true

Valid values:
true, false

ENABLE_WORKBENCH_HTTP If set to true, PPM Workbench communicates with PPM Server via HTTP(S). If set to false, PPM Workbench communicates with PPM Server via RMI(S).

Default: true

Valid values:
true, false

ETL_END_DATE

If PPM's Operational Reporting solution is implemented, this determines the end date for the PPM data to extract, transform, and load into the Operational Reporting database schema.

Default: N/A

Valid values:

Calendar date in the format
mm-dd-yyyy

ETL_START_DATE

If PPM's Operational Reporting solution is implemented, this determines the start date for the PPM data to extract, transform, and load into the Operational Reporting database schema.

Default: N/A

Valid values:

Calendar date in the format
mm-dd-yyyy

EV_ALLOW_PRORATING

If set to false, indicates that if a task or project is less than 100 percent complete, the earned value is calculated to be 0. The EV calculation is 100 only if the task or project is 100% complete.

Default: true

Valid values:
true, false

EXCEL_EXPORT_POSITIONS_LIMIT Specifies the maximum number of positions that can be exported to Excel on the Forecast Planning page. Default: 2,000
EXCEL_EXPORT_RESOURCES_LIMIT

Specifies the maximum number of resources that can be exported to Excel on the Search Resources page.

Default: 3,000

EXCEPTION_DETAIL_LEVEL

Determines the level of detail to include in internal error exceptions displayed in PPM. The exception message is included in server logs.

This parameter uses a bitwise value combination, as follows:

  • If bit 1 is set to 1 (001), the message includes exception correlation information.

  • If bit 2 is set to 1 (010), the message includes the application server node name.

  • If bit 3 is set to 1 (100), the message includes the filtered stack trace.

A value of 7 includes all levels of detail. for the error.

Default: 3

Valid Values:
Integer using bitwise value combination (includes correlation information and server node name)

EXCEPTION_ENGINE_PROCESSING_ THREAD_COUNT You can use this parameter to specify the thread number of the Exception Rule Service. Default: 1

Valid values: Positive integer

EXCEPTION_ENGINE_WAKE_UP_TIME

Determines the time at which the daily exception engine full calculation runs. A full calculation is needed for exceptions that occur as time elapses. The default value of 1 (1:00 AM) specifies that the daily exception calculation is performed once every day at 1:00 AM.

Default: 1 (1:00 AM)

Valid Values:

Integer between 1 and 24

EXCEPTIONS_RETAIN_PERIOD

Number of days non-service PPM exceptions are to be retained.

Also see LOG_EXCEPTIONS_TO_DB.

Default: 14
Valid Values:
Zero or higher integer

EXTERNAL_WEB_PORT

If you are using an external Web server to serve PPM clients, you must configure this parameter as an available port that can communicate with the PPM Server.

Note: If you are using an external Web server, you must still configure the standard PPMUsing the Server Configuration Utility to Modify Server Configuration Parameters. This port is used internally by PPM reports. There is no need to make it accessible to the network.

Valid value:
Any available port number

EXTERNAL_WEB_PROTOCOL

If you are using an external Web server to serve PPM clients, use this parameter to specify the protocol with which the Web server connects PPM server.

For example, if the Web server connects PPM via http protocol, set EXTERNAL_WEB_PROTOCOL to HTTP, and use EXTERNAL_WEB_PORT to specify the port number.

Default: AJP

Valid values: AJP, HTTP

FAIL_EXECUTIONS_ON_STARTUP

If the PPM Server stops while command executions are running, those executions are interrupted and the parent entities (package lines, releases, requests, and so on) are assigned the status "in progress". This parameter tells the server that, after it starts, it must check for any entities that have "in progress" status and that have no executions running (that is, executions that were interrupted). The server sets the internal status of those entities to FAILED, with a visible status of "Failed (Interrupted)".

Default: true

Valid values:
true, false

FONT_SIZE_OF_GRAPHIC_WORKFLOW

Specifies a font size for displaying larger or smaller characters in workflow layout images.

Default: 9

FORECAST_PLANNING_PAGE_SIZE

Number of staffing profile positions displayed on a Forecast Planning page in Resource Management.

Default: 50

FS_QUEUE_CONCURRENT_CONSUMERS

Initial number of concurrent instances of the Financial Summary background service.

Default: 1

Valid values:
Non-negative integer

FS_QUEUE_MAX_CONCURRENT_CONSUMERS

Maximum number of concurrent instances of the Financial Summary background service.

Default: 2

Valid values:
Non-negative integer

GRAPHICAL_WF_ENABLED

If set to true, makes links to view graphical workflow available on submitted requests.

Default: true

Valid values:
true, false

GROUP.PRIVATE.
PUBLIC.PAGES

If set to true, after a user selects Dashboard > Personalize Dashboard, the PPM Dashboard displays two sections: Private and Shared. The Private section contains single pages and groups, the Shared section contains modules. If set to false, dashboard pages will appear as a flat list.

Default: true

Valid values:
true, false

GZIP_ENCODING_ENABLED

Determines whether HTTP responses are compressed before they are sent to PPM HTML clients. If set to true, then textual HTTP responses are compressed using GZIP compression (if the requesting browser supports GZIP).

By default, this is set to true to improve the responsiveness of the PPM standard (HTML) interface, because less overall data is carried across the Internet between the client and the PPM Server.

If all PPM clients have fast network access to the PPM Server, then consider setting this parameter to false to reduce the overhead of compressing and decompressing responses.

Caution: There is a known issue related to GZIP compression in the Oracle Java Virtual Machine (for details, see http://bugs.java.com/bugdatabase/view_bug.do?bug_id=8028216 and https://bugs.java.com/bugdatabase/view_bug.do?bug_id=8176548). If you see GZIP exceptions in the server log, you should set this parameter to false until Oracle fixes this issue.

Default: true

Valid values:
true, false

*HEAVY_QUEUE_CONCURRENT_CONSUMERS

Number of listeners per node to execute heavy background services.

Default: 1

Valid values:
Positive integer

*HEAVY_QUEUE_MAX_CONCURRENT_CONSUMERS

Maximum number of listeners per node to execute heavy background services.

Default: 1

Valid values:
Positive integer

*HEAVY_QUEUE_MAX_DEPTH

Maximum depth of the heavy services queue.

Default: 10000

Valid values:
Positive integer

*HEAVY_QUEUE_REDELIVERY_DELAY

Delay between redeliveries of messages to the heavy service queue.

Default: 60000
(milliseconds)

Valid values:
Positive integer

*HEAVY_QUEUE_REDELIVERY_LIMIT

Number of times messages are to be redelivered to the heavy service queue.

Default: 5

Valid values:
Positive integer

HIDE_COST_TAB_ON_ PROJECT_PAGE This parameter is used to hide or display the Cost tab in the Project Overview page. Setting it to true, you hide the Cost tab. Otherwise, the tab is shown.

Default value: false

Valid values: true, false

HIDE_STAFFING_TAB_ON_ PROJECT_PAGE This parameter is used to hide or display the Staffing tab in the Project Overview page. Setting it to true, you hide the Staffing tab. Otherwise, the tab is shown.

Default value: false

Valid values: true, false

*HIGH_PAGE_SIZE

Recommended number of work plan lines to load into the Work Plan page if the user is connected through a fast connection such as a LAN.

Default: 100

Valid values:
Positive integer

HIGHLIGHT_NONWORKING_DAYS_IN_TIMESHEET

If set to true,for time sheets on which time is logged on a daily basis, the columns for non-working days are highlighted in color.

Default: false

Valid values:
true, false

*HISTORY_MENU_SIZE

Number of links to display in the History menu in the PPM standard interface.

Default: 10

Valid values:
Positive integer

*HOURS_TO_KEEP_DEBUG_MESSAGE_ROWS

Number of hours to keep rows in the KNTA_DEBUG_MESSAGES table.

For high-volume PPM installations, a large number of rows may be generated in this table. For such installations, decrease this value accordingly.

Default: 48

Valid values: Positive integer

*HTTP_PORT

Port to use to communicate with the built-in HTTP server.

If PPM is in stand-alone mode (that is, it is not integrated with an external Web server), then PPM clients must have access to the HTTP_PORT.

If PPM is integrated with an external Web server, then client HTTP traffic is routed through the EXTERNAL_WEB_PORT. However, even in that case, the PPM Server still uses the *HTTP_PORT internally to run reports. In this case, it is not necessary to make the *HTTP_PORT externally accessible to PPM clients (and thus, the port need not be exposed outside of the PPM Server).

Note: If you are integrating PPM with Application Lifecycle Management, then you must set the parameter to a number less than 32767.

Default: 8080

Valid values: Unique port greater than 1024 and distinct from the Web server, SQL*Net, and RMI ports.

HTTP_PROXY_URL

URL of the HTTP proxy server used for PPM to connect to the Internet. It can be used by integration solutions or other PPM functionality.

 

HTTPS_CIPHERS

Specifies the ciphers for the SSL/ TLS protocol with which the PPM Server negotiates. This parameter accepts a comma-separated list of ciphers that the server is to allow for SSL/TLS connections. You can use the parameter to limit the cipher suite to a set of specific strong ciphers.

Default: N/A

Valid values: comma-separated list of ciphers

HTTPS_KEYPASSWORD

Keystore password (encrypted). This setting is required if the ENABLE_SSL_LOGIN parameter is set to true.

Note: You must use kEncrypt.sh to encrypt the password. For information on how to run the kEncrypt.sh script, see kEncrypt.sh.

Default: N/A

Valid values:
Encrypted password in the format
#!#<Encrypted_Password>#!#

HTTPS_KEYSTORE_LOCATION

Full path location of the keystore. This parameter setting is required if the ENABLE_SSL_LOGIN parameter is set to true.

Default: N/A

Valid values: N/A

HTTPS_PORT

HTTPS port to use for SSL Login. This parameter setting is required if the ENABLE_SSL_LOGIN parameter is set to true.

Default: none

Valid values:
Must be the HTTP_PORT number + 363

HTTPS_PROTOCOL

Specifies the HTTPS protocol (TLS) the PPM Server uses.

Note: Starting from version 9.31, SSLv3 as the HTTPS protocol is disabled in order to enhance security.

Default: TLS

Valid values:
TLS

HTTPS_ENABLED_PROTOCOLS Specifies the HTTPS protocols in details. Default: TLSv1, TLSv1.1, TLSv1.2

HTTPS_WEB_THREAD_MAX

Maximum number of HTTPS threads. This parameter setting is required if the ENABLE_SSL_LOGIN parameter is set to true.

Default: 75

Valid values:
Positive integer

HTTPS_WEB_THREAD_MIN

Minimum number of HTTPS threads. This parameter setting is required if the ENABLE_SSL_LOGIN parameter is set to true.

Default: 5

Valid values:
Positive integer

IGNORE_NEGATIVE_UNMET_DEMAND

If you set this parameter to true, PPM ignores negative unmet demand value in the calculation of forecast labor cost.

If you set this parameter to false, PPM does not ignore negative unmet demand value (regards the negative unmet demand value as it is) in the calculation of forecast labor cost.

Default: true

Valid values: true, false

IGNORE_UNMET_DEMAND_THRESHOLD

When the position's daily unmet demand is smaller than the threshold, its unmet demand is ignored and the position is regarded as fulfilled.

When the unmet demand is negative (over-allocation), PPM compares its absolute value with the threshold.

Default: 0.000001

I18N_CARET_DIRECTION

Caret position on input fields (for example, text fields).

If unspecified, the system uses the value specified for I18N_SECTION_DIRECTION.

Default: ltr

Valid values:
ltr,rtl
(left to right,
right to left)

I18N_ENCODING

Character encoding to be used on all HTML pages in the PPM standard interface.

Default: UTF-8

I18N_LAYOUT_DIRECTION

Default layout direction of HTML pages in the PPM standard interface.

Default: ltr

Valid values:
ltr,rtl
(left to right,
right to left)

I18N_REPORT_HTML_CHARSET

HTML character set used to generate PL/SQL reports.

Must map to the character set specified for I18N_REPORTS_ENCODING.

Default: WE8ISO8859P15

Valid values:
Any character set names that Oracle recognizes

I18N_REPORTS_ENCODING

Character encoding to use to generate reports in PPM.

We recommend IW8MSWIN1255 for Windows systems.

Default: UTF-8

Valid values:
Any encoding algorithm that Oracle can interpret.

I18N_SECTION_DIRECTION

Layout direction of custom sections (for example, request detail sections).

If unspecified, the system uses the value specified for I18N_LAYOUT_DIRECTION.

Default: ltr

Valid values:
ltr,rtl

IMPACT_ANALYSIS_REPORT_CATEGORY

If you have enabled the attachment of Universal CMDB Impact Analysis Reports for CIs in PDF format to requests in PPM, use this parameter to specify the default category value for impact analysis reports, for example, change or operation.

For details, see the Demand Management Configuration Guide.

Default: N/A

Valid values:

NO CHANGE
PLAN
NEW
CANCEL

IMPACT_ANALYSIS_REPORT_LANGUAGE

If you have enabled the attachment of Universal CMDB Impact Analysis Reports for CIs in PDF format to requests in PPM, use this parameter to set the default language code.

For details, see the Demand Management Configuration Guide.

Default: N/A

Valid values:
de (German)
en (English)
es (Spanish)
fr (French)
it (Italian)
ja (Japanese)
ko (Korean)
pt (Brazilian Portuguese)
ru (Russian)
zh (Simplified Chimese)
IMPACT_ANALYSIS_REPORT_NAME Specifies a name for the UCMDB impact analysis report. Default:
DefaultImpactA
nalysisReportN
ame
IMPACT_ANALYSIS_REPORT_SEVERITY If you have enabled the attachment of Universal CMDB Impact Analysis Reports for CIs in PDF format to requests in PPM, use this parameter to set the default severity value for the impact analysis report. For details, see the Demand Management Configuration Guide. Default: N/A
Valid values:
NORMAL
WARNING(1
WARNING(2
MINOR(3
MINOR(4
MINOR(5
MINOR(6
MAJOR(7
MAJOR(8
CRITICAL
*INSTALLATION_LOCALE Language and country code of the PPM installation. The language code must match the PPM installation language. Default: en_US
Valid values: PPM installation language code
JAVA_CLASSES_LOC JRE classes location. Example:
C:/Java/j2sdk1.7
/jre/lib/classes
.zip
JAVA_PLUGIN_CLASSID

Class ID for the Java plugin used for the PPM Workbench.

The value of this parameter is automatically set to CAFEEFAC-0018-0000-FFFF-ABCDEFFEDCBA if the value of the parameter WORKBENCH_PLUGIN_VERSION is JRE 8.

Default:
CAFEEFAC-0017
-0000-FFFF
-ABCDEFFEDCBA
JAVA_PLUGIN_PATH_IE

Web location for downloading the cross-platform Java plug-in bundle for Internet Explorer browsers.

Note: If the parameter WORKBENCH_PLUGIN_VERSION has a value, but you do not want the JRE packages to be automatically downloaded, you can set the value of this parameter to NA. Ed users will be directed to the link specified in JAVA_PLUGIN_PATH_NS to manually install JRE bundle.

If the value of the parameter WORKBENCH_PLUGIN_VERSION is JRE 8, the values of this parameter is empty because Oracle does not provide address for automatically downloading JRE 8.

Default:
//java.sun
.com/update
/1.7.0/jinst
all-7u72
-windows
-i586.cab
JAVA_PLUGIN_PATH_NS

Web location for downloading the cross-platform Java plug-in installer for Netscape browsers.

The value of this parameter is automatically set to http://java.com/dt-redirect if the value of the parameter WORKBENCH_PLUGIN_VERSION is JRE 8.

Example:
http://www.oracle
.com/technetwork
/java/javase
/downloads
/index.html
JAVA_PLUGIN_VERSION Earliest version of the Sun Java plug-in used to start the PPM Workbench. Default:
1.7.0_72
JAVA_PLUGIN_XPI_PATH

Web location for downloading the cross-platform Java plug-in installer for Firefox and Chrome browsers.

Note: If the parameter WORKBENCH_PLUGIN_VERSION has a value, but you do not want the JRE packages to be automatically downloaded, you can set the value of this parameter to NA. Ed users will be directed to the link specified in JAVA_PLUGIN_PATH_NS to manually install JRE bundle.

If the value of the parameter WORKBENCH_PLUGIN_VERSION is JRE 8, the values of this parameter is empty because Oracle does not provide address for automatically downloading JRE 8.

Example:
http://javadl.sun
.com/webapps/down
load/GetFile/1.7.0
_11-b21/windows
-i586/xpiinstall
.exe
JDBC_DEBUGGING Enables debugging of the Java database calls. Default: false
Valid values:
true, false

*JDBC_URL

Note: For Oracle RAC (Real Application Clusters), this parameter must contain the host and port information for all databases to which the PPM Server connects.

Locator for the database that contains the PPM database schema.
Must be specified correctly for PPM Server to communicate with the database.
Format: jdbc:oracle.thin:@<Host_Name>:<Port>:<SID>

where

  • <Host_Name> is the DNS name or IP address of the system running the database
  • <Port> is the port used by SQL*Net to connect to the database. Refer to the database entry in the tnsnames.ora file
  • <SID> is the database system ID.

Note: If you want to specify a literal IPv6 address, make sure you enclose the literal address with "[" and "]" characters. For example, jdbc:oracle:thin:@[::1]:1521:SID

Note: We strongly recommend you specify DNS name instead of literal IPv6 address.

Default: 1521
Example:
jdbc:oracle:thin
:@DBhost.domain.
com:1521:SID
*JOB_STATUS_CLEANUP_INTERVAL Timeout (in minutes) for cleaning the JOB_STATUS table. Default: 720 (minutes)

Valid values:

JSP_RECOMPILE_ENABLED

Determines whether changes to JSP files are picked up on a running server, thereby quickly making them visible.

If set to false, JSP files are checked for changes only the first time they are accessed, with the result that changes are visible only after the server is restarted.

Default:
false on production systems, true on development systems
Valid values:
true, false
*JSP_COMPILE_EXCLUDE_FOLDERS If JSP_RECOMPILE_ENABLED is set to true, changes made to the JSP files inside the folders specified by the JSP_COMPILE_EXCLUDE_FOLDERS parameter are picked up on a running server, therefore making them visible quickly. Default: web/knta
/rpt;web/knta/test
JVM_OPTIONS For Micro Focus internal use only. Do not alter its value unless directed to do so by Software Support for PPM. Default: N/A
KEEP_ALIVE_INTERVAL Frequency with which the client sends keep-alive messages to the PPM Server. Default: 2
KEY_STORE_FILE Specifies the keystore file for Secure RMI. (See Enabling Secure RMI.) Default: N/A
KEY_STORE_PASSWORD

Password for the keystore created for Secure RMI. (See Enabling Secure RMI.)

Note: You must use kEncrypt.sh to encrypt the password. For information on how to run the kEncrypt.sh script, see kEncrypt.sh.

Default: N/A
Valid values:
Encrypted password in the format
#!#<Encrypted_Password>#!#
**KINTANA_LDAP_ID
Required if AUTHENTICATION_MODE = LDAP
PPM account on the LDAP server.
Used by the PPM Server to bind to the LDAP server.
Default: N/A
Examples:
uid=admin, ou
=dev, cn=Users
**KINTANA_LDAP_PASSWORD
Required if AUTHENTICATION_MODE = LDAP
PPM password on the LDAP server.
The PPM Server configuration utility automatically encrypts this password. To manually edit this value, surround the encrypted password with #!# delimiters.
Default: #!##!#
Format:
#!#<Encrypted_Password>#!#
KINTANA_LOGON_FILENAME Used in non-HTML notification, this parameter value is specified with the filename (to be appended to the URL), which points to the logon page.

Note: We recommend that you not reset this parameter.

Example:
kintanaHome.html
KINTANA_SERVER_DIRECTORY Server directory location. Set this value if you have a clustered server setup. Default:
PPM_930_ALL
KINTANA_SERVER_LIST The server sets the (read-only) value of this parameter at runtime. Example:
aeon!rmi://ice
:27099/KintanaS
erver
*KINTANA_SERVER_NAME Name of the PPM Server instance.
If multiple PPM Servers are running on the same machine, this name must be unique for each server.
If the server is running Windows, this name must match the name of the Windows service name.

Default:
PPM_930_ALL

*KINTANA_SESSION_TIMEOUT Time set to elapse before the PPM Server terminates a user session (in the PPM Workbench or standard interface) because of inactivity. A value of 0 denotes no timeout. Default: 120
(minutes)
Valid values:
10 through 720
LDAP_BASE_DN Base distinguished name on the LDAP server. Each LDAP URL must specify a base distinguished name (DN), which is used in place of the LDAP_BASE_DN server configuration parameter. If the URLs provided for LDAP_URL_FULL do not have a DN value, PPM uses the value set for LDAP_BASE_DN. Default: N/A
Examples:
CN=Users,DC
=PPMAD,DC=com
LDAP_BASE_DN Base distinguished name on the LDAP server. Each LDAP URL must specify a base distinguished name (DN), which is used in place of the LDAP_BASE_DN server configuration parameter. If the URLs provided for LDAP_URL_FULL do not have a DN value, PPM uses the value set for LDAP_BASE_DN. Default: N/A
Examples:
CN=Users,DC
=PPMAD,DC=com
LDAP_CONNECT_TIMEOUT The amount of time (in milliseconds) the PPM Service tries to connect o LDAP server before it times out.

Default: -1 (equal to 15000)

 

LDAP_ENABLE_DEREFERENCING If set to yes, enables LDAP dereferencing.
For more details about LDAP dereferencing, see "Dereferencing Aliases" on Oracle's Sun Developer Web site (java.sun.com/products/jndi/tutorial/ldap/misc/aliases.html).
Default: yes
Valid values:
yes, no
**LDAP_GROUP_RECURSION_LIMIT
(Required if AUTHENTICATION_MODE = LDAP)
Number of levels of subgroups to traverse when importing users from groups. Default: 15
LDAP_KEYSTORE LDAP keystore. Default: N/A
LDAP_KEYSTORE_PASSWORD LDAP keystore password.

Note: You must use kEncrypt.sh to encrypt the password. For information on how to run the kEncrypt.sh script, see kEncrypt.sh.

Default: N/A
Valid values:
Encrypted password in the format
#!#<Encrypted_Password>#!#
LDAP_LAST_SYNCH_TIMESTAMP Last time the LDAP import was run. Default: N/A
LDAP_REFERRAL_CHASE If set to true, enables the LDAP server to follow referrals. Default: false
Valid values:
true, false
LDAP_REFERRAL_HOP_LIMIT Maximum number of referral hops that the LDAP libraries can follow. Default: 10
LDAP_SERVER_TYPE Type of LDAP server used. Default: N/A
**LDAP_SSL_PORT
Required if AUTHENTICATION_MODE = LDAP
SSL port number on the LDAP server. If not specified, all transactions are carried over the port specified for **LDAP_URL. Default: 636
**LDAP_URL
(Required if AUTHENTICATION_MODE = LDAP)

Comma-delimited list of LDAP URLs, which the PPM Server queries in the order specified.

Note:  

  • Make sure you specify a port number even when you use the default port number 389 for LDAP server or when you use SSL-enabled LDAP server. Otherwise, an error occurs.
  • The LDAP_URL_FULL parameter supersedes the LDAP_URL parameter. That is, if a value is set for both in the server.conf file, LDAP_URL_FULL is used. If the URLs specified for LDAP_URL_FULL do not have a DN value, the value set for LDAP_BASE_DN is used.
Format: ldap://ldap.
<URL>.com:389

Example:
ldap://10.100
.102.199:389
LDAP_URL_FULL PPM uses this parameter to handle multiple domains during LDAP authentication. The values for the parameter include a space-separated (not comma-separated) list of full LDAP URLs. Each LDAP URL must specify a base DN.

Note:

  • To specify a space character inside a URL, use the URL encoding scheme, and replace the space with "%20". For example, if you have an organizational unit called "My Org Unit", then specify "My%20Org%20Unit" in the LDAP URL.
  • The LDAP_URL_FULL parameter supersedes the LDAP_URL parameter. That is, if a value is set for both in the server.conf file, LDAP_URL_FULL is used. If URLs specified for LDAP_URL_FULL do not have a DN value, the value set for LDAP_BASE_DN is used.

Example:
com.kintana.core
.server.LDAP_URL
_FULL=ldap://host.
yourdomain.com
/CN=Users,DC
=yourdomain,DC
=com ldap://host.
yourdomai.com
/OU=Users2,DC
=yourdomain
,DC=com
LICENSE_KEY License key required to use PPM core functionality. Example
36ha5b993c1776k
c6g03gjct5k7hv5c3
*LIGHT_QUEUE_CONCURRENT_CONSUMERS Number of listeners per node to execute light-weight background services. Default: 1
Valid values:
Positive integer
*LIGHT_QUEUE_MAX_CONCURRENT_CONSUMERS Maximum number of listeners per node to execute light background services. Default: 3
Valid values: |
Positive integer
*LIGHT_QUEUE_MAX_DEPTH Maximum depth of the light services queue. Default: 10000
Valid values:
Positive integer
*LIGHT_QUEUE_REDELIVERY_DELAY Delay between redeliveries of a message to the light service queue. Default: 60000
(milliseconds)
Valid values:
Positive integer
*LIGHT_QUEUE_REDELIVERY_LIMIT Number of times a message can be redelivered to the light service queue. Default: 5
Valid values:
Positive integer
LOAD_FACTOR Determines how much load to place on a node in the server cluster. Default: 1.0
Valid values:
LOCAL_IP Used to construct the servlet URL for use by PPM Server when the PPM Server internally invokes one of its own servlets. An example of this is when a report is executed. Ordinarily, this parameter should not need to be specified. Defaults to the IP address extracted from the server configuration parameter *RMI_URL
Example: 
10.1.101.64
LOCK_TIMESHEET_ENABLED Enables you to lock time sheets as long as they are not cancelled, frozen, or closed. Default: true
Valid values:
true, false
LOG_EXCEPTIONS_TO_DB The menu item Search > Administrative > Exceptions, which opens the Search Exceptions page, is hidden by default. To enable it, set the LOG_EXCEPTIONS_TO_DB parameter to true.
You must have the administration license and the "server tools: Execute admin tools" access grant to access the Search Exceptions page.
Except for service exceptions, all exceptions more than 14 days old are purged automatically. To reduce the load on the PPM Server, the purge is triggered for every 100th exception created. The value of 14 days can be configured using the EXCEPTIONS_RETAIN_PERIOD parameter.
Default: false
Valid values:
true, false
LOGIN_COOKIE_MAX_AGE Maximum age (and thus the expiration) of cookies used to start a PPM session. Default: 180 (days)
Valid values:
LOGON_METHOD Method used to log on to PPM. Default: USER_NAME
LOGON_PAGE URL for the PPM logon page. Default:
/web/knta
/global
/Logon.jsp
*LOGON_TRIES_INTERVAL Interval (in minutes) during which logon attempts are monitored. Default: 15
(minutes)
Valid values:
Positive integer
*LOW_PAGE_SIZE Number of work plan lines to load into the Work Plan page if the user is connected through a slow connection such as a WAN. Default: 20
Valid values:
Positive integer
LW_SSO_CLEAR_COOKIE If LW-SSO authentication is enabled, add this parameter to the server.conf file to specify that PPM must clear the LW-SSO token when a user logs out of PPM.

Note: For security purposes, we recommend that you always keep this parameter set to true.

Default: N/A
Valid values:
true, false
LW_SSO_DOMAIN If LW-SSO authentication is enabled, add this parameter to the server.conf file to specify the LW-SSO domain. Default: N/A
Valid values:
LW-SSO domain
Example: xyz.com
LW_SSO_EXPIRATION_ PERIOD The token for validating user logon has an expiration value that determines an application's session validity. If LW-SSO authentication is enabled, add this parameter to the server.conf file to specify the LW-SSO token expiration period in minutes.
Configure a token expiration for each Micro Focus application that uses LW-SSO. We recommend that you set the value to 60 (minutes).

Note: The expiration value must be at least as high as that of the application session expiration value. For more information, see Configuring PPM for LW-SSO.

Default: N/A
Valid value: Integer (minutes)
Recommended value:
60
LW_SSO_INIT_STRING If LW-SSO authentication is enabled, add this parameter to the server.conf file to specify the value of the initString parameter. For information about the initString parameter, see LW-SSO Security Warnings. Default: N/A
Valid value:
String value at least 12 characters long
LW_SSO_TRUSTED_DOMAIN If LW-SSO authentication is enabled, add this parameter to the server.conf file to specify one or more LW-SSO trusted domains. To separate multiple domains, use semicolons (;). Default: N/A
Valid value:
Example:
xyz.com;
abc.net
MAC_LOG_SEVERITY a Logging level to use. If set to 0, only integration exceptions and a summary are logged. If set to 1, events other than errors related to processing changes are also logged. Default: 1
Valid values:
0 and 1
MAX_BATCH_TIMESHEET_FREEZE_CLOSE Maximum number of time sheets that can be frozen or closed at one time is the lower of:
  • Value of this parameter, which has no default value, and a recommended value of 50.
  • Value of the Results Displayed Per Page field on the Search for a Time Sheet to Freeze/Close page (which has a default value of 50).
Default: None
Valid values:
Integer
MAX_BATCH_TIMESHEET_LINE_APPROVE Maximum number of time sheets that can be approved at one time is the lower of:
  • Value of this parameter, which has no default value, and a recommended value of 50.
  • Value of the Results Displayed Per Page field if using the Approve Time Sheets page (which has a default value of 50), or Rows Displayed field if using the Approve Time Sheets portlet (which has a default value of 5).
Default: None
Valid values:
Integer
MAX_BUBBLE_CHART_RESULT Maximum number of results to display in bubble charts. Default: 500
MAX_BUBBLE_CHART_SIZE Maximum number of bubbles (entities) that can be displayed in a bubble chart. Default: 500
Valid values:
Integer
MAX_CONCURRENT_AGM_REST_CALL_ FOR_TIMESHEET Specifies the maximum number of concurrent users to import time information from Agile Manager.

Default: 10

Valid values: integer

Recommended range: 1~50

MAX_DB_CONNECTION_IDLE_TIME Amount of time (in minutes) that an unused database connection stays open before it is closed and removed from the pool. Default: 60
(minutes)
MAX_DB_CONNECTION_LIFE_TIME Amount of time that a database session is held open before it is closed and removed from the pool.
Some Oracle cleanup operations that should be run periodically occur only at the end of database sessions. Therefore, do not keep database sessions open for the life of the PPM Server.
Default: 1440
(minutes)
MAX_DB_CONNECTION_WAIT_TIME Amount of time that the system waits before it times out a request for a database connection. Default: 180
(seconds)
MAX_DB_CONNECTIONS Maximum size of each of the two database connection pools that the PPM Server creates. Each user does not get a dedicated connection. The server uses connection pooling, so it opens a new database connection only if no connections are available in the pool.
After this number is reached, user sessions queue for the next available database connection.
Default: 60
*MAX_EXECUTION_MANAGERS Maximum number of concurrent executions allowed to run on the server. If your system is heavily loaded, decreasing this may help reduce load, but may also delay execution of tasks.
If your organization processes a high volume of packages, you may require more execution managers.
Default: 15
MAX_QC_ALM_RELEASES_NUMBER Specifies the maximum number of releases from ALM to be displayed on the Project Details page in PPM Default: 500
*MAX_LOGON_TRIES Maximum number of logon attempts in the time interval specified for *LOGON_TRIES_INTERVAL. Default: 5
*MAX_PAGE_SIZE Absolute maximum number of work plan lines that can be loaded into the Work Plan page. Use this parameter to prevent excessive load on the server from excessive queries, and to prevent users from getting themselves into low performance situations. Default: 500
*MAX_RELEASE_EXECUTION_MANAGERS Number of command executions that can run in a release distribution simultaneously.
Organizations that process a high volume of packages may require a larger number of release execution managers.
Default: 15
Valid values:
Integer greater than 1
MAX_RESULTS_ALLOWED_ON_PROJ_SEARCH Specifies the maximum number of projects returned on project searches.
To set this restriction, you must also set the ENABLE_RESTRICTIONS_ON_PROJ_SEARCH parameter.
Default: 1000
Valid values:
Positive integer
MAX_RESULT_OF_AUDIT_EVENT_QUERY Specifies the maximum number of audit event query results. Default: 1000
Valid values:
Positive integer
MAX_SERVER_CONF_BACKUPS Number of server.conf file backups to be maintained when application configuration parameters are updated through the Administration Console. Default: 1
Valid values:
Positive integer
MAX_RSC_IN_SG_TMAPPROVERS Specifies the maximum number of resources allowed in a security group that serves as time approvers. Default: 10,000

Valid values:
Positive integer

MAX_WEB_ATTACHMENT_SIZE_IN_MB Specifies maximum attachment size (in MB) for files uploaded using PPM web interface. Default: 20
Valid values:
Integer
MOBILITY_ACCESS_BATCH_SIZE Number of emails that the Mobility Access service fetches in a single batch. Default: 100
MOBILITY_ACCESS_FETCH_TIMEOUT Amount of time the PPM Server tries to connect to the email account before it times out. Default: 3
MOBILITY_ACCESS_HIDE_INITIAL_MESSAGE Controls whether to hide or display the initial text in an Mobility Access email notification. Default: false
MOBILITY_ACCESS_SERVICE_INTERVAL Number of minutes the Mobility Access service is to wait after the start time or the last batch sent, before sending out the next batch of email notifications. Default: 5
MOBILITY_ACCESS_THREAD_COUNT Number of threads that the Mobility Access service uses to process emails. Default: 1
MSP_NOTES_SIZE_LIMIT Maximum size of Microsoft Project notes in PPM. Notes larger than the size specified for this parameter are truncated when MSP data is synchronized with PPM. Default: 2 MB
MSP_PROJECT_CUSTOM_FIELD Microsoft Project includes a set of pre-defined text fields (Text1, Text2, Text3, and so on) that users can use to store whatever they want. By default, PPM uses the Text30 field at the project level in Microsoft Project to store information about the PPM project with which the Microsoft Project file is associated.
If you already use the Text30 field in Microsoft Project, you can use this parameter to specify the Microsoft Project field for PPM to use.

Caution: Do not change this parameter value after the Microsoft Project integration has been used.

Default: Text30
MSPS_RESOURCE_CUSTOM_FIELD Used to specify which enterprise custom resource field name is to be used by the Plug-in for PPM during enterprise resource mapping.
Make sure that you specify a value for this parameter for each resource on all MSP Servers, and that the value uniquely identifies a resource across all MSP Servers. Use this parameter only when working with multiple MSP servers.
Default: none
MY_LINKS_MAX_COUNT Maximum number of links a user can add to the My Links menu in the standard interface. Default: 100
Valid values:
Positive integer
**NLS_DATE_<NLS_LANGUAGE> Language used to display dates, by locale, on a multilingual PPM system. You can specify NLS_DATE_<NLS_LANGUAGE> using all languages installed on a PPM instance.
Although values are set during installation when the administrator selects the languages to install, the administrator can also add these values to the server.conf file manually.
For example, if you install Korean and Brazilian Portuguese languages after you install PPM, you would add the following to the server.conf file: com.kintana.core.server.NLS_DATE_KOREAN=GENERIC_M and com.kintana.core.server.NLS_DATE_BRAZILIAN_PORTUGUESE=GENERIC_M
For guidance on what values to set for this parameter, see the Oracle Database Globalization Support Guide(http://www.oracle.com/technology/software/index.html).
Valid values:
Any Oracle-supported values
NLS_SORT_<NLS_LANGUAGE> Sort order of search results displayed on a multilingual PPM system. You can specify NLS_SORT_<NLS_LANGUAGE> values for all of the languages installed on a PPM instance.
Although values are set during installation when the administrator selects the languages to install, the administrator can also add these values to the server.conf file manually.
For example, if you install Korean and Brazilian Portuguese languages after you install PPM, you would add the following to the server.conf file: com.kintana.core.server.NLS_DATE_KOREAN=GENERIC_M and com.kintana.core.server.NLS_DATE_BRAZILIAN_PORTUGUESE=GENERIC_M
For guidance on what values to set for this parameter, see the Oracle Database Globalization Support Guide(http://www.oracle.com/technology/software/index.html).
Valid values:
Any Oracle-supported values
NLS_TERRITORY<NLS_LANGUAGE> Oracle defaults for a territory by Java locale. Valid values:
Any Oracle-supported values
NOTIFICATIONS_CLEANUP_PERIOD Number of days that notifications remain in the system before the Notifications Cleanup Service removes them. Default: 7
Valid values:
Integer greater than 1
NUMBER_OF_FUTURE_YEARS_TO_SHOW_ON_FINANCIAL_SUMMARY

Number of future fiscal years that can be viewed in:

  • Financial summary
  • Edit Costs page and Edit Benefits page
  • Update Budget page and Allocate Budget page

Time Managementuses this value to determine the latest future fiscal year that users can specify in the Fiscal Year and Data Range fields on a financial summary.

Note: This parameter is also applied to snapshots of financial summaries, but is applied relative to the fiscal year each snapshot was taken, and not relative to the current fiscal year.

Default: 5
Valid values:
Integer between 0 and 20

NUMBER_OF_PAST_YEARS_TO_SHOW_ON_FINANCIAL_SUMMARY

Number of past fiscal years that can be viewed in:

  • Financial summary
  • Edit Costs page and Edit Benefits page
  • Update Budget page and Allocate Budget page

Time Management uses this value to determine the earliest previous fiscal year that users can specify in the Fiscal Year and Data Range fields on a financial summary.

Note: This parameter is also applied to snapshots of financial summaries, but is applied relative to the fiscal year each snapshot was taken, and not relative to the current fiscal year.

Default: 2

Valid values:
Integer between 0 and 20

ONLINE_IMPACT_ANALYSIS_REPORT

Enable or disable the attachment of Universal CMDB Impact Analysis Reports for CIs in PDF format to requests in PPM Center.

For details, see the Demand Management Configuration Guide.

Default: true

Valid values:
true, false

OPTIMIZATION_ITERATION_MULTIPLIER

Number of algorithmic iterations that the optimization engine is to run. The more iterations, the more time is given to finding an optimal portfolio. Although the default is adequate in most instances, complex cases can benefit from more iterations.

Note: This parameter also affects generation of the Efficient Frontier curve.

Default: 100
(iterations)

OPTIMIZER_NUMBER_OF_TIMESHIFTS

Maximum number of periods the optimizer can shift start dates forward. This does not affect manually-shifted Portfolio Management entities.

If you allow a new start date for a project, the optimizer can start the project any time between the original start date and six months beyond that date.

Default: 6
(months)

**ORACLE_APPS_ENABLED

Determines whether PPM is to be integrated with Oracle Apps.

You must set this parameter to true for installations using Deployment Management to integrate with Oracle Apps through Object Migrator or GL Migrator. If you use Object Migrator with PPM, you must specify a value.

Default: false

Valid values:
true, false

ORACLE_APPS_VERSION

Version of Oracle Apps used.

For releases R11, R11i, and R12, specify R11.

Default: R11

Valid values:
R11 for any Oracle
Apps release 11 or later

ORACLE_DB_VERSION

The server sets this read-only parameter value during startup.

Example
10.2.0.4.0

Valid values:
Any supported Oracle database software version

*ORACLE_HOME

Full path to the Oracle home directory on the PPM Server.

The <Oracle_Home>/network/admin directory must contain the correct TNS names (or a file containing the names such as tnsnames.ora) required to connect to the PPM database schema.

Example

d:/orant

PACKAGE_LOG_DIR

Directory to which PPM writes package output.

In a server cluster, if you have overridden the default value for this parameter to refer to a different directory, then all servers in the cluster must be able to access and share the directory.

Default:
Same default value as the BASE_LOG_DIR parameter

PACKAGE_LOG_EXT

Extension used for package log files.

Default: html

PACKAGE_LOG_HEADER

Prefix used for package log file names.

Default: PKG_

PAGE_PDF_EXPORT_DISABLED

To disable the Export to PDF feature, add this parameter to the server.conf file, and set its value to true.

Default: N/A

Valid values:
true, false

PARTITION_NAME

Logical group name assigned to a cluster of Tomcat application servers. Any node in the server cluster that is started with the same partition name becomes part of the cluster.

The value for this parameter is set during installation. The startup script pulls the specified partition name from the server.conf file and uses it to start the PPM Server.

Default: N/A

*PASSWORD_EXPIRATION_DAYS

Expiration period of passwords for new users.

A value of 0 indicates no expiration.

Default: 90
(days)

Valid values:
0 through 366

*PASSWORD_REUSE_RESTRICTION_DAYS

Number of days to restrict the reuse of an old password from the last date the password changed.

A value of 0 indicates no restriction.

Default: 366

Valid values:
0 through 2192

PDF_FONT_FILE

Absolute file path to the font used in exporting work plans in PDF file format.

Default: N/A

Valid values:
<Absolute_Font
_File_Path
>

PENDING_STATUS_CHANGE_SERVICE_POOL_SIZE

Size of the thread pool for the Request Status Change service.

Default: 5

Valid values: integer

PLUGINS

Semicolon-separated list of plugins used by the PPM Server.

Default: N/A

*PM_CAN_ROLLUP_ACTUALS_ON_SAVE

If set to true, enables the user to change the mode on Project Management's Enter Actuals page. The resulting options are either rollups calculated during save processing, or rollups are deferred (and rolled up using the associated service).

Default: true

Valid values:
true, false

*PM_NUM_EDIT_ASGMTS

Maximum number of assignments that can be displayed for editing on the Enter Actuals page in Project Management.

Default: 200

PORTFOLIO_MANAGEMENT_LICENSE_KEY

License key required to use Portfolio Management. This key is available in the Autopass license key file.

Default: N/A

PORTLET_EXEC_TIMEOUT

Amount of time (in seconds) a portlet's SQL statement is to run before it is automatically disconnected from the database.

This parameter is used to limit long-running queries in portlets, which may be caused by adding portlets without filtering criteria. Used to avoid excessive database CPU processing when users end their sessions before processing has completed.

Note: Increase the value of PORTLET_EXEC_TIMEOUT only as a last resort. This setting has system-wide performance impact. If you must increase the value, specify a value such as 30, and not a high value such as 200.

Default: 20
(seconds)

PORTLET_MONITOR_THRESHOLD

If the ENABLE_PORTLET_MONITOR parameter is set to true, then this parameter determines the portlet load time threshold (in milliseconds) above which the portlet monitor logs portlet load information.

Default: 10000
(milliseconds)

PORTLET_MONITOR_PERSIST_STATE If set to true, information captured by portlet monitor logs performance is saved in the table PPM_PERFORMANCE_LOG.

Default: false

Valid values:
true, false

PROJ_COST_ROLL_UP_DURATION_IN_DAYS

Determines the maximum duration of a project (based on start and finish dates of root task in the assigned work plan), on which cost roll-up calculations are performed. The default is optimized for performance.

Default: 3650
(days)

PROJECTED_COST_ FORMULA_TYPE

Controls how PPM calculates projected cost.

Projected Cost = the cost of each previous month + the cost of the current month + the cost of each future month.

When this parameter is set to comparative, the cost of each previous month equals to the actual cost when actual cost is not blank or zero, otherwise, it equals to the forecast cost; the cost of the current month equals to the higher of the actual cost and the forecast cost; the cost of each future month equals to the forecast cost.

When this parameter is set to absolute, the cost of each previous month equals to the actual cost; the cost of the current month and of each future month equals to the forecast cost.

Default: comparative

Valid values:
comparative, absolute

PV_USE_ACTIVE_BASELINE_DATES

If set to true, enables users to use the Planned Value (PV) calculation algorithm, which uses projects' active baseline dates instead of their scheduled dates.

When the Project Planned Value Update service runs, and the PV_USE_ACTIVE_BASELINE_DATES flag is set to true,PPM checks for and uses active baseline dates instead of scheduled dates for planned value calculations on all projects. The PV calculation formula is:

PV = Baseline Cost * {MIN (Today's Date, Baseline Finish Date) - Baseline Start Date} / (Baseline Finish Date - Baseline Start Date)

Where Baseline Cost = Planned Labor + Planned Non-Labor

When the Project Planned Value Update service runs the first time after this flag is turned on, projects with scheduled dates and active baseline dates that are past are added to the queue for PV recalculation.

Default: false

Valid values:
true, false

*QUARTZ_WORKER_THREADS

Number of threads to be invoked per PPM Server node to send messages.

Default: 10

Valid values:
Integer greater than zero

REMOTE_ADMIN_REQUIRE_AUTH

Determines whether user authentication is required for remote administration of the PPM instance.

If set to true, users running kStop.sh to shut down the PPM Server must supply a valid PPM user name and password.

If set to false, any user with access to kStop.sh can shut down the server.

Default: true

Valid values:
true, false

REPORT_DIR

If you want report output to be written to a location other than the default directory (outside of the PPM Server directory structure), use this parameter to specify a different directory. Make sure that the PPM Server has access to the directory so that the report output HTML files can be written here.

Example

D:/<PPM_Home>
/930/aeon
/reports/

REPORT_LOG_DIR

Directory in which the PPM report logs are stored.

Note: In a server cluster, if you have overridden the default value for this parameter to refer to a different directory, then all nodes in the cluster must be able to access and share the directory.

Same default value as the BASE_LOG_DIR parameter

Example

D:/<PPM_Home>
/930/aeon/logs
/reports/

REPORTING_BASE_URL

If Operational Reporting is deployed on your system, this is the base URL for your BusinessObjects server.

Example

http:\\corpqa25
:8080

REPORTING_JDBC_URL If Operational Reporting is deployed on your system, this is the locator for the database that contains the Operational Reporting database schema. NA
REPORTING_DB_USERNAME If Operational Reporting is deployed on your system, this is the username for the Operational Reporting database schema. NA
REPORTING_DB_PASSWORD If Operational Reporting is deployed on your system, this is the password for the Operational Reporting database schema. NA

REPORTING_STATUS_REFRESH_RATE

Frequency with which report status is refreshed and displayed to the user.

Default: 5

(seconds)

REQUEST_AND_PROJECT_ KEEPALIVE_MAX_IDLE_TIME

Specifies the duration (in minutes) that you can stay idle on the Request Details page and Project Details page before your session starts to time out.

  • If the value of this parameter is grater than 0, users can stay idle in the Request Details page, Project Details page, and Edit Time Sheet page for the specified duration. After the duration ends, the session times out when the time specified in the parameter KINTANA_SESSION_TIMEOUT is up.
  • If the value of this parameter is 0, the parameter KINTANA_SESSION_ TIMEOUT works in the Request Details page and Project Details page as it does in other PPM pages: your session times out if no requests are sent from the browser to the server for a duration equal to or greater than the KINTANA_SESSION_TIMEOUT value.

Default value: 600

Valid value: integer

REQUEST_LINK_ALM_ ENTITY_STATUS Setting the parameter value to false disables the PPM Center defect workflow driven synchronization between PPM Center request status and ALM entity status. The default value is true.

Default value: true

Valid values:
true, false

REQUEST_LOG_DIR

Location for Request execution log output. (Logs directory directly under the directory specified by the BASE_PATH parameter.)

Note: In a server cluster, if you have overridden the default value for this parameter to refer to a different directory, then all nodes in the cluster must be able to access and share the directory.

Example

D:/PPM/930
/aeon/logs/

REQUEST_TYPE_CACHE_TIMEOUT

Determines the stale check timeout frequency for the cache that holds mapping between parameter and tokens for Request Type and Request Header Type.

Note: Do not change the value of this parameter.

Default: 3600
(seconds)

REQUEST_SEARCH_RESULTS_MAX_ROWS

Maximum number of results returned by a search. The value is displayed as the default in the Limit Rows Returned To field.

You can increase or lower the value to meet your needs.

If you want to restrict the maximum number of records returned for the current search only, you can change the value in the Limit Rows Returned To field directly.

Default: 1000

REQUEST_SEARCH_RESULTS_SHOW_TOTAL_NUMBER_OF_RECORDS

Flags whether or not to show total number of records for the request search results pages. The default value is false for better system performance.

Default value: false

Valid values:
true, false

REQUEST_TYPE_CACHE_TIMEOUT

Stale check timeout for the cache that maintains mappings between parameters and tokens for Request Type and Request Header Type.

Note: We strongly recommend that you not change the value of this parameter.

Default: 3600

(seconds)

RESOURCE_FINDER_ROLE_WEIGHT

Value used to calculate the suitability score for items returned on the Resource Finder results page.

Default: 0

Valid values:
0 through 100

RESOURCE_FINDER_SEARCH_MAX_USERS

Maximum number of resources that can be targeted in a user search. If the targeted number exceeds this value, the Resource Finder displays the message that the number of resources targeted is too large.

Default: 100

RESOURCE_FINDER_SKILL_WEIGHT

Value used to calculate the suitability score for items returned on the resource finder results page.

Default: 50

Valid values:
0 through 100

RESTRICT_BYPASS_EXECUTION_TO_MANAGERS

Determines whether only managers can bypass execution of workflow steps in packages.

If set to true, only users with an access grant of Package Manager or Request Manager access can bypass executions.

If set to false, all users eligible to act on executions can bypass them.

Default:
false

Valid values:
true, false

RESTRICT_BYPASS_REQ_EXEC_TO_MANAGERS

Restricts bypass execution to request managers. If set to true, only a user with the Manage Request access grant can bypass an execution step on a request.

Default: false

Valid values:
true,false

RM_ALLOWED_EFFORT_TYPES

Determines the effort types allowed for Resource Management staffing profile and other modules. You can specify a combination of up to three comma-delimited values.

Examples

  • fte, person_days, hours
  • fte, person_days
  • fte, hours
  • person_days, hours

The order does not matter.

Default:
fte, person_days

Valid values:
hours, fte,
person_days

*RM_DEFAULT_EFFORT_TYPE

Effort type used to display staffing profiles and resource pool information.

Default: fte

Valid values:
hours, fte,
person_days

*RM_DEFAULT_PERIOD_TYPE

Default period type used to display staffing profiles and resource pool information.

Default: month

Valid values:
quarter,
month,
week,
year

*RM_MAX_RESOURCE_IN_POOL

Maximum number of resources in a resource pool. If the number of resources exceeds this value, some features are unavailable on the Resource Pool overview page.

The View Resource Load button is not available if the number of resources in that resource pool (or its hierarchy if the "Include children resource pools when calculating load for this resource pool" flag is selected) exceeds the value set for this parameter.

The View Forecasted Demand and Manage Pool Capacity button are also unavailable if the number of resources in the resource pool exceeds the default. However, you can still use the Resource page Manage Participation feature to add or remove resources.

Values greater than the default (250) may increase response times and memory footprint when the above operations are performed.

Default: 250

RM_OVERRIDE_ASSIGNMENT_CONTROLS

If set to true, this parameter turns off security during allocation of a resource to a staffing profile or during assignment of a resource to a work plan. Any user with “Edit/View Staffing Profiles” or “Edit/View All Staffing Profiles” access grant can then directly perform the following actions:

  • Assign any resource (in a resource pool) to the staffing profile or the work plan, or to both.

  • Reject unmet resource demand for one or more staffing profile lines.

  • Forward unmet resource demand for one or more staffing profile lines to a different resource pool.

The user can also use the resource finder to locate and assign resources in all resource pools.

Default: false

Valid values:
true,false

*RMI_URL

Port on which the PPM Server listens to initiate RMI client/server communication.

Must be a unique port, distinct from the Web server, SQL*Net, and the HTTP or HTTPS ports.

Format:

rmi://<Host_Name>:<Port>/KintanaServer

Note: If you want to specify a literal IPv6 address, make sure you enclose the literal address with "[" and "]" characters. For example, rmi://[::1]:1099/

Note: We strongly recommend you specify DNS name instead of literal IPv6 address.

Default: 1099

Valid values:
Port numbers higher than 1024

Example

rmi://gold.ppm
.com:1099
/PPMServer

RMI_VALIDATE_SERVER_CERTIFICATE

Used if PPM Server is running in secure RMI mode.

If set to true, the client PPM Workbench validates the server certificate against the Certificate Authorizer's to verify server identity. If set to false, the certificate is not validated.

Default: false

Valid values:
true, false

*RML_PASSWORD

Password for the Oracle schema name specified for *RML_USERNAME.

Note: You must use kEncrypt.sh to encrypt the password. For information on how to run the kEncrypt.sh script, see kEncrypt.sh.

Valid values:
Encrypted password in the format
#!#<Encrypted_Password>#!#

*RML_USERNAME

Oracle schema name for the meta layer schema.

Must be the same as the database schema name used during installation.

Valid values:

Any user name format that Oracle supports

RMO_MAX_POSITION_AMOUNT The maximum number of positions allowed by RMO when it assigns resources to positions

Default: 50

Valid Values: Positive integer

RMO_MAX_PERIOD_AMOUNT The longest duration (in days) of positions allowed by RMO when it assigns resources to positions

Default: 365*2

Valid Values: Positive integer

RMO_OPTIMIZE_CONCURRENT_THRESHOLD

The maximum number of concurrent threads supported by RMO

For example, if the value of this parameter is set to 1, it means only one user is allowed to use the feature at a time.

Default: 1

Valid Values: Positive integer

RMO_OPTIMIZE_AMOUNT_THRESHOLD

The maximum amount of data to be handled by RMO

The amount of the data for calculation = (number of positions) x (number of resources in the specified resource pool) x (number of days)

Default: 11,000,000

(100 positions, 100 resources, 3 years)

Valid Values: Positive integer

RMO_OPT_CONCURRENT_TIMEOUT The timeout (in milliseconds) of RMO

Default: 10,000

Valid Values: Positive integer

SCHEME_BASED_REDIRECT_FILTER_ENABLED

If set to true, enables the SchemeBasedRedirectFilter filter.

The SchemeBasedRedirectFilter generates a correct redirect URL by adding the BASE_URL value as prefix to the redirect URL, such that every redirect URL starts with scheme

(http/https) and the same base URL, and then sends to the correct target.

If the parameter is not present in server.conf, the system would treat it as a true condition by default.

If you do not use https or reverse proxy, you can disable the SchemeBasedRedirectFilter by setting the parameter to false.

Default: true

Valid values:
true, false

SCPCLIENT_TIMEOUT

Amount of time after which SCP clients must provide feedback after a file transfer has initiated, else a timeout occurs.

Set to the maximum expected time for file transfer.

Default: 10000
(milliseconds)

SDI_LOG_SEVERITY

Level of detail included in Service Desk Integration (SDI) error logs. To log only errors, specify the value 0. To log both errors and information, specify the value 1.

Valid values:
0 and 1

SDI_SERVICE_INTERVAL

Frequency (in seconds) with which the SDI service is run.

Default: 900
(seconds)

SEARCH_TIMEOUT

Number of seconds after which searches time out. It controls the timeout of both request search and time sheets search.

Used to limit long-running queries in searches, which may be caused by submitting a search without specifying selective data. Avoids taking up database CPU if a user ends a session before the search is completed.

Default: 60

(seconds)

SEARCH_ALL_REQUEST_TYPE Setting this parameter to true, you can find all request types listed in the Request Type auto-complete list on the Search Request page. However, you are still not able to see the requests that you have no access to.

Default: false

Valid values:
true, false

SERVER_ENV_NAME

Name of the PPM environment that contains information about the PPM Server machine (for example, host name, user name, and password).

Must be set before PPM entity migrators or commands involving secure copy can run.

Default:
KINTANA_SERVER

SERVER_LOCALE_COUNTRY_CODE

Country code for the default regional settings.

Add this parameter to the server.conf file manually and set a country code value to specify the default regional settings. The default value is null. Valid values are any two-letter abbreviation of a country in uppercase. For example, if you want to set the default regional settings to United States, set this parameter value to US.

This parameter works together with SERVER_LOCALE_LANGUAGE_CODE to ensure that PPM Center groups all PPM Center users and non-PPM Center users together when sending notifications.

Default: null

Valid values:
Two-letter abbreviation of a country in uppercase.
Example, US.

SERVER_LOCALE_LANGUAGE_CODE

Language code for the default display language.

Add this parameter to the server.conf file manually and set a language code value to specify the default display language. The default value is null. Valid values are any two-letter abbreviation of a language in lowercase. For example, if you want to set the default display language to English, set the SERVER_LOCALE_LANGUAGE_CODE server configuration parameter to en.

This parameter works together with SERVER_LOCALE_COUNTRY_CODE to ensure that PPM Center groups all PPM Center users and non-PPM Center users together when sending notifications.

Default: null

Valid values:
Two-letter abbreviation of a language in lowercase.
Example, en.

SERVER_MAX_HEAP_SIZE Specify the maximum heap size of JVM. Default: 1280

SERVER_MAX_PERM_SIZE

For Micro Focus internal use only. Do not change its value unless directed to do so by Software Support for PPM.

Default: N/A

SERVER_MODE

Server mode to use in case you want exclusive access to a running server.

Default: NORMAL

Valid values:
Normal,
Restricted,
Disabled

*SERVER_NAME

DNS name or IP address of the machine hosting the PPM Server.

If you want to specify a literal IPv6 address, make sure you enclose the literal address with "[" and "]" characters. For example, [::1]

Note: We strongly recommend you specify DNS name instead of literal IPv6 address.

Default: kintana

Valid values:
Any valid machine name

SERVICE_RECORDS_EXPIRATION_DAYS At the end of every service run, PPM automatically deletes the run records as well as the errors that are older than the days specified by this parameter. Default: 14

SERVER_TYPE_CODE

Operating system on which the PPM Server is installed.

Valid values:
UNIX, WINDOWS

SERVICE_LIST_SOURCE

Source of the available list of services that users can associate with a request (through Demand Management) or a project task (through Project Management):

  • If set to uCMDB,PPM retrieves the list of services for requests from the integrated Universal CMDB application in real time.

  • If set to lookup,PPM retrieves the list of services for requests and tasks from the PPM Server.

Default: Validation

Valid values:
uCMDB,lookup

SERVICE_LIST_UCMDB_CACHE_TIMEOUT

Used for integration with Universal CMDB for service list retrieval.

Length of time (in seconds) that the service list remains in PPM cache before it is retrieved again.

Default: 300

Valid values: Integer

SERVICE_LIST_UCMDB_CI_MAPPINGS

Used for integration with Universal CMDB for service list retrieval.

Service list mappings between PPM and Universal CMDB CIs. For more information, see the Solution Integrations Guide.

Default: N/A

Example:

name:data_name
,description
:service
_description

SERVICE_LIST_UCMDB_CI_TYPE

Used for integration with Universal CMDB for service list retrieval.

Name of the configuration item (CI) type used to store the service list.

Note: You must create this CI type on the Universal CMDB server. For more information about creating a CI type, see the documentation for Universal CMDB.

Default: Service

Valid Values:

SERVICE_LIST_UCMDB_WS_MAX_CI_NUMBER

Used for integration with Universal CMDB for service list retrieval.

Maximum number of Universal CMDB configuration items (CIs) allowed in the service list.

Default: 1000

Valid values:
Integer

SERVICE_PROVIDER_SECURITY_GROUP

A group of PPM users that no users in the system outside of this group can modify. This prevents these users from being locked out of the system and ensures that they always maintain a specific set of access rights.

For Micro Focus internal use only. Do not change its value unless directed to do so by Software Support for PPM.

Default: N/A

SERVICES_ENABLED

Services, if any, run on a node in a server cluster. This parameter is set for every server in a cluster.

Valid values are:

  • false - This node does not process light or heavy services.

  • light - This node only processes light services

  • heavy - This node only processes heavy services

  • true - This node processes all (light and heavy) service types

For a description of PPM background services and instructions on how to configure them, see PPM Background Services.

Default: true

Valid values:
true, false,
light, heavy

SHOW_BASE_URL_ON_NOTIFICATIONS

Determines whether the URL for the PPM logon window is displayed at the top of each email notification.

Default: true

Valid values:
true, false

SHOW_DEBUGGING_CONSOLE_PER_USER Controls whether you can access the Debug Console by holding the ALT key and clicking the company logo.

Default: false

Valid values:
true, false

SHOW_PARAMETERS_AT_STARTUP

If set to true, enables the display (and logging) of all PPM server configuration parameters used during startup.

Default: false

Valid values:
true, false

SHOW_PERSONALIZE_FIRST

If set to true,Personalize Dashboard is the first PPM Dashboard menu item listed on the menu bar.

Default: false

Valid values:
true, false

SINGLE_SIGN_ON_PLUGIN

In single sign-on configuration, this parameter is used to specify the SSO method. You must manually add this parameter to the server.conf file. For more information, see Implementing User Authentication.

Example

com.kintana
.sc.security
.auth.Site
MinderSingle
SignOn

SKIP_CHECK_REQUIRED_FIELD_WHEN_IMPORT_PROJECT

If set to true, the import utility skips the check for required fields during project creation.

Default: false

Valid values:
true, false

SKIP_REQUEST_CREATE_CONFIRMATION_PAGE If you set this parameter to true, you can skip the Request Creation Confirmed page and directly go to the request details page after clicking Submit on the Create New Request page.

Default: false

Valid values:
true, false

SM_RFC_INTEGRATION_ENABLED

Enables the integration of PPM tasks and Service Manager requests for change (RFCs).

Default: true

Valid values:
true, false

SM_PASSWORD

Password that PPM Center uses to access Service Manager. You must encrypt this password by using the kEncrypt.sh script, which is located in the bin directory of the PPM Server. Then remove #!# from the beginning and the end of the encrypted password.

Note: For information on how to run the kEncrypt.sh script, see kEncrypt.sh.

Default: N/A

SM_URL

Host name or IP address of Service Manager.

Default: N/A

Example:

http://<Host_Name>
:13080

SM_USERNAME

User name that PPM uses to access Service Manager.

This user name must include only single-byte characters.

Default: N/A

Example: admin

SM_WEB_URL

Address of Service Manager Web tier.

Example:

http://<Host_
Name>:<Port>
/<WebTier_
Package_File
_Name>/index.do

SMTP_ADD_PERIOD

Enables an SMTP client to prepend a dot to each line in the body of an email message.

Default: true

Valid values:
true, false

SMTP_AUTH_PASSWORD Encrypted password of SMTP authentication.

Note: You must use kEncrypt.sh to encrypt the password. For information on how to run the kEncrypt.sh script, see kEncrypt.sh.

Default: N/A

Valid values:
Encrypted password in the format
#!#<Encrypted_Password>#!#

SMTP_AUTH_USERNAME Username of SMTP authentication. Default: N/A

SMTP_PORT

Port used to connect to the SMTP server when sending notifications.

Default:
25 if SMTP_USE_SSL is false;
465 if SMTP_USE_SSL is true.

Valid values:
Any available port number.

SMTP_RFC_COMPLIANCE

If set to true, formats PPM email notifications with line-feed <LF> and carriage-return <CR> characters appropriate for restrictive Global 9 security SMTP servers.

Default: false

Valid values:
true, false

**SMTP_SERVER

Required if notifications are used

Host name of the SMTP-compliant mail server that acts as the gateway for email notifications.

Example
mailserver
.mydomain.com

SMTP_USE_SSL Specifies whether or not to connect to SMTP server using SSL.

Note: SSL is not used by default.

Default: false
Valid values:
true, false
SMTP_USE_STARTTLS Specifies whether or not to connect to SMTP server using STARTTLS.

Note: STARTTLS is not the same as SSL. By default, STARTTLS is not used.

Default: false
Valid values:
true, false

SMTP_WINDOWS_ADD_PERIOD

If set to true, and if a Windows SMTP server is detected, PPM appends a period (.) to email notifications.

Default: true

Valid values:
true, false

SOCKS_PROXY_HOST

Host name of the SOCKS proxy server.

Host name of the SOCKS proxy server

SOCKS_PROXY_PORT

Port on the SOCKS proxy host that accepts proxy connections.

Any available port on the SOCKS proxy host

SP_RESOURCE_ROLE_RATE_ENABLE

If it is set to true, PPM uses the resource role for the cost fator "Role" when calculating the forecasted labor cost of a committed resource. When the resource role is not defined, PPM uses the position role.

If it is set to false, PPM uses the position role for the cost fator "Role" when calculating the forecasted labor cost of a committed resource.

Default: true

Valid values:
true, false

*SQLPLUS

Name of the command-line SQL*Plus executable, which must be in the <Oracle_Home>/bin directory.

Default:
sqlplus.exe

SQLPLUS_CMDLINE_HANDLER

SQL*Plus version and operating system that use the command line to pass arguments.

Default: N/A

Example:
101030:WINDOWS

SQLPLUS_ESCAPE_CHARACTER

Specifies the SQL*Plus escape character.

Default: (none)

**SQLPLUS_VERSION

Oracle SQL*Plus version installed on the machine that hosts the PPM Server. You must set this for some PPM reports that run from command-line SQL*Plus calls.

If you encounter problems running PL/SQL-based reports in PPM, set this parameter.

Example

com.kintana.core
.server.SQLPLUS_
VERSION=10.1.0.2

SSH2_JSCH_DISABLE_ STRICT_HOST_KEY_ CHECKING

If set to true, the SSH2 client will connect to the remote host even when its key is not in the list of the trusted hosts (known_hosts file).

Caution: This parameter should not be set to true on a production environment.

Default: false

Valid values: true, false

SSH2_JSCH_KNOWN_ HOSTS_FILE_PATH

When a value is defined in this parameter (valid file path), PPM Center will use it as known_hosts file to validate keys of trusted hosts it connects to.

The remote servers you will connect to should be included in the known_hosts file (using OpenSSH format), otherwise the client cannot connect to them (unless the SSH2_JSCH_DISABLE_STRICT_HOST_KEY_CHECKING parameter is set to true, in which case PPM does not search for a known_hosts file).

If this parameter is left empty, PPM first checks if there is a <PPM_HOME>/known_hosts file to use. If no, PPM then checks known standard locations for known_hosts file:

  • .../.ssh/known_hosts and .../etc/ssh/ssh_known_hosts under UNIX

  • %USERPROFILE%\ssh\known_hosts and %USERPROFILE%\.ssh\known_hosts under Windows

Note: When a Linux user connects to a remote server using the ssh command on the command line and then accepts the host key when prompted, this remote machine key will be automatically added to the trusted hosts list in .../.ssh/known_hosts.

Default: N/A
STAFFING_PROFILE_DEFAULT_COLUMNS

It only works for staffing profile New UI. Specify the reference codes of columns that are to be displayed by default in staffing profiles. The reference codes are separated by semicolons.

The reference code for each available staffing profile column is as follows:

Column Reference Code
Status status
Resource Pool resourcePool
Start Date startDate
Finish Date finishDate
Average FTE/Total Hours avgFTEShort
Resource Type resourceType
Specific Resource Requested specificResource
Response Needed By responseBy
Skills skillProficiencies
Cost Category costCategory
position user data The User Data Col. value, e.g., USER_DATA4
Example: resourceType; skillProficiencies; costCategory.
STAFFING_PROFILE_REQUIRED_COLUMNS

It only works for staffing profile New UI. Specify the reference codes of columns that are required in staffing profiles. The reference codes are separated by semicolons.

The reference code for each available staffing profile column is as follows:

Column Reference Code
Resource Pool resourcePool
Resource Type resourceType
Specific Resource Requested specificResource
Response Needed By responseBy
Skills skillProficiencies
Cost Category costCategory

Required columns are always displayed in staffing profiles even when they are not set as default columns.

Example: resourcePool; specificResource.

SYNCH_EXEC_INIT_WAIT_TIME

Amount of time (in seconds) after which the intermediate Request Working page opens.

Default: 4

SYNCH_EXEC_MAX_POLL_TRIES

Maximum number of times to poll for completion of a request before a final message is sent to the user.

Default: 4

SYNCH_EXEC_POLL_INTERVAL

Time interval (in seconds) at which to poll for completion of a request after the intermediate Request Working page opens.

Default: 15

SYNCH_PFM_PROJECT_HEALTH_INTERVAL

Determines how often (in seconds) the Synch PFM Project Health service runs.

Default: 600
(seconds)

Valid values: N/A

THREAD_POOL_MAX_THREADS

Maximum number of packages to run simultaneously within a release distribution.

If a large number of packages in a distribution are processing, increasing this value can improve performance.

Default: 10

THREAD_POOL_MIN_THREADS

Minimum number of packages to be run simultaneously within a release distribution.

See also THREAD_POOL_MAX_THREADS.

Default: 5

**TIME_ZONE

Required if the PPM Server and the Oracle database are in different time zones

Used to set the time zone of the Oracle database. Leave the parameter blank if the PPM Server and the Oracle database host are in the same time zone. If they are in different time zones, set this to the time zone of the Oracle database host.

Use a "standard" time zone setting, and not a daylight savings setting (such as EDT or PDT). You can use a fully-qualified time zone name (you are not restricted to three digits), such as "America/Los_Angeles" or "Australia/LHI". For a list of fully-qualified names, run the Client Time Zone Report in the Admin Tools window of the PPM Workbench.

For details on how to run the report, see Running Server Reports from the Admin Tools Window.

If you do not a specify a value for this parameter, the value defaults to the time zone in which the PPM Server is running.

Default: Time zone in which the PPM Server is running

Valid values: Any fully-qualified time zone designation such as "America/Los_Angeles" or "Australia/LHI".

Do not use daylight savings-modified time zones such as "EDT" or "PDT".

SSL_CLIENT_SOCKET_ENABLED_PROTOCOL Enables you to specify the TLS protocol of LDAPs connections.

Default: TLS

Valid values: TLS, TLSv1, TLSv1.1, and TLSv1.2

SYNC_POSITIONS_FROM_WORKPLAN Enables you to copy staffing profile positions from work plan tasks.

Default: true

Valid values: true, false

TIMESHEET_KEEPALIVE_MAX_ IDLE_TIME

Specifies the duration (in minutes) that you can stay idle on the Edit Time Sheet page before your session starts to time out.

  • If the value of this parameter is greater than 0, users can stay idle in the Edit Time Sheet page for the specified duration. After the duration ends, the session times out when the time specified in the parameter KINTANA_SESSION_TIMEOUT is up.
  • If the value of this parameter is 0, the parameter KINTANA_SESSION_TIMEOUT works in the Edit Time Sheet page as it does in other PPM pages: your session times out if no requests are sent from the browser to the server for a duration equal to or greater than the KINTANA_SESSION_ TIMEOUT value.

 

Default value: 180

Valid value: integer

TM_CANNOT_ADD_ASSIGNMENT_COMPLETE_TASK

By default, if a user has already marked his/her assignment 100% complete in the time sheet, the user can still log time on the task when the task is not 100% complete.

If you do not want users who have completed their assignments on a task to continue logging time on the task, set the parameter to true.

Default: false

Valid: true, false

TM_CANNOT_REOPEN_CLOSED_TASK

By default, when users continue to log time on a task that is already closed, saving the time sheet updates the task % complete value and reopens the task.

When the parameter is set to true, the time logged against a closed task does not change its percent complete value or reopen it.

Default: false

Valid: true, false

TM_DISABLE_INCLUDING_LAST_TS_ITEMS

If set to true, disables the option for users to include (copy) items from a time sheet for the most recent previous period when they create a new time sheet.

If set to false, enables the option.

We recommend setting this parameter to true.

Default: true

Valid values: true, false

TM_DYNAMIC_DESC_CHARS

If set to true, enables the width allotted to the Item column on each time sheet to vary as items are added or removed, according to the number of characters in the longest work item data in all the rows on the time sheet. The maximum width of the column is determined by the TM_DYNAMIC_DESC_CHARS_MAX parameter.

Default: false

Valid values:

true, false

TM_DYNAMIC_DESC_CHARS_MAX

If the TM_DYNAMIC_DESC_CHARS parameter is set to true, this parameter determines the maximum width (in number of characters) of the Item column on time sheets. The allotted column width is calculated from this number as an approximation, and the data for particular items might be truncated. If this is an issue, you can increase the value of this parameter.

Note: We recommend that you use the default value of 80 characters.

Default: 80

Valid values: Integer

TM_ENABLE_GRID_RESIZE_CONTROL

If set to true, enables users to vertically resize Time Breakdown tables on time sheets.

Default: false

Valid values:

true, false

TM_ENABLE_POLICY_EXTENSION

Enable or disable the Time Management Custom Policy Extension.

Default: false

Valid values:
true, false

TM_ENABLE_REQ_ACTIVITY_CONTROLS

In time sheet policies, you can require users to specify activities on time sheet lines for requests of particular request types. To enable this activity restriction based on request types, you must set this parameter to true. (You must also select the Use Time Management to track actuals option from the PPM Workbench.)

Default: false

Valid values:
true, false

TM_ENABLE_SHOW_WHATS_NEW

The first time a user opens any time sheet, PPM displays a message that describes the saving of the time sheet. After this, the message is not displayed to that user again for any time sheet.

To disable the display of this message, set this parameter value to false.

Note: On PPM instances that support multiple languages, the message is displayed only to users who select English at log-in.

Default: true

Valid values:
true, false

TM_MAX_PREVIOUS_TIME_PERIODS

Determines the maximum number of time periods that can be displayed in the Previous Time Periods to Show list on the Approve Time Sheets page.

The default value (4) supplied is for optimal performance. If you increase the value, search performance may suffer.

Default: 4

Valid values:
Integer

TM_MAX_TIMESHEET_QUERY_RESULTS

Determines the maximum number of result rows retrieved from the database for queries from the Search Time Sheets, Search for a Time Sheet to Freeze, Search for a Time Sheet to Close, and Approve Time Sheet pages.

Default: 500

Valid values:
Integer

TM_MAX_TIME_APPROVER_WARNING_COUNT The maximum number of time approvers of time sheet lines allowed by the system before it throws warning.

Default Value: 80,000,000

Valid Value: Positive integer

TM_MAX_BILLING_APPROVER_WARNING_COUNT The maximum number of billing approvers of time sheets allowed by the system before it throws warning.

Default Value: 160,000,000

Valid Value: Positive integer

TM_MAX_TIME_APPROVER_ERROR_COUNT The maximum number of time approvers of time sheet lines allowed by the system before it throws error.

Default Value: 100,000,000

Valid Value: Positive integer

TM_MAX_BILLING_APPROVER_ERROR_COUNT The maximum number of billing approvers of time sheets allowed by the system before it throws error.

Default Value: 200,000,000

Valid Value: Positive integer

TM_REEVALUATE_COUNT Specifies the amount of the Reevaluate Time Sheet information handled by the Evaluate TM Approvers service. Default Value:1,000,000

TMG_CONFIGURABLE_FILTERS_REF_CODE

Stores the reference code for the Time Management request type to use to override the default request type used in the Add Work Item to Timesheet window.

Default: N/A

Valid values:
Reference code of the request type

TMG_FUTURE_PERIODS_TO_ALLOW

Specifies the number future periods for which users can specify time on time sheets.

Default: 10

TMG_PAST_PERIODS_TO_ALLOW

Specifies the number of previous periods for which users can specify time.

Default: 10

TMPM_SYNC_SERVICE_INTERVAL

Determined the frequency (in milliseconds) with which the TM-PM Sync Service runs.

Note: We strongly recommend that you keep the default value (equal to three hours).

Default: 10800000
(in ms)

TRANSFER_PATH

Specifies the default temporary directory that PPM uses. The main purpose of this directory is to temporarily hold files as they are migrated from a source environment to a destination environment with Deployment Management.

In a server cluster, all servers must be able to access and share the specified directory.

Example

D:/<PPM_Home>
/930/ionia
/transfers/

TURN_ON_CONCURRENT_REQUEST_WATCH_DOG

If set to true, enables the Watchdog tool.

Default: true

Valid values:
true, false

UCMDB_GATEWAY_URL

Used for integration with Universal CMDB for CI selection.

Web location of the Probe Gateway component of the Discovery and Dependency Mapping (DDM) Probe. The Probe Gateway provides communication (HTTP or HTTPS) between the Probe Manager and the Universal CMDB server for processes such as downloading tasks and returning task results.

For more information, see the Solution Integrations Guide.

Valid values:

UCMDB_MAX_CI_NUMBER

Used for integration with Universal CMDB for CI selection.

Maximum number of configuration items (CIs) to display on the Universal CMDB section of the request details page. For more information, see the Solution Integrations Guide.

Default: 20

Valid values:
Integer between 1 and 100

Note: If you specify a value greater than 100, the Universal CMDB server does not restart, and instead displays an error message.

UCMDB_PASSWORD

Encrypted password for the Universal CMDB user. For more information, see the Solution Integrations Guide.

Note: You must use kEncrypt.sh to encrypt the password. For information on how to run the kEncrypt.sh script, see kEncrypt.sh.

Valid values: Encrypted password in the format #!#<Encrpted_Password>#!#

UCMDB_SERVER_URL

URL of the Universal CMDB server.

http://<UCMDB_Host>:<Port>/ucmdb/

or

https://<UCMDB_Host>:<Port>/ucmdb

where <UCMDB_Host> represents the machine on which Universal CMDB is running.

Note: If the Universal CMDB server is configured to support HTTPS, make sure that you configure the UCMDB_SSL_KEYSTORE_PATH parameter.

For more information, see the Solution Integrations Guide.

Default: N/A

UCMDB_SSL_KEYSTORE_PATH

Used for integration with Universal CMDB for CI selection or service list retrieval.

SSL keystore path. Required only if UCMDB_SERVER_URL parameter uses HTTPS.

Default: N/A

Example:
/home/release
/Instances
/ucmdb80
.keystore

UCMDB_USER

Used for integration with Universal CMDB for CI selection.

Universal CMDB user name for the integration. For more information, see the Solution Integrations Guide.

Default: N/A

Example: Admin

UCMDB_WS_MAX_CONNECTION_NUMBER

Determines the maximum number of connections to the Universal CMDB server through the Web Service API.

Default: 10

UCMDB_WS_PASSWORD

Universal CMDB user password for logging in through Web service.

Note: You must use kEncrypt.sh to encrypt the password. For information on how to run the kEncrypt.sh script, see kEncrypt.sh.

Default: N/A

Valid values: Encrypted password in the format #!#<Password>#!#

UCMDB_WS_USER

Used for integration with Universal CMDB for service list retrieval.

Universal CMDB user name for logging in through Web service.

Default: N/A

Example: Admin

UI_MONITOR_THRESHOLD

If ENABLE_UI_MONITOR is set to true, this parameter determines the time threshold value of the activity monitor.

Default: 4000 (milliseconds)

Valid values: Integer greater than 0

USE_REGION_OF_ RESOURCE_POOL _FOR_POSITION_ FORECAST_COST

If you set this parameter to true, PPM uses the region of the resource pool specified for the position to pick up cost rule when calculating its forecast labor cost. Otherwise, PPM uses the region of the staffing profile to pick up the cost rule.

If you change the parameter value, the new value will be used in the calculation of forecast labor cost the next time when Staffing Profile Financial Summary Sync service runs.

Default: false

Valid values:
true, false

USE_ROLE_OF_TASK_FOR_WP_COSTS

When it is set to true, PPM uses the task role for the cost factor "Role" when calculating the task cost. When task role is not defined, use the resource role.

When it is set to false, for the assigned portion of the task, PPM uses the role of the resource; for the unassigned portion, PPM uses the task role. If , for the assigned portion of the task, the assigned resource does not have a role, PPM uses the task role.

Value changes of this parameter do not impact existing tasks until they are modified.

Default: false

Valid values:
true, false

USER_SEARCH_RESULTS_MAX_ROWS The maximum number of users displayed in User Management Console.

Default: 200

Valid values: positive integer

USE_SERVER_LOCALE_FOR_NOTIFICATIONS Flags whether or not to check notification recipient regional settings. Setting the value to true ignores users' regional settings when sending email notifications, and uses the values of server configuration parameters SERVER_LOCALE_COUNTRY_CODE and SERVER_LOCALE_LANGUAGE_CODE instead. This ensures that recipients are not split into different groups according to their regional settings.

Default: false

Valid values:
true, false

USER_PASSWORD_MAX_LENGTH

Maximum number of characters in user passwords.

Default: 16

USER_PASSWORD_MIN_DIGITS

Minimum number of digits in user passwords.

Default: 1

USER_PASSWORD_MIN_LENGTH

Minimum number of characters in a user password.

Default: 8

USER_PASSWORD_MIN_SPECIAL

Determines the minimum number of non-alphanumeric characters that user passwords must contain.

Default: 0

USER_PASSWORD_MIN_UPPERCASE_LETTERS Minimum number of uppercase letters in a user password. Default: 1
USER_PASSWORD_MIN_LOWERCASE_LETTERS Minimum number of lowercase letters in a user password. Default: 1

VALIDATION_LOG_DIR

In a server cluster, if you have overridden the default value for this parameters to refer to a different directory, then all servers in the cluster must be able to access and share the directory.

Same default value as the BASE_LOG_DIR parameter

Example

D:/<PPM_Home>
/930/aeon
/logs

VALIDATE_TASK_USER_DATA

When set to true, PPM validates tasks' user data when you save a work plan.

It is not recommended to change the parameter's default value unless there is serious performance issue. Check this with support before changing the value to false.

Default: true

Valid values:
true, false

VISUALIZATION_EXEC_TIMEOUT

Length of time (in seconds) that resource management visualizations can run before they time out.

Default: 180

**WEB_CACHE_DIR

Specifies web cache directory.

Add this parameter to the server.conf file if it is not there and make sure to use a shared folder in clustered configuration so that whenever a chart in portlet is loaded by PPM Dashboard, it creates charts pictures into this shared folder. Then, the Directory Cleanup Service can automatically clean up the older pictures files.

Required only if all the nodes of the cluster are not located on the same physical machine AND in the same <PPM_Home> folder.

Example:

//<IP_Address>
/<Local_Drive_Letter>$
/<Shared_Folder>/

or

<File_Server_Name>$
/<Shared_Folder>
WF_DISABLE_DELEGATE_DECISION_STEP

By adding this parameter to the server.conf file and setting it to true, you can hide the Delegate Decision button for workflow steps where the Decision Required option is set to At Least One or All. If this parameter is not set or set to false, the Delegate Decision button will be displayed.

Default: false

Valid values:
true, false

WF_SCHEDULED_TASK_INTERVAL

Frequency with which the PPM Server checks for pending scheduled tasks, and starts the tasks if worker threads are available.

Default: 60
(seconds)

WF_SCHEDULED_TASK_PRIORITY

Determines the priority of scheduled tasks.

Because scheduled tasks run in the background, it may be useful to run them at a lower priority than the threads servicing user-oriented interactive tasks.

Default: 10

WORKBENCH_PLUGIN_VERSION

Earliest Java plug-in version used to access the PPM Workbench interface.

Use this parameter to use a specific version (other than the default version) of the Java plug-in to open the PPM Workbench.

Example

1.7.0_72

WORKBENCH_MAX_HEAP_SIZE

Specifies maximum available memory (in MB) for the PPM Workbench.

Default: 256

WORKBENCH_SERVICE_URL

The address of PPM Server that PPM Workbench communicates with via HTTP(S). If not set, PPM Workbench communicates with the server specified in BASE_URL. The format of this parameter is the same as BASE_URL.

This parameter is only effective when ENABLE_WORKBENCH_HTTP is set to true.

Default: null

WORK_PLAN_RESOURCE_AVAILABILITY_DAYS_LIMIT

Specifies resource availability days limit for a task, including the resource's non-working days.

A schedule warning appears if the total of the value entered in the Scheduled Duration field and the resource's non-working days is bigger than the limit you specified.

Default: 2000

Valid values: An integer value greater than 0 and less than 2147483648

WS_UPDATE_CLOSED_AND_CANCELED_REQUESTS

If set to true, lets Web services update closed and canceled requests.

Default: false

Valid values:
true, false

    a.    For details about this parameter, see the Solution Integrations Guide.

    b.    For details about this parameter, see Center Management for Quality Center Guide.