Server parameters

Administrators can configure server parameters that determine how PPM works.

Overview

Administrators can set server parameters to control the behavior of different areas in PPM.

You can configure the server parameters from the following locations:

A single asterisk (*) in the Parameter column indicates that the parameter is required to set up a PPM server. Two asterisks (**) in this column indicates that the parameter is required based on the condition of another parameter.

Back to top

Parameters

The following table lists the available server parameters.

Parameter

Details

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 value to prevent PPM from hanging if a user defines portlet criteria that would return a very large volume of data.

Values:

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.

Values:

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.

Values:

Default: false

Valid values: true, false

ADJUST_NOTES_TIMESTAMP_TO_BROWSER_TIMEZONE

When set to true, if the Web Browser is using a timezone that’s different from the PPM Server JVM Timezone, the date/time of the Notes (on all PPM web pages with notes) will be adjusted to use the Browser timezone. A small icon will appear to the left of the date and show the time in the Server timezone as a tooltip.

Values:

Default: false

Valid values: true, false

ALLOW_CONCURRENT_LICENSE_STEAL_AFTER_IDLE_DELAY_IN_MINUTES

When you have run out of concurrent licenses, sessions that have been inactive longer than the specified number of minutes will be forcibly closed to release the concurrent licenses. The longest inactive session will be closed first. The value for this parameter must be smaller than the value specified in the KINTANA_SESSION_TIMEOUT parameter.

Values:

Default: 120 (minutes)

Added in version: 10.0.

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.

Values:

Default: false

Valid values: true, false

ALLOW_LOG_TIME_ON_MILESTONES

When it is set to false, time submitters cannot add milestone tasks to their time sheets.

This parameter only prevents time submitters from adding new milestones to their time sheets or to the My Items. For the milestone tasks that are in the Suggested Items or already added to My Items before disabling the parameter, time submitters can still log time on them.

Values:

Default: true

Valid values: true, false

ALLOW_NO_SIZE_LIMIT_RICH_TEXT_FIELD

If set to true, there's no limit for the size of the request rich text fields (HTML), and you can add image files in such fields.

Default: false

Valid values: true, false

Introduced in version: 24.2

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.

You should flush the user menu cache after changing the parameter value to make sure the change takes effect on the related menus.

Values:

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 Microsoft 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.

Values:

Default: BOTH

Valid values: MPP_FILE, PLUGIN,BOTH

APM_ROADMAP_HIERARCHY_PORTFOLIO_LEVEL

Specifies the depth of roadmap hierarchy in the portfolio level.

Values:

Default: 5

Valid values: Any value from 0 to the value specified by APM_ROADMAP_HIERARCHY_MAX_LEVEL

APM_ROADMAP_HIERARCHY_REQUEST_LEVEL

Specifies the depth of roadmap hierarchy in the request level.

Values:

Default: 5

Valid values: any value from o to the value specified by APM_ROADMAP_HIERARCHY_MAX_LEVEL

APM_ROADMAP_HIERARCHY_MAX_LEVEL

Specifies the maximum depth of roadmap hierarchy in the request or portfolio level.

Values:

Default: 5

Valid values: integer

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.

Values:

Default: 8093

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

ARP_DATA_EXTRACT_MAX_RESOURCE_POOLS

Maximum number of resource pools allowed when exporting data of the Analyze Resource Pools page.

Values:

Default: 900

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.

Values:

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.

Values:

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.

Values:

Default: 30

Valid values: any positive integer

ASSET_ROLLUP_TIMESHEETLINE_BATCH_SIZE

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

Values:

Default: 800

Valid values: 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/attachment

ATTACHMENT_SORT_COLUMN

Specifies a column by which the attachments in the References section are sorted ascendingly.

Parameter value is case-sensitive.

If you left the parameter undefined, attachments are sorted ascendingly by the creation date.

Valid values:

  • fileName,
  • fileSize,
  • author,
  • creationDate,
  • checkedInDate

AUTHENTICATE_REPORTS

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

Values:

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.

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.

Values:

Default: false

Valid values: true, false

AUTO_COMPLETE_LONG_TYPE_MAX_ROWS

Maximum number of rows in long auto-complete lists.

Values:

Default: 5000

AUTO_COMPLETE_QUERY_TIMEOUT

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

Values:

Default: 30 (seconds)

AUTO_COMPLETE_SHORT_TYPE_MAX_ROWS

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

Values:

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.

Values:

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.

Values:

Default: 5 (seconds)

AVAILABLE_WORK_PLAN_FILE_FORMAT_FOR_DOWNLOAD

Specifies which file formats can be selected for the downloaded work plan files in the Project Settings > Project Scheduling Integration policy. The valid values include:

  • MPP. Project work plans can be downloaded as Microsoft Project MPP files.
  • MSXML. Project work plans can be downloaded as Microsoft Project XML files.
  • XER. Project work plans can be downloaded as Primavera P6 XER files.
  • P6XML. Project work plans can be downloaded as Primavera P6 XML files.

Separate multiple values with a comma. If you only specify one value for this parameter, the options to select the file format is not displayed in the Project Settings. The work plan file is downloaded in the specified format. If no value is specified for this parameter, the default value, MPP, is used.

Values:

Default: MPP

Valid values: MPP, MSP_XML, P6_XER, P6_XML

Introduced in version: 2023.

BACKGROUND_SERVICE_MONITOR_THRESHOLD

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

Values:

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.kintana.core.server.BASE_LOG_DIR=C:/PPM/eon/logs

*BASE_PATH

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

Values:

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 Solution integrations.

Values:

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. We suggest that you exercise caution when setting this parameter to false, unless you are absolutely sure about the consequences.

Values:

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.

Values:

Default: false

Valid values: true, false

BUDGET_IN_WHOLE_DOLLARS

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

Values:

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.

Values:

Default: false

Valid values: true, false

CCM_MACHINE_URL

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

For details about this parameter, see the Solution Integrations Guide

Valid value format:

http://<Host>:<Port>/ccm/

CHANGE_MANAGEMENT_LICENSE_KEY

License key for Demand Management.

Default: N/A

CHANGE_PASSWORD_TOKEN_TIMEOUT

Validity duration (in minutes) of the one-time token for reset password.

Added in release: PPM 9.60

Values:

Default: 5 (minutes)

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 ENABLE_COMMIT_RESOURCE_FINDER parameter is set to true.

Values:

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 ENABLE_DISTRIBUTE_RESOURCE_IN_RESOURCE_FINDER parameter is set to true.

Values:

Default: false

Valid values: true, false

CHECK_HIDE_PAST_NOT_FULFILLED_REQUESTS

Controls whether or not the option Hide past not-fulfilled resource requests is checked by default when users opens the resource pool page for the first time.

  • true: the option is checked by default.
  • false: the option is cleared by default.

The next time you open the resource pool page, the option keeps the status (checked or cleared) as it was when you last left the page, regardless of the parameter value.

Values:

Default: false

Valid values: true, false

CHECK_HOST_HEADER_WHEN_REDIRECT

When set to true, when a request needs to be redirected, PPM checks the host header of the request. If the host header is not the same as the base URL, the request is rejected.

Values:

Default: false

Valid values: true, false

Introduced in version: 10.0.4

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.

Note: Setting this parameter to true might have impact on system performance.

Values:

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.

Values:

Default: 5

CLOSE_BROWSER_ON_APPLET_EXIT

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

Values:

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_LIC_USAGE_MINIMUM_DELAY_BETWEEN_NOTIF_IN_HOURS

The number of hours to wait after the last notifications defined in the CONC_LIC_USAGE_SEND_NOTIF_IF_STEAL_YOUNGER_THAN_IN_MIN, CONC_LIC_USAGE_SEND_NOTIF_WHEN_CONC_LOG_IN_REFUSED, CONC_LIC_USAGE_SEND_NOTIF_WHEN_STEALING_IDLE_SESSION, and CONC_LIC_USAGE_THRESHOLD_IN_PERCENT parameters were sent, before sending out the next notifications. It applies independently to each of the notifications.

Default: 24 (hours)

Added in version: 10.0.

CONC_LIC_USAGE_NOTIF_RECIPIENTS

Email addresses of the users to be notified when the concurrent license usage reaches the thresholds defined in the CONC_LIC_USAGE_SEND_NOTIF_IF_STEAL_YOUNGER_THAN_IN_MIN, CONC_LIC_USAGE_SEND_NOTIF_WHEN_CONC_LOG_IN_REFUSED, CONC_LIC_USAGE_SEND_NOTIF_WHEN_STEALING_IDLE_SESSION, and CONC_LIC_USAGE_THRESHOLD_IN_PERCENT parameters.

Use colons or semicolons to separate multiple email addresses.

Example: mgr@ppm.com

Added in version: 10.0.

CONC_LIC_USAGE_SEND_NOTIF_IF_STEAL_YOUNGER_THAN_IN_MIN

When sessions that have been inactive less than the number of minutes defined in this parameter are forcibly closed to release concurrent licenses, a notification will be sent to email addresses defined in the CONC_LIC_USAGE_NOTIF_RECIPIENTS parameter. A valid value for this parameter should be greater than the value of the ALLOW_CONCURRENT_LICENSE_STEAL_AFTER_IDLE_DELAY_IN_MINUTES parameter, and smaller than the value of the *KINTANA_SESSION_TIMEOUT parameter.

Default: 140 (minutes)

Introduced in version: 10.0.

CONC_LIC_USAGE_SEND_NOTIF_WHEN_CONC_LOG_IN_REFUSED

When set to true, an email notification will be sent to email addresses defined in the CONC_LIC_USAGE_NOTIF_RECIPIENTS parameter when you have run out of concurrent licenses and that no eligible sessions can be forcibly closed to release a concurrent session. When this happens, it means some users could not log into PPM.

Valid values: true, false

Introduced in version: 10.0.

CONC_LIC_USAGE_SEND_NOTIF_WHEN_STEALING_IDLE_SESSION

When set to true, an email notification will be sent to email addresses defined in the CONC_LIC_USAGE_NOTIF_RECIPIENTS parameter when inactive sessions are forcibly terminated to release concurrent licenses. See ALLOW_CONCURRENT_LICENSE_STEAL_AFTER_IDLE_DELAY_IN_MINUTES for more information.

Valid values: true, false

Introduced in version: 10.0.

CONC_LIC_USAGE_THRESHOLD_IN_PERCENT

When the concurrent license usage reaches the specified percentage, an email notification will be sent to the email addresses defined in the CONC_LIC_USAGE_NOTIF_RECIPIENTS parameter. If the value is empty or <=0, this function is disabled. Any value greater than 100 is considered 100.

Example: 95

Introduced in version: 10.0.

**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.

When only the protocol "SCP2JSch" enables retrieving AOL logs from the EBS server, the parameter should be set to "SCP2JSch".

Values:

Default: FTP

Valid values: FTP, SCP, SCP2JSch

**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 in the Installation and Administration guide.

Values:

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 the CONC_LOG_TRANSFER_PROTOCOL parameter.

Example: applmgr

CONTENT_SECURITY_POLICY

Defines the value of the Content-Security-Policy HTTP Header that is sent along with every PPM page. %TRUSTED_EXTERNAL_URLS% is a placeholder, it is inserted with the value of the TRUSTED_EXTERNAL_URLS server parameter. We recommend you use the TRUSTED_EXTERNAL_URLS parameter to specify the URLs that are allowed by the Content-Security-Policy HTTP Header.

Default:

default-src blob: 'self' 'unsafe-inline' 'unsafe-eval' %TRUSTED_EXTERNAL_URLS%;img-src 'self' data: %TRUSTED_EXTERNAL_URLS%;font-src 'self' data:

Introduced in version: 10.0.3.

COPY_REQUEST_COPY_AGILE_DEFAULT

If it is set to true, when copying a request, the Copy Agile Integration Fields option is selected by default.

When the COPY_REQUEST_SHOW_COPY_AGILE parameter is set to false, setting this parameter to true always copies the request agile integration fields, and setting this parameter to false does not copy the request agile integration fields.

The setting of this parameter is meaningful only when the request has the Agile Integration Info field group enabled.

Introduced in version: 10.0.2.

COPY_REQUEST_COPY_NOTES_DEFAULT

If it is set to true, when copying a request, the Copy Notes option is selected by default.

When the COPY_REQUEST_SHOW_COPY_NOTES parameter is set to false, setting this parameter to true always copies the request notes when copying a request, and setting this parameter to false does not copy the request notes.

Valid values: true, false

Introduced in version: 10.0.2.

COPY_REQUEST_COPY_REFERENCES_DEFAULT

If it is set to true, when copying a request, the Copy References option is selected by default.

When the COPY_REQUEST_SHOW_COPY_REFERENCES parameter is set to false, setting this parameter to true always copies the request notes when copying a request, and setting this parameter to false does not copy the request notes.

Valid values: true, false

Introduced in version: 10.0.2.

COPY_REQUEST_SHOW_COPY_AGILE

When it is set to true, the Copy Agile Integration Fields option is available for selection in the Copy Request page.

When you set this parameter to false, the Copy Agile Integration Fields option is not available. The COPY_REQUEST_COPY_AGILE_DEFAULT parameter determines whether or not the request agile integration fields are copied when copying a request.

The setting of this parameter is meaningful only when the request has the Agile Integration Info field group enabled.

Valid values: true, false

Introduced in version: 10.0.2.

COPY_REQUEST_SHOW_COPY_NOTES

When it is set to true, the Copy Notes option is available for selection in the Copy Request page.

When you set this parameter to false, the Copy Notes option is not available. The COPY_REQUEST_COPY_NOTES_DEFAULT parameter determines whether or not the requests notes are copied when copying a request.

Valid values: true, false

Introduced in version: 10.0.2.

COPY_REQUEST_SHOW_COPY_REFERENCES

When it is set to true, the Copy References option is available for selection in the Copy Request page.

When you set this parameter to false, the Copy References option is not available. The COPY_REQUEST_COPY_REFERENCES_DEFAULT parameter determines whether or not the request references are copied when copying a request.

Valid values: true, false

Introduced in version: 10.0.2.

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.

Values:

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.kintanas.core.server.CUSTOM_SERVER_INFO=Welcome to PPM Workbench

Values:

Default: N/A

Valid value: Text string

CUSTOM_WARS

List of custom WAR files that should be deployed in PPM. The corresponding WAR files should exist in the PPM_HOME/server/_common/deploy directory. With this parameter, the WAR files will be automatically inserted as contexts in the server.xsl and server.xml files. Separate multiple WAR files with semicolons.

Example: ppm-sample-custom-war

Introduced in version: 10.0.

dashboard.CHECK_HOST_HEADER_WHEN_REDIRECT

When set to true, when a request received by PPM dashboard pages needs to be redirected, PPM checks the host header of the request. If the host header is not the same as the base URL, the request is rejected.

Values:

Default: false

Valid values: true, false

Introduced in version: 10.0.4

dashboard.Page-Filters-Usage

Whether or not to enable dashboard page filters.

Note: This parameter was removed in PPM 9.61. To enable dashboard page filters in PPM 9.61 or later versions, turn on the Dashboard Page Filters for Builder Portlets feature toggle.

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 in the Installation and Administration Guide.

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

DEBUG_REQUEST_URI_PATH

Specify the UI path for the web service requests that are enabled for logging.

Multiple values are separated by semicolons.

Example:

/itg/rest; itg/rest2

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.

Values:

Default value: Capex

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

DEFAULT_FA_CLOSING_DAY

When the feature of locking forecast and actual costs of the past months is enabled, this parameter specifies the default starting day of each month after which users cannot edit the forecast or actual cost of the previous month.

If you set it to 1, it mean editing forecast or actual cost of the past months is not allowed.

If you set it to a value greater than the days of a current month, it means editing forecast or actual cost of the past months is always allowed in the current month.

Values:

Default value: 1

Valid values: 1-31

*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.

Values:

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.

Values:

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.

Values:

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.

Values:

Default: grouped

Valid values: grouped, flat

DELETE_SCHEDULED_REPORT_WHEN_SUBMITTER_DISABLED

When a PPM user is disabled for the specified number of days, PPM deletes the reports scheduled by that user.

This parameter works only if the SKIP_SCHEDULED_REPORT_WHEN_SUBMITTER_DISABLED parameter is set to true.

Valid values: integer

Introduced in version: 10.0.4.

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/

DISABLE_DATES_BEFORE_RESOURCE_START_DATE_IN_TS

Controls whether or not date cells earlier than a resource's start date are disabled in the time sheet.

  • true: date cells earlier than a resource's start date are disabled.
  • false: date cells earlier than a resource's start date are not disabled.

The parameter does not work for the My Tasks portlet or REST APIs, where users can still log time on dates before your start date.

Values:

Default: false

Valid values: true, false

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

Specifies which control modes can be selected for the project scheduling integration policy in the Project Settings. The valid values include:

  • PPM. The PPM control mode is available for selection for the project scheduling integration.
  • MSP. The scheduling tool control mode is available for selection for the project scheduling integration.
  • SHARED. The shared control mode is available for selection for the project scheduling integration.

Separate multiple values with a comma. If no value is specified for this parameter, all the control modes are available for selection.

Introduced in version: 2023.

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.

Values:

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.

Values:

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.

Values:

Default: 1000

Valid values: integer

DMS_INSECURE_FILE_EXTENSIONS

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

Default:

exe, com, bat, reg, jar, cmd, lnk, htm, html, js

DMS_INSECURE_FILE_EXTENSION_CHECK

Flags whether or not to prevent uploading files of the extensions defined in the DMS_INSECURE_FILE_EXTENSIONS 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_EXTENSIONS cannot be uploaded.

Values:

Default: false

Valid values: true, and false

DMS_SECURE_FILE_EXTENSIONS_ALLOW_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_EXTENSIONS
  • DMS_INSECURE_FILE_EXTENSION_CHECK

Note: This parameter was added in PPM 9.62 to replace the parameter DMS_SECURE_FILE_EXTENSIONS_WHITE_LIST. You need to configure the values for the new parameter.

Default:

txt, doc, docx, gif, pdf, png, ppt, pptx, pps, ppsx, psd, wav, wmv, xls, xlsx, ico, jpeg, jpg, m4a, mov, mp3, mp4, m4v, mpg, odt, ogg, ogv, 3g2, 3gp, avi

DMS_SECURE_FILE_EXTENSIONS_WHITE_LIST

(removed in PPM 9.62)

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_EXTENSIONS
  • DMS_INSECURE_FILE_EXTENSION_CHECK

Note: This parameter was removed in PPM 9.62. Use the parameter DMS_SECURE_FILE_EXTENSIONS_ALLOW_LIST instead.

Default:

txt, doc, docx, gif, pdf, png, ppt, pptx, pps, ppsx, psd, wav, wmv, xls, xlsx, ico, jpeg, jpg, m4a, mov, mp3, mp4, m4v, mpg, odt, ogg, ogv, 3g2, 3gp, avi

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.

Values:

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.

Values:

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.

Values:

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.

Values:

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.

Values:

Default value: 1,500

Valid values: positive integer

EMAIL_DEBUG_DUMP_FOLDER

When you enter a valid folder path for this parameter, all email notifications are saved as files in this folder instead of being sent. Use this parameter for debugging purpose only. Do not use in production as doing so would stop all email notifications from being sent.

Example: c:\temp\ppm_mail

Introduced in version: 2023.

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

EMAIL_TEMPLATE_FILE_CHARSET

Charset of the reset password email template. If you customize your reset password email messages, make sure the charset of the customized filed is the same as the template. Otherwise the message will not be displayed properly.

Default: UTF-8

Introduced in release: PPM 9.60

ENABLE_ADD_DELEGATE-FOR_ONESELF

If you set it to true, a resource can add his or her own delegates without the need to have the Edit All Resources access grant.

If you set it to false, a resource cannot add his or her own delegates unless the resource has the Edit All Resources access grant.

Values:

Default: true

Valid values: true, false

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.

Values:

Default: true

Valid values: true, false

ENABLE_ASSET_SP_SYNCHRONIZED

When it is set to true, the financial summary setting "Calculate the forecasted labor costs from the staffing profile (all labor costs are set to operating)." for new assets is enabled by default.

Note:

  • This parameter does not work for new assets that are saved as draft or created via then user interface table.
  • This parameter does not work for assets that are created from projects using the web service.
  • If the new assets are created from projects, and users want the assets financial summary settings to follow the projects financial summary settings, you should not enable this parameter.
  • Do not enable this parameter if you use the web service to update staffing profile header. It may cause session timeout.

Values:

Default: false

Valid values: true, false

ENABLE_ASSET_TM_ACTUAL_SYNCHRONIZED

When it is set to true, the financial summary setting "Calculate the actual labor costs from time logged against the asset (all labor costs are set to operating)." for new assets is enabled by default.

Note:

  • This parameter does not work for new assets that are saved as draft or created via then user interface table.
  • This parameter does not work for assets that are created from projects using the web service.

  • If the new assets are created from projects, and users want the assets financial summary settings to follow the projects financial summary settings, you should not enable this parameter.

Values:

Default: false

Valid values: true, false

ENABLE_ASSET_TRACK_CAPITAL_COST

When it is set to true, the financial summary setting "The asset tracks capital non-labor costs." for new assets is enabled by default.

Note:

  • This parameter does not work for new assets that are saved as draft or created via then user interface table.
  • This parameter does not work for assets that are created from projects using the web service.

  • If the new assets are created from projects, and users want the assets financial summary settings to follow the projects financial summary settings, you should not enable this parameter.

Values:

Default: false

Valid values: true, false

ENABLE_BACKGROUND_SERVICE_MONITOR

If set to true, enables the background services monitor.

Values:

Default: true

Valid values: true, false

ENABLE_BUSINESS_OBJECTIVES

Menus for creating and managing business objectives will 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.

You should flush the usermenu cache after changing the parameter value to make sure the change takes effect on the related menus.

Values:

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.

Values:

Default: true

Valid values: true, false

ENABLE_DEBUG_REQUEST

Flags whether or not to enable logging the content of web service requests and responses for the purpose of troubleshooting.

Values:

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.

Values:

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.

Values:

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.

Values:

Default: false

Valid values: true, false

ENABLE_IMPORT_EXPORT_WORK_PLAN

When it is set to true, you can import tasks from Excel by downloading work plan as Excel, editing tasks in the Excel file, and then uploading the Excel file to PPM.

Values:

Default: false

Valid values: true, false

ENABLE_NAVIGATOR_AVIATOR

Set this parameter to true to enable Navigator Aviator, an intelligent assistant that enables to you to access chat-based conversational search for selected PPM modules.

Values:

Default: true

Valid values: true, false

Introduced in version: 24.2

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.

Values:

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.

Values:

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.

You should flush the usermenu cache after changing the parameter value to make sure the change takes effect on the related menus.

Values:

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.

Values:

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.

Values:

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.

Values:

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).

Values:

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.

Values:

Default: false

Valid values: true, false

ENABLE_LOG_SUCCESS_SERVICE_LIST

Specify the reference 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

Values:

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.

Values:

Default: N/A

Valid values: true, false

ENABLE_MOBILITY_ACCESS_SERVICE

If set to true, enables the Mobility Access Service.

Values:

Default: false

Valid values: true, false

This parameter was deprecated in version 10.0.1.

ENABLE_MOBILITY_APPS

When this parameter is set to true, users accessing PPM with a mobile device will be sent to the legacy mobile UI. When it is set to false, they will be sent to the new mobile UI. Refer to PPM documentation for more information about differences between the legacy and new mobile UIs.If you change the parameter value, you should run sh ./kUpdateHtml.sh in the <PPM_Home>/bin directory to make the change take effect.

Values:

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).

Values:

Default: false

Valid values: true, false

ENABLE_PORTLET_FULL_RESULTS_SORTING

If set to true, enables sorting of portlet results.

Values:

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.

Values:

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.

Values:

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.

Values:

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.

Values:

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.

Values:

Default: false

Valid values: true, false

ENABLE_PROPOSAL_SP_SYNCHRONIZED

When it is set to true, the financial summary setting "Calculate the forecasted labor costs from the staffing profile." for new proposals is enabled by default.

Note:

  • This parameter does not work for proposals that are saved as draft or created via then user interface table.
  • Do not enable this parameter if you use the web service to update staffing profile header. It may cause session timeout.

Values:

Default: false

Valid values: true, false

ENABLE_PROPOSAL_TM_ACTUAL_SYNCHRONIZED

When it is set to true, the financial summary setting "Calculate the actual labor costs from time logged against the proposal request." for new proposals is enabled by default.

Note: This parameter does not work for proposals that are saved as draft or created via then user interface table.

Values:

Default: false

Valid values: true, false

ENABLE_PROPOSAL_TRACK_CAPITAL_COST

When it is set to true, the financial summary setting "The proposal is for a project that tracks capital costs." for new proposals is enabled by default.

Note: This parameter does not work for proposals that are saved as draft or created via then user interface table.

Values:

Default: false

Valid values: true, false

ENABLE_QUALITY_CENTER_INTEGRATION

(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.

For details about this parameter, see the Solution Integrations Guide

Values:

Default: false

Valid values: true, false

ENABLE_QUERY_BUILDER

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

Values:

Default: true

Valid values: true, false

ENABLE_QUICKLIST_UPDATE

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

Values:

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.

Values:

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.

Values:

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.

Values:

Default: false

Valid values: true, false

ENABLE_SITE_MAP

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

Values:

Default: false

Valid values: true, false

ENABLE_SKIP_NAVIGATION

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

Values:

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.

Values:

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.

Values:

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:

  • HTTPS_PORT
  • HTTPS_WEB_THREAD_MIN
  • HTTPS_WEB_THREAD_MAX
  • HTTPS_KEYSTORE_LOCATION
  • HTTPS_KEYPASSWORD

Values:

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.

Values:

Default: false

Valid values: true, false

ENABLE_STRATEGIC_THEMES

Menus, request details section, portfolio Strategy tab, and portfolio type Strategy section for managing strategic themes will show up only if the parameter is set to true.

You should flush the usermenu cache after changing the parameter value to make sure the change takes effect on the related menus.

Values:

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.

Values:

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.

Values:

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_QUICK_SEARCH

If set to true, the Quick Search to Add Items option is available in the Add Items list of a time sheet page. This option enables you to search a work item by its name or ID and add to the time sheet. If set to false, the Quick Search to Add Items option is not displayed.

Values:

Default: false

Valid values: true, false

Introduced in version: 2023.3

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.

Values:

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

Values:

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.

Values:

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.

Values:

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.

Values:

Default: false

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.

Values:

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.

Values:

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.

Values:

Default: true

Valid values: true, false

ENABLE_WEB_SERVICES

Enables the PPM Web services interface.

Values:

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.

Values:

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.

Values:

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).

Values:

Default: true

Valid values: true, false

ENABLE_WORKPLAN_TAILOR_FROM_WORKPLAN_TEMPLATE

If it is set to true, when creating a work plan from a template, you can select which tasks in the template are imported to the work plan.

Values:

Default: false

Valid values: true, false

ENFORCE_DOMAINS_ALLOWLIST_FOR_DESKTOP_MENU_XML

When set to true, any menu.xml external links to a domain not listed in parameter MENU_EXTERNAL_URLS_ALLOWLIST will be blocked.

Values:

Default: false

Valid values: true, false

Introduced in release: 9.62

ENFORCE_DOMAINS_ALLOWLIST_FOR_MOBILE_MENU_XML

When it is set to true, any mobile_menu.xml external links to a domain not listed in parameter MENU_EXTERNAL_URLS_ALLOWLIST will be blocked.

Values:

Default: true

Valid values: true, false

Introduced in release: 9.62

ENFORCE_ORG_UNIT_FOR_RESOURCE_POOL_AND_TEAM

When it is set to true, when creating a resource pool or a team, you must associated it with a primary organization unit. Resource pools and teams cannot be freestanding.

Values:

Default: false

Valid values: true, false

Introduced in version: 2023.3.

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.

Values:

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.

Values:

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.

Values:

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.

Values:

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.

Values:

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.

Values:

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 the LOG_EXCEPTIONS_TO_DB parameter.

Values:

Default: 14
Valid Values: Zero or higher integer

EXTERNAL_WEB_ADDRESS If you are using an external web server that serves PPM clients and the web server uses the AJP protocol to connect the PPM server, you can use this parameter to specify the IP or host of the machine where PPM is installed.

**EXTERNAL_WEB_PORT

Required if a value is specified for EXTERNAL_WEB_PROTOCOL

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.

This parameter works together with the EXTERNAL_WEB_PROTOCOL parameter to specify the external web server that is used to connect the PPM server. For example, if the external web server connects PPM via http protocol, set EXTERNAL_WEB_PROTOCOL to HTTP, and use EXTERNAL_WEB_PORT to specify the port number.

Note: If you are using an external Web server, you must still configure the standard PPM*HTTP_PORT. 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

Required if a value is specified for EXTERNAL_WEB_PORT

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.

This parameter works together with the EXTERNAL_WEB_PORT parameter to specify the external web server that is used to connect the 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.

Values:

Default: AJP

Valid values: AJP, HTTP, HTTPS

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)".

Values:

Default: true

Valid values: true, false

FM_SP_POSITION_REGION_PRECEDENCE

Specifies the precedence of regions that PPM uses to pick up the cost rule when calculating the forecast labor cost of a position's unmet demand. You can specify all or any subset of the following values for this parameter:

  • resource_pool. Region of the resource pool specified for the position.
  • preferred_resource. Region of the specific resource requested by the position. If there's more than one specified resource, the region of the first specified resource is used.
  • position. Region of the position.
  • staffing_profile. Region of the staffing profile.

If no value is specified, or the region is not defined for the specified values, PPM uses the region of the staffing profile. Use commas (,) to separate multiple values.

For example, if you set the parameter value to "resource_pool,preferred_resource,position,staffing_profile", PPM uses the region of the resource pool specified for the position for the cost factor "Region" when calculating the forecast cost of the position's unmet demand. If the region is not defined for the resource pool, PPM uses the region of the first specified resource requested by the position, and so on.

Valid values: resource_pool, preferred_resource, position, staffing_profile

Introduced in version: 10.0.3.

FORCE_NEW_CSRF_TOKEN_ON_NEW_SESSION

When this parameter is set to true, each time when a user successfully logs into PPM, a new CSRF token is generated. We strongly recommend that you set this parameter to true to enable CSRF mitigation.

Values:

Default: false

Valid values: true, false

Introduced in version: 10.0.2.

FS_DS_INCLUDE_MASTER_PROJECT_CHILDREN_CHECKBOX

Customizes the label of the checkbox that decides whether or not the Financial Costs datasource of Self-Service portlet includes a project's related projects.

Values:

Default: N/A

Valid value: Text string

Introduced in version: 9.65.

FINANCIAL_LINES_DETAILS_MAX_COUNT

Maximum number of financial lines in a financial summary that can be viewed on the web page. If the number is exceeded, to view them, you have to edit them or export data to Excel.

Default: 300

FINANCIAL_SUMMARY_KEEPALIVE_MAX_IDLE_TIME

Maximum time (in minutes) for which PPM keeps alive for an idle user editing financial summary.

Default: 180

FOCUS_ON_FIRST_EDITABLE_FIELD_IN_REQUEST_DETAILS

Controls whether or not PPM automatically focuses the cursor on the first editable field in the request details page.

If a request is read-only, PPM does not focus on the first editable field, regardless of the parameter value.

Values:

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.

Values:

Default: 1

Valid values: Non-negative integer

FS_QUEUE_MAX_CONCURRENT_CONSUMERS

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

Values:

Default: 2

Valid values: Non-negative integer

GLOBAL_TEAM_HEATMAP_COLORS

Specifies the team heatmap colors for all the teams in the system, including utilization colors and percentage fulfillment colors.

The parameter value should be in the JSON format.

Default value of this parameter is as follows. The "color" element only supports "RED", "YELLOW", and "GREEN", and it is case-sensitive.

If you set the parameter to an invalid value, the system resets the parameter to its default value.

{  
   "utilizationColor":[  
      {  
         "color":"RED",
         "min":"100",
         "max":""
      },
      {  
         "color":"YELLOW",
         "min":"0",
         "max":"80"
      },
      {  
         "color":"GREEN",
         "min":"80",
         "max":"100"
      }
   ],
   "fulfilledColor":[  
      {  
         "color":"RED",
         "min":100",
         "max":""
      },
      {  
         "color":"YELLOW",
         "min":"0",
         "max":"80"
      },
      {  
         "color":"GREEN",
         "min":"80",
         "max":"100"
      }
   ]
}
GLOBAL_TEAM_OVERLOAD_RATIO_COLORS

Specifies the overload ratio colors for all the teams in the system.

The parameter value should be in the JSON format.

Default value of this parameter is as follows. The "color" element only supports "RED", "YELLOW", and "GREEN", and it is case-sensitive.

If you set the parameter to an invalid value, the system resets the parameter to its default value.

{  
   "overloadRatioColor":[  
      {  
         "color":"RED",
         "min":"100",
         "max":""
      },
      {  
         "color":"YELLOW",
         "min":"0",
         "max":"80"
      },
      {  
         "color":"GREEN",
         "min":"80",
         "max":"100"
      }
   ]
}

Introduced in version: 10.0.3

GRAPHICAL_WF_ENABLED

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

Values:

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.

Values:

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.

Values:

Default: true

Valid values: true, false

*HEAVY_QUEUE_CONCURRENT_CONSUMERS

Number of listeners per node to execute heavy background services.

Values:

Default: 1

Valid values: Positive integer

*HEAVY_QUEUE_MAX_CONCURRENT_CONSUMERS

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

Values:

Default: 1

Valid values: positive integer

*HEAVY_QUEUE_MAX_DEPTH

Maximum depth of the heavy services queue.

Values:

Default: 10000

Valid values: Positive integer

*HEAVY_QUEUE_REDELIVERY_DELAY

Delay between redeliveries of messages to the heavy service queue.

Values:

Default: 60000(milliseconds)

Valid values: positive integer

*HEAVY_QUEUE_REDELIVERY_LIMIT

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

Values:

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.

Values:

Default: false

Valid values: true, false

HIDE_PROJECT_SETTINGS_DASHBOARD_RESET_BUTTON

Controls whether the Reset Overview Layout button is displayed on the Project Overview Layout page.

Values:

Default: false

Valid values: true, false

Introduced in version: 10.0.3

HIDE_PROJECT_TYPE_DASHBOARDS_ADD_PORTLET_BUTTON

Controls whether the Add Portlets to All Projects button is displayed on the Project Overview Layout page.

Values:

Default: false

Valid values: true, false

Introduced in version: 10.0.3.

HIDE_PROJECT_TYPE_DASHBOARDS_RESET_BUTTON

Controls whether the Reset Overview Layout for Existing Projects button is displayed on the Project Overview Layout page.

Values:

Default: false

Valid values: true, false

Introduced in version: 10.0.3.

HIDE_PROJECT_TYPE_DASHBOARDS_ADD_PORTLET_BUTTON

Controls whether the Reset Overview Layout button is displayed on the Project Overview Layout page.

Values:

Default: false

Valid values: true, false

Introduced in version: 10.0.3

HIDE_SECTION_WHEN_ITS_FIELDS_ARE_HIDDEN_BY_UI_RULES

This parameter is used to hide a section in a request details page when all the fields in this section become invisible by UI rules. Setting it to true, you hide the section. Otherwise, the section is shown.

Values:

Default: false

Valid values: true, false

Added in version: 10.0.

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.

Values:

Default: 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.

Values:

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.

Values:

Default: false

Valid values: true, false

*HISTORY_MENU_SIZE

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

Values:

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.

Values:

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.

Values:

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.

Values:

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.

You must use kEncrypt.sh to encrypt the password. For information on how to run the kEncrypt.sh script, see kEncrypt.sh in the Installation and Administration Guide.

Values:

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.

Values:

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

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.

Values:

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.

Values:

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.

Values:

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.

Values:

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

IGNORE_POOLS_WITH_ONLY_PAST_RESOURCE_PARTICIPATION

When you add a resource as the requested resource of a position, PPM automatically fills the position's attributes based on the resource details. If the resource have allocations in different resource pools in different time periods, PPM by default lists all these resource pools for you to select one for the position.

Now, if this parameter is set to true, PPM only lists the resource pools that have the resource's allocations in the future.

Values:

Default: false

Valid values: true, false

I18N_CARET_DIRECTION

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

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

Values:

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.

Values:

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.

Values:

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.

Values:

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.

Values:

Default: ltr

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

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.

Values:

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.

Values:

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 Chinese)

IMPACT_ANALYSIS_REPORT_NAME

Specifies a name for the UCMDB impact analysis report.

Default:
DefaultImpactAnalysisReportName

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.

Values:

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.

Values:

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/jinstall-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/download/GetFile/1.7.0_11-b21/windows-i586/xpiinstall.exe

JDBC_DEBUGGING

Enables debugging of the Java database calls.

Values:

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
  • We strongly recommend you specify DNS name instead of literal IPv6 address.

Values:

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)

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.

Values:

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 internal use only. Do not alter its value unless directed to do so by Software Support for PPM.

Default: N/A

JWT_JWK_PROVIDER_PROXY

The proxy of the JWK provider. Must use the format host:port .

Introduced in version: 9.66

JWT_JWK_PROVIDER_URL

Defines the URL of the JWK provider when using JWT Authentication. The/.well-known/jwks.json part should be omitted.

If no value is provided, the JWT authentication is not activated.

Introduced in version: 9.66

JWT_USER_INFO_CLAIM

Specifies the JWT claim in which the PPM username or login ID will be stored. If empty, defaults to sub.

Added in version: 9.66

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 the Enabling Secure RMI (Optional) topic in the Installation and Administration Guide.)

Default: N/A

KEY_STORE_PASSWORD

Password for the keystore created for Secure RMI. (See Enabling Secure RMI (Optional) topic in the Installation and Administration Guide.)

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

Values:

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.

Values:

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.

Values:

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/KintanaServer

*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.

Values:

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.

Values:

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).

Values:

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.
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 in the Installation and Administration Guide.

Values:

Default: N/A

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

LDAP_LAST_SYNCH_TIMESTAMP Last time the LDAP import was run.
LDAP_REFERRAL_CHASE

If set to true, enables the LDAP server to follow referrals.

Values:

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

LEGAL_NOTICE_CAPTION

Enables customization of the legal notice caption that displays on the PPM login page.

Values:

Default: N/A

Valid values: Text string

Introduced in version: PPM 10.0.

LEGAL_NOTICE_TEXT

Enables customization of the legal notice content that displays on the PPM login page.

Values:

Default: N/A

Valid values: Text string

Introduced in version: PPM 10.0.

LICENSE_KEY

License key required to use PPM core functionality.

Example : 36ha5b993c1776kc6g03gjct5k7hv5c3

*LIGHT_QUEUE_CONCURRENT_CONSUMERS

Number of listeners per node to execute light-weight background services.

Values:

Default: 1

Valid values: positive integer

*LIGHT_QUEUE_MAX_CONCURRENT_CONSUMERS

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

Values:

Default: 3

Valid values: positive integer

*LIGHT_QUEUE_MAX_DEPTH

Maximum depth of the light services queue.

Values:

Default: 10000

Valid values: positive integer

*LIGHT_QUEUE_REDELIVERY_DELAY

Delay between redeliveries of a message to the light service queue.

Values:

Default: 60000 (milliseconds)

Valid values: positive integer

*LIGHT_QUEUE_REDELIVERY_LIMIT

Number of times a message can be redelivered to the light service queue.

Values:

Default: 5

Valid values: positive integer

LOAD_FACTOR

Determines how much load to place on a node in the server cluster.

Default: 1.0

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.

You should flush the usermenu cache after changing the parameter value to make sure the change takes effect on the related menus.

Values:

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.

You should flush the usermenu cache after changing the parameter value to make sure the change takes effect on the related menus.

Values:

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)

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.

Values:

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.

Values:

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.

Values:

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.

Values:

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 OpenText 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 in the Installation and Administration Guide.

Values:

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 in the Installation and Administration Guide.

Values:

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 (;).

Values:

Default: N/A

Example: xyz.com; abc.net

MAC_LOG_SEVERITY

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.

For details about this parameter, see the Solution Integrations Guide

Values:

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).

Values:

Default: None

Valid values: integers

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).

Values:

Default: None

Valid values: integers

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.

Values:

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.

Values:

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_FILES_UPLOADED_TO_PPM_PER_USER

Maximum number of files that a single user is allowed to upload to the PPM.

Default: 1000

Introduced in release: PPM 9.62

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.

Values:

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.

Values:

Default: 1000

Valid values: positive integer

MAX_RESULT_OF_AUDIT_EVENT_QUERY

Specifies the maximum number of audit event query results.

Values:

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.

Values:

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.

Values:

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.

Values:

Default: 20

Valid values: positive integer

MENU_EXTERNAL_URLS_ALLOWLIST

A comma-separated list of domains/server names/IPs that are allowed in external URLs (HTTP or HTTPS) in custom menu XML files. All sub-domains will be allowed unless explicitly specified. Whether this is enforced depends on the values of parameters ENFORCE_DOMAINS_ALLOWLIST_FOR_MOBILE_MENU_XML and ENFORCE_DOMAINS_ALLOWLIST_FOR_DESKTOP_MENU_XML.

Introduced in release: PPM 9.62

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.

Values:

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.

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.

Valid values: Any Oracle-supported values

NLS_TERRITORY<NLS_LANGUAGE>

Oracle defaults for a territory by Java locale.

Valid values: Any Oracle-supported values

NO_INITIAL_ROLE_IN_RESOURCE_FINDER

Controls whether the role specified for a position is used as a default filtering criterion when searching for resources to assign to that position.

Values:

Default: false

Valid values: true, false

Introduced in version: 24.1

NOTIFICATIONS_CLEANUP_PERIOD

Number of days that notifications remain in the system before the Notifications Cleanup Service removes them.

Values:

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 throughout financial summaries. For details, see Configuring Range of Fiscal Years in the Installation and Administration Guide.

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.

Values:

Default: 5

Valid values: Integer between 0 and 20

NUMBER_OF_PAST_YEARS_TO_SHOW_ON_FINANCIAL_SUMMARY

Number of future fiscal years that can be viewed throughout financial summaries. For details, see Configuring Range of Fiscal Years in the Installation and Administration Guide..

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.

Values:

Default: 2

Valid values: Integer between 0 and 20

ODATA_LINK_BASE_URL

The URL that PPM uses to generate the OData links for self-service portlet data sources. If not set, PPM uses the BASE_URL to generate the OData links. The format of this parameter is the same as BASE_URL.

Default: null

Added in version: 9.66.

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.

Values:

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.

Values:

Default: false

Valid values: true, false

ORACLE_APPS_VERSION

Version of Oracle Apps used.

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

Values:

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

P6_FIELD_MAPPING_TO_USER_DATA

Use this parameter to configure the mappings between Primavera P6 fields and PPM task user data when using Oracle Primavera P6 XER and XML files in work plan to synchronize project scheduling information between PPM and Oracle Primavera P6.

Use a semi-colon separated list of key-value pairs in the format "Aspose Task Field Key: PPM User Data index". For example, "ACTIVITY_ID:1; REMAINING_COST:3; BUDGET_COST:4" maps the Activity_id field to USER_DATA1, remaining_cost to USER_DATA3, and so forth. For better readability, you can add spaces around separators such as |(; or : ). You can obtain PPM User Data index from the PPM workbench.

Introduced in version: 23.4.

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.

Values:

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.

Values:

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.

Values:

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.

Values:

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.

Values:

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).

Values:

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.

Values:

Default: false

Valid values: true, false

PORTFOLIO_MAX_PPA_INITIATIVES

Defines the maximum number of initiatives (proposals, projects, and assets) that can be included in a portfolio.

Note: You should be careful when increasing the default value as it might have performance impact.

Default: 1000

POSTGRESQL_HOME

Full path to the PostgreSQL home directory on the PPM server.

Example: d:/postgres/11

Introduced in version: 10.0.2.

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)

PROJECT_TYPE_DASHBOARDS_BATCH_SIZE

Specifies the batch size of projects when resetting project overview layout and adding portlets to projects from the Project Overview Layout policy.

PROJECT_TYPE_DASHBOARDS_SLEEP_BETWEEN_BATCHES_IN_SEC Specifies the duration (in seconds) before the next batch of resetting project overview layout or adding portlets to all projects should happen.
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.

Values:

Default: comparative

Valid values: comparative, absolute

*PSQL

Name of the command-line PSQL executable, which must be in the <POSTGRESQL_HOME>/bin directory.

Default: psql

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.

Values:

Default: false

Valid values: true, false

*QUARTZ_WORKER_THREADS

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

Values:

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.

Values:

Default: true

Valid values: true, false

REMOTE_IP_HTTP_HEADER

The HTTP Header storing the IP of remote clients when using a Web server or load balancer in front of PPM.

Values:

Default: X-Forwarded-For

Valid values: Any valid HTTP header name.

Introduced in version: 9.65.

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.
REPORTING_DB_USERNAME If Operational Reporting is deployed on your system, this is the username for the Operational Reporting database schema.
REPORTING_DB_PASSWORD If Operational Reporting is deployed on your system, this is the password for the Operational Reporting database schema.

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 Create Request page, Request Details page, Project Details page, and Edit Time Sheet page before your session starts to time out.

  • If the value of this parameter is grater than 0, users can stay idle in the these pages 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 these pages 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.

Values:

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.

Values:

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_QUICK_EDIT_MAX_ROWS

Specifies the request quick edit maximum rows.

Values:

Default value: 100

Valid values: <= 100

REQUEST_QUICK_EDIT_MAX_COLS

Specifies the request quick edit maximum columns.

Be cautious when setting this value too high. It might cause performance issues.

Values:

Default value: 20

Valid values: integer

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.

Values:

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)

RESOLVE_DYNAMIC_SECURITY_TOKENS_REQUEST_TYPES

Specifies the request types, when used by workflows, the security token defined for the workflow steps will dynamically resolve to users or security groups that are authorized to act on the workflow steps in the requests that use the request types.

You must manually add this parameter in the server.conf file. Separate multiple request types with commas.

Example:

bug-request-type

Introduced in version: 10.0

RESOURCE_ASSIGNMENT_TRANSFER_OPTION

When you transfer 100% of a resource's participation from the current team, this parameter decides the default transfer option of this resource's assignments.

  • Unchanged. After the resource is transferred, the resource's assignment in the current team stays unchanged starting from the effective date.
  • Removed. After the resource is transferred, the resource's assignment in the current team is cleared starting from the effective date.
  • Transferred. After the resource is transferred, the resource's assignment is transferred to the target team starting from the effective date.

Values:

Default: Unchanged

Valid values: Unchanged, Unchanged, Removed, and Transferred

Introduced in version: 10.0.3.

RESOURCE_FINDER_ROLE_WEIGHT

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

Values:

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.

Values:

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 the Edit All Packages access grant can bypass execution steps on a package.

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

Values:

Default value: false

Valid values: true, false

RESTRICT_BYPASS_REQ_EXEC_TO_MANAGERS

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

If set to true, only users with the Edit All Requests access grant can bypass an execution step on a request.

Values:

Default value: 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.

Values:

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.

Values:

Default: fte

Valid values: hours, fte, person_days

*RM_DEFAULT_PERIOD_TYPE

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

Values:

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.

Values:

Default value: 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/
  • We strongly recommend you specify DNS name instead of literal IPv6 address.

Values:

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.

Values:

Default value: 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 in the Installation and Administration Guide.

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.

Values:

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

Values:

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.

Values:

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)

Values:

Default: 11,000,000 (100 positions, 100 resources, 3 years)

Valid Values: Positive integer

RMO_OPT_CONCURRENT_TIMEOUT

The timeout (in milliseconds) of RMO.

Values:

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.

Values:

Default value: 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.

Values:

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.

Values:

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.

Values:

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: 4096

SERVER_MAX_PERM_SIZE

For 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.

Values:

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.

Values:

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.

Values:

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.

Values:

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.

Values:

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

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.

Values:

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 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 Background Services in the Installation and Administration Guide.

Values:

Default: true

Valid values: true, false, light, heavy

SET_SUCCESSOR_MILESTONE_PERCENTAGE

Sets the default percentage complete value for milestones whose predecessors are completed. PPM automatically updates the milestone status based on the value. If you set the value to 0, the milestone status is updated to Ready. If you set the value to any integer from 1 to 99 the milestone status is updated to In progress.

Values:

Default: 99

Valid values: Integer from 0 and 99

Introduced in version: 2023.

SHOW_BASE_URL_ON_NOTIFICATIONS

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

Values:

Default: true

Valid values: true, false

SHOW_BETA_FEATURES

If it is set to true, beta features are shown in the Feature Toggles page.

If it is set to false, beta features are hidden in the Feature Toggles page.

Values:

Default: true

Valid values: true, false

SHOW_UNDER_DEVELOPMENT_FEATURES

If it is set to true, under-development features are shown in the Feature Toggles page.

If it is set to false, under-development features are hidden in the Feature Toggles page.

Values:

Default: false

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.

Values:

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.

Values:

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.

Values:

Default: false

Valid values: true, false

SHOW_PORTFOLIO_CONTENTS_IN_PORTFOLIO

If set to true, the Contents tab is available in the portfolio details page.

Values:

Default: true

Valid values: true, false

Introduced in release: PPM 9.62

SHOW_PORTFOLIO_EPICS_IN_PORTFOLIO

If set to true, the Portfolio Epics tab is available in the portfolio page to show portfolio epics details.

Values:

Default: true

Valid values: true, false

SHOW_PORTFOLIO_TIMELINE_IN_PORTFOLIO

If set to true, the Timeline tab is available in the portfolio details page.

Values:

Default: true

Valid values: true, false

Introduced in release: PPM 9.62

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 in the Installation and Administration Guide.

Example:

com.kintana.sc.security.auth.SiteMinderSingleSignOn

SKIP_CHECK_REQUIRED_FIELD_WHEN_IMPORT_PROJECT

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

Values:

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.

Values:

Default: false

Valid values: true, false

SKIP_SCHEDULED_REPORT_WHEN_SUBMITTER_DISABLED

If you set this parameter to true, when a user is disabled, the reports scheduled by the user are skipped.

Values:

Default: false

Valid values: true, false

Introduced in version: 10.0.4.

SM_RFC_INTEGRATION_ENABLED

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

Values:

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 in the Installation and Administration Guide.

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.

Values:

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 in the Installation and Administration Guide.

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.

Values:

Default: true

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_SSL_ENABLED_PROTOCOL

Specifies the SMTP protocol (TLS) the PPM server uses.

Default: TLSv1.2

Valid values: TLSv1.2, TLSv1.3

Introduced in version: 2023.3.

SMTP_USE_SSL

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

Note: SSL is not used by default.

Default: false, false

SMTP_USE_STARTTLS

Specifies whether or not to connect to SMTP server using STARTTLS.STARTTLS is not the same as SSL.

Note: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.

SOCKS_PROXY_PORT

Port on the SOCKS proxy host that accepts proxy connections.

Valid values: 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 factor "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 factor "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.

Values:

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

This parameter only works for staffing profile New UI. Specify the reference codes of columns that are to be displayed by default in staffing profiles. Separate the reference codes 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

Region

(Added in version: 10.0.3)

region
STAFFING_PROFILE_END_PERIOD_NO_EARLIER_THAN_MONTH

Specifies the earliest month that the staffing profile end period can be changed to. 0 stands for the current month, positive values stand for months in the future, and negative values for months in the past. Suppose the current month is December 2021, if you set the parameter to 3, when changing the staffing profile end period, the new end period must be no earlier than March 2022. If the parameter is set to -3, the new end period must be no earlier than September 2021.

If you do not specify the parameter value, the staffing profile end period can be changed to any time period.

This parameter only applies when changing the staffing profile end date. It does not apply when creating a staffing profile.

If staffing profile dates are synchronized with project dates (controlled by the Synchronize Staffing Profile Dates with Project Dates feature toggle), this parameter also applies when changing the project end period.

Values:

Default: null

Valid values: integer

Introduced in version: 10.0.1

STAFFING_PROFILE_KEEPALIVE_MAX_IDLE_TIME

Maximum time (in minutes) for which PPM keeps alive for an idle user editing a staffing profile. To disable the session-keep-alive function, set it to 0.

Default: 180

STAFFING_PROFILE_REQUIRED_COLUMNS

Specifies the reference codes of columns that are required in staffing profiles. Separate the reference codes by semicolons.

It works both when you use inline edit and when you use the pop-up position window.

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
Cost Category costCategory

Region

(Added in version: 10.0.3)

region

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

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)

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 in the Installation and Administration Guide..

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.

Values:

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.

Values:

Default: TLS

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

SYNC_POSITIONS_FROM_WORKPLAN

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

Note: This parameter was removed since PPM 9.61. To enable copying staffing profile positions from work plan tasks in PPM 9.61 and later, turn on the feature toggle Sync Between Task and Positions.

Values:

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.

Values:

Default: 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.

Values:

Default: false

Valid: true, false

TM_CLOSED_REQUEST_RESTRICTION

If set to true, users are NOT allowed to do the following:

  • Add closed or cancelled requests to a time sheet.
  • (Applicable to 24.2 and later versions) Edit effort for closed requests in a time sheet.
  • (Applicable to 24.2 and later versions) Copy closed requests to a time sheet.

Values:

Default: false

Valid: true, false

Introduced in version: 23.3.

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.

Values:

Default: true

Valid: 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.

Values:

Default: false

Valid: 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.

Values:

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.

Values:

Default: false

Valid: true, false

TM_ENABLE_POLICY_EXTENSION

Enable or disable the Time Management Custom Policy Extension.

Values:

Default: false

Valid: 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.)

Values:

Default: false

Valid: 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.

Values:

Default: true

Valid: true, false

TM_LOCK_DEFAULT_BILLING_APPROVER

Determines whether the Default Billing Approver field on the Modify Resource > Time Management tab is read-only or editable. When set to true, the Default Billing Approver field becomes read-only.

Values:

Default: true

Valid: true, false

Introduced in version: 23.4.

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 page, the Search Time Sheets page, and the Approve Time Sheets portlet (available in 2023.3 and later versions).

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

Values:

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.

Values:

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.

Values:

Default: 80,000,000

Valid: 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.

Values:

Default: 160,000,000

Valid: 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.

Values:

Default: 100,000,000

Valid: 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.

Values:

Default: 200,000,000

Valid: 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.

Values:

Default: N/A

Valid: reference code of the request type

TM_SHOW_TIME_FIELD_ZERO_VALUES_AS_BLANK

When set to true, the time sheet Time Breakdown tab displays the time field as blank if the time value is zero. 

Values:

Default: false

Valid: true, false

Introduced in version: 2023.3

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.

Values:

Default: true

Valid: true, false

TRUSTED_EXTERNAL_URLS

Lists the URLs that are allowed in the PPM Content-Security-Policy HTTP Header, to allow iframe embedding or script or image linking. Separate multiple values with spaces. This parameter takes effect only when the CONTENT_SECURITY_POLICY includes the %TRUSTED_EXTERNAL_URLS% placeholder in its value.

Default:

http://app.powerbi.com, admhelp.microfocus.com, https://internal.almoctane.com, https://www.youtube.com

Example:

http://www.mydomain.com

Introduced in version: 10.0.3.

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.

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.

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

Values:

Default: 20

Valid values: Integer between 1 and 100

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 in the Installation and Administration Guide.

Valid values: Encrypted password in the format #!#<Encrypted_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 in the Installation and Administration Guide.

Values:

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.

Values:

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 the Staffing Profile Financial Summary Sync service runs.

This parameter was deprecated in the version 10.0.3. Use the FM_SP_POSITION_REGION_PRECEDENCE parameter instead.

  • If USE_REGION_OF_RESOURCE_POOL_FOR_POSITION_FORECAST_COST is set to true, after the upgrade to 10.0.3, the initial value of FM_SP_POSITION_REGION_PRECEDENCE will be set to "resource_pool,position,staffing_profile".
  • If USE_REGION_OF_RESOURCE_POOL_FOR_POSITION_FORECAST_COST is set to false, after the upgrade to 10.0.3, the initial value of FM_SP_POSITION_REGION_PRECEDENCE will be set to "position,staffing_profile".

Values:

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.

This parameter works both when the task effort is tracked in the work plan and when it is tracked in time sheets.

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

Values:

Default: false

Valid values: true, false

USER_SEARCH_RESULTS_MAX_ROWS

The maximum number of users displayed in User Management Console.

Values:

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.

Values:

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.

Values:

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>

WEB_SERVICE_USERS

Specifies the PPM users who can call the Web service API. You must manually add the PPM usernames to the server.conf file. Separate multiple usernames by colons. If no usernames are specified, all the users that can access the Web applications can call the Web service API.

Values:

Default: N/A

Valid values: PPM username

Added in version: 10.0.

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.

Values:

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_DEFAULT_VIEW

Specifies the default work plan view when viewing or creating a work plan for the first time.

Valid values are: quickView, scheduleView, actualsView, costingView, earnedValueView, ganttView, printingView, customView.

If this parameter is not specified or the view it specifies is not enabled, the work plan is opened in the Quick view.

Example: scheduleView

WORK_PLAN_DEFAULT_COLUMNS

Specifies the default columns in the work plan view defined by the WORK_PLAN_DEFAULT_VIEW parameter when viewing or creating a work plan for the first time. The columns could be OOTB columns and task user data.

If the WORK_PLAN_DEFAULT_VIEW parameter is not specified, values of this parameter do not work.

Valid values are:

taskStatus, scheduledDuration, scheduledStart, scheduledFinish, scheduledEffort, unassignedEffort, predecessors, resources, role, activity, service, actualEffort, actualStart, actualFinish, actualDuration, actualsAsOf, percentComplete, estimatedRemainingEffort, estimatedFinish, plannedLabor, plannedNonLabor, plannedCost, actualLabor, actualNonLabor, plannedCapitalExpense, plannedOperatingExpense, actualCapitalExpense, actualOperatingExpense, plannedValue, earnedValue, costVariance, scheduleVariance, cpi, spi, actualCost, baselineScheduledStart, baselineScheduledFinish, baselineScheduledEffort, baselineActualStart, baselineActualFinish, baselineActualEffort, percentWorkComplete.

If you want to specify default task user data, add the user data token values.

Values should be separated by semicolons.

Example: taskStatus; scheduledDuration; scheduledEffort

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.

Values:

Default: 2000

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

WORK_PLAN_RESOURCE_LOAD_MODE

Defines how PPM calculates the resource load when the work plan task assignments are set to present resource load in the Project Settings. Values include:

  • scheduled: The default value. Calculate the resource load with work plan task scheduled dates and effort. The scheduled effort of cancelled task is not included in the resource load.

  • actuals_when_completed: For completed, cancelled, and on-hold tasks, calculate the resource load with work plan task actuals.

  • actuals_always: Regardless of task statuses, always calculate the resource load with task actuals such as actual effort, actual dates, and estimated remaining effort.

Values:

Default: scheduled

Valid values: actuals_when_completed, actuals_always

Added in release: 9.66.

WS_UPDATE_CLOSED_AND_CANCELED_REQUESTS

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

Values:

Default: false

Valid values: true, false

See also: