Appendix A :Configuration parameters

Refer to the following section for details on configuration parameters.

Modifying Configuration Files

Route One Configuration

Property Name	Property Value	Description	Remarks
Configuration File: ro_servlet_init.conf
LOSApplica­tionRequest­ServiceURL	http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSAppli­cationRequestSer­vice	URL for OFSLL New application WebSer­vice	Refer the recommended context root table for CONTEXT ROOT. Sample URL: http://host­name:port/dbkls-xws-app-ro/LOSApplication­RequestService
LOSApplica­tionUpdate­ServiceURL	http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSAppli­cationUpdateSer­vice	URL for OFSLL application update WebService	Refer the recommended context root table for CONTEXT ROOT. Sample URL: http://host­name:port/dbkls-xws-app-ro/LOSApplica­tionUpdateService
LOSeCon­tractWebSer­viceServiceURL	http://<local­host>:<port>/dbkls-xws-app-ro/LOSEContractSer­vice	URL to validate and receive the contract information	Refer the recommended context root table for CONTEXT ROOT. Sample URL: http://host­name:port/dbkls-xws-app-ro/LOSEContract­Service
keystoreLoca­tion	config/dls_cacerts	Parameter to set key­store location	The keystore location should not be changed and keystore should be available in this location
postURL	https://messag­ing.itl.routeone.net/IF1_ITL/CASSB­MessagingRe­ceiver	URL for posting acknowledgement message to Route one	Verify the URL with Route One
fileLocation	/tmp	temporary file direc­tory	The directory for tempo­rary files. Make sure that such directory exists on the deployment server
postTimeout	10	Parameter to set timeout value to post XML message to third party.	Timeout value should be specified in number of seconds.
useProxy	0	Parameter to switch on/off proxy use. By default use of proxy is switched off. To use proxy setup value to "1", else setup value as "0"
proxyHost	abc.com	Parameter to set proxy host. This is required if useProxy is set to 1.
proxyPort	80	Parameter to set proxy port. This is required if useProxy is set to 1.
Configuration File: dbkws_xae_init.conf
lenderId	SOME­LENDER_ID	The finance source identifier used in the dealer file	SOMELENDER_ID is a sample value
lenderName	SOME_LENDER_NAME	The finance source name used in the dealer file	SOME_LENDER_NAME is a sample value
application­Source	ROUTEONE	Parameter to set application source	Don't modify this value
dealerEle­mentName	DEALER_DE­TAILS	Name of XML ele­ment used for the dealer details used in the dealer file	DEALER_DETAILS is a sample value
fileLocation	/tmp		The directory for tempo­rary files. Make sure that such directory exists on the deployment server
fileDelimiter	,	Delimiter used in dealer header file	Needed only for Route­One
jndiLookupDa­taSource	jdbc/IN1Huk­WznG0b4esj	Parameter that defines the JNDI look up for the applicaton datasource	Don't modify the value
keystoreLoca­tion	config/dls_cacerts	Parameter to set location for public/pri­vate key store for HTTPS posting and for XML Digital Sig­nature	The keystore location should not be changed and keystore should be available in this location
postTimeout	10	Parameter to set timeout value to post XML message to third party.	Timeout value should be specified in number of seconds.
useProxy	0	Parameter to switch on/off proxy use. By default use of proxy is switched off. To use proxy setup value to "1", else setup value as "0"
proxyHost	abc.com	Parameter to set proxy host. This is required if useProxy is set to 1.
proxyPort	80	Parameter to set proxy port. This is required if useProxy is set to 1.
Configuration File: dbkws_xec_init.conf
jndiLookupDa­taSource	jdbc/IN1Huk­WznG0b4esj	Parameter that defines the JNDI look up for the applicaton datasource	Don't modify the value
Configuration File: dbkws_xcl_init.conf
lenderId	SOME­LENDER_ID	The finance source identifier used in the dealer file	SOMELENDER_ID is a sample value
lenderName	SOME_LENDER_NAME	The finance source name used in the dealer file	SOME_LENDER_NAME is a sample value
dealerEle­mentName	DEALER_DE­TAILS	Name of XML ele­ment used for the dealer details used in the dealer file	DEALER_DETAILS is a sample value
fileLocation	/tmp		The directory for tempo­rary files. Make sure that such directory exists on the deployment server
fileDelimiter	,	Delimiter used in dealer header file
jndiLookupDa­taSource	jdbc/dbk105nlE­JBDS	Parameter that defines the JNDI look up for the applicaton datasource	Don't modify the value
keystoreLoca­tion	config/dls_cacerts	Parameter to set location for public/pri­vate key store for HTTPS posting and for XML Digital Sig­nature	The keystore location should not be changed and keystore should be available in this location
keystorePass­word	changeit	The keystore pass­word	The deafult password is "changeit". Modify the property in case the pass­word is different for the keystore.
sscroKeyAlias	ofss_routeone	OFSLL's private key alias name. The pri­vate key is used to sign xml response to RouteOne	You may import the pri­vate key with alias "ofss_routeone" else modify the property value to alias used while importing the private key into keystore.
sscroKeyPass­word	demotestSSCR1	OFSLL's private key password	demotestSSCR1 is a sample value
Configuration File: Logging.properties
handlers	java.util.log­ging.FileHandler, java.util.log­ging.Console­Handler
java.util.log­ging.File­Handler.level	ALL
java.util.log­ging.File­Handler.pattern	/somewhere/logs/dbkls_xws_%g.log
java.util.log­ging.File­Handler.limit	1000000
java.util.log­ging.File­Handler.count	4
java.util.log­ging.File­Handler.append	true
java.util.log­ging.File­Handler.formatter	java.util.log­ging.SimpleFor­matter
java.util.log­ging.Console­Handler.level	WARNING
java.util.log­ging.Console­Handler.formatter	java.util.log­ging.SimpleFor­matter
com.ofss.fll.xws.level	FINER	set the logging level for the application	Other Level values -- FIN­EST,FINE,CONFIG and INFO

Dealer Track

Property Name	Property Value	Description	Remarks
Configuration File: dt_servlet_init.conf
LOSAppli­cationRe­questServiceURL	http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSAppli­cationRequestSer­vice	URL for OFSLL New application WebService	Refer the recommended context root table for CONTEXT ROOT. Sample URL: http://host­name:port/dbkls-xws-app-dt/LOSApplicationRe­questService
LOSAppli­cationUp­dateServiceURL	http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSAppli­cationUpdateSer­vice	URL for OFSLL applica­tion update WebService	Refer the recommended context root table for CONTEXT ROOT. Sample URL: http://host­name:port/dbkls-xws-app-dt/LOSApplicationUp­dateService
postTime­out	10	Parameter to set timeout value to post XML mes­sage to third party.	Timeout value should be specified in number of seconds.
useProxy	0	Parameter to switch on/off proxy use. By default use of proxy is switched off. To use proxy setup value to "1", else setup value as "0"
proxyHost	abc.com	Parameter to set proxy host. This is required if useProxy is set to 1.
proxyPort	80	Parameter to set proxy port. This is required if useProxy is set to 1.
Configuration File: dbkws_xae_init.conf
lenderId	SOME­LENDER_ID	The finance source iden­tifier used in the dealer file	SOMELENDER_ID is a sample value
lender­Name	SOME_LENDER_NAME	The finance source name used in the dealer file	SOME_LENDER_NAME is a sample value
applica­tion­Source	DEALERTRACK	Parameter to set applica­tion source	Don't modify this value
dealerEle­ment­Name	DEALER_DE­TAILS	Name of XML element used for the dealer details used in the dealer file	DEALER_DETAILS is a sample value
fileLoca­tion	/tmp		The directory for tempo­rary files. Make sure that such directory exists on the deployment server
jndi­Lookup­DataSource	jdbc/IN1Huk­WznG0b4esj	Parameter that defines the JNDI look up for the applicaton datasource	Don't modify the value
keystore­Location	config/dls_cacerts	Parameter to set location for public/private key store for HTTPS posting and for XML Digital Sig­nature	The keystore location should not be changed and keystore should be available in this location
keystore­Password	changeit	The keystore password	The deafult password is "changeit". Modify the property in case the pass­word is different for the keystore.
postTime­out	10	Parameter to set timeout value to post XML mes­sage to third party.	Timeout value should be specified in number of seconds.
useProxy	0	Parameter to switch on/off proxy use. By default use of proxy is switched off. To use proxy setup value to "1", else setup value as "0"
proxyHost	abc.com	Parameter to set proxy host. This is required if useProxy is set to 1.
proxyPort	80	Parameter to set proxy port. This is required if useProxy is set to 1.
Configuration File: dbkws_xcl_init.conf
lenderId	SOME­LENDER_ID	The finance source iden­tifier used in the dealer file	SOMELENDER_ID is a sample value
lender­Name	SOME_LENDER_NAME	The finance source name used in the dealer file	SOME_LENDER_NAME is a sample value
dealerEle­ment­Name	DEALER_DE­TAILS	Name of XML element used for the dealer details used in the dealer file	DEALER_DETAILS is a sample value
fileLoca­tion	/tmp		The directory for tempo­rary files. Make sure that such directory exists on the deployment server
fileDelim­iter	,	Delimiter used in dealer header file	Needed only for Route­One
jndi­Lookup­DataSource	jdbc/dbk105nlE­JBDS	Parameter that defines the JNDI look up for the applicaton datasource	Don't modify the value
keystore­Location	config/dls_cacerts	Parameter to set location for public/private key store for HTTPS posting and for XML Digital Sig­nature	The keystore location should not be changed and keystore should be available in this location
keystore­Password	changeit	The keystore password	The deafult password is "changeit". Modify the property in case the pass­word is different for the keystore.
sscroKeyAlias	ofss_routeone	OFSLL's private key alias name. The private key is used to sign xml response to RouteOne	You may import the pri­vate key with alias "ofss_routeone" else modify the property value to alias used while import­ing the private key into keystore.
sscroKey­Password	demotestSSCR1	OFSLL's private key password	demotestSSCR1 is a sample value
Configuration File: Logging.properties
handlers	java.util.log­ging.FileHandler, java.util.log­ging.Console­Handler
java.util.logging.File­Han­dler.level	ALL
java.util.logging.File­Han­dler.pattern	/somewhere/logs/dbkls_xws_%g.log
java.util.logging.File­Han­dler.limit	1000000
java.util.logging.File­Han­dler.count	4
java.util.logging.File­Han­dler.append	true
java.util.logging.File­Han­dler.formatter	java.util.log­ging.SimpleFor­matter
java.util.logging.Console­Han­dler.level	WARNING
java.util.logging.Console­Han­dler.formatter	java.util.log­ging.SimpleFor­matter
com.ofss.fll.xws.level	FINER	set the logging level for the application	Other Level values -- FIN­EST,FINE,CONFIG and INFO

EDOCS

Property Name	Property Value	Description	Remarks
Configuration File: ds_servlet_init.conf
LOSeApplication­RequestServi­ceURL	http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSeAp­plicationRequest­Service	URL for OFSLL eDocs Create/update applica­tion WebService	Refer the recommended context root table for CON­TEXT ROOT. Sample URL: http://host­name:port/dbkls-xws-app-ds/LOSeApplicationRe­questService
LOSApplication­CommentUpdate­ServiceURL	http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSAp­plicationCom­mentUpdateService	URL for OFSLL eDocs comment update WebSer­vice	Refer the recommended context root table for CON­TEXT ROOT. Sample URL: http://host­name:port/dbkls-xws-app-ds/LOSApplicationCom­mentUpdateService
LOSApplication­LocationUpdate­ServiceURL	http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSAp­plicationLoca­tionUpdateService	URL for OFSLL eDocs location update WebSer­vice	Refer the recommended context root table for CON­TEXT ROOT. Sample URL: http://host­name:port/dbkls-xws-app-ds/LOSApplicationLoca­tionUpdateService
postTimeout	10	Parameter to set timeout value to post XML mes­sage to third party.	Timeout value should be specified in number of sec­onds.
useProxy	0	Parameter to switch on/off proxy use. By default use of proxy is switched off. To use proxy setup value to "1", else setup value as "0"
proxyHost	abc.com	Parameter to set proxy host. This is required if useProxy is set to 1.
proxyPort	80	Parameter to set proxy port. This is required if useProxy is set to 1.
Configuration File: dbkws_xae_init.conf
lenderId	SOME­LENDER_ID	The finance source identifier used in the dealer file	SOMELENDER_ID is a sample value
lenderName	SOME_LENDER_NAME	The finance source name used in the dealer file	SOME_LENDER_NAME is a sample value
applicationSource	EDOCS	Parameter to set application source	Don't modify this value
dealerElement­Name	DEALER_DE­TAILS	Name of XML element used for the dealer details used in the dealer file	DEALER_DETAILS is a sample value
fileLocation	/tmp		The directory for temporary files. Make sure that such directory exists on the deployment server
jndiLookupData­Source	jdbc/IN1Huk­WznG0b4esj	Parameter that defines the JNDI look up for the applicaton data­source	Don't modify the value
keystoreLocation	config/dls_cacerts	Parameter to set location for pub­lic/private key store for HTTPS posting and for XML Digital Sig­nature	The keystore location should not be changed and keystore should be availa­ble in this location
keystorePassword	changeit	The keystore password	The deafult password is "changeit". Modify the property in case the pass­word is different for the keystore.
postTimeout	10	Parameter to set timeout value to post XML mes­sage to third party.	Timeout value should be specified in number of sec­onds.
useProxy	0	Parameter to switch on/off proxy use. By default use of proxy is switched off. To use proxy setup value to "1", else setup value as "0"
proxyHost	abc.com	Parameter to set proxy host. This is required if useProxy is set to 1.
proxyPort	80	Parameter to set proxy port. This is required if useProxy is set to 1.
Configuration File: dbkws_xcl_init.conf
lenderId	SOME­LENDER_ID	The finance source identifier used in the dealer file	SOMELENDER_ID is a sample value
lenderName	SOME_LENDER_NAME	The finance source name used in the dealer file	SOME_LENDER_NAME is a sample value
dealerElement­Name	DEALER_DE­TAILS	Name of XML element used for the dealer details used in the dealer file	DEALER_DETAILS is a sample value
fileLocation	/tmp		The directory for temporary files. Make sure that such directory exists on the deployment server
fileDelimiter	,	Delimiter used in dealer header file
jndiLookupData­Source	jdbc/dbk105nlE­JBDS	Parameter that defines the JNDI look up for the applicaton data­source	Don't modify the value
keystoreLocation	config/dls_cacerts	Parameter to set location for pub­lic/private key store for HTTPS posting and for XML Digital Sig­nature	The keystore location should not be changed and keystore should be availa­ble in this location
keystorePassword	changeit	The keystore password	The deafult password is "changeit". Modify the property in case the pass­word is different for the keystore.
sscroKeyAlias	ofss_routeone	OFSLL's pri­vate key alias name. The pri­vate key is used to sign xml response to RouteOne	You may import the private key with alias "ofss_route­one" else modify the prop­erty value to alias used while importing the private key into keystore.
sscroKeyPass­word	demotestSSCR1	OFSLL's private key password	demotestSSCR1 is a sam­ple value
Configuration File: Logging.properties
handlers	java.util.log­ging.FileHandler, java.util.log­ging.Console­Handler
java.util.log­ging.File­Handler.level	ALL
java.util.log­ging.File­Handler.pattern	/somewhere/logs/dbkls_x­ws_%g.log
java.util.log­ging.File­Handler.limit	1000000
java.util.log­ging.File­Handler.count	4
java.util.log­ging.File­Handler.append	true
java.util.log­ging.File­Handler.formatter	java.util.log­ging.SimpleFor­matter
java.util.log­ging.Console­Handler.level	WARNING
java.util.log­ging.Console­Handler.formatter	java.util.log­ging.SimpleFor­matter
com.ofss.fll.xws.level	FINER	set the logging level for the application	Other Level values -- FIN­EST,FINE,CONFIG and INFO

Others

• Verify that latest XWS SQL Types, Views and Packages are installed.
• Required Java permissions have been granted
• Verify that System parameters for WebServices URLs as well as Post Response URLs are set. Please see the table below for details
• System parameter CMN_WALLET_PATH and CMN_WALLET_PASSWORD is setup
• Verify lenderId, lendername in config(dbkws_xae_init.conf) file and also set lenderId in all response xsl in element "A:TargetId".
• For DealerTrack access, user name/pwd should be setup in file ".htpasswd" under config dir

System Parameters to be configured:

System Parameter Name	System Parameter Desc
XWS_XAE_DLR_TRACK_RESP_PWD	DEALERTRACK APPLICATION RESPONSE BASIC AUTH PASSWORD
XWS_XAE_DLR_TRACK_RESP_URL	DEALERTRACK APPLICATION RESPONSE URL
XWS_XAE_DLR_TRACK_RESP_USER	DEALERTRACK APPLICATION RESPONSE BASIC AUTH USER
XWS_XAE_DLR_TRACK_WS_URL	OFSLL WEBSERVICE URL TO POST APPLICATION RESPONSE TO DEALER­TRACK
XWS_XAE_ROUTEONE_RESP_PWD	ROUTE ONE APPLICATION RESPONSE BASIC AUTH PASSWORD
XWS_XAE_ROUTEONE_RESP_URL	ROUTE ONE APPLICATION RESPONSE URL
XWS_XAE_ROUTEONE_RESP_USER	ROUTE ONE APPLICATION RESPONSE BASIC AUTH USER
XWS_XAE_ROUTEONE_WS_URL	OFSLL WEBSERVICE URL TO POST APPLICATION RESPONSE TO ROUTE ONE
XWS_XAE_EDOC_RESP_URL	EDOCS APPLICATION RESPONSE BASIC AUTH PASSWORD
XWS_XAE_EDOC_WS_URL	EDOCS APPLICATION RESPONSE URL
XWS_XAE_EDOC_RESP_USER	EDOCS APPLICATION RESPONSE BASIC AUTH USER
XWS_XAE_EDOC_RESP_PWD	OFSLL WEBSERVICE URL TO POST APPLICATION RESPONSE TO EDOCS
XWS_XPR_DLR_TRACK_RESP_PWD	DEALER TRACK DEALER LOAD PASS­WORD
XWS_XPR_DLR_TRACK_RESP_URL	DEALER TRACK DEALER LOAD RESPONSE URL
XWS_XPR_DLR_TRACK_RESP_USER	DEALER TRACK DEALER LOAD USER ID
XWS_XPR_DLR_TRACK_WS_URL	OFSLL WEBSERVICE URL TO POST DEALER DETAILS TO DEALER TRACK
XWS_XPR_INCLUDE_TEMP	INCLUDE TEMP PRODUCERS
XWS_XPR_ROUTEONE_RESP_PWD	ROUTE ONE DEALER LOAD PASS­WORD
XWS_XPR_ROUTEONE_RESP_URL	ROUTE ONE DEALER LOAD RESPONSE URL
XWS_XPR_ROUTEONE_RESP_USER	ROUTE ONE DEALER LOAD USER ID
XWS_XPR_ROUTEONE_WS_URL	OFSLL WEBSERVICE URL TO POST DEALER DETAILS TO ROUTE ONE
XWS_XAE_DLR_TRACK_LENDERID	DEALERTRACK LENDER ID
XWS_XAE_ROUTEONE_LENDERID	ROUTEONE LENDER ID
XWS_XAE_DL­R_TRACK_LENDER_NAME	DEALERTRACK LENDER NAME
XWS_XAE_ROUTE­ONE_LENDER_NAME	ROUTEONE LENDER NAME
XWS_XAE_ECON_ROU­TEEONE_RESP_URL	Route One E-contract response URL