configurables.cfg #4

# See additional documentation at the end of this file.

# See documentation regarding configurables here:
# https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/configurables.alphabetical.html

# Format:
# Profile|Configurable|ExpectedValue|CompareStyle|Optionality|ServerIDType|SetNotes

#------------------------------------------------------------------------------
# Default values. These always apply, and are combined with one user-specified
# profile defined further below, e.g. 'demo' or 'hcc'.
#------------------------------------------------------------------------------
always|auth.id|null|Set|Required|any|EDITME_AddURLForNotes
always|rpl.forward.login|1|Exact|Required|any|EDITME_AddURLForNotes
always|run.users.authorize|1|Exact|Required|any|None
always|dm.user.hideinvalid|1|Exact|Required|any|None
always|server|3|AtLeast|Recommended|any|None
always|server.depot.root|/p4/__SDP_INSTANCE__/depots|Exact|Required|any|None
always|journalPrefix|/p4/__SDP_INSTANCE__/checkpoints/__P4SERVER__|Exact|Required|any|None
always|dm.info.hide|1|Exact|Required|any|None
always|monitor|1|AtLeast|Required|any|None
always|net.tcpsize|null|Unset|Required|any|None
always|net.autotune|null|Unset|Required|any|https://portal.perforce.com/s/article/15368
always|db.monitor.shared|4096|AtLeast|Required|any|None
always|net.backlog|2048|AtLeast|Required|any|None
always|lbr.bufsize|1M|AtLeast|Required|any|None
always|filesys.bufsize|1M|AtLeast|Required|any|None
always|server.commandlimits|2|Exact|Required|any|None
always|rpl.checksum.auto|1|Exact|Required|any|None
always|rpl.checksum.change|2|Exact|Required|any|None
always|rpl.checksum.table|1|Exact|Required|any|None
always|rpl.compress|4|Exact|Recommended|any|None
always|dm.user.loginattempts|7|AtLeast|Recommended|any|None
always|server.start.unlicensed|1|Exact|Recommended|any|None
always|rejectList|P4EXP,version=2014.2|Contains|Recommended|any|None
always|rt.monitorfile|monfile.mem|Exact|Recommended|any|None
always|server.global.client.views|1|Exact|Recommended|any|None
always|server.locks.global|1|Exact|Recommended|any|None
always|proxy.monitor.level|3|AtLeast|Recommended|any|None
always|submit.noretransfer|1|Exact|Recommended|any|None

# Best Practices for Swarm
always|dm.shelve.promote|1|Exact|Recommended|any|None
always|dm.keys.hide|2|Exact|Recommended|any|None
always|filetype.bypasslock|1|Exact|Recommended|any|None

# Extensions
always|server.extensions.dir|__LOGS__/p4-extensions|Exact|Recommended|any|None

# Enable Partition Clients
always|client.readonly.dir|__P4ROOT__/client.readonly.dir|Set|Recommended|any|None
always|client.sendq.dir|__P4ROOT__/client.readonly.dir|Set|Recommended|any|None

# Structured Logging.
always|serverlog.file.3|__LOGS__/errors.csv|Exact|Recommended|any|None
always|serverlog.retain.3|__KEEPLOGS__|AtLeast|Recommended|any|None
always|serverlog.file.7|__LOGS__/events.csv|Exact|Recommended|any|None
always|serverlog.retain.7|__KEEPLOGS__|AtLeast|Recommended|any|None
always|serverlog.file.8|__LOGS__/integrity.csv|Exact|Recommended|any|None
always|serverlog.retain.8|__KEEPLOGS__|AtLeast|Recommended|any|None
always|serverlog.file.11|__LOGS__/triggers.csv|Exact|Recommended|any|None
always|serverlog.retain.11|__KEEPLOGS__|AtLeast|Recommended|any|None

# Net Keepalive Settings.
always|net.keepalive.count|9|AtLeast|Recommended|any|None
always|net.keepalive.disable|0|Exact|Recommended|any|None
always|net.keepalive.idle|180|Set|Recommended|any|None
always|net.keepalive.interval|15|AtLeast|Recommended|any|None

always|lbr.autocompress|1|Exact|Required|any|None
always|db.reorg.disable|1|Exact|Recommended|any|None

#------------------------------------------------------------------------------
# Demo Profile Settings
#------------------------------------------------------------------------------
demo|filesys.P4ROOT.min|5M|AtLeast|Recommended|any|None
demo|filesys.depot.min|5M|AtLeast|Recommended|any|None
demo|filesys.P4JOURNAL.min|5M|AtLeast|Recommended|any|None
demo|server.maxcommands|2500|AtLeast|Required|any|None
demo|net.parallel.max|10|AtLeast|Recommended|any|None
demo|net.parallel.threads|4|AtLeast|Recommended|any|None
demo|net.parallel.sync.svrthreads|300|NoMoreThan|Recommended|any|None

# Helix Core Cloud
hcc|security|4|Exact|Required|any|Standard
hcc|dm.user.noautocreate|2|Exact|Recommended|any|None
hcc|filesys.P4ROOT.min|5M|AtLeast|Recommended|any|None
hcc|filesys.depot.min|5M|AtLeast|Recommended|any|None
hcc|filesys.P4JOURNAL.min|5M|AtLeast|Exact|Recommended|any|None
hcc|server.maxcommands|2500|AtLeast|Required|any|None
hcc|net.parallel.max|8|AtLeast|Recommended|any|None
hcc|net.parallel.threads|4|AtLeast|Recommended|any|None
hcc|net.parallel.sync.svrthreads|300|NoMoreThan|Recommended|any|None

# Production Commercial Profile Settings
prod|security|4|AtLeast|Required|any|Standard
prod|filesys.P4ROOT.min|5G|AtLeast|Recommended|any|None
prod|filesys.depot.min|5G|AtLeast|Recommended|any|None
prod|filesys.P4JOURNAL.min|5G|AtLeast|Recommended|any|None
prod|dm.user.noautocreate|2|Exact|Recommended|any|None
prod|server.maxcommands|2500|AtLeast|Required|any|None
prod|auth.sso.allow.passwd|1|Exact|Recommended|any|None
prod|auth.sso.nonldap|1|Exact|Recommended|any|None
prod|net.parallel.max|10|AtLeast|Recommended|any|None
prod|net.parallel.threads|4|AtLeast|Recommended|any|None
prod|net.parallel.sync.svrthreads|3000|NoMoreThan|Recommended|any|None

# Public Server Profile Settings
pub|security|0|Exact|Required|any|Standard
pub|filesys.P4ROOT.min|1G|AtLeast|Recommended|any|None
pub|filesys.depot.min|1G|AtLeast|Recommended|any|None
pub|filesys.P4JOURNAL.min|1G|AtLeast|Recommended|any|None
pub|server.maxcommands|2500|AtLeast|Required|any|None
pub|net.parallel.max|10|AtLeast|Recommended|any|None
pub|net.parallel.threads|4|AtLeast|Recommended|any|None
pub|net.parallel.sync.svrthreads|400|NoMoreThan|Recommended|any|None

#------------------------------------------------------------------------------
# Overview
#
# This data file, intended for use with the ccheck.sh script, defines best
# practices for various configurables for a Helix Core server.  The best
# practices are categorized by profiles of Helix Core servers. For example,
# the 'pub' profile is for a public server, which would be expected to have
# security=0. The 'prod' profile for a commercial production server would be
# expected to have security set to at least 4.
#------------------------------------------------------------------------------
# Profile
#
# Each configurable and expected value is associated with a profile:
# * always - This is a special profile that always applies; other profiles
#            specified will add to or override values defined in this profile.
#
# * prod - For commercial production Helix Core servers (closed source, secure)
#          This is the default profile. This is for production usage at small
#          small-to-medium scale.
#
# * prodent - Production at large enterprise scale.
#
# * demo - For demo and evaluation servers, with no security needs.
#
# * open - For public/open source servers, with open read access (security=0).
#------------------------------------------------------------------------------
# ExpectedValue:
#
# The expected value of the configurable.  (See also: CompareStyle)
# Expected values can have substitutions.  Values to be substituted use a
# double-underscore as a prefix and suffix, e.g. __SDP_INSTANCE__ will be
# substitued with the SDP Instance Name.  The follwoing substitutsions are
# done:
#
# __SDP_INSTANCE__     SDP Instance name, e.g. '1'.
# __P4ROOT__           Server root, e.g. /p4/N/root.
# __P4SERVER__         SDP Instance name, e.g. 'p4_1'.
# __KEEPLOGS__         KEEPLOGS setting defined in SDP shell env.
# __LOGS__             Logs dir, e.g. '/p4/1/logs'.
#------------------------------------------------------------------------------
# CompareStyle:
#
# This determines how actual and expected Value are matched.
# * Exact      - Actual value matches expected exactly, numeric or string.
# * Set        - Actual value is set to anything, just not null/unset.
# * Unset      - Value must not be explicitly set with 'p4 configure'.
# * AtLeast    - Actual is as big or bigger than expected.  This is a
#                numeric comparison. The value must be an integer or a size
#                e.g. 20K, 4G (ending in B, K, M, G, T, P, or E).
# * NoMoreThan - Actual is as no more than expected; opposite of AtLeast.
# * Contains   - Actual value contains the expected value (string compare).
#
#------------------------------------------------------------------------------
# Optionality:
#
# This indicates whether the given setting is required or recommended.  Values
# are:
#
# Required - If the value is not set to the expected value, validations fail.
#
# Recommended - If the value is not set to the expected value, validations
# succeed with a warning.
#------------------------------------------------------------------------------
# ServerIDType
#
# This can be one of:
#
# * any - For the global default 'any' config.
# * commit - Setting for the singular ServerID of the commit server, as defined
#   by the P4MASTER_ID setting.
# * replica - For a non-standby replica
# * standby - For a standby/journalcopy replica
# * edge - For an edge server
#------------------------------------------------------------------------------
# SetNotes:
#
# This column contains a reference to info to be displayed if it is determined
# that the configurable needs to be changed. For example, setting auth.id will
# invalidate all tickets, and thus may require planning to roll out in an
# enterprise environment.
#
# This is empty or has the value None for configurables that can safely be set
# in real-time without further contemplation. For settings that require a
# maintenance windows (due to a service restart), or possibly require planning
# and awareness of impact to users to change, this field contains a link to a
# URL with details.  This is used for configurables like auth.id, security, and
# rpl.forward.login that have details to be aware of when changing them.