Reviewing the Customization File for Multiple Domains
For multiple domains, duplicate the entire domain section, again
maintaining the indentation from the original psft_configuration.yaml
file. This sample shows a psft_customizations.yaml file for two application
server domains, two PIA domains, and two Process Scheduler domains,
with annotations added for the purposes of this explanation. The annotations
are labelled with letters referring to the text discussion, and by
### characters, such as ###(A)###.
Follow these guidelines in creating a psft_customizations.yaml file for customized PeopleSoft domains. The letters correspond to those in the code sample.
-
(A) For more than one application server, include the
pia_psserver_listentry at the top of the psft_customizations.yaml definitions. List the application server domains that are used by the PIA domains, using the format <application_server_host>:<Jolt port>. Separate the entries with a comma. -
(B) Include the scalar parameters for each domain at the top.
You can retain the default names for each domain, or change them.
This sample starts with several scalar parameters. Interpolation functions that reference these scalar parameters will also use the non-default values. This applies to the interpolation function in psft_customizations.yaml as well as those used by the ACM plug-ins in psft_configuration.yaml.
-
(C) Copy the entire section for the domains that you want to customize.
Be sure to retain the indentation as given in the delivered YAML file when you copy the sections into the psft_customizations.yaml file.
In the delivered psft_configuration.yaml file, each section begins with a domain name that is defined as an interpolation token based on the scalar parameter. For example, under
appserver_domain_list, the domain name is defined as"%{lookup('appserver_domain_name')}", which uses the scalar parameterappserver_domain_name. After you copy the sections into the psft_customizations.yaml file, in the first section, either duplicate the value of the scalar parameter, or retain the interpolation token to refer to it. -
(D) Specify unique names for each domain.
-
(E) Specify unique, unused ports for each domain.
This sample starts with several scalar parameters for ports. Interpolation functions for the first application server domain, APPDOM111, which reference these scalar parameters, will use the same values. This applies to the interpolation functions in psft_customizations.yaml as well as those used by the ACM plug-ins in psft_configuration.yaml.
For the second application server domain, APPDOM222, enter non-default port values for Jolt Listener/Port and Workstation Listener/Port directly.
To set Jolt Listener/Port and Workstation Listener/Port for the second domain, you must take into account the range of ports that will be used by the first domain. Derive the allowed ports using the Workstation and Jolt Max Handler values. The default Max Handler values are based on the application server template type. The default DPK deployment uses the small template. Refer to the PeopleTools documentation for the values.
See PeopleTools: System and Server Administration, “Setting Application Server Domain Parameters,” Jolt Listener Options.
See PeopleTools: System and Server Administration, “Setting Application Server Domain Parameters,” Workstation Listener Options.
For example, if the Workstation Listener/Port is set to 7001 for the first domain, APPDOM111, and the Workstation Max Handler is 3, set the Workstation Listener/Port for the second domain, APPDOM222, to 7004 (skip 3 numbers).
-
(E) If specifying more than one PIA domain, ensure that the ports are not in use, and use different ports for HTTP and HTTPS for each domain.
-
(F) If specifying more than one Process Scheduler domain, you must specify unique Process Scheduler server names.
In this sample, the first Process Scheduler server uses the default value, which is defined as an interpolation token. The first Process Scheduler server name is specified with a scalar parameter at the top,
prcs_domain_name.The second Process Scheduler server has a different name,
PRCS222.Each Process Scheduler server name must begin with a letter and include a maximum of 8 characters.
-
(G) The Master Scheduler Server should be enabled for the first Process Scheduler domain (
MSTRSRV: “Yes”), and disabled for subsequent Process Scheduler domains (MSTRSRV: “No”).See PeopleTools: Process Scheduler, "Understanding PeopleSoft Master Scheduler Server."
-
(H) If specifying more than one PIA domain, you must specify different site names for each.
In this sample, the first PIA site name uses the default value, which is defined as an interpolation token. The second PIA site name has a different name,
ps222.
---
pia_psserver_list: "hostname.example.com:9033,hostname.example.com:9043"
### (A) ###
### (B), (E) ###
appserver_domain_name: APPDOM111
prcs_domain_name: PRCSDOM111 ### (F) ###
pia_domain_name: PIA111
pia_site_name: ps
pia_http_port: 8000
pia_https_port: 8443
jolt_port: 9033
wsl_port: 7000
appserver_domain_list:
"%{lookup('appserver_domain_name')}": ###(C), (D) ###
os_user: "%{lookup('domain_user')}"
template_type: "%{lookup('appserver_template')}"
ps_cfg_home_dir: "%{lookup('ps_config_home')}"
db_settings:
db_name: "%{lookup('db_name')}"
db_type: "%{lookup('db_platform')}"
db_opr_id: "%{lookup('db_user')}"
db_opr_pwd: "%{lookup('db_user_pwd')}"
db_connect_id: "%{lookup('db_connect_id')}"
db_connect_pwd: "%{lookup('db_connect_pwd')}"
config_settings:
Domain Settings/Domain ID: IBUPG0
PSAPPSRV/Min Instances: 3
PSAPPSRV/Max Instances: 5
JOLT Listener/Port: "%{lookup('jolt_port')}" ### (E) ###
Workstation Listener/Port: "%{lookup('wsl_port')}" ### (E) ###
feature_settings:
PUBSUB: "Yes"
QUICKSRV: "No"
QUERYSRV: "No"
JOLT: "Yes"
JRAD: "No"
WSL: "Yes"
DBGSRV: "No"
RENSRV: "No"
MCF: "No"
PPM: "Yes"
PSPPMSRV: "Yes"
ANALYTICSRV: "No"
SERVER_EVENTS: "Yes"
DOMAIN_GW: "No"
"APPDOM222": ### (C), (D) ###
os_user: "%{lookup('domain_user')}"
template_type: "%{lookup('appserver_template')}"
ps_cfg_home_dir: "%{lookup('ps_config_home')}"
db_settings:
db_name: "%{lookup('db_name')}"
db_type: "%{lookup('db_platform')}"
db_opr_id: "%{lookup('db_user')}"
db_opr_pwd: "%{lookup('db_user_pwd')}"
db_connect_id: "%{lookup('db_connect_id')}"
db_connect_pwd: "%{lookup('db_connect_pwd')}"
config_settings:
Domain Settings/Domain ID: IBUPG0
PSAPPSRV/Min Instances: 3
PSAPPSRV/Max Instances: 5
JOLT Listener/Port: 9041 ### (E) ###
Workstation Listener/Port: 7004 ### (E) ###
feature_settings:
PUBSUB: "Yes"
QUICKSRV: "No"
QUERYSRV: "No"
JOLT: "Yes"
JRAD: "No"
WSL: "Yes"
DBGSRV: "No"
RENSRV: "No"
MCF: "No"
PPM: "Yes"
PSPPMSRV: "Yes"
ANALYTICSRV: "No"
SERVER_EVENTS: "Yes"
DOMAIN_GW: "No"
pia_domain_list:
"%{lookup('pia_domain_name')}": ### (C), (D) ###
os_user: "%{lookup('domain_user')}"
ps_cfg_home_dir: "%{lookup('ps_config_home')}"
gateway_user: "%{lookup('pia_gateway_user')}"
gateway_user_pwd: "%{lookup('pia_gateway_user_pwd')}"
auth_token_domain: ".%{::domain}"
webserver_settings:
webserver_type: "%{lookup('webserver_type')}"
webserver_home: "%{lookup('weblogic_location')}"
webserver_admin_user: system
webserver_admin_user_pwd: ENC[xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx]
##############################################################
# Replace this password sample with encrypted text from the #
# generated psft_configuration.yaml file. #
##############################################################
webserver_admin_port: 8000 ### (E) ###
webserver_http_port: 8000 ### (E) ###
webserver_https_port: 8443 ### (E) ###
site_list:
"%{lookup('pia_site_name')}": ### (H) ###
appserver_connections: "%{lookup('pia_psserver_list')}"
domain_conn_pwd: "%{lookup('domain_conn_pwd')}"
webprofile_settings:
profile_name: "%{lookup('pia_webprofile_name')}"
profile_user: PTWEBSERVER
profile_user_pwd: ENC[xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx]
##############################################################
# Replace this password sample with encrypted text from the #
# generated psft_configuration.yaml file. #
##############################################################
report_repository_dir: "%{lookup('report_repository_dir')}"
"PIADOM222": ### (C), (D) ###
os_user: "%{lookup('domain_user')}"
ps_cfg_home_dir: "%{lookup('ps_config_home')}"
gateway_user: "%{lookup('pia_gateway_user')}"
gateway_user_pwd: "%{lookup('pia_gateway_user_pwd')}"
auth_token_domain: ".%{::domain}"
webserver_settings:
webserver_type: "%{lookup('webserver_type')}"
webserver_home: "%{lookup('weblogic_location')}"
webserver_admin_user: system
webserver_admin_user_pwd: ENC[xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx]
##############################################################
# Replace this password sample with encrypted text from the #
# generated psft_configuration.yaml file. #
##############################################################
webserver_admin_port: 8002 ### (E) ###
webserver_http_port: 8002 ### (E) ###
webserver_https_port: 8445 ### (E) ###
site_list:
"ps222": ###(H) ###
appserver_connections: "%{lookup('pia_psserver_list')}"
domain_conn_pwd: "%{lookup('domain_conn_pwd')}"
webprofile_settings:
profile_name: "%{lookup('pia_webprofile_name')}"
profile_user: PTWEBSERVER
profile_user_pwd: ENC[xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx]
##############################################################
# Replace this password sample with encrypted text from the #
# generated psft_configuration.yaml file. #
##############################################################
report_repository_dir: "%{lookup('report_repository_dir')}"
prcs_domain_list:
"%{lookup('prcs_domain_name')}":
os_user: "%{lookup('domain_user')}"
ps_cfg_home_dir: "%{lookup('ps_config_home')}"
db_settings:
db_name: "%{lookup('db_name')}"
db_type: "%{lookup('db_platform')}"
db_opr_id: "%{lookup('db_user')}"
db_opr_pwd: "%{lookup('db_user_pwd')}"
db_connect_id: "%{lookup('db_connect_id')}"
db_connect_pwd: "%{lookup('db_connect_pwd')}"
config_settings:
Process Scheduler/PrcsServerName: "%{lookup('prcs_domain_id')}" ###(F)###
Security/DomainConnectionPwd: "%{lookup('domain_conn_pwd')}"
feature_settings:
MSTRSRV: "Yes" ### (G) ###
APPENG: "Yes"
"PRCSDOM222":
os_user: "%{lookup('domain_user')}"
ps_cfg_home_dir: "%{lookup('ps_config_home')}"
db_settings:
db_name: "%{lookup('db_name')}"
db_type: "%{lookup('db_platform')}"
db_opr_id: "%{lookup('db_user')}"
db_opr_pwd: "%{lookup('db_user_pwd')}"
db_connect_id: "%{lookup('db_connect_id')}"
db_connect_pwd: "%{lookup('db_connect_pwd')}"
config_settings:
Process Scheduler/PrcsServerName: PRCS222 ### (F)###
Security/DomainConnectionPwd: "%{lookup('domain_conn_pwd')}"
feature_settings:
MSTRSRV: "No" ###(G)###
APPENG: "Yes"