7 Appendix A :Configuration parameters
Refer to the following section for details on configuration parameters.
Modifying Configuration Files
Table 7-1 Route One Configuration
| Property Name | Property Value | Description | Remarks |
|---|---|---|---|
| Configuration File: ro_servlet_init.conf | |||
| LOSApplicationRequestServiceURL | http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSApplicationRequestService | URL for OFSLL New application WebService |
Refer the recommended context root table for CONTEXT ROOT. Sample URL: http://hostname:port/dbkls-xws-app-ro/LOSApplicationRequestService |
| LOSApplicationUpdateServiceURL | http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSApplicationUpdateService | URL for OFSLL application update WebService |
Refer the recommended context root table for CONTEXT ROOT. Sample URL: http://hostname:port/dbkls-xws-app-ro/LOSApplicationUpdateService |
| LOSeContractWebServiceServiceURL | http://<localhost>:<port>/dbkls-xws-app-ro/LOSEContractService | URL to validate and receive the contract information |
Refer the recommended context root table for CONTEXT ROOT. Sample URL: http://hostname:port/dbkls-xws-app-ro/LOSEContractService |
| keystoreLocation | config/dls_cacerts | Parameter to set keystore location | The keystore location should not be changed and keystore should be available in this location |
| postURL | https://messaging.itl.routeone.net/IF1_ITL/CASSBMessagingReceiver | URL for posting acknowledgement message to Route one | Verify the URL with Route One |
| fileLocation | /tmp | temporary file directory | The directory for temporary 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 | SOMELENDER_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 | ROUTEONE | Parameter to set application source | Don't modify this value |
| dealerElementName | DEALER_DETAILS | 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 | Needed only for RouteOne |
| jndiLookupDataSource | jdbc/IN1HukWznG0b4esj | Parameter that defines the JNDI look up for the applicaton datasource | Don't modify the value |
| keystoreLocation | config/dls_cacerts | Parameter to set location for public/private key store for HTTPS posting and for XML Digital Signature | 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 | |||
| jndiLookupDataSource | jdbc/IN1HukWznG0b4esj | Parameter that defines the JNDI look up for the applicaton datasource | Don't modify the value |
| Configuration File: dbkws_xcl_init.conf | |||
| lenderId | SOMELENDER_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 |
| dealerElementName | DEALER_DETAILS | 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 | |
| jndiLookupDataSource | jdbc/dbk105nlEJBDS | Parameter that defines the JNDI look up for the applicaton datasource | Don't modify the value |
| keystoreLocation | config/dls_cacerts | Parameter to set location for public/private key store for HTTPS posting and for XML Digital Signature | The keystore location should not be changed and keystore should be available in this location |
| keystorePassword | setme | The keystore password | The deafult password is "setme". Modify the property in case the password 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 private key with alias "ofss_routeone" else modify the property value to alias used while importing the private key into keystore. |
| sscroKeyPassword | demotestSSCR1 | OFSLL's private key password | demotestSSCR1 is a sample value |
| Configuration File: Logging.properties | |||
| handlers | java.util.logging.FileHandler, java.util.logging.ConsoleHandler | ||
| java.util.logging.FileHandler.level | ALL | ||
| java.util.logging.FileHandler.pattern | /somewhere/logs/dbkls_xws_%g.log | ||
| java.util.logging.FileHandler.limit | 1000000 | ||
| java.util.logging.FileHandler.count | 4 | ||
| java.util.logging.FileHandler.append | true | ||
| java.util.logging.FileHandler.formatter | java.util.logging.SimpleFormatter | ||
| java.util.logging.ConsoleHandler.level | WARNING | ||
| java.util.logging.ConsoleHandler.formatter | java.util.logging.SimpleFormatter | ||
| com.ofss.fll.xws.level | FINER | set the logging level for the application | Other Level values -- FINEST,FINE,CONFIG and INFO |
Table 7-2 Dealer Track
| Property Name | Property Value | Description | Remarks |
|---|---|---|---|
| Configuration File: dt_servlet_init.conf | |||
| LOSApplicationRequestServiceURL | http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSApplicationRequestService | URL for OFSLL New application WebService |
Refer the recommended context root table for CONTEXT ROOT. Sample URL: http://hostname:port/dbkls-xws-app-dt/LOSApplicationRequestService |
| LOSApplicationUpdateServiceURL | http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSApplicationUpdateService | URL for OFSLL application update WebService |
Refer the recommended context root table for CONTEXT ROOT. Sample URL: http://hostname:port/dbkls-xws-app-dt/LOSApplicationUpdateService |
| 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 | SOMELENDER_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 | DEALERTRACK | Parameter to set application source | Don't modify this value |
| dealerElementName | DEALER_DETAILS | 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 | |
| jndiLookupDataSource | jdbc/IN1HukWznG0b4esj | Parameter that defines the JNDI look up for the applicaton datasource | Don't modify the value |
| keystoreLocation | config/dls_cacerts | Parameter to set location for public/private key store for HTTPS posting and for XML Digital Signature | The keystore location should not be changed and keystore should be available in this location |
| keystorePassword | setme | The keystore password | The default password is "setme". Modify the property in case the password is different for the keystore. |
| 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_xcl_init.conf | |||
| lenderId | SOMELENDER_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 |
| dealerElementName | DEALER_DETAILS | 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 | Needed only for RouteOne |
| jndiLookupDataSource | jdbc/dbk105nlEJBDS | Parameter that defines the JNDI look up for the applicaton datasource | Don't modify the value |
| keystoreLocation | config/dls_cacerts | Parameter to set location for public/private key store for HTTPS posting and for XML Digital Signature | The keystore location should not be changed and keystore should be available in this location |
| keystorePassword | setme | The keystore password | The deafult password is "setme". Modify the property in case the password 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 private key with alias "ofss_routeone" else modify the property value to alias used while importing the private key into keystore. |
| sscroKeyPassword | demotestSSCR1 | OFSLL's private key password | demotestSSCR1 is a sample value |
| Configuration File: Logging.properties | |||
| handlers | java.util.logging.FileHandler, java.util.logging.ConsoleHandler | ||
| java.util.logging.FileHandler.level | ALL | ||
| java.util.logging.FileHandler.pattern | /somewhere/logs/dbkls_xws_%g.log | ||
| java.util.logging.FileHandler.limit | 1000000 | ||
| java.util.logging.FileHandler.count | 4 | ||
| java.util.logging.FileHandler.append | true | ||
| java.util.logging.FileHandler.formatter | java.util.logging.SimpleFormatter | ||
| java.util.logging.ConsoleHandler.level | WARNING | ||
| java.util.logging.ConsoleHandler.formatter | java.util.logging.SimpleFormatter | ||
| com.ofss.fll.xws.level | FINER | set the logging level for the application | Other Level values -- FINEST,FINE,CONFIG and INFO |
Table 7-3 EDOCS
| Property Name | Property Value | Description | Remarks |
|---|---|---|---|
| Configuration File: ds_servlet_init.conf | |||
| LOSeApplicationRequestServiceURL | http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSeApplicationRequestService | URL for OFSLL eDocs Create/update application WebService |
Refer the recommended context root table for CONTEXT ROOT. Sample URL: http://hostname:port/dbkls-xws-app-ds/LOSeApplicationRequestService |
| LOSApplicationCommentUpdateServiceURL | http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSApplicationCommentUpdateService | URL for OFSLL eDocs comment update WebService |
Refer the recommended context root table for CONTEXT ROOT. Sample URL: http://hostname:port/dbkls-xws-app-ds/LOSApplicationCommentUpdateService |
| LOSApplicationLocationUpdateServiceURL | http://<HOST NAME>:<PORT>/<CONTEXT ROOT>/LOSApplicationLocationUpdateService | URL for OFSLL eDocs location update WebService |
Refer the recommended context root table for CONTEXT ROOT. Sample URL: http://hostname:port/dbkls-xws-app-ds/LOSApplicationLocationUpdateService |
| 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 | SOMELENDER_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 |
| dealerElementName | DEALER_DETAILS | 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 | |
| jndiLookupDataSource | jdbc/IN1HukWznG0b4esj | Parameter that defines the JNDI look up for the applicaton datasource | Don't modify the value |
| keystoreLocation | config/dls_cacerts | Parameter to set location for public/private key store for HTTPS posting and for XML Digital Signature | The keystore location should not be changed and keystore should be available in this location |
| keystorePassword | setme | The keystore password | The deafult password is "setme". Modify the property in case the password is different for the keystore. |
| 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_xcl_init.conf | |||
| lenderId | SOMELENDER_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 |
| dealerElementName | DEALER_DETAILS | 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 | |
| jndiLookupDataSource | jdbc/dbk105nlEJBDS | Parameter that defines the JNDI look up for the applicaton datasource | Don't modify the value |
| keystoreLocation | config/dls_cacerts | Parameter to set location for public/private key store for HTTPS posting and for XML Digital Signature | The keystore location should not be changed and keystore should be available in this location |
| keystorePassword | setme | The keystore password | The deafult password is "setme". Modify the property in case the password 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 private key with alias "ofss_routeone" else modify the property value to alias used while importing the private key into keystore. |
| sscroKeyPassword | demotestSSCR1 | OFSLL's private key password | demotestSSCR1 is a sample value |
| Configuration File: Logging.properties | |||
| handlers | java.util.logging.FileHandler, java.util.logging.ConsoleHandler | ||
| java.util.logging.FileHandler.level | ALL | ||
| java.util.logging.FileHandler.pattern | /somewhere/logs/dbkls_xws_%g.log | ||
| java.util.logging.FileHandler.limit | 1000000 | ||
| java.util.logging.FileHandler.count | 4 | ||
| java.util.logging.FileHandler.append | true | ||
| java.util.logging.FileHandler.formatter | java.util.logging.SimpleFormatter | ||
| java.util.logging.ConsoleHandler.level | WARNING | ||
| java.util.logging.ConsoleHandler.formatter | java.util.logging.SimpleFormatter | ||
| com.ofss.fll.xws.level | FINER | set the logging level for the application | Other Level values -- FINEST,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
Table 7-4 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 DEALERTRACK |
| 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 PASSWORD |
| 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 PASSWORD |
| 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_DLR_TRACK_LENDER_NAME | DEALERTRACK LENDER NAME |
| XWS_XAE_ROUTEONE_LENDER_NAME | ROUTEONE LENDER NAME |
| XWS_XAE_ECON_ROUTEEONE_RESP_URL | Route One E-contract response URL |