Try OpenEdge Now
skip to main content
Application Migration and Development Guide
Migrating AppServer and WebSpeed Applications : Migrating server configuration and management : Migrating classic AppServer properties
 

Migrating classic AppServer properties

The classic AppServer keeps the properties for all defined instances in a single properties file located at $DLC/properties/ubroker.properties. With those properties, you define a set of property values that serve as the application's default configuration. An administrator installing an application typically defines a new AppServer instance and can change those property values to suit a site's specific requirements.
PAS for OpenEdge operates in the same general fashion, but is different with regards to the following:
*Each PAS for OpenEdge instance embeds its openedge.properties file inside the instance's conf directory.
*A PAS for OpenEdge instance supports named ABL applications that correspond to the core server's architecture.
*The properties for an ABL application in PAS for OpenEdge configure its Web applications, transports, an ABL session manager, and ABL multi-session agents.
To briefly compare classic AppServer properties to PAS for OpenEdge properties:
*Many of the properties used by a classic AppServer can be found in PAS for OpenEdge.
*Some classic AppServer properties have no meaning and are not found in PAS for OpenEdge.
*Some classic AppServer properties relate to functionality that is provided by the core PAS server and are managed using core server properties.
*PAS for OpenEdge has new properties that apply only to itself and have no relation to the classic AppServer.
Following is an overview of how the properties found in ubroker.properties file for a classic AppServer map to properties found in a PAS for OpenEdge instances openedge.properties file. The detailed information on individual properties can be found in the respective README files (ubroker.properties.README and openedge.properties.README).
There are certain rules for reading property names:
*All classic AppServer property names do not supply a group (a [...] name as the properties can exist in any [Ubroker…] group).
*All PAS for OpenEdge property names use a name-space declaration that tracks the group hierarchy found in the openedge.properties file. Examples:
*AppServer.Agent [AppServer.Agent]
*AppServer.Agent [AppServer.Agent]
*AppServer.Agent.oepas1 [AppServer.Agent.oepas1]
*AppServer.Agent.wrkdir [AppServer.Agent] wrkdir
*AppServer.Agent.oepas1.wrkdir [AppServer.Agent.oepas1] wrkdir
*PAS for OpenEdge groups include:
*[AppServer] — Properties that apply across the server instance
*[AppServer.Agent] — Properties that apply across all multi-session agents in the server instance (inherits from nothing )
*[AppServer.Agent.appname] — Multi-session agent properties that apply only to the ABL application named appname (inherits from [AppServer.Agent])
*[AppServer.SessMgr] — Properties that apply across all ABL application session managers in the server instance (inherits from nothing )
*[AppServer.SessMgr.appname] — ABL application session manager properties that apply only to the ABL application named appname (inherits from [AppServer.SessMgr])
*[appname] — Properties that apply only to the ABL application’s Web applications (inherits from nothing)
*[appname.web-app-name] — Properties that apply only to the ABL application’s Web application named web-app-name (inherits from [appname])
*[appname.web-app-name.APSV] — Properties that apply only to the ABL application’s Web application named web-app-name and to its APSV transport (inherits from [appname.web-app-name])
*[appname.web-app-name.SOAP] — Properties that apply only to the ABL application’s Web application named web-app-name and to its SOAP transport
*[appname.web-app-name.REST] — Properties that apply only to the ABL application’s Web application named web-app-name and to its REST transport
The following table list the classic AppServer properties and how they correspond to a PAS for OpenEdge instance property.
Table 10. Mapping AppServer to PAS for OpenEdge instance properties
Classic AppServer property
PAS for OpenEdge property
4glSrcCompile
N/A
allowRuntimeUpdates
AppServer.allowRuntimeUpdates
appServerKeepaliveCapabilities
N/A
appserviceNameList
N/A
autoStart
N/A
autoTrimTimeout
N/A
brkrDebuggerEnabled
N/A
brkrDebuggerKeyAlias
N/A
brkrDebuggerKeyAliasPassword
N/A
brkrDebuggerPassphrase
N/A
brkrDebuggerPortNumber
N/A
brkrDebuggerSSLEnable
N/A
brkrDebuggerUseBrokerAlias
N/A
brkrLogAppend
N/A
brkrLogEntries
N/A
brkrLogEntryTypes
N/A
brkrLogThreshold
N/A
brkrLoggingLevel
N/A
brkrNumLogFiles
N/A
brokerLogFile
N/A
certStorePath
N/A
classMain
N/A
collectStatsData
AppServer.Agent.collectStatsData
compressionEnable
See PAS server properties
connectingTimeout
See PAS server properties
controllingNameServer
N/A
debuggerEnabled
N/A
defaultService
N/A
description
N/A
environment
N/A
flushStatsData
AppServer.Agent.flushStatsData
groupName
N/A
hostName
N/A
infoVersion
AppServer.Agent.infoVersion
initialSrvrInstance
AppServer.SessMgr.numInitialAgents
ipver
AppServer.SessMgr.ipver
keyAlias
AppServer.Agent.keyAlias
keyAliasPasswd
AppServer.Agent.keyAliasPasswd
keyStorePasswd
AppServer.Agent.keyStorePasswd
keyStorePath
AppServer.Agent.keyStorePath
maxClientInstance
See PAS server properties
maxSrvrInstance
AppServer.SessMgr.maxAgents
minSrvrInstance
N/A
noSessionCache
AppServer.Agent.noSessionCache
operatingMode
N/A
password
N/A
portNumber
See PAS server properties
priorityWeight
N/A
PROPATH
AppServer.Agent.PROPATH
registerNameServer
N/A
registrationMode
N/A
registrationRetry
N/A
requestTimeout
See PAS server properties
serverASKActivityTimeout
N/A
serverASKResponseTimeout
N/A
serverLifespan
N/A
serverLifespanPadding
N/A
sessionTimeout
AppServer.Agent.sessionTimeout
srvrActivateProc
AppServer.Agent.sessionActivateProc
srvrConnectProc
AppServer.Agent.sessionConnectProc
srvrDeactivateProc
AppServer.Agent.sessionDeactivateProc
srvrDisconnProc
AppServer.Agent.sessionDisconnProc
srvrExecFile
AppServer.SessMgr.agentExecFile
srvrExecutionTimeLimit
N/A
srvrLogAppend
N/A
srvrLogEntryTypes
AppServer.SessMgr.agentLogEntryTypes
srvrLogFile
AppServer.Agent.agentLogFile
srvrLogThreshold
AppServer.SessMgr.agentLogThreshold
srvrLogWatchdogInterval
N/A
srvrLoggingLevel
AppServer.SessMgr.agentLoggingLevel
srvrMaxPort
AppServer.Agent.agentMaxPort
srvrMinPort
AppServer.Agent.agentMinPort
srvrNumLogFiles
AppServer.SessMgr.agentNumLogFiles
srvrSelectionScheme
N/A
srvrShutdownProc
AppServer.Agent.sessionShutdownProc
srvrStartupParam
AppServer.Agent.sessionStartupParam
srvrStartupProc
AppServer.Agent.sessionStartupProc
srvrStartupProcParam
AppServer.Agent.sessionStartupProcParam
srvrStartupTimeout
N/A
sslAlgorithms
AppServer.Agent.sslAlgorithms
sslEnable
AppServer.Agent.sslEnable
userName
N/A
uuid
AppServer.Agent.uuid
workDir
N/A
N/A
AppServer.statusEnabled
N/A
AppServer.collectMetrics
N/A
AppServer.applications
N/A
AppServer.Agent.agentShutdownProc
N/A
AppServer.Agent.agentStartupProc
N/A
AppServer.Agent.agentStartupProcParam
N/A
appname.webApps
N/A
appname.SessionMgr
N/A
appname.web-app-name.adapterEnabled
N/A
appname.web-app-name.SOAP.adminEnabled
N/A
appname.web-app-name.SOAP.adminSoapAction
N/A
appname.web-app-name.SOAP.debugClients
N/A
appname.web-app-name.SOAP.wsdlEnabled
N/A
appname.web-app-name.SOAP.wsaUrl
N/A
AppServer.SessMgr.publishDir