Salesforce

What is the PASOE equivalent of mergeprop for tailoring property configuration

« Go Back

Information

 
TitleWhat is the PASOE equivalent of mergeprop for tailoring property configuration
URL NamePASOE-equivalent-of-mergeprop-000084179
Article Number000144604
EnvironmentProduct: OpenEdge
Version: 11.5.1, 11.6.x, 11.7x, 12.x
OS: All supported platforms
Other: OEPAS
Question/Problem Description
How to script PASOE configuration property updates
How to change the work-dir, startup-params and propath of openedge.properties when PASOE is deployed
What is the MERGEPROP equivalent for appserver.properties and openedge.properties property value configuration changes?
What is the PASOE equivalent of mergeprop for the Classic AppServer to configure properties ?
What to use during deployment of a PAS instance's to configure property changes

 
Steps to Reproduce
Clarifying Information
MERGEPROP was used for deployment of the Classic AppServer to configure ubroker.properties
Error Message
Defect Number
Enhancement Number
Cause
Resolution

1. OEPROP


OEPROP is a command-line utility used to display and manage properties in the server's conf/openedge.properties file with similar functionality to mergeprop.
  • The server's conf/openedge.properties file is in the instances' [CATALINA_BASE]/conf directory. For example: C:/OpenEdge/WRK/oepas1/conf
  • Like mergeprop, new values cannot be added to or removed from an existing parameter with oeprop
  • When a property is specified as a parameter to the oeprop command, the Group name must precede the Property name. For example: AppServer.SessMgr.maxAgents.
  • Either individual properties or a set of properties can be merged from a file (-f) to openedge.properties (just like mergeprop). 
  • The instance needs to be restarted after changing the openedge.properties configuration.
  • All options that can be used are provided in the menu: "oeprop -help" 

OEPROP Examples: 

  • The current value of any group property name can be viewed by listing the property:
$CATALINA_BASE/bin/oeprop AppServer.Agent.oepas1.PROPATH
  • To modify an individual property the existing value is replaced with the old value and the new value (ie: including the old value):
$CATALINA_BASE/bin/oeprop agentStartupParam=-T ${catalina.base}/temp -db C:/OpenEdge/WRK/sports2000
  • To modify a set of properties from a file: 
$CATALINA_BASE/bin/oeprop -f mynew.props
   
Where "mynew.props" is a text file with the configuration changes listed under the appropriate Section:
   
[AppServer.Agent.WebspeedABLApp]
PROPATH=C:/OpenEdge/WRK,${CATALINA_BASE}/webapps/Items/WEB-INF/openedge, ${CATALINA_BASE}/openedge,${DLC}/tty,${DLC}/tty/netlib/OpenEdge.Net.pl
sessionActivateProc=WebActivate.p

[AppServer.SessMgr.WebspeedABLApp]
agentStartupParam=-T ${catalina.base}/temp -db C:/OpenEdge/WRK/sports2000 

A typical use-case example is provided in Article  How to add many entries to PROPATH of PASOE Instance all at once   

2. TCMAN 

TCMAN is a command-line utility which can also be used to manage the properties in conf/appserver.properties or to view (only) the properties in conf/jvm.properties.  "tcman help config" or "tcman help feature" provides all options that can be used.

TCMAN config Examples: 

  • To view the CATALINA_BASE configuration (core Tomcat server’s configuration, conf/appserver.properties and .conf/jvm.properties):
  $CATALINA_BASE/bin/tcman config
  • To view a specific property, for example the current HTTPS port in /conf/appserver.properties:
  $CATALINA_BASE/bin/tcman config psc.as.https.port
psc.as.https.port=8811
  • To change and verify the HTTPS port number in /conf/appserver.properties:
$CATALINA_BASE/bin/​tcman config psc.as.http.port=8821

To view the configuration change:
$CATALINA_BASE/bin/tcman config psc.as.https.port
psc.as.https.port=8821

TCMAN feature Examples: 

  • To view, server features contained in the /conf/server.xml file of an instance and their current status
  $CATALINA_BASE/bin/tcman feature
  • To enable, or disable the server features contained in the /conf/server.xml file of an instance.
For example, if only HTTPS has to be enabled, disable HTTP:
  $CATALINA_BASE/bin/tcman feature http=off
  • To display the status of a single server feature:
$CATALINA_BASE/bin/tcman feature http
HTTP=off
Workaround
Notes
Keyword Phrase
Last Modified Date11/20/2020 7:13 AM

Powered by